HP LaserJet 9000 User manual

HP Distributed Print Service
User’s Guide
HP 9000 Computers
B2355-90156
E1097
Printed in: U.S.A.
© Copyright 1997, Hewlett-Packard Company.

2
Legal Notices
The information in this document is subject to change without notice.
Hewlett-Packard makes no warranty of any kind with regard to this
manual, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Hewlett-Packard
shall not be held liable for errors contained herein or direct, indirect,
special, incidental or consequential damages in connection with the
furnishing, performance, or use of this material.
Warranty. A copy of the specific warranty terms applicable to your
Hewlett-Packard product and replacement parts can be obtained from
your local Sales and Service Office.
Restricted Rights Legend. Use, duplication or disclosure by the U.S.
Government is subject to restrictions as set forth in subparagraph (c) (1)
(ii) of the Rights in Technical Data and Computer Software clause at
DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and
(c) (2) of the Commercial Computer Software Restricted Rights clause at
FAR 52.227-19 for other agencies.
HEWLETT-PACKARD COMPANY
3000 Hanover Street
Palo Alto, California 94304
U.S.A.
Use of this manual and flexible disk(s) or tape cartridge(s) supplied for
this pack is restricted to this product only. Additional copies of the
programs may be made for security and back-up purposes only. Resale of
the programs in their present form or with alterations, is expressly
prohibited.
Copyright Notices. ©copyright 1983-97 Hewlett-Packard Company, all
rights reserved.
Reproduction, adaptation, or translation of this document without prior
written permission is prohibited, except as allowed under the copyright
laws.
©copyright 1979, 1980, 1983, 1985-93 Regents of the University of
California

3
This software is based in part on the Fourth Berkeley Software
Distribution under license from the Regents of the University of
California.
©copyright 1980, 1984, 1986 Novell, Inc.
©copyright 1986-1992 Sun Microsystems, Inc.
©copyright 1985, 1986, 1988 Massachusetts Institute of Technology.
©copyright 1989-93 The Open Software Foundation, Inc.
©copyright 1986 Digital Equipment Corporation.
©copyright 1990 Motorola, Inc.
©copyright 1990-1995 Cornell University
©copyright 1989-1991 The University of Maryland
©copyright 1988 Carnegie Mellon University
Trademark Notices UNIX is a registered trademark of The Open
Group.
X Window System is a trademark of the Massachusetts Institute of
Technology.
MS-DOS and Microsoft are U.S. registered trademarks of Microsoft
Corporation.
OSF/Motif is a trademark of the Open Software Foundation, Inc. in the
U.S. and other countries.

4

Contents
5
1. What Is HP Distributed Print Service?
What Are the Advantages of Using HPDPS?. . . . . . . . . . . . . . . . . . . . . .14
You Will Not Have to Start from Scratch to Learn How to Print Jobs .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
You Can Access Many Kinds of Printers. . . . . . . . . . . . . . . . . . . . . . . .14
Your Print Jobs Are Validated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
You Receive Notification of Job Progress or Problems . . . . . . . . . . . . .15
You Can Receive Improved Administrative Support . . . . . . . . . . . . . .15
What Functionality Does HPDPS Provide? . . . . . . . . . . . . . . . . . . . . . . .16
HPDPS Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
2. Basic Printing Tasks
Using LP Spooler Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Getting Help for HPDPS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Defining a Default Logical Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Submitting Jobs to an HPDPS Printer. . . . . . . . . . . . . . . . . . . . . . . . . . .24
Printing to a Default Logical Printer . . . . . . . . . . . . . . . . . . . . . . . . . .24
Printing to a Specific Logical Printer . . . . . . . . . . . . . . . . . . . . . . . . . .24
Specifying Attributes for HPDPS Print Jobs. . . . . . . . . . . . . . . . . . . . . .25
Specifying the Number of Copies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Specifying Two-Sided Print Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Specifying the Page Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Specifying the Document Format for a Job. . . . . . . . . . . . . . . . . . . . . .27
Specifying Number of Images on a Page. . . . . . . . . . . . . . . . . . . . . . . .27
Printing Multiple Documents in a Single Job. . . . . . . . . . . . . . . . . . . .27
Using the pdpr Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Using a Reference File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Specifying a Medium for a Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Specifying the Number of Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

