HP LaserJet 9000 Instruction Manual

HP 9000 Computer Systems
HP Distributed Print Service
Administration Guide
ABCDE
HP Part No. B2355-90113
Printed in U.S.A. 1996
First Edition
E0696

The information contained in this do cument is sub ject to change
without notice.
Hewlett-Packard makes no warrantyofany kind with regard to this
material, including, but not limited to, the implied warranties of
merchantability or tness for a particular purpose. Hewlett-P
ackard
shall not b e liable for errors contained herein or for direct, indirect,
special, incidental or consequential damages in connection with the
furnishing or use of this material.
Hewlett-Packard assumes no resp onsibility for the use or reliabilityof
its software on equipment that is not furnished by Hewlett-Packard.
This do cument contains proprietary information which is protected
by copyright. All rights are reserved. Repro duction, adaptation, or
translation without prior written permission is prohibited, except as
allowed under the copyrightlaws.
Copyright
c
 1996 by Hewlett-Packard Company
Use, duplication, or disclosure by the U.S. Government is sub ject
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. Rights for non-DoD U.S. Government Departments and
agencies are as set forth in FAR 52.227-19 (c) (1,2).
Hewlett-Packard Company
3000 Hanover Street
Palo Alto, CA 94304 U.S.A.
Restricted Rights Legend

Conventions Used in this Manual
This manual uses the following typographic conventions:
Italic Italic indicates a parameter or argument that you must replace
with the actual value, suchas ServerName .
Computer Computer indicates commands, attributes, les, directories,
and other items whose names are predened by the system,
suchas pdls and notification-delivery-method .
Bold Bold indicates words dened for the rst time.
iii

Syntax Notation
Syntax Notation
Command syntax notation uses symbols to indicate sp ecic conditions. Do
not enter the following symbols, unless sp ecically instructed to do so, when
actually issuing an HPDPS command:
Brackets []
Braces {}
Bar |
Ellipsis ...
These symbols have the following meanings.
Brackets, [] , around values indicate that they are optional. For example:
pdmod [ Flags ]{ LocalJobId ... | GlobalJobId ... }
means that you do not haveto enter any of the available pdmod ags with the
pdmod command.
Braces, {} , around values indicate required items that you must supply with
the command. For example:
pdmod [ Flags ]{ LocalJobId ... | GlobalJobId ... }
means that you must enter either a LocalJobId or a GlobalJobId with the
pdmod command. Braces are also used within the notification-profile
attribute.
Avertical bar, | ,between values indicates that you can only enter one of the
values with the command. For example:
pdmod [ Flags ]{ LocalJobId ... | GlobalJobId ... }
means that when you issue the pdmod command, you can sp ecify either a
LocalJobId or a GlobalJobId , but not b oth.
An ellipsis, . . . , indicates that you can supply more than one o ccurrence of
a particular type of value with the command. For example:
pdmod [ Flags ]{ LocalJobId ... | GlobalJobId ... }
iv

Syntax Notation
means that you can supply more than one lo cal job identier value or more
than one global job identier value with the pdmod command.
v

Special Characters in Syntax
Special Characters in Syntax
Some sp ecial 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, : , separate related values. For example:
pdmod -x "sides=2" Spool12:1011230045
1011230045 is a global job identier on the Spool12 server.
A dash, - , always precedes a ag. For example, -x .
The equals sign, = , separates attribute and value pairs. For example:
pdmod -x "sides=2" Spool12:1011230045
means that 2 is 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.
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}"
vi

Special Characters in Syntax
Double amp ersand, && , 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:
Astericks 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" nal string match
For information on writing HPDPS commands, see HP Distributed Print
Service User's Guide .
vii

Using Abbreviations for Attribute Names and Values
Using Abbreviations for Attribute Names and Values
In many cases, you can abbreviate attribute names and values by using the
rst letter of eachword in the name or value. For example, you can use the
abbreviation s-m-s for the start-message-supported attribute, t for the
true value, and sp ecify the attribute and value pair as s-m-s=t .
However, in some cases specifying only the rst letter in eachword 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.
viii

