pdset command: defines attribute values

Syntax

pdset [-H host:port] [-c ObjectClass] [-g] [-m "MessageText"] 
[-r "attribute …"] [-s StyleName] 
[-x "attribute=value …"] [-X AttributesFileName] 
{ServerName … |  ServerName:AuxiliarySheetName … | 
ServerName:DefaultDocumentName … | 
ServerName:DefaultJobName … | 
[ServerName:]DestinationName … | ServerName:LogName … | 
ServerName:MediumName … |[ServerName:]QueueName … | 
ServerName:ResourceContextName … | 
ServerName:TransformName … | 
LocalJobID … | 
GlobalJobID …}

pdset -h

Description

Use the pdset administrative command to define or modify the values of object attributes.

If SNMPv1 is enabled on an actual destination and the snmp-write-community-name attribute on the actual destination is set properly, you can set information directly on the device associated with the actual destination by setting device-specific actual destination attributes. If SNMPv3 is enabled on an actual destination and the snmpv3-username attribute on the actual destination is set properly, you can set information directly on the device associated with the actual destination by setting device-specific actual destination attributes. For more information about device-specific attributes, see “About SNMP communication” in the RICOH InfoPrint Manager for AIX: Procedures, RICOH InfoPrint Manager for Linux: Procedures, or RICOH InfoPrint Manager for Windows: Procedures. For a description of the individual device-specific actual destination attributes, see InfoPrint object attributes.

You must disable an actual destination before you can modify its attributes. However, you do not need to disable an actual destination to change values for device-specific information, such as the device-contact or device-location attributes.

You cannot set actual destination and device-specific attributes in the same pdset command.

For more information about device-specific attributes, see “Working with SNMP Printers” in RICOH InfoPrint Manager for AIX: Procedures, RICOH InfoPrint Manager for Linux: Procedures, or RICOH InfoPrint Manager for Windows: Procedures.

The next table lists the four modification operators.

pdset operators

Operator Syntax Description
Replace attribute=value Replaces the entire value of the attribute with value or adds the attribute to the object, if not already present.
Add values attribute+=value Adds the value to the attribute. You cannot add values to single-valued attributes. InfoPrint honors an add request that duplicates values on a multi-valued attribute without warning.
Remove values attribute-=value Removes the value from the attribute. InfoPrint ignores a remove request for a nonexistent value, without warning or error. A remove request for the last or only value of an attribute is equivalent to a reset-to-default request.
Reset to default attribute== Sets the attribute value to the default. If you supply values with a reset-to-default request, InfoPrint ignores them.

If you do not specify a value with a replace, add, or remove request, InfoPrint issues an error and rejects the request to change the object.

You can only use the Replace operator of the pdset command with device-specific attributes.

You can only change values for resettable attributes using the pdset command. Using this command for non-settable or initially settable attributes results in an error.

See InfoPrint object attributes for lists of all resettable attributes by object and a description of each attribute.

Changes made to objects are permanent and remain changed even if you shut down and then restart the system (except for logs).

If the ignore-ivo-values attribute is set to true on the server and the request is to default or remove a value and there are no values left for that attribute, InfoPrint Manager ignores the value of the job and document default attribute when setting its value. See the ignore-ivo-values attribute.

Flags

You can use these flags with the pdset command:

-H host:port

Identifies the host and port of the InfoPrint Manager server used for communication. When not specified, the command follows the Configuration logic to define the host and socket.

-c {destination | job | server | queue | auxiliary-sheet | document | initial-value-job | initial-value-document | medium | resource-context | transform | log} DEFAULT=destination
Specifies the object class that you want for this command. In the valid classes, destination is for a logical destination or actual destination.

Using this flag is equivalent to specifying the command attribute operation-class.

-g
Turns off headings.

Using this flag is equivalent to specifying the command attribute headings=false.

-m "MessageText"
Specifies the message that you want to associate with the object that you want to modify. You can use this message to indicate the reason why you are modifying or setting object attributes or to provide any other comments.

If the command operates on a job, you can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command. Otherwise, you can list this message by specifying requested-attributes=message with the pdls command.

If you do not specify the -m flag, the message already stored with the object remains unchanged.

Using this flag is equivalent to specifying the command attribute message.

-r {none | brief | verbose} DEFAULT=none
Specifies the attribute values you want to display for the specified object.
none
Displays no attributes.
brief
Displays a small subset of important attributes for each object.
verbose
Displays a larger subset of important attributes for each object.

Using this flag is equivalent to specifying the command attribute requested-attributes.

-s {column | doccol | line} DEFAULT=column
Specifies the format in which you want InfoPrint to display the attributes.
column
Attribute values are displayed in tabular format, so that values of the same attribute for multiple objects line up in columns.
doccol