HP Distributed Print Service User’s Guide HP 9000 Computers B2355-90156 E1097 Printed in: U.S.A. © Copyright 1997, Hewlett-Packard Company.
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.
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.
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 . ........................................... 14 You Can Access Many Kinds of Printers . . . . . . . . . . . . . . . . . . . . . . . .14 Your Print Jobs Are Validated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14 You Receive Notification of Job Progress or Problems . . . . . . . . . . . .
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 . . . . . . . . . . . .
Contents 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. . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 8
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.
• 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.
• 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.
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.
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.
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.
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.
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.
What Is HP Distributed Print Service? HPDPS Terminology 18 Chapter 1
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”.
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.
Basic Printing Tasks Getting Help for HPDPS Commands Getting Help for HPDPS Commands For quick help about an HPDPS command and its flags, enter a command followed by the -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.
Basic Printing Tasks Getting Help for HPDPS Commands The following HPDPS attribute manpages are available.
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. You specify the default logical printer using the environment variable PDPRINTER in your .profile or .login file.
Basic Printing Tasks Submitting Jobs to an HPDPS Printer Submitting Jobs to an HPDPS 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 • From an application Printing to a Default Logical Printer To submit a job, you can use the pdpr command.
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. You may have other jobs that require rotation of the printing orientation or multiple copies. You may also have jobs that require a combination of these things.
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” for a complete description of all flags and more information on attribute value pairs. NOTE The default attribute values described in the following tasks are the values provided with HPDPS.
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.
Basic Printing Tasks Specifying Attributes for HPDPS Print Jobs Using the pdpr Command To print multiple documents in one job, list each of the document file names as arguments of the pdpr command. All document files in the job must have the same attributes or HPDPS will reject the job. For example, they must have the same data format such as ASCII or PostScript. Specify any document attributes, such as sides=2 or number-up=4 before the list of file names.
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. This flag value returns a listing of key job attributes and their values.
Basic Printing Tasks Determining the Status of Your Job Current State Shows the status of your job. The information in this example shows that the job is pending (in the queue). Printer Requested Shows the name of the logical printer to which the job has been submitted. Requesting Status Information after Submitting the Job To display status information about your job after you have submitted it, enter the pdq command and identify the logical printer to which you submitted your job.
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. When the printer finishes printing your job, HPDPS can send you a notification message and display the name of the physical printer on which your job was printed.
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 NOTE If the job you want to delete is currently printing, you may not be able to delete it.
Command Reference 3 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. HPDPS commands act on these objects. Both the commands and the objects are influenced by the attributes they possess. This chapter explains how to construct syntactically correct HPDPS commands.
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. The object classes printer and server are sub-divided as shown in Table 3-1; however, only the basic class can be used in a command.
Command Reference HPDPS Object Classes vs. Objects Object Class Name Purpose queue Manages a collection of jobs that are waiting to be printed. A print queue receives jobs from one or more logical printers and schedules and sends the jobs to physical printers. server (spooler) Represents the server that manages the validation, routing, notification, logging, and scheduling of jobs.
Command Reference HPDPS Commands HPDPS Commands The HPDPS commands create, modify, and delete objects, and may also return status and other information about the objects. Additionally, there are commands that serve as utilities. As a general guideline, commands can be sub-divided into those primarily for users and those primarily for administrators. Administrator capability is required to run the administrator commands.
Command Reference HPDPS Commands Command Description pdq Queries the status of one or more jobs in a queue. pdresubmit Resubmits a previously submitted job (that is pending, timed-out, retained, or held) to a specified logical printer on the same or different spooler. pdrm Cancels (removes) one or more previously submitted print jobs. Table 3-3 HPDPS Administrator Commands Command Description pdclean Removes all jobs from the specified server, printer, or queue.
Command Reference HPDPS Commands Command Description pdstartclient Used to start the HPDPS client daemon. pdstartspl Used to create or restart an HPDPS spooler. pdstartsuv Used to create or restart an HPDPS supervisor. pdstopd Used to stop the HPDPS client daemon.
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. Using the -x Flag with Attribute Value Pairs Both object-attributes and command-attributes have values and can be entered using the -x flag. Command-attributes modify the action of commands.
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,” or the manpages for each command to determine which flags as well as which values are supported by that command.
Command Reference Command Syntax Table 3-4 Command Flags Flag -c Value document initial-value-document initial-value-job Purpose Defines the object class that the command is to operate on. Equivalent to specifying the command-attribute class. job log printer queue server -f “FileName” With pdpr, optionally specifies the name of the file you want to print. Useful for identifying files whose name begins with a “-” character.
Command Reference Command Syntax Flag Value Purpose -j With pdls, displays job attributes. With pdpause, pauses the currently printing job on a specified physical printer. -l Create a symbolic link from the spool area to the data files rather than copying them. -m "MessageText" This flag and its value (a text string) are used to specify a message that is associated with the object being acted on. Enclose the message in quotes. Equivalent to specifying the command-attribute message.
Command Reference Command Syntax Flag -r Value all archive brief none verbose “AttributesList" Purpose Specifies the group of attributes that you want displayed for a specified object class. Equivalent to specifying the command-attribute requested-attributes. If you specify more than one attribute for the -r flag, surround the attributes with double quotes or use commas with no space between them.
Command Reference Command Syntax Flag -w Value after-current after-all now Purpose Specifies when you want the server to be shut down. Equivalent to specifying the command-attribute when. -x "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 enclosed in quotes. -X AttributesFileName Reads in command and objectattributes from a file.
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. • Using both the -r flag with multiple values and the commandattribute requested-attributes in the same command may result in a loss of additivity.
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" \ SPOOL2 Command-Attributes Table 3-5, “Command-Attributes,” shows the various commandattributes and the purpose of each.
Command Reference Command Syntax Table 3-5 Command-Attributes Attribute Value Purpose attributes AttributesFileName To read in command and 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. class document To define the object class that the command is to operate on.
Command Reference Command Syntax Attribute Value notification-deliverymethod email message none Purpose To specify the method that you or another person is to be notified of given events related to the object. printer-name-requested PrinterName To specify a logical printer as the target of a print request. requested-attributes all To specify the group of attributes that you want displayed for a specified object class.
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.
Command Reference Command Syntax Table 3-6 Frequently Used Object-Attributes Attribute Value Purpose copy-count CopyCount An integer used to specify the number of copies that are to be printed. A value of 0 is not valid. document-format Format Specifies the format of the document, as for example, postscript or ascii. job-hold true Specifies whether you want to put the job in hold state. false job-name JobName Specifies a new name for a given job.
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. • When an object is created and its attribute values are not specified using the -x flag or -X flag, some of the attribute values may be set to server defaults.
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. The server name is required for: • Commands specifying an object class that resides in a supervisor, such as log. • Object names within a spooler that are not unique within a namespace. • The pdcreate command.
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. NOTE The pdpr command creates a job object.
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. You can override these default values by specifying a different value using the -x and X flags.
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.
Command Reference Command Syntax The rules for using a colon are as follows: • Do not enter the component name. • Separate the value for each component with a colon (:) and no spaces. • Separate each attribute value with spaces. • Enter a colon (:) even if you are not going to enter a value for a given component. The default value or no value will be set for that component. • If the last value is to be set to the default value, the colon (:) for that component is not required.
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.
Command Reference Command Syntax -r 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. -s Specifies the style or format in which the attribute values are to be displayed. This flag is equivalent to using the command-attribute style.
Command Reference Command Syntax The attribute values for requested-attributes are listed here along with the commands involved: Values Available on… all the pdls and pdq commands. archive the pdls and pdq commands, only displaying the specifiable and settable attributes. Refer to “Setting Object-Attributes” earlier for more information. brief the pdcreate, pdls, pdmod, pdpr, pdq, and pdset commands. "AttributesList" the pdls and pdq commands.
Command Reference Command Syntax Table 3-7 HPDPS Object-Attributes Object Document Attributes Brief: document-file-name document-format document-sequence-number Verbose: copy-count document-type octet-count sides Initial-Value-Document Brief: associated-server copy-count document-format initial-value-document-identifier logical-printers-ready sides Note: No Verbose attributes.
Command Reference Command Syntax Object Initial-Value-Job Attributes Brief: associated-server initial-value-job-identifier logical-printers-ready printer-locations-requested printer-models-requested Verbose: job-retention-period 64 Chapter 3
Command Reference Command Syntax Object Job Attributes Brief: current-job-state intervening-jobs (See Note 1) job-client-id (local ID) job-identifier (global ID) job-name printers-assigned (See Note 2) printer-name-requested (See Note 3) Verbose: job-owner job-state-reasons total-job-octets (See Note 4) Notes: 1. Only returned on the pdls and pdq commands. 2. Physical printer name to which the job has been assigned (if such a scheduling decision has been made). 3.
Command Reference Command Syntax Object Log Attributes Brief: associated-server enabled log-identifier log-type Verbose: log-size log-wrap Printer Brief: associated-queue availability enabled printer-name printer-realization printer-state Verbose: associated-server printer-associated-printers (logical printers) printer-locations scheduler-ready 66 Chapter 3
Command Reference Command Syntax Object Queue Attributes 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. Headings .
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: column The output is displayed with column headings. line The object name precedes the attribute name. See “Style” below for examples of displayed output with and without headings. Style . The style command-attribute or the -s flag is used to specify the format of presentation for attribute values returned by the server.
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.
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. initial-value-job Specifies values for job attributes. IVOs are contained in the spooler and can be used in two ways: 1.
Command Reference Command Syntax 3.
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. (See the sample attribute file in the section below.) This makes your files easier to read and maintain.
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 =3 document-types-supported =printable printer-memory =32 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" PhysPrt2 • Com
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. A job can be referenced by either a local ID or global ID number: • A local ID is represented as a single integer generated by the client.
Command Reference Authorization Authorization The administrator configures each HPDPS host to run in one of two environments: the Basic Environment or the DCE Extended Environment. The Basic Environment is used when your host is not a member of a Distributed Computing Environment (DCE) cell. In the Basic Environment, only the root login may create, modify, or delete HPDPS objects; all other logins are not authorized to perform these operations.
Command Reference Environment Variables Environment Variables To set environment variables, edit the file that contains them. See “Defining a Default Logical Printer” in Chapter 2 for instructions on modifying your .profile file (if you are using the POSIX or Korn shell) or your .login file (if you are using the C shell). Table 3-8, “Environment Variables,” describes the environment variables that affect how HPDPS commands are processed.
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. PD_SOCKET The value for the socket number provided by your HPDPS administrator. The socket number you specify should be for a HPDPS client and compatible with the value you specify for your LANG environment variable. PD_MAXRETRIES Specifies the number of times a command will retry when it can’t reach the client daemon.
Command Reference Environment Variables Variable Description LANG The name of the locale to use for local categories when neither 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. Follow the shell-specific rules pertaining to the shell you are using. Some shells may intercept and interpret the asterisk before HPDPS has a chance to operate on it.
Command Reference Additional Tips 80 Chapter 3
Command Summary A 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.
Command Summary HPDPS Commands HPDPS Commands Table A-1 Command Summary Command pdclean Flags, Attributes, and Arguments Flags: -c {printer | queue | server} -h -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer | queue | server} message="MessageText" Arguments: [ServerName:]PrinterName [ServerName:]QueueName ServerName 82 Appendix A
Command Summary HPDPS Commands Command pdcreate Flags, Attributes, and Arguments Flags: -c {printer | queue| initial-value-job | initial-value-document} -g -h -m "MessageText" -r {none, brief, verbose} -s column | line -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer | queue | initial-value-job | initial-value-document } force={true | false} headings={true |false} message="MessageText" requested-attributes={none, brief, verbose} style={column
Command Summary HPDPS Commands Command pddelete Flags, Attributes, and Arguments Flags: -c {printer | job |queue | initial-value-job | initial-value-document | server} -h -m "MessageText" -r JobRetentionPeriod -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer |job | queue | initial-value-job | initial-value-document | server} message="MessageText" Object-Attributes: job-retention-period=JobRetentionPeriod Arguments: LocalJobID GlobalJobID Se
Command Summary HPDPS Commands Command pddisable Flags, Attributes, and Arguments Flags: -c {printer |log|queue | server} -h -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer |log| queue | server} message="MessageText" Arguments: ServerName:LogName [ServerName:]PrinterName [ServerName:]QueueName ServerName Appendix A 85
Command Summary HPDPS Commands Command pdenable Flags, Attributes, and Arguments Flags: -c {printer | log | queue |server} -h -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer | log | queue |server} message="MessageText" Arguments: ServerName:LogName [ServerName:]PrinterName [ServerName:]QueueName ServerName pdgwcfg Flags: -{a | -m}} -h -p -v 86 Appendix A
Command Summary HPDPS Commands Command pdls Flags, Attributes, and Arguments Flags: -c {job | queue | log | printer |initial-value-job | initial-value-document | document |server} -f "FilterCriteria" -F -g -h -j -r {brief, all, verbose, archive, "AttributesList" | none} -s {column | line} column for -r brief and -r verbose, line for -r all, -r "AttributesList" and -r archive -U -x "AttributeValuePairs" -X AttributesFileName Appendix A 87
Command Summary HPDPS Commands Command pdls (cont.
Command Summary HPDPS Commands Command pdmod Flags, Attributes, and Arguments Flags: -g -h -m "MessageText" -n CopyCount -r {none, brief, verbose} -s {column | line} -t JobName -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName headings={true | false} message="MessageText" requested-attributes={none, verbose, brief} style={column | line} Object-Attributes: copy-count=CopyCount job-hold={true | false} job-name=JobName Arguments: LocalJobID GlobalJobID Appen
Command Summary HPDPS Commands Command pdpause Flags, Attributes, and Arguments Flags: -c {printer | queue | job |server} -h -j -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes attributes=AttributesFileName class={printer | job | queue | server} message="MessageText" Arguments: [ServerName:]PrinterName [ServerName:]QueueName ServerName 90 Appendix A
Command Summary HPDPS Commands Command pdpr Flags, Attributes, and Arguments Flags: -f FileName -g -h -l -n{1 | CopyCount} -N {email | message | none} -p PrinterName -r {none, brief, verbose} -s {column | line} -t JobName -x "AttributeValuePairs" -X AttributesFileName Appendix A 91
Command Summary HPDPS Commands Command pdpr (cont.
Command Summary HPDPS Commands Command pdpromote Flags, Attributes, and Arguments Flags: -h -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName message="MessageText" Arguments: LocalJobID GlobalJobID Appendix A 93
Command Summary HPDPS Commands Command pdq Flags, Attributes, and Arguments Flags: -f "FilterCriteria" -F -g -h -j -p PrinterName -r {brief, none, verbose, "AttributesList" | all} -s {column | line} -U -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName filter="FilterCriteria" headings={true | false} printer-name-requested=PrinterName requested-attributes={brief, all, none, verbose, "AttributesList"} style={column | line} Arguments: [LocalJobID[.DocNumber.
Command Summary HPDPS Commands Command pdresubmit Flags, Attributes, and Arguments Flags: -c {job | queue | printer} -g -h -r {none| brief, verbose} -s {column | line} -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={job | queue | printer} headings={true | false} requested-attributes={none, brief, verbose} style={column | line} Arguments: [ServerName:]TargetPrinterName LocalJobID GlobalJobID [ServerName:]PrinterName [ServerName:]QueueName Appendix
Command Summary HPDPS Commands Command pdresume Flags, Attributes, and Arguments Flags: -c {printer | queue | job | server} -h -m "MessageText" -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName class={printer | queue | job | server} message="MessageText" Arguments: LocalJobID GlobalJobID [ServerName:]PrinterName [ServerName:]QueueName ServerName 96 Appendix A
Command Summary HPDPS Commands Command pdrm Flags, Attributes, and Arguments Flags: -h -m "MessageText" -r JobRetentionPeriod -x "AttributeValuePairs" -X AttributesFileName Command-Attributes: attributes=AttributesFileName message="MessageText" Object-Attributes: job-retention-period=JobRetentionPeriod Arguments: LocalJobID GlobalJobID Appendix A 97
Command Summary HPDPS Commands Command pdset Flags, Attributes, and Arguments Flags: -c {printer | job | server | queue | document | initial-value-job | initial-value-document | log } -g -h -m "MessageText" -r {none, brief,verbose} -s {column | line} -x "AttributeValuePairs" -X AttributesFileName 98 Appendix A
Command Summary HPDPS Commands Command pdset (cont.
Command Summary HPDPS Commands Command pdshutdown Flags, Attributes, and Arguments Flags: -c server -h -m "MessageText" -w {after-current | now | after-all} -x "AttributeValuePairs" -X AttributesFileName Command Attributes: attributes=AttributesFileName class=server message="MessageText" when={after-current | now | after-all} Argument: ServerName 100 Appendix A
LP Spooler Commands Translated to HPDPS Commands B LP Spooler Commands Translated to HPDPS Commands Appendix B 101
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Spooler Commands Table B-1 LP Command LP Flag HPDPS Command, Flag and Value Action lp -c HPDPS default behavior for the pdpr command. Makes a copy of the file to be printed. Allows the user to change the file before the job has printed without affecting the printed output. lp -ddest pdpr -p PrinterName Submits the job to the specified print queue or HPDPS logical printer.
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Command LP Flag HPDPS Command, Flag and Value Action lp -ttitle pdpr -x "job-name=JobName" Specifies a value for the job-name attribute, when sent to an HPDPS logical printer. lp -w pdpr -x "notification-profile= {event-identifiers= job-complete delivery-method=email}" Notifies job-originator when a job has printed. lp -s HPDPS default behavior for the pdpr command. Suppresses messages.
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Command LP Flag lpstat -a lpstat -aPrinterName HPDPS Command, Flag and Value Action pdls -U -c printer -f "printer-realization== logical" -r enabled \*: Lists acceptance state of all printers. pdls -U -c printer -f Lists acceptance state of PrinterName. "printer-realization== logical && printer-name== PrinterName" -r enabled \*: lpstat -aPrinterName1, PrinterName2, ...
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Command LP Flag HPDPS Command, Flag and Value Action lpstat -uUserName1, UserName2, ... pdls -U -c job -f "job-owner==UserName1 || job-owner==UserName2 || …" -r job-client-id job-owner job-priority submission-time job-name total-job-octets” \* Lists status of print jobs for each UserName in list of users.
LP Spooler Commands Translated to HPDPS Commands LP Spooler Commands LP Command LP Flag lpstat -pPrinterName pdls -U -c printer -f "printer-name== PrinterName && printer-realization== logical" -r printer-name printer-ready enabled \*: Lists status of PrinterName. lpadmin -dPrinterName No equivalent HPDPS command. Sets up a logical printer as the default printer. cancel RequestId pdrm GlobalJobID Cancels the job specified by the RequestId.
Index Symbols .login, 23 .
Index global ID, 74 H -h flag, 21, 43 headings command-attribute, 43, 49, 67 help for HPDPS commands, 21 I images specifying number for a page, 27 initial value objects (IVOs) to specify attribute values, 70 initial-value-document defined, 70 list of attributes, 63 purpose, 36 initial-value-job defined, 70 list of attributes, 63 purpose, 36 input-tray-select, 29 J -j flag, 44 job purpose, 36 job identifiers, 74 job-client-id list of attributes, 63 job-copies, 28 job-hold object-attribute, 52 job-name objec
Index number-up attribute, 27 O object, 17 object classes, 36 object-attributes, 41, 42 default values, 56 description of, 51 setting, 54 objects naming restrictions, 37 purposes, 36 options specifying for jobs, 25 orientation value specifying, 26 output-bin, 28 P -p flag, 44 page orientation specifying, 26 page-count, 29 pages specifying number, 29 paper specifying type, 29 PD_CONFIRM_DELETE description, 76 PD_MAXRETRIES description, 77 PD_MAXTHREADS description, 77 PD_MEMLIMIT description, 77 PD_RETRY_IN
Index to a specific logical printer, 24 Q queue purpose, 36 queues, 17 list of attributes, 63 quotation marks, 25 R -r flag, 30, 44 range and dimensions, 60 redirecting data, 79 reference file, 28 requested-attributes, 61 formatting, 67 syntax, 61 requested-attributes commandattribute, 45, 47, 49 requesting attribute values, 60 results-profile, 58 results-profile attribute, 28 results-set-comment, 28 S -s flag, 44 server name when to specify, 53 servers, 17 list of attributes, 63 settable attributes, 54 se