Contents
1. Intro ducing HP Distributed Print Service
The Benets of HPDPS . . . . . . . . . . . . . . . . . . 1-1
The Minimum HPDPS Conguration . . . . . . . . . . . . 1-3
HPDPS Architecture . . . . . . . . . . . . . . . . . . . 1-4
What is an HPDPS Physical Printer? . . . . . . . . . . . 1-5
What Is an HPDPS Logical Printer? . . . . . . . . . . . 1-5
What Is an HPDPS Queue? . . . . . . . . . . . . . . . 1-5
What Is an HPDPS Sp o oler? . . . . . . . . . . . . . . . 1-6
What Is an HPDPS Sup ervisor? . . . . . . . . . . . . . 1-6
The Distributed PrintEnvironment . . . . . . . . . . . . . 1-6
The DCE Extended Environment. . . . . . . . . . . . . 1-7
The Basic Environment . . . . . . . . . . . . . . . . . 1-7
What Are Ob jects and Attributes? . . . . . . . . . . . . . 1-7
How HPDPS Pro cesses Jobs . . . . . . . . . . . . . . . . 1-8
Understanding Job and Do cument Defaulting . . . . . . . . . 1-9
Conguring HPDPS to Meet the Needs of Your Users . . . . . 1-10
Balancing the Use of Printer Devices . . . . . . . . . . . 1-10
Providing Secured Access to Printer Devices . . . . . . . . 1-12
Authorizing Access to Printer Functions . . . . . . . . . . 1-13
Basic Environment Access to DCE Extended Environments . 1-14
Supporting LP Spo oler Users . . . . . . . . . . . . . . . 1-15
HPDPS System ManagementInterfaces . . . . . . . . . . . 1-16
Using the Command Line Interface . . . . . . . . . . . . 1-16
Using the System Administration Manager (SAM) . . . . . 1-16
Contents-1

2. Installing HP Distributed Print Service
Prerequisites for HPDPS Installation . . . . . . . . . . . . 2-1
Calculating the Memory and Disk Space Requirements . . . . 2-2
Disk Space Required for HPDPS Comp onents . . . . . . . 2-2
Disk Space Required for Spo oling . . . . . . . . . . . . 2-3
Disk Space Required for Paging . . . . . . . . . . . . . 2-3
Total Disk Space Required for a Distributed Print
Environment . . . . . . . . . . . . . . . . . . . 2-5
Installing Individual HPDPS Comp onents . . . . . . . . . . 2-5
Conguring DCE Comp onents . . . . . . . . . . . . . . . 2-6
Conguring DCE Security . . . . . . . . . . . . . . . . . 2-6
3. Planning Your HPDPS Conguration
Planning Overview . . . . . . . . . . . . . . . . . . . . 3-1
Meeting Your Printing and Management Needs . . . . . . . . 3-2
Planning Your Physical Conguration . . . . . . . . . . . . 3-3
Determining How Many Clients to Install . . . . . . . . . 3-3
Determining How Many Spo olers to Install . . . . . . . . . 3-3
Determining How Many Supervisors to Install . . . . . . . 3-4
Migrating Your Printers to Be Managed by HPDPS . . . . . 3-4
Planning Your Logical Conguration . . . . . . . . . . . . 3-5
Spo oler Considerations . . . . . . . . . . . . . . . . . 3-5
Logical Printer Considerations . . . . . . . . . . . . . . 3-5
Queue Considerations . . . . . . . . . . . . . . . . . . 3-6
Supervisor Considerations . . . . . . . . . . . . . . . . 3-6
Physical Printer Considerations . . . . . . . . . . . . . . 3-6
HPDPS Gateway Printer Considerations . . . . . . . . . . 3-6
Selecting Logical Conguration Mo dels . . . . . . . . . . . 3-7
The Desktop Conguration Mo del . . . . . . . . . . . . 3-7
The Printer Pool Conguration Mo del . . . . . . . . . . . 3-9
The Funnel Conguration Mo del . . . . . . . . . . . . . 3-10
The Hourglass Conguration Mo del . . . . . . . . . . . . 3-12
Planning DCE Extended EnvironmentPersonnel Groups . . . . 3-13
Security Considerations . . . . . . . . . . . . . . . . . 3-13
Notication Considerations . . . . . . . . . . . . . . . . 3-14
Planning User Groups . . . . . . . . . . . . . . . . . . 3-14
Planning Printer Operator Groups . . . . . . . . . . . . 3-14
Planning System Operator Groups . . . . . . . . . . . . 3-15
Contents-2