6
Contents
Determining the Status of Your Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Requesting Status Information When Submitting a Job . . . . . . . . . . 30
Requesting Status Information after Submitting the Job . . . . . . . . . 31
Determining Which Printer Device Printed the Job . . . . . . . . . . . . . . . 33
Deleting HPDPS Print Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3. Command Reference
HPDPS Object Classes vs. Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Naming of HPDPS Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
HPDPS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Command Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Using the -x Flag with Attribute Value Pairs . . . . . . . . . . . . . . . . . . . 41
Using Command Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Combining Attribute Value Pairs and Command Flags . . . . . . . . . 42
Rules for Command Flags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Examples Using Command Flags. . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Command-Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Object-Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Using Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Setting Object-Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Setting Attributes When an Object is Created . . . . . . . . . . . . . . . . 55
Setting Attributes After an Object is Created . . . . . . . . . . . . . . . . . 55
Attributes That Cannot be Specified or Set . . . . . . . . . . . . . . . . . . . 55
Default Values for Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Syntax for Attribute Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Single-Value Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Multiple-Value Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Complex Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Complex Attributes Using Braces . . . . . . . . . . . . . . . . . . . . . . . . . 57
Complex Attributes Using Colons . . . . . . . . . . . . . . . . . . . . . . . . . 58

Contents
7
Time Attribute Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Attribute Values for Range and Dimensions. . . . . . . . . . . . . . . . . . .60
Requesting Attribute Values from Objects . . . . . . . . . . . . . . . . . . . . . .60
Values for requested-attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Formatting the Display of Attribute Values . . . . . . . . . . . . . . . . . . .67
Headings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Using Initial Value Objects (IVOs) to Specify Attribute Values . . . . .70
Using an Attributes File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Reading in the Attributes File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Job and Document Identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Specific Documents within Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Authorization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Additional Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Global Character (Wildcard) Support . . . . . . . . . . . . . . . . . . . . . . . . . .79
Abbreviations for Attributes and Values. . . . . . . . . . . . . . . . . . . . . . . .79
Redirecting Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
A. Command Summary
HPDPS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
B. LP Spooler Commands Translated to HPDPS Commands
LP Spooler Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

8
Contents

9
Conventions Used in this Manual
This manual uses the following typographic conventions:
User input Text that must be entered at the command line exactly
as shown, such as
pdpr -x “page-count=50” File3
Computer Indicates commands or command segments, flags,
attributes, files, directories, and other items whose
names are predefined by the system, such as pdls and
notification-delivery-method.
Also shows text that is displayed as output on your
screen or is included within a particular file, such as
# This is a line in my attributes file
Italics Indicates a parameter or argument that you must
replace with the actual value, such as ServerName.
Also indicates a manpage reference.
Bold Indicates words defined for the first time.
Also indicates a default value for a flag.
Syntax Notation Command syntax notation uses symbols to indicate specific conditions.
When issuing an HPDPS command, do not actually enter the following
symbols at the command line, unless specifically instructed to do so:
Brackets [ ]
Braces { }
Bar |
Ellipsis …
These symbols have the following meanings, as illustrated using the
following sample syntax statement:
pdmod [Flags]{LocalJobId …|GlobalJobId …}

10
• Brackets, [ ], around values indicate that they are optional. Here,
they mean that you do not have to enter any of the available pdmod
flags with the pdmod command.
• Braces, { }, around values indicate required items that you must
supply with the command. Here, they mean that you must enter
either a LocalJobId or a GlobalJobId with the pdmod command.
Braces are also used within the notification-profile attribute.
• A vertical bar, |, between values indicates that you can only enter one
of the values with the command. Here, it means that when you issue
the pdmod command, you can specify either a LocalJobId or a
GlobalJobId, but not both.
• An ellipsis, …, indicates that you can supply more than one
occurrence of a particular type of value with the command. Here, it
means that you can supply more than one local job identifier value or
more than one global job identifier value with the pdmod command.
Special Characters in
Syntax Some special characters are included in commands. When colons, dashes,
the equals sign, double quotation marks, single quotation marks, and
braces are shown in command syntax notation, include them when you
issue the command. These special characters have the following
meanings:
• A colon, :, separates related values. For example:
pdmod -x "sides=2" Spool12:1011230045
Spool12:1011230045 is a global job identifier on the Spool12
server.
• A dash, -, always precedes a flag. For example, -x.
• The equals sign, =, separates attribute and value pairs. For example:
pdmod -x "sides=2" Spool12:1011230045
means that 2is the value assigned to the sides attribute.
• Double quotation marks, " ", surround multiple attribute and value
pairs, such as:
-x "sides=2 content-orientation=portrait"
For consistency, double quotation marks also are shown around single
attribute and value pairs in all examples, although they are not
required.

