1    Introduction

Advanced Printing Software is a network printing service. It manages jobs and printers from anywhere on the local network regardless of type of printer. It provides a smart link between you and the available printers.

1.1    Benefits of Using Advanced Printing Software

When you use printers managed by Advanced Printing Software, you gain several benefits. These include:

1.2    Advanced Printing Software Terminology

The following terms describe how Advanced Printing Software processes your print requests.

1.3    Access to the User Interfaces

In addition to the command-line interface described in this manual, the Advanced Printing Software contains a graphical user interface (GUI) that can be used to submit print jobs and monitor print jobs.

The pdprint GUI program submits print jobs. The pdprintinfo GUI program obtains job and printer status. These GUIs are accessible from the command-line or from the Print Manager icon of the CDE desktop. The following methods can be used to access these programs:

1.4    Command Syntax Elements

The syntax for all print system commands has the following format:

command option option-argument object-instance

The syntax elements are:

The following is an example of the complete command-line:

pdpr -n 2 opus1.txt

1.4.1    Specifying Options and Arguments

Options and option arguments modify the default behavior of print system commands. The following guidelines apply to using options and arguments with the CLI commands:

1.4.2    Specifying Operands and Classes

Some commands require you to specify at least one operand. A command operand specifies an object such as a file name on which you want to perform an operation.

Several commands that take operands can perform an operation on different classes of print system objects. The class of an object indicates what kind of object it is, such as a printer, queue, job, server, or document. Use the-c class option to specify the operand class of a command.

The following table summarizes the commands available to end users.

Table 1-1:  End User Commands

Command Description
pdls Lists print object attributes.
pdmod Modifies previously submitted print jobs or documents.
pdpause Pauses your print jobs.
pdpr Submits a print job.
pdq Reports on or obtains status of print jobs.
pdresubmit Resubmits print jobs.
pdresume Resumes your own print jobs.
pdrm Removes (that is, cancels) your print jobs.

1.5    Attribute Guidelines

The print system manages print jobs by using objects such as printers, jobs, documents, and queues. Every object has attributes and associated attribute values. For example:

The following sections provide guidelines for using attributes with print commands.

1.5.1    Modifying Default Attribute Values

Some attributes have default values. However, for most attributes, the default value is no value. Attribute values can be modified in several ways.

For a detailed directory of all attributes and their associated values, refer to the Advanced Printing Software Command Reference Guide.

1.5.2    Attribute Value Syntax

Some attributes can have only one value at a time (singlevalued). Others can have multiple values (multivalued). Yet other attributes can have one or more values, where each value itself has multiple components (complex).

This section describes the syntax for single-valued, multivalued, and complex attributes.

1.5.2.1    Syntax for Single-Value Attributes

The syntax for single-valued attributes is:

attribute=value

For example:

copy-count=2

If an attribute value is a text string with embedded space characters, you must enclose the string inside two sets of quotes. For example:

job-comment='"Deliver to Joe"'

1.5.2.2    Syntax for Multivalue Attributes

The syntax for multivalued attributes is:

attribute="value_1 value_2 ... value_n"

For example:

content-orientations-supported="portrait landscape"

1.5.2.3    Syntax for Complex Attributes

The syntax for complex attributes is:

attribute="{attribute=value attribute=value attribute=value}"

For example:

access-control-list="{name-type=all-users privilege-level=end-user}"

1.5.3    Abbreviating Attributes and Values

You can abbreviate attributes and standard identifier values by using only a few letters of each word in the name or value. For example, you can use the abbreviation j-s for the job-sheets attribute, j-c-s for the job-copy-start value, and specify the attribute as j-s=j-c-s.

The system accepts only unambiguous abbreviations. For example, abbreviating job-owner as j-o is not valid because it can also stand for job-originator. You need to specify enough of the attribute or value name so that it is unique. Examples of valid abbreviations are as follows:

j-ow or job-own for job-ownerj-or or job-orig for job-originatori-a3-w for iso-a3-white

You cannot abbreviate name values that are not standard identifiers, such as site-specific media or tray names.

1.6    Job and Document Identifiers

Every print job is identified by a unique job identifier, comprised of a server (spooler) name, a colon, and a job number. The server assigns a job identifier when it accepts your job as part of a print request.

Examples of valid job identifiers are galileo_spl:1564 and kepler:1571.

Several commands, such as pdpause and pdresume, accept job identifiers as operands. Such commands also allow you to specify a document identifier in a multidocument job.

Some commands require you to identify a specific document within a multidocument job. A document identifier is expressed as a job identifier, a period, and a document number. Within each multidocument job, the documents are numbered starting with 1.

If kepler:1571 is a valid job identifier, then the second document in that job would be kepler:1571.2.

1.7    Getting Help for Commands

To get help for a command and its options, enter the command name followed by the -h option. For example, for help on the pdpr command, enter:

% pdpr -h

You can also use the man command to display information about the print system commands. For example, for help on the pdpr command, type:

% man pdpr