Planning Administrator Groups . . . . . . . . . . . . . . 3-15
4. Getting Started with HPDPS
HPDPS Administration Login . . . . . . . . . . . . . . . 4-1
Logging in to DCE . . . . . . . . . . . . . . . . . . . 4-1
Initially Starting HPDPS Comp onents . . . . . . . . . . . . 4-2
Startup Log File . . . . . . . . . . . . . . . . . . . . 4-2
Verifying That HPDPS Pro cesses Are Running . . . . . . . . 4-3
Using SAM to Verify HPDPS Pro cesses . . . . . . . . . . 4-3
Verifying That the HPDPS Client Daemon Is Running . . . . 4-3
Verifying That the Supervisor Is Running . . . . . . . . . 4-3
Checking on Multiple Sup ervisors . . . . . . . . . . . . 4-4
Verifying That the Sp o oler Is Running . . . . . . . . . . . 4-4
Checking on Multiple Sp oolers . . . . . . . . . . . . . 4-5
Automatically Starting HPDPS . . . . . . . . . . . . . . . 4-5
Starting HPDPS . . . . . . . . . . . . . . . . . . . . 4-7
Stopping HPDPS Comp onents . . . . . . . . . . . . . . 4-7
Verifying and Setting EnvironmentVariables . . . . . . . . . 4-7
Verifying the Setting of the PATH EnvironmentVariable . . . 4-8
Setting the PD CONFIRM DELETE EnvironmentVariable . 4-8
Setting the PDPRINTER EnvironmentVariable . . . . . . 4-8
Understanding How System Shutdown Aects HPDPS . . . . . 4-9
Backing Up and Restoring HPDPS Directories . . . . . . . . 4-9
Backing up Your HPDPS Directories and Files . . . . . . . 4-9
Restoring Data . . . . . . . . . . . . . . . . . . . . . 4-10
Further Tuning of HPDPS . . . . . . . . . . . . . . . . . 4-10
5. Creating/Conguring Supervisors and Physical Printers
Creating and Conguring Supervisors . . . . . . . . . . . . 5-2
Creating or Starting the Supervisor . . . . . . . . . . . . 5-2
Conguring Sup ervisors . . . . . . . . . . . . . . . . . 5-3
Specifying a Description for the Supervisor . . . . . . . . 5-3
Specifying Key Contacts for the Sup ervisor . . . . . . . . 5-3
Receiving Supervisor Notication Messages . . . . . . . . 5-3
Creating and Conguring Physical Printers . . . . . . . . . . 5-4
Creating a Physical Printer . . . . . . . . . . . . . . . 5-4
Adding A Printer Mo del . . . . . . . . . . . . . . . . . 5-9
Conguring Physical Printers . . . . . . . . . . . . . . . 5-10
Contents-3

Descriptive Attributes . . . . . . . . . . . . . . . . . 5-10
Determining Attributes of a Physical Printer . . . . . . . 5-10
Enabling a Physical Printer . . . . . . . . . . . . . . . 5-11
6. Conguring Spo olers, Queues, and Logical Printers
Creating and Conguring HPDPS Spo olers . . . . . . . . . . 6-2
Creating or Starting the Spo oler . . . . . . . . . . . . . 6-2
Conguring Sp oolers . . . . . . . . . . . . . . . . . . 6-3
Receiving Spo oler Notication Messages . . . . . . . . . 6-3
Specifying Key Contacts for the Sp ooler . . . . . . . . . 6-4
Specifying a Description for the Spo oler . . . . . . . . . 6-4
Creating and Conguring Queues . . . . . . . . . . . . . . 6-5
Creating a Queue . . . . . . . . . . . . . . . . . . . . 6-5
Specifying the Queue Scheduling Metho d . . . . . . . . . 6-5
About the First-In-First-Out (FIFO) Scheduling Metho d . . 6-6
About the Priority-FIFOScheduling Metho d . . . . . . . 6-7
Conguring the Queue Backlog Attributes . . . . . . . . . 6-9
About Controlling Queue Backlog Pro cessing . . . . . . . 6-10
Receiving Queue Notication Messages . . . . . . . . . . 6-12
Specifying Who Receives Messages From Users . . . . . . . 6-12
Specifying a Description for the Queue . . . . . . . . . . . 6-13
Creating and Conguring Initial-Value-Job and
Initial-Value-Do cument Ob jects . . . . . . . . . . . . . 6-14
What Attributes Can You Specify for Initial Value Ob jects? . 6-14
Creating an Initial Value Ob ject . . . . . . . . . . . . . 6-15
Asso ciating an Initial Value Ob ject with a Logical Printer . . 6-15
Creating and Conguring Logical Printers . . . . . . . . . . 6-16
Creating the Logical Printer . . . . . . . . . . . . . . . 6-16
Conguring the Logical Printer . . . . . . . . . . . . . . 6-17
About Job Defaulting and Validation . . . . . . . . . . . 6-18
Validation at the Logical Printer . . . . . . . . . . . . 6-20
Validation at the Physical Printer . . . . . . . . . . . . 6-20
Job/Do cumentAttributes Requiring Initial Value Ob jects to
Restrict . . . . . . . . . . . . . . . . . . . . . . . 6-21
Physical Printer Selection Attributes . . . . . . . . . . . 6-24
Conguring Logical Printers for Defaulting and Restriction . . . 6-26
Using an Initial Value Ob ject for Job and Do cument Defaulting 6-27
Adding Logical Printers to a Desktop Conguration . . . . . 6-29
Contents-4