11
• Double quotation marks, " ", surround text strings that contain
spaces, such as:
-m "Down for maintenance"
• Single quotation marks, ' ' , surround a text string that contains
spaces when the text string is imbedded in a statement already
enclosed in double quotation marks. An example is:
-x "sides=2 job-print-after='08:00:00 03/09/95'"
• Braces, {}, surround a value within the notification-profile
attribute. An example is:
-x "notification-profile={delivery-method=electronic-mail}"
• Double ampersand, &&, means "and" within a command. An example
is:
pdls -U -f "user-name=*fljones && \
printer-name-requested==LogPrt1" Spool1:
• Double vertical bar, ||, means "or" within a command. An example is:
pdls -U -r brief,job-state-reasons -s column \
-f "current-job-state==retained \
|| current-job-state==timed-out" \
Spool2:
• Asterisks and equal signs are used to match strings. For example:
"job owner=*Jones" initial string match
"job-owner*=*one" any substring match
"job-owner*=nes" final string match
Using Abbreviations
for Attribute Names
and Values
In many cases, you can abbreviate attribute names and values by using
the first letter of each word in the name or value. For example, you can
use the abbreviation s-m-s for the start-message-supported
attribute, tfor the true value, and specify the attribute and value pair
as s-m-s=t.
However, in some cases specifying only the first letter in each word can
be ambiguous, as for the attributes job-owner and job-originator.
In these cases, specify enough of the name so that is unique, as in j-ow
and j-or. If the values are ambiguous, HPDPS rejects the command and
you receive an error message. Use abbreviated attribute names and
values as appropriate.

12

Chapter 1 13
What Is HP Distributed Print Service?
1 What Is HP Distributed Print
Service?
HP Distributed Print Service (HPDPS or DPS) is a product that
facilitates and simplifies printing in a network environment. It allows
you to use systems, printers, and applications from a variety of vendors
and gives your print administrator the tools to serve your needs
effectively.

14 Chapter1
What Is HP Distributed Print Service?
What Are the Advantages of Using HPDPS?
What Are the Advantages of Using
HPDPS?
You Will Not Have to Start from Scratch to
Learn How to Print Jobs
You may not even be aware that you are using HPDPS-managed
printers. To send jobs to HPDPS printers, you can use the same
commands, applications, and “drag and drop” actions that you are using
today. All you do is just specify a printer configured as an HPDPS printer
as the destination for your job.
You Can Access Many Kinds of Printers
You may currently be using desktop PostScript printers,
network-attached printers, and host-attached production printers to
print from your applications. You may be using different print commands
or menus to access each of these printers and may get involved in some
complicated setup procedures to gain access to the printers you need.
With HPDPS, you can access the printers in your network without
having to know where the printers are located, which data formats they
accept, or to which print servers the printers are attached.
Your Print Jobs Are Validated
Submitting your job to an HPDPS-managed “logical” printer gives you
more power and flexibility than sending your job to a specific hardware
device. When you submit a job to a logical printer, HPDPS validates the
job before accepting it to ensure that a physical printer will be able to
print the job correctly. (More on the distinction between a logical printer
and a physical printer shortly.) You don't need to be an expert on data
formats or printer capabilities; HPDPS directs your job to a printer
capable of successfully completing your job, if one exists, or rejects your
job, if one doesn't exist. You do not have to wait until your job is printed,
possibly incorrectly, to find out whether the printer can accept a
particular data format or if it can print double-sided jobs (duplex).

Chapter 1 15
What Is HP Distributed Print Service?
What Are the Advantages of Using HPDPS?
You Receive Notification of Job Progress or
Problems
After your job is accepted by HPDPS, it waits in a queue until a physical
printer becomes available to print the job. While the job is waiting in the
queue and then while it is printing, you can receive messages that
indicate its progress or any problems that occur. For example, you can be
notified when the job finishes printing.
You Can Receive Improved Administrative
Support
HPDPS provides tools for managing printers and jobs that improve the
ability of your administrator to meet your printing needs. The
administrator can configure the distributed print environment and set
up job defaults according to your needs while also meeting the needs of
other groups of users. Problems in the print system are reported to the
appropriate personnel immediately so that an administrator can
anticipate or respond to a problem, often before you are even aware of it.
If your job gets delayed because of a large demand for a printer, your
administrator can re-route or promote your job so that it will print more
quickly.

