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.
Contents 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 .
Page 6
Contents Determining the Status of Your Job ......30 Requesting Status Information When Submitting a Job ..30 Requesting Status Information after Submitting the Job .
Page 7
Contents Time Attribute Values........59 Attribute Values for Range and Dimensions .
Conventions Used in this Manual This manual uses the following typographic conventions: Text that must be entered at the command line exactly User input as shown, such as pdpr -x “page-count=50” File3 Indicates commands or command segments, flags, Computer attributes, files, directories, and other items whose names are predefined by the system, such as pdls and notification-delivery-method.
Page 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.
Page 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.
What Is HP Distributed Print Service? 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.
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.
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.
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.
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.
Page 18
What Is HP Distributed Print Service? HPDPS Terminology Chapter 1...
Basic Printing Tasks 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 •...
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.
-h flag. For example, for information on the pdpr command used to print jobs, enter: pdpr -h You can also use the HP-UX man command to display help information about HPDPS commands. For example: man pdpr The manpages contain examples of all the HPDPS commands.
Page 22
Basic Printing Tasks Getting Help for HPDPS Commands The following HPDPS attribute manpages are available. These list valid attributes for a given object: pd_att(5) pd_att_document(5) pd_att_ivdocument(5) pd_att_ivjob(5) pd_att_job(5) pd_att_log(5) pd_att_log_ptr(5) pd_att_phy_ptr(5) pd_att_queue(5) pd_att_spooler(5) pd_att_supervisor(5) Chapter 2...
Basic Printing Tasks Defining a Default Logical Printer Defining a Default Logical Printer Every job in HPDPS is submitted to a logical printer. If you submit all or most of your jobs to the same logical printer, defining a default logical printer allows you to issue HPDPS printing commands without overtly specifying the logical printer.
When you or your print administrator have configured one or more HPDPS logical printers, you can submit jobs to them: • Using “drag and drop” printing from CDE or HP VUE • By entering commands at the command line, such as pdpr •...
Basic Printing Tasks Specifying Attributes for HPDPS Print Jobs Specifying Attributes for HPDPS Print Jobs Quite often, the characteristics, or attributes, of print jobs differ from job to job. You may have a particularly large job that requires printing on two sides.
Basic Printing Tasks Specifying Attributes for HPDPS Print Jobs Some attributes have additional flags that can be used to substitute for the attribute name. For example, to print three copies of File1 you can also use -n CopyCount flag and its value: pdpr -n 3 File1 Refer to Chapter 3, “Command Reference”...
Basic Printing Tasks Specifying Attributes for HPDPS Print Jobs you do not specify the content-orientation attribute, HPDPS prints your job in portrait orientation. To submit the file File1 to the default logical printer and specify landscape orientation, enter: pdpr -x "content-orientation=landscape" File1 Specifying the Document Format for a Job Use -x document-format=Format with the pdpr command to specify the document format of your job.
In the example above, the components are separated by colons. See “Complex Attributes Using Colons” in Chapter 3 for rules on colon syntax. See HP Distributed Print Service Administration Guide or the manpage pd_att_job(5) for details on results-profile. Using a Reference File You can use a reference file that contains a list of the documents you...
Basic Printing Tasks Specifying Attributes for HPDPS Print Jobs pdpr -x “document-type=file-reference” myref submits the reference file, myref, and prints each document listed within it. Each document within myref must be on a separate line. Specifying a Medium for a Job To specify a particular medium to print, you can specify a value for input-tray-select, such as top or middle.
Basic Printing Tasks Determining the Status of Your Job Determining the Status of Your Job You can request status information about your job when you submit the job or after you submit the job. Requesting Status Information When Submitting a Job Use the optional -r flag with the pdpr command to have HPDPS display status information about your job when it is accepted.
Basic Printing Tasks Determining the Status of Your Job Shows the status of your job. The Current State information in this example shows that the job is pending (in the queue). Shows the name of the logical printer Printer Requested to which the job has been submitted.
Page 32
Basic Printing Tasks Determining the Status of Your Job NOTE Your administrator may have set up your system with multiple logical printers sending jobs to the same queue. If you have submitted jobs to more than one of the logical printers supporting the same queue, HPDPS displays status information for all of your jobs in the queue (as shown in the preceding example) regardless of which logical printer the job was submitted to.
Basic Printing Tasks Determining Which Printer Device Printed the Job Determining Which Printer Device Printed the Job When you submit a job to a logical printer, any of the logical printer's associated physical printers that support all of the job and document attributes may print the job.
Basic Printing Tasks Deleting HPDPS Print Jobs Deleting HPDPS Print Jobs Use the pdrm command to delete a job you have submitted. You identify the job that you want to delete by its local job identifier. To obtain your local job identifier when you submit a job, type: pdpr -r brief FileName To delete the job whose local job identifier is 15, enter: pdrm 15...
Command Reference Command Reference HP Distributed Print Service enables you to send a file to print on a physical printer device. HPDPS performs the management and printing of documents by means of objects, such as a printers, jobs, or print queues.
Command Reference HPDPS Object Classes vs. Objects HPDPS Object Classes vs. Objects Objects have associated attributes that provide information about them. Objects are grouped into classes. An object class contains objects that share a common definition and common properties, operations, and behavior.
Command Reference HPDPS Object Classes vs. Objects Object Class Name Purpose Manages a collection of jobs that are waiting to be queue printed. A print queue receives jobs from one or more logical printers and schedules and sends the jobs to physical printers.
You may need to be authorized to use HPDPS commands. For more information on authorization, see “Authorization” in this chapter as well as the HP Distributed Print Service Administration Guide. For a complete description of each HPDPS command, see the appropriate NOTE manpage.
Page 39
Command Reference HPDPS Commands Command Description Queries the status of one or more jobs in a queue. Resubmits a previously submitted job (that is pending, timed-out, pdresubmit retained, or held) to a specified logical printer on the same or different spooler. Cancels (removes) one or more previously submitted print jobs.
Page 40
Command Reference HPDPS Commands Command Description Used to start the HPDPS client daemon. pdstartclient Used to create or restart an HPDPS spooler. pdstartspl Used to create or restart an HPDPS supervisor. pdstartsuv Used to stop the HPDPS client daemon. pdstopd Chapter 3...
Command Reference Command Syntax Command Syntax You can enter HPDPS commands using an attribute value pair, a command-attribute or an object-attribute and its value, with the -x flag, other command flags, or a combination of the two. More information on each of these options follows.
Command Reference Command Syntax Using Command Flags Command flags either substitute for command- or object-attributes or modify the way a command is processed. For example, the -c command flag can be used instead of the class command-attribute. Many flags have values associated with them. See Appendix A, “Command Summary,”...
Page 43
Command Reference Command Syntax Table 3-4 Command Flags Flag Value Purpose Defines the object class that the document command is to operate on. initial-value-document Equivalent to specifying the command-attribute class. initial-value-job printer queue server “FileName” With pdpr, optionally specifies the name of the file you want to print.
Page 44
Command Reference Command Syntax Flag Value Purpose With pdls, displays job attributes. With pdpause, pauses the currently printing job on a specified physical printer. Create a symbolic link from the spool area to the data files rather than copying them. "MessageText"...
Page 45
Command Reference Command Syntax Flag Value Purpose Specifies the group of attributes that you want displayed for a archive specified object class. Equivalent to specifying the brief command-attribute none requested-attributes. If you specify more than one verbose attribute for the -r flag, “AttributesList"...
Command Reference Command Syntax Flag Value Purpose Specifies when you want the after-current server to be shut down. after-all Equivalent to specifying the command-attribute when. "AttributeValuePairs" Applies one or more attributes and their values on the command line. If there are any spaces within the attribute value or between the attribute value pairs, the string must be...
Command Reference Command Syntax • The first -r flag from Table 3-4 can accept multiple values for the "AttributesList" and for another value (e.g. brief) shown for the flag. You use a comma-delineated listing with the -r flag to achieve an additive AttributesList, meaning all values are used.
Command Reference Command Syntax The end result is that the only value returned is the value for physical-printers-ready. • To request all three values shown in the previous example to be used additively, employ the += operator within the -x attribute value pair: pdls -c server \ -r logical-printers-supported,queues-supported \ -x "requested-attributes+=physical-printers-ready"...
Page 49
Command Reference Command Syntax Table 3-5 Command-Attributes Attribute Value Purpose AttributesFileName To read in command and attributes object attributes from a file. When this attribute is encountered, the designated attributes file is read and the contents are inserted at the current point in the command.
Page 50
Command Reference Command Syntax Attribute Value Purpose To specify the method notification-delivery- email that you or another method message person is to be notified of given events related to none the object. PrinterName To specify a logical printer-name-requested printer as the target of a print request.
Command Reference Command Syntax Otherwise, any pre-existing values for the command-attribute are no longer available. • If multiple values are specified for the command attribute class and the object class of the command argument does not agree with the last value specified, the command is rejected. Object-Attributes The manpages contain a list of attributes for each object.
Page 52
Command Reference Command Syntax Table 3-6 Frequently Used Object-Attributes Attribute Value Purpose CopyCount An integer used to specify the copy-count number of copies that are to be printed. A value of 0 is not valid. Format Specifies the format of the document-format document, as for example, postscript or ascii.
Command Reference Command Syntax • If you specify more than one value for a single-value attribute in one command using either the -x flag or an attributes file specified by the -X flag, or a combination, the last value specified for the attribute is the one assigned.
Command Reference Command Syntax The server name is optional for: • Commands using local job IDs as the argument. • Commands using the printer name or the queue name; these names must be unique within the namespace. An exception to this is the pdcreate command where the server name is always required.
Command Reference Command Syntax Setting Attributes When an Object is Created A specifiable attribute can be set only when you create the object.You can specify an attribute with the pdcreate or the pdpr command. The pdpr command creates a job object. NOTE For example, the following command creates a logical printer called LogPrt1 in the server (spooler) called SPOOL1, setting the logical printer...
Command Reference Command Syntax There are likewise other attributes such as total-job-octets, current-job-state, or job-copies-completed that are determined and set by HPDPS. Default Values for Attributes For some attributes, the default value is "no value". • When you create an object, HPDPS assigns a default value (or values, for some multi-value attributes) to each attribute.
Command Reference Command Syntax NOTE If you specify more than one value for a single-value attribute in one command using either the -x flag or an attribute file specified by the -X flag, or a combination, only the last value specified for the attribute is assigned.
Command Reference Command Syntax pdset -c queue \ -x "notification-profile= \ {event-identifiers=job-modified queue-state-changed \ delivery-method=email \ event-comment="This is a job modification or status event" \ delivery-address=dave@cowboy locale=C}" SPOOL1:QUEUE1 If you change one component within the notification profile, the rest of the components will be set to their default values.
An example of setting the results-profile attribute for a job are: pdset -c job -x \ "results-profile=‘pickup:Please staple:dave@cowboy:2:’" 2 See the HP Distributed Print Service Administration Guide for information on the results-profile attribute. Time Attribute Values For time attribute values, use the local time format as defined in the LC_TIME environment variable.
Command Reference Command Syntax This format specifies hours and minutes; hours are optional. If hours are used, separate the two values with a colon, with no spaces. This example shows a time interval of 1 hour and 15 minutes: pdset -c printer -x "printer-register-threshold=1:15" PhysPrt4 This can also be expressed as: pdset -c printer -x "printer-register-threshold=75"...
Command Reference Command Syntax Specifies the attributes for which values are to be returned. This flag is equivalent to using the command-attribute requested-attributes. Refer to “Values for requested-attributes” in the next section for a description of the use of this command-attribute and flag.
Page 62
Command Reference Command Syntax The attribute values for requested-attributes are listed here along with the commands involved: Values Available on… the pdls and pdq commands. the pdls and pdq commands, only displaying the archive specifiable and settable attributes. Refer to “Setting Object-Attributes”...
Command Reference Command Syntax Object Attributes Queue Brief: associated-server queue-name queue-state scheduler-ready Verbose: logical-printer-assigned physical-printer-assigned Server Brief: server-name server-state server-type Verbose: logical-printers-supported (spooler) physical-printers-supported queues-supported Formatting the Display of Attribute Values Use the headings and style command-attributes to format the display of requested-attributes.
Command Reference Command Syntax Specifying headings=true or using the default, causes the following depending on the style selected, as described in the next section: The output is displayed with column headings. column The object name precedes the attribute name. line See “Style”...
Page 69
Command Reference Command Syntax This will display the requested attributes, with headings, for all of the logical printers in the server (spooler) SPOOL2. Here "headings" means that each attribute name is preceded by the object name. The output looks like: LogPrt1: maximum-copies-supported LogPrt1: printer-name = LogPrt1...
Command Reference Command Syntax Using Initial Value Objects (IVOs) to Specify Attribute Values An initial value object (IVO) represents a collection of default values for job or document attributes. There are two types of initial value objects: initial-value-document Specifies values for document attributes.
Command Reference Using an Attributes File Using an Attributes File You may want to pre-define specific attribute value pairs in permanent files and access them when you need those specific values within a command. When creating a file containing attribute and value pairings, you may want to use space between the end of each attribute name and the equal sign so the equal signs and values are aligned.
Page 73
Command Reference Using an Attributes File Both of the previous examples referenced the following sample attributes file: # Physical Printer Attributes File # AttrFilePP1 document-formats-supported =ascii pcl maximum-copies-supported document-types-supported =printable printer-memory This attributes file is equivalent to the following command: pdset -c printer -x "document-formats-supported=ascii pcl \ maximum-copies-supported=3 document-types-supported=printable \ printer-memory=32"...
Command Reference Job and Document Identifiers Job and Document Identifiers Many commands accept job identifiers as input. Job identifiers (LocalJobID and GlobalJobID) are specific arguments for some commands. Local IDs are generated for each user, on each host, for each job.
Another person cannot change the condition of your jobs unless that person has the proper authorization to do so. See HP Distributed Print Service Administration Guide for information on security and how authorization is set and controlled.
Table 3-8, “Environment Variables,” describes the environment variables that affect how HPDPS commands are processed. For more detailed information on those environment variables used primarily by the administrator, see the HP Distributed Print Service Administration Guide. Table 3-8 Environment Variables...
Page 77
Command Reference Environment Variables Variable Description Defines the maximum amount of memory (in kilobytes) the PD_MEMLIMIT spooler or supervisor can use on the host system. The value for the socket number provided by your HPDPS PD_SOCKET administrator. The socket number you specify should be for a HPDPS client and compatible with the value you specify for your LANG environment variable.
Page 78
Command Reference Environment Variables Variable Description The name of the locale to use for local categories when neither LANG LC_ALL nor the corresponding environment variable beginning with LC_ specifies a locale. Used to determine the language, territory, or character set of messages and other information that are sent to a person.
Command Reference Additional Tips Additional Tips The following tips can make your use of commands easier. Global Character (Wildcard) Support You can use the global asterisk character (*) to facilitate broadcasting commands to all servers. For example, STU*: sends the command to all servers whose names begin with the letters STU.
Command Summary Command Summary This appendix presents HPDPS commands alphabetically and the flags, command-attributes, and arguments that each command supports. Default values are shown in bold. See Table 3-2, “HPDPS User Commands,” and Table 3-3, “HPDPS Administrator Commands,” in Chapter 3 for a description of each command. Appendix A...
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Spooler Commands Table B-1 HPDPS Command, Flag and Com- LP Flag Action Value mand HPDPS default behavior for the Makes a copy pdpr command. of the file to be printed.
Page 103
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands HPDPS Command, Flag and Com- LP Flag Action Value mand Specifies a -ttitle pdpr -x job-name=JobName" " value for the job-name attribute, when sent to an HPDPS logical printer. Notifies pdpr -x job-originator notification-profile=...
Page 104
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands HPDPS Command, Flag and Com- LP Flag Action Value mand Lists lpstat pdls -U -c printer -f acceptance printer-realization== " state of all logical -r enabled " printers. Lists lpstat -aPrinterName pdls -U -c printer -f acceptance...
Page 105
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands HPDPS Command, Flag and Com- LP Flag Action Value mand Lists status of lpstat -uUserName1, pdls -U -c job -f UserName2, ... print jobs for job-owner==UserName1 || " each UserName job-owner==UserName2 || …"...
Page 106
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands HPDPS Command, Flag and Com- LP Flag Action Value mand Lists status of lpstat -pPrinterName pdls -U -c printer -f PrinterName. printer-name== " PrinterName && printer-realization== logical" -r printer-name printer-ready enabled No equivalent HPDPS command.
Page 107
Index Symbols syntax document-format command flags specifying .login command-attributes document-format object- .profile default values attribute description of documents commands printing in a single job abbreviations description of arguments duplex for attributes and values summary of definitions and specifying arguments user type description complex attribute attribute manpages...
Page 108
Index global ID list of attributes lp command printing multiple documents translated to HPDPS commands specifying attributes LP spooler -h flag specifying copy count commands translated to headings command-attribute specifying document format HPDPS commands specifying commands help specifying duplex lpadmin command for HPDPS commands specifying orientation value translated to HPDPS...
Page 109
Index number-up attribute description description summary of summary of pdcreate command pdresubmit command description description object summary of summary of object classes pddcesetup command pdresume command object-attributes description description default values pddelete command summary of description of description pdrm command setting summary of description...
Page 110
Index to a specific logical printer style command-attribute style of output submitting jobs queue supervisor purpose purpose queues supervisors list of attributes syntax quotation marks commands for attribute values notation -r flag range of values range and dimensions requested-attributes redirecting data using abbreviations reference file requested-attributes...