Using Logical Printers to Restrict the Use of Printer
Capabilities . . . . . . . . . . . . . . . . . . . . . 6-31
Using Initial Value Ob jects to Ensure Restriction . . . . . . 6-35
Conguring Logical Printers for Workload Balancing . . . . . 6-36
Conguring Logical Printers with DCE Security . . . . . . . 6-38
Using DCE to Restrict Access with One Logical Printer . . . 6-39
Using DCE to Restrict Access with Multiple Logical Printers . 6-41
Using Logical Printers and DCE to Restrict Capabilities . . . 6-43
Conguring Logical Printers as HPDPS Gateway Printers . . . 6-46
Other Logical Printer Conguration Tasks . . . . . . . . . . 6-49
Specifying a Description for the Logical Printer . . . . . . . 6-49
Receiving Logical Printer Notication Messages . . . . . . . 6-50
Enabling a Logical Printer . . . . . . . . . . . . . . . . 6-51
7. Using Notication
What Is Notication? . . . . . . . . . . . . . . . . . . . 7-1
Understanding the notication-prole Attribute . . . . . . . . 7-1
event-identiers Comp onent . . . . . . . . . . . . . . . 7-2
Events Specied for Servers (Spo olers and Supervisors) . . 7-3
Events Specied in any Notication Prole . . . . . . . . 7-3
delivery-method and delivery-address Comp onents . . . . . 7-4
event-comment Comp onent. . . . . . . . . . . . . . . . 7-5
lo cale Comp onent. . . . . . . . . . . . . . . . . . . . 7-5
List of Notication Event Identiers . . . . . . . . . . . . . 7-5
List of Notication Event Classes . . . . . . . . . . . . . . 7-23
Understanding Default Notication . . . . . . . . . . . . . 7-29
Adding, Replacing, or Deleting Values from Notication Proles 7-31
Displaying the Contents of a Notication Prole . . . . . . . 7-33
Creating a Notication Prole . . . . . . . . . . . . . . . 7-33
Adding a Value to a Notication Prole . . . . . . . . . . 7-34
Adding an Event to an Existing Value . . . . . . . . . . . 7-34
Specifying Who Receives Notication . . . . . . . . . . . 7-35
Sending DierentPeople Messages for the Same Ob ject . . 7-35
Setting TwoValues for the Same Person . . . . . . . . . 7-35
Setting TwoValues for Someone Other Than Yourself . . . 7-35
Using Just the delivery-method Comp onent . . . . . . . 7-37
Using Just the delivery-address Comp onent . . . . . . . 7-38
Creating a Notication Prole Attributes File . . . . . . . . 7-39
Contents-5