16 Chapter1
What Is HP Distributed Print Service?
What Functionality Does HPDPS Provide?
What Functionality Does HPDPS
Provide?
You can query a job’s status and receive messages telling you how your
job is progressing.
HPDPS will validate your job, ensuring that there are printers capable of
printing it.
When you submit a job, you can indicate specific characteristics or
attributes for your job and the documents in your job. If you need to alter
these attributes, you can modify the job at any time until the job begins
printing. For example, suppose you submit a job and then realize you
need multiple copies or two-sided output. As long as the job is still
waiting to print, you can modify the request.
If the printers become too busy or inoperable, you can move your job to
another printer without reconstructing the job.
You can select which job-related messages you want to receive. For
example, if your printer is located within your work area, you may not
want messages related to problems with the printer but you may want to
know if your job is cancelled by the administrator before it gets to the
printer. If you are sending a high-priority job to a printer that is not
located near you, you may want to get detailed information about any
significant happenings related to the job. In addition, you can route some
job messages to other interested users.

Chapter 1 17
What Is HP Distributed Print Service?
HPDPS Terminology
HPDPS Terminology
All jobs are printed on hardware called printers or printer devices.
Within your printing system, there are likely to be many printer devices
with each device having its own capabilities. For example, some printer
devices can print on both sides of the page, some can print PostScript
documents, and so on. HPDPS internally represents each printer device
and its capabilities as a physical printer. Each physical printer within
an HPDPS environment has an associated print queue and logical
printer, defined below.
When you submit a job for printing, you submit it to a logical printer.
HPDPS uses a logical printer to check (validate) the printer
requirements of a job and determine if there is a physical printer capable
of handling the job requirements before the job is accepted. When
HPDPS accepts the job, the logical printer provides some default values
for the job and places the job in a print queue where the job waits until
an appropriate physical printer is available to print the job.
HPDPS manages and prints jobs by using objects such as printers, jobs,
and queues. Each HPDPS object has attributes and associated attribute
values. For example, the attributes of a job define the printer
requirements of the job, and the attributes of a physical printer define
the capabilities of the printer device it represents. Using particular
attribute values, HPDPS can determine which printer device is capable
of printing the job.
The logical printers, queues and physical printers to which you have
access are all managed by a server. The HPDPS environment has two
types of servers: the spooler and the supervisor. The HPDPS spooler is
the server that manages the logical printers. The HPDPS supervisor is
the server that controls the physical printers that print the job.
Each HPDPS command described in this book acts on one or more of
HPDPS objects. These commands enable you to submit, modify and
remove jobs. They also enable you to query the status and attributes of
your jobs and all the other objects in your HPDPS environment.
If HPDPS uses Distributed Computing Environment (DCE) services, the
environment is called a DCE Extended Environment; if DCE services
are not used, then HPDPS operates in a Basic Environment. This has
implications for how your print system is set up. See the HP Distributed
Print Service Administration Guide for more information.

18 Chapter1
What Is HP Distributed Print Service?
HPDPS Terminology

Chapter 2 19
Basic Printing Tasks
2 Basic Printing Tasks
This chapter contains information to help you do the following tasks:
• use LP spooler commands
• get help for HPDPS commands
• set up a default logical printer
• submit a print job
• specify attributes for HPDPS jobs
• determine the status of your job
• determine which printer device printed a job
• delete print jobs
For complete information about all the HPDPS commands and their
attributes, refer to Chapter 3, “Command Reference”.

20 Chapter2
Basic Printing Tasks
Using LP Spooler Commands
Using LP Spooler Commands
With HPDPS, you can continue to submit your usual HP-UX Line
Printer Spooler (LP spooler) commands. HPDPS translates these
commands as needed and provides, as closely as possible, the same
functionality. However, there are small differences between the ways
that LP spooler-managed printers and HPDPS-managed printers handle
some commands. You may also see differences in the information
returned from a query command. For more detailed information, see
Appendix B, “LP Spooler Commands Translated to HPDPS Commands”.
All printers configured with HPDPS on a local system are visible
immediately to the LP spooler without any additional configuration.
Remotely located HPDPS printers will also be visible to the LP spooler if
running in the DCE Extended Environment.