Flags

You can use these flags with the pddelete command:

-Hhost: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 | queue | medium | initial-value-job | initial-value-document | auxiliary-sheet | resource-context | transform | server}
Specifies the object class you want for this command.

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

-m"MessageText"
Specifies the message you want to associate with the object that you want to delete. You can use this message to indicate the reason for deleting the object or to provide any other comments.

If the command operates on a job with a non-zero value for the job-retention-period or job-retain-until attribute (either previously set or set with this command), you can list this message by specifying requested-attributes=job-message-from-administrator with the pdls command. Otherwise, InfoPrint deletes this message with the object and you cannot retrieve it. If you do not specify -m, the message already stored with the object remains unchanged and InfoPrint deletes it as previously described.

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

-rJobRetentionPeriod
You can only use this flag if the object class is job. InfoPrint rejects the command if you use this flag with any other class.

If the job has a retention period or retention deadline, you must specify this flag with a zero (0) value to delete the job. If not specified, InfoPrint uses the present retention period or retention deadline for the job.

Using this flag is equivalent to specifying the object attribute job-retention-period.

-x"attribute=value …"
A single attribute string, consisting of one or more attribute-value pairs.
-XAttributesFileName
Specifies the name of a file containing attribute and value pairs you want InfoPrint to insert at the current point in the command.

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

-h
Displays a command-specific help message containing information about command syntax and flags. If you use this flag with any other flag or attribute, InfoPrint recognizes only the -h flag.

Configuration logic

The command determines which server host and server port to use based on this sequence:

  1. Server host and server port specified with the -H parameter.
  2. Server host and server port specified with the PDHOST and PD_SOCKET envirnonment variables.
  3. Uses the defaults for PDHOST=localhost and PD_SOCKET=6874.
Note: This configuration logic enables multiple commands to run on a single machine communicating with one or more InfoPrint Manager servers.