Setting Notication Prole Values Using an Attributes File . . 7-40
Resetting a Notication Prole to the Original Default Values 7-40
Notication Prole Examples by HPDPS Ob ject Type . . . . . 7-41
Spo oler Notication Prole Examples . . . . . . . . . . . 7-41
Logical Printer Notication Prole Examples . . . . . . . . 7-44
Queue Notication Prole Example . . . . . . . . . . . . 7-45
Supervisor Notication Prole Examples . . . . . . . . . . 7-46
Physical Printer Notication Prole Examples . . . . . . . 7-47
Initial-Value-Job Notication Prole Examples . . . . . . . 7-49
Job Notication Prole Example . . . . . . . . . . . . . 7-51
Getting Help for Notication Messages . . . . . . . . . . . 7-52
Summary Tables for the notication-prole Attribute . . . . . 7-53
8. Managing DCE Security for HPDPS
DCE Do cumentation . . . . . . . . . . . . . . . . . . . 8-2
Determining Appropriate DCE Permissions for HPDPS User
Groups . . . . . . . . . . . . . . . . . . . . . . . . 8-3
Deciding Which Groups Your Organization Needs . . . . . . . 8-4
Creating Additional Groups . . . . . . . . . . . . . . . . 8-5
Planning a Printer Operator Group . . . . . . . . . . . . 8-5
Planning a Group for People Who Will Use Restricted Printers 8-7
Restricting Access to a Printer Device . . . . . . . . . . 8-7
Restricting Functions of a Printer Device . . . . . . . . 8-8
Giving Your DCE Groups Permissions to HPDPS Ob jects . . . 8-9
Understanding Where HPDPS Security Information is Stored . 8-10
Understanding How DCE Permissions Propagate Downward . 8-11
Setting the Default Permissions Granted by a Server and All
Its Ob jects . . . . . . . . . . . . . . . . . . . . 8-12
Giving a Group Permission to the Security Directory IO and
IC ACLs . . . . . . . . . . . . . . . . . . . . . 8-15
Removing a Group from the Security Directory IO and IC
ACLs . . . . . . . . . . . . . . . . . . . . . . . 8-17
Setting the Default Permissions Granted by All Physical
Printers in a Supervisor . . . . . . . . . . . . . . . . 8-18
Setting the Permissions Granted by One HPDPS Ob ject . . . 8-19
Examples of Sp ecifying Dierent Kinds of Ob jects . . . . 8-19
Giving a DCE Group Permission to an Individual HPDPS
Ob ject . . . . . . . . . . . . . . . . . . . . . 8-20
Contents-6

Taking Away All Permissions That a Group Has to an
Individual . . . . . . . . . . . . . . . . . . . . . 8-20
Taking Away All Permissions That any other and
unauthenticated Have to an HPDPS Ob ject . . . . . . 8-21
9. Managing the Sp o oler, Logical Printers, and Queues
Monitoring Spo oler, Logical Printer, and Queue Congurations . 9-1
Setting the Message Attribute for Sp o olers and Spo oler Ob jects 9-2
Creating Archive Files for Sp o olers and Spo oler Ob jects . . . 9-3
Querying for Spo oler Information . . . . . . . . . . . . . . 9-4
Querying for the State of a Specic Sp ooler . . . . . . . . 9-4
Spo oler States . . . . . . . . . . . . . . . . . . . . 9-5
Querying for the States of All HPDPS Spo olers . . . . . . . 9-5
Querying for the Verbose Set of Sp o oler Attributes . . . . . 9-6
Querying for Job and Do cumentAttributes Supported by the
Spo oler . . . . . . . . . . . . . . . . . . . . . . . 9-6
Querying for Enabled Logical Printers Contained in the Sp o oler 9-7
Querying for Physical Printers Registered with the Sp o oler . . 9-7
Querying for Logical Printer Information . . . . . . . . . . . 9-8
Querying for the Status of a Logical Printer . . . . . . . . 9-8
Querying for the Verbose Set of Logical Printer Attributes . . 9-9
Querying for Ready Physical Printers Asso ciated with the
Logical Printer . . . . . . . . . . . . . . . . . . . 9-9
Querying for Queue Information . . . . . . . . . . . . . . 9-10
Querying for the Status of a Queue . . . . . . . . . . . . 9-10
Queue States . . . . . . . . . . . . . . . . . . . . . 9-11
Querying for the Verbose Set of Queue Attributes . . . . . . 9-11
Querying for Backlogged Queues . . . . . . . . . . . . . 9-11
Querying for Queue Backlog Boundaries . . . . . . . . . . 9-12
Querying for Enabled Logical Printers Associated with the
Queue . . . . . . . . . . . . . . . . . . . . . . . 9-13
Querying for Ready Physical Printers Asso ciated with the
Queue . . . . . . . . . . . . . . . . . . . . . . . 9-13
Managing Jobs in Queues and Spo olers . . . . . . . . . . . 9-14
Querying for Jobs in the Queue . . . . . . . . . . . . . . 9-15
Querying for Timed-Out and Retained Jobs in the Spo oler . . 9-16
Pausing a Queue . . . . . . . . . . . . . . . . . . . . 9-16
Resuming a Paused Queue . . . . . . . . . . . . . . . . 9-18
Contents-7

Deleting Jobs from Queues and from the Spooler . . . . . . 9-18
Deleting Pending, Paused, or Held Jobs from the Queue . . 9-18
Deleting Jobs from the Queue and Retaining Them in the
Spo oler . . . . . . . . . . . . . . . . . . . . . . 9-19
Deleting Timed-Out or Retained Jobs from the Sp o oler . . 9-19
Deleting Jobs with the p dclean Command . . . . . . . . 9-20
Resubmitting Jobs to Dierent Logical Printers . . . . . . . 9-20
Receiving Messages Related to Pro duction Jobs . . . . . . . 9-22
Disabling Messages Related to Pro duction Jobs . . . . . . . 9-22
Performing Other Spo oler-Related Tasks . . . . . . . . . . . 9-23
About Managing Queue Backlog . . . . . . . . . . . . . 9-23
About the Queue Upper Backlog Boundary . . . . . . . 9-23
About the Queue Lower Backlog Boundary . . . . . . . . 9-24
About the Queue Backlog Update Interval . . . . . . . . 9-24
Responding to Queue Backlog . . . . . . . . . . . . . 9-25
Determining the Cause of the Queue Backlog . . . . . . . 9-27
Managing Job-Related Queue Backlogs . . . . . . . . . 9-27
About Enabling Logical Printers . . . . . . . . . . . . . 9-29
Disabling a Logical Printer . . . . . . . . . . . . . . . 9-30
Disabling All Logical Printers Asso ciated with a Queue . . 9-30
Enabling a Disabled Logical Printer . . . . . . . . . . . 9-31
Mo difying Logical Printer Attributes . . . . . . . . . . . 9-31
Mo difying Initial Value Ob jects . . . . . . . . . . . . . . 9-32
Mo difying the printer-register-threshold Spo oler Attribute . . 9-33
About Server Communications . . . . . . . . . . . . . . 9-34
Deleting Ob jects Contained in Sp oolers . . . . . . . . . . . 9-35
Deleting a Logical Printer . . . . . . . . . . . . . . . . 9-35
Deleting a Queue . . . . . . . . . . . . . . . . . . . . 9-36
Deleting a Queue that Contains Pending Jobs . . . . . . 9-36
Deleting a Queue that Contains Held or Paused Jobs . . . 9-37
Deleting an Initial Value Ob ject . . . . . . . . . . . . . 9-39
Shutting Down and Restarting the Spo oler . . . . . . . . . . 9-40
Shutting Down the Spo oler Immediately . . . . . . . . . . 9-40
Shutting Down the Spo oler after All Jobs Have Printed . . . 9-41
Restarting the Spo oler after It Has Been Shut Down . . . . 9-42
Deleting the Sp ooler . . . . . . . . . . . . . . . . . . . . 9-43
Contents-8

10. Managing Supervisors and Physical Printers
Monitoring Supervisor and Physical Printer Congurations . . . 10-1
Setting the message Attribute for Supervisors and Supervisor
Ob jects . . . . . . . . . . . . . . . . . . . . . . . 10-1
Creating Archive Files for Supervisors and Supervisor Ob jects 10-2
Setting Policy for Job-Size Physical Printer Attributes . . . . 10-3
Using the maximum-copies-supported Attribute . . . . . . 10-4
Controlling the Sizes of Jobs Accepted by the Physical
Printer . . . . . . . . . . . . . . . . . . . . . . 10-5
Determining WhichPhysical Printers Require Authorization . 10-6
Supporting Special Media . . . . . . . . . . . . . . . . 10-6
Sending Media-Related Messages to Operators . . . . . . . 10-7
Querying for Supervisor Information . . . . . . . . . . . . 10-8
Querying for the State of a Specic Supervisor . . . . . . . 10-8
Supervisor States . . . . . . . . . . . . . . . . . . . 10-9
Querying for the States of All HPDPS Supervisors . . . . . 10-9
Querying for the Verbose Set of Sup ervisor Attributes . . . . 10-9
Querying for Ready Physical Printers Contained in the
Supervisor . . . . . . . . . . . . . . . . . . . . . 10-10
Querying for Physical Printer Information . . . . . . . . . . 10-11
Querying for the State of a Physical Printer . . . . . . . . 10-11
Physical Printer States . . . . . . . . . . . . . . . . 10-11
Determining Whether a Physical Printer is Registered . . . . 10-12
Responding to Physical Printer State Problems . . . . . . . . 10-13
Printer needs-key-op erator Problem . . . . . . . . . . . . 10-13
Printer has timed-out Problem . . . . . . . . . . . . . . 10-14
Message-Related Tasks for Physical Printer Management. . . . 10-15
Specifying Who Receives Job Start and End Messages . . . . 10-15
About Controlling Job Start and End Messages . . . . . . . 10-16
Disabling Job Start and End Messages . . . . . . . . . . 10-17
Job-Related Tasks for Physical Printer Management. . . . . . 10-18
Determining Which Jobs Are Scheduled to a Physical Printer . 10-18
Cancelling Pro cessing Jobs . . . . . . . . . . . . . . . . 10-18
Pausing Pro cessing Jobs . . . . . . . . . . . . . . . . . 10-19
About Pausing and Disabling Physical Printers . . . . . . . 10-19
Disabling a Physical Printer . . . . . . . . . . . . . . 10-20
Enabling a Disabled Physical Printer . . . . . . . . . . 10-21
Pausing a Physical Printer . . . . . . . . . . . . . . . 10-21
Contents-9

