Flags

You can use these flags with the pdls 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 {job | auxiliary-sheet | document | initial-value-document | initial-value-job | log | medium | destination | queue | resource-context| transform| server} DEFAULT=job

Specifies the object class of the object whose attributes you want to list. All object classes are valid.

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

-A

Use this flag to display information about a logical destination and its associated actual destinations. Associated actual destinations are defined as those listed on a logical destinations default job's actual-destinations-requested attribute, or if no actual destinations are listed, then all the actual destinations associated with the same queue as the logical destination.

If the target of the request is an actual destination or other object class, the flag is ignored.

Using this flag is equivalent to specifying the pdls associated-actual-destinations command attribute.

-f"FilterCriteria"

Specifies the filter criteria you want to use in selecting from the candidate objects. Among the candidate objects, InfoPrint returns only those matching the filter expression. See the command attribute filter, for filter expression details.

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

-F

Turns off all filtering, both specified and default. See the -U flag for suppressing only the default.

-g

Turns off headings.

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

-j

Use this flag to display only job attributes.

-r {brief | verbose | archive |"attribute …" | all | all-device | none} DEFAULT=brief

Specifies the group of attributes that you want to display for the specified job, auxiliary sheet, document, default document, default job, log, medium, destination, queue, resource-context, or server.

brief

Displays a small subset of important attributes for each object.

verbose

Displays a larger subset of important attributes for each object.

archive

Writes only initially settable and resettable attributes to an archive file (see Create an archive file).

attributes …

Displays the attributes you specify.

all

Displays all attributes.

all-device

Displays all device attributes from the device associated with an actual destination.

none

Displays no attributes.

If you specify more than one of these values, InfoPrint displays all the attributes requested.

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

-Rservername

Displays information for retained jobs only.

Using this flag is equivalent to specifying the command attribute retained-jobs-only.

-s {column | doccol | line} DEFAULT={ column | line }

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. This is the default for -r brief and -r verbose.

doccol

For jobs only, job attribute values and the document attribute values for the first document in the job are displayed in column format on the same line.

line

Each attribute is displayed on a separate line. This is the default for -r all, -r"attribute …:", and -r archive.

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

-U

Suppresses the default user-name filter.

-x"attribute=value …"

Consists of a single attribute string, containing one or more attribute-value pairs.

-XAttributesFileName

Specifies the name of the 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.