Resuming a Paused Physical Printer . . . . . . . . . . . 10-21
Performing Routine Physical Printer Tasks . . . . . . . . . . 10-22
Changing the Media in Printers . . . . . . . . . . . . . . 10-22
Performing Preventative Maintenance on the Printer Device . 10-22
Mo difying Supervisor and Physical Printer Tuning Attributes . 10-23
Setting the job-submission-timer Sup ervisor Attribute . . . . 10-23
Setting the printer-register-threshold Physical Printer Attribute 10-24
Setting the printer-timeout-perio d Physical Printer Attribute . 10-25
Deleting a Physical Printer . . . . . . . . . . . . . . . . . 10-26
Shutting Down and Restarting the Supervisor . . . . . . . . 10-27
Shutting Down the Supervisor Immediately . . . . . . . . 10-27
Cancelling Jobs and Shutting Down the Supervisor . . . . . 10-28
Shutting Down the Supervisor when the HPDPS Client is not
Running . . . . . . . . . . . . . . . . . . . . . . 10-28
Restarting the Supervisor After it has been Sh
ut Down . . 10-29
Deleting the Sup ervisor . . . . . . . . . . . . . . . . . . 10-29
11. Managing Jobs and Supp orting Users
Finding and Identifying Jobs . . . . . . . . . . . . . . . . 11-1
Understanding Job Identiers . . . . . . . . . . . . . . 11-3
Understanding the user-name, job-originator, and job-owner
Attributes . . . . . . . . . . . . . . . . . . . . . 11-3
Understanding the job-name Attribute . . . . . . . . . . . 11-4
Finding Jobs Submitted by Other Users . . . . . . . . . . 11-4
Managing Jobs in Queues and Spo olers . . . . . . . . . . . 11-6
Attributes That Control Scheduling, Retaining, and Discarding
Jobs . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Promoting a User Job . . . . . . . . . . . . . . . . . . 11-8
Increasing the Priority of a User Job . . . . . . . . . . . 11-9
Resubmitting Jobs for Users . . . . . . . . . . . . . . . 11-9
Holding a Job . . . . . . . . . . . . . . . . . . . . . 11-10
Releasing a Held Job . . . . . . . . . . . . . . . . . 11-11
Assigning a Retention Period for a Job . . . . . . . . . . 11-11
Determining When Retained Jobs Will Be Discarded . . . 11-12
Assigning a job-discard-time for a Job . . . . . . . . . . . 11-12
Assigning a job-print-after Time for a Job . . . . . . . . . 11-13
About Mo difying Other Job and Do cumentAttributes . . . . 11-13
Setting Up a Logical Printer for High-Priority Jobs . . . . . . 11-15
Contents-10

Setting Up the Job Results Prole . . . . . . . . . . . . . 11-16
Specifying the results-prole Attribute with a Job . . . . . . 11-17
Specifying copy-count and job-copies . . . . . . . . . . 11-18
Changing the Default Order of Do cuments . . . . . . . . 11-18
Specifying Multiple Values for the results-prole Attribute . 11-19
Setting Up a Results Prole with an Initial-Value-Job . . . . 11-19
About Pausing and Cancelling Jobs . . . . . . . . . . . . . 11-20
Determining Job States and Job Status . . . . . . . . . . . 11-21
Querying for the Status of Jobs . . . . . . . . . . . . . . 11-23
Querying for the Brief Set of Job Attributes . . . . . . . 11-23
Querying for the Verbose Set of Job Attributes . . . . . . 11-23
Querying for Specic Job-Status Attributes . . . . . . . 11-24
About Current and Previous Job States . . . . . . . . . . 11-26
Job-State Reasons . . . . . . . . . . . . . . . . . . . 11-28
About Jobs That Cannot Be Scheduled Because of Resources . 11-29
Querying Job Status for Large Jobs . . . . . . . . . . . . 11-30
Querying for the Number of Octets Completed for a
Pro cessing Job . . . . . . . . . . . . . . . . . . 11-31
Querying for the Number of Job Copies Completed for a
Pro cessing Job . . . . . . . . . . . . . . . . . . 11-31
Querying for the Pro cessing Time Required by a Job . . . 11-32
12. Using HPDPS Error Logs
Finding and Viewing a Client Error Log . . . . . . . . . . . 12-1
Changing Server Error Log Attribute Values . . . . . . . . . 12-2
Changing the Attribute Values of a Server Error Log
Temporarily . . . . . . . . . . . . . . . . . . . . . 12-2
Using Conguration Files to Set Attribute Values for Server
Error Logs on Restart . . . . . . . . . . . . . . . . 12-3
Available Values for the log-severityAttribute . . . . . . . 12-4
How HPDPS Backs Up Server Error Logs . . . . . . . . . . 12-5
Error Log Backup After a Server is Shutdown . . . . . . . 12-5
Error Log Backup After a Server is Deleted . . . . . . . . 12-6
Finding and Viewing Server (Sp o oler and Sup ervisor) Error
Logs . . . . . . . . . . . . . . . . . . . . . . . . 12-6
Finding Messages in an Old Error Log . . . . . . . . . . . 12-7
Removing Error Log Backup Files and Directories . . . . . . 12-8
Using the rm Command to Delete an Error Log File . . . . 12-8
Contents-11

Using the rm Command to Delete an Error Log Directory . 12-8
Using the Messages in Error Logs . . . . . . . . . . . . . 12-8
13. Troubleshooting
Getting Full Descriptions for HPDPS Error and Notication
Messages . . . . . . . . . . . . . . . . . . . . . . . 13-1
Problems with Physical Printers . . . . . . . . . . . . . . 13-3
Checking the Physical Printers for a Queue . . . . . . . . . 13-3
The Printer Device is Not Printing . . . . . . . . . . . . 13-5
Physical Printer State is needs-key-op erator . . . . . . . . 13-7
Physical Printer State is Timed-Out . . . . . . . . . . . . 13-8
When Multiple Printers are Listed . . . . . . . . . . . 13-9
When a Single Printer is Listed . . . . . . . . . . . . . 13-10
Cannot Print to an Enabled Physical Printer . . . . . . . . 13-10
Problems with Jobs . . . . . . . . . . . . . . . . . . . . 13-11
Error Message Returns with p dpr Command Instead of
Creating a Job . . . . . . . . . . . . . . . . . . . 13-12
HPDPS Cannot Find or Op en a File or Ob ject Y
our Job
Needs . . . . . . . . . . . . . . . . . . . . . . 13-12
There Is a Problem with the Attributes or Values the User
Specied . . . . . . . . . . . . . . . . . . . . . 13-14
The User Is Not Authorized to Use the Logical Prin
ter . . 13-16
List the DCE Permissions Granted by an HPDPS Ob ject 13-16
List the Members of a DCE Group . . . . . . . . . . 13-17
The Job Is Not Printing . . . . . . . . . . . . . . . . . 13-18
The Job Is Behind Many Others in the Queue . . . . . . 13-19
The Current State Is \Pending" but the Job Is Not Moving
in the Queue . . . . . . . . . . . . . . . . . . . 13-20
The Job's Current State Is \Pro cessing", But There Is No
Printout . . . . . . . . . . . . . . . . . . . . . 13-20
The Job's Current State is Neither Pending Nor Pro cessing 13-21
The Job Could Not Be Scheduled for Printing . . . . . . 13-24
The Printer Resources that the Job Requires Are Not Ready 13-25
Finding the Printers that Support the Job's Attribute
Values . . . . . . . . . . . . . . . . . . . . . 13-26
Mo difying the job-size-range-ready Attribute Value . . . 13-28
Mo difying the media-ready Attribute Value . . . . . . 13-28
Contents-12