.\" $Header:
.TA p
.TH pd_att_job 5
.SH NAME
pd_att_job \- list of attributes for an HPDPS job object
.SH DESCRIPTION
The following is a list of valid attributes and values for the job object
class of the HP Distributed Print Service.
.SS Attributes for a Job Object         
.cs 1 22
.lg 0
.nf
|------------------------------------------------------------------------|
| Settable Attribute Listing         | Specifiable Attribute Listing     |
|------------------------------------|-----------------------------------|
|     interface-program-method       |     initial-value-job             | 
|     job-comment                    |     job-client-id                 |
|     job-discard-time               |     job-originator                |
|     job-end-message                |     job-owner                     |
|     job-hold                       |     printer-name-requested        |
|     job-message-to-operator        |     user-name                     |
|     job-name                       |                                   |
|     job-print-after                |                                   |
|     job-priority                   |                                   |
|     job-retention-period           |                                   |
|     job-sheets                     |                                   |
|     job-start-message              |                                   |
|     notification-profile           |                                   |
|     physical-printers-requested    |                                   |
|     printer-locations-requested    |                                   |
|     printer-models-requested       |                                   |
|     printer-types-requested        |                                   |
|     results-profile                |                                   |
|------------------------------------------------------------------------|

|------------------------------------------------------------------------|
| Table  1-1. Job Attributes                                             |
|------------------------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | client-basic-ds                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the host to contact for information about the  |
|            | source environment from which the job was submitted.  This|
|            | attribute is present only when the job is submitted to an |
|            | HPDPS Gateway printer.                                    |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string containing the IP address of the host in    |
|            | dotted decimal format.                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | The destination environment uses this attribute to        |
| Guidelines | contact the source environment, such as to perform        |
|            | dce-pipe-pull document transfers.  The IP address is of a |
|            | host that runs a basicdsd server for the source           |
|            | environment.                                              |
|------------------------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | completion-time                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the time when the job completed printing.  Set |
|            | by HPDPS.                                                 |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format; USA is "HH:MM:SS mm/dd/yy"             |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | Provides status information.                              |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | current-job-state                                         |
|------------|-----------------------------------------------------------|
| Input      | job-state                                                 |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the current state of the job.                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values:                        |
|            |                                                           |
|            | cancelled                                                 |
|            | held                                                      |
|            | paused                                                    |
|            | pending                                                   |
|            | pre-processing                                            |
|            | processing                                                |
|            | retained                                                  |
|            | terminating                                               |
|            | timed-out                                                 |
|            | unknown                                                   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The value is set and updated by HPDPS as the job      |
| Guidelines |     progresses.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | device-name-assigned                                      |
|------------|-----------------------------------------------------------|
| Type       | Non Settable.                                             |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the path name of the device special file       |
|            | associated with the physical printer.                     |
|------------|-----------------------------------------------------------|
| Value Type | Single Value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string that contains the path name of the device   |
|            | associated with the printer.  Implicitly set by HPDPS if  |
|            | the value of printer attribute attachment-type is serial  |
|            | or parallel.                                              |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is intended for use in the ipmap       |
| Guidelines |     file to pass the device path name to the interface    |
|            |     program that accesses the device.                     |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | initial-value-job                                         |
|------------|-----------------------------------------------------------|
| Type       | Specifiable with the pdpr command.                        |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the initial-value-job object in the spooler    |
|            | that is to be used to create the job object during job    |
|            | submission.                                               |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The name of an existing initial-value-job object.         |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   If a value is specified for this attribute, the job   |
| Guidelines |     uses the attributes and values from the object unless |
|            |     those are overridden by attribute values supplied at  |
|            |     the command line.                                     |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | interface-program-method                                  |
|------------|-----------------------------------------------------------|
| Input      | ip-method                                                 |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the invocation method of the interface program. |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values:                        |
|            |                                                           |
|            | hpdps                                                     |
|            | lp                                                        |
|------------|-----------------------------------------------------------|
| Default    | hpdps                                                     |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated against the printer attribute    |
| Guidelines |     interface-program-methods-supported.                  |
|            |                                                           |
|            | o   If the value hpdps is specified, the interface program|
|            |     is invoked to print one job result-set as follows:    |
|            |                                                           |
|            |     - The value of the job-copies component of the job    |
|            |       results-profile attribute is passed as the 4th      |
|            |       argument of the interface program.                  |
|            |                                                           |
|            |     - Each document is duplicated n times before being    |
|            |       passed to the interface program, where n is the     |
|            |       value of the document copy-count attribute.         |
|            |                                                           |
|            | o   If the value lp is specified, the interface program is|
|            |     invoked to print each job copy in one job result set: |
|            |                                                           |
|            |     - The value of document attribute copy-count is passed|
|            |       as the 4th argument of the interface program.       |
|            |                                                           |
|            |     - The interface program is invoked n times, where n   |
|            |       is the value of the job-copies component of the job |
|            |       results-profile attribute.                          |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | intervening-jobs                                          |
|------------|-----------------------------------------------------------|
| Input      | position-in-queue, queue-position                         |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Indicates the number of jobs in the queue before this     |
|            | job.                                                      |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 0 to 2147483647.  Set and updated by      |
|            | HPDPS.                                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Provides status information.                          |
| Guidelines | o   A value of zero (0) means that the job is currently   |
|            |     printing.                                             |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-client-id                                             |
|------------|-----------------------------------------------------------|
| Input      | local-id                                                  |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the local job identifier.                      |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The local ID.  Set by HPDPS.                              |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Generated by the client program and is unique for a   |
| Guidelines |     given user ID.  The local ID is mapped to global ID   |
|            |     (the job attribute job-identifier), which is unique   |
|            |     for the system.                                       |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-comment                                               |
|------------|-----------------------------------------------------------|
| Input      | comment                                                   |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Provides information that is associated with this job.    |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains some    |
|            | information associated with this job.                     |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-copies-completed                                      |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Indicates the total number of copies of the job that have |
|            | finished printing.                                        |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 0 to 2147483647.  Set and updated by      |
|            | HPDPS.                                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This value is updated at the completion of each       |
| Guidelines |     result-set.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-discard-time                                          |
|------------|-----------------------------------------------------------|
| Input      | discard-time                                              |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the time or time and calendar date at which the |
|            | print job is to be discarded, whether or not it has       |
|            | printed.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format: USA format is HH:MM:SS or "HH:MM:SS    |
|            | mm/dd/yy" The string must be quoted if the date is        |
|            | specified.                                                |
|------------|-----------------------------------------------------------|
| Default    | No default                                                |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-end-message                                           |
|------------|-----------------------------------------------------------|
| Input      | end-message                                               |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message conveying information about output     |
|            | handling when the job completes printing.                 |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains         |
|            | instructions to an operator such as special output        |
|            | delivery instructions.                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Validate and schedule the job against the             |
| Guidelines |     printer attribute end-message-supported.              |
|            | o   This message is sent if the attribute                 |
|            |     end-message-supported is "true" for the physical      |
|            |     printer to which the job is submitted.                |
|            | o   The printer attribute notify-operator identifies the  |
|            |     operators that are to receive the message.            |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-hold                                                  |
|------------|-----------------------------------------------------------|
| Input      | hold                                                      |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Indicates whether the print job can be scheduled for      |
|            | printing.                                                 |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values:                        |
|            |                                                           |
|            | Fixed Value         Input Synonym                         |
|            | true                yes                                   |
|            | false               no                                    |
|------------|-----------------------------------------------------------|
| Default    | false                                                     |
|------------|-----------------------------------------------------------|
| Usage      | o   If true, the job-state changes to hold and the        |
| Guidelines |     job-state-reasons is set to job-hold-set.             |
|            | o   If held, the job remains in the queue until:          |
|            |     -   job-hold is set to "false" and the job can        |
|            |         continue.                                         |
|            |     -   The time specified in the job-discard-time        |
|            |         attribute is reached.                             |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-identifier                                            |
|------------|-----------------------------------------------------------|
| Input      | global-id                                                 |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| The global job identifier.  It uniquely identifies the    |
|            | job within the server.                                    |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The global ID.  Set by HPDPS.                             |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-message-from-administrator                            |
|------------|-----------------------------------------------------------|
| Input      | message-from-administrator                                |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable; see Usage Guidelines.                           |
|------------|-----------------------------------------------------------|
| Explanation| Describes the reasons that the job is being or has been   |
|            | changed.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that provides         |
|            | information concerning why a given action has been taken. |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Set with the value specified with the -m flag or the  |
| Guidelines |     command attribute message when included:              |
|            |     -   With the pdmod or pdset command and the           |
|            |         object class is job.                              |
|            |     -   With the pdpause, pdresume, pdpromote, or pdrm    |
|            |         commands.                                         |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-message-to-operator                                   |
|------------|-----------------------------------------------------------|
| Input      | message-to-operator                                       |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message that is to be sent to an operator when |
|            | the job is added to a queue.                              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains         |
|            | information about job processing requirements such as     |
|            | some type of special handling.                            |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The operator that is to receive the message is        |
| Guidelines |     identified in the queue attribute notify-operator.    |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-name                                                  |
|------------|-----------------------------------------------------------|
| Input      | name                                                      |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Provides a human readable job identification.             |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the      |
|            | identification.                                           |
|------------|-----------------------------------------------------------|
| Default    | The file name of the first document in the job.           |
|------------|-----------------------------------------------------------|
| Usage      | o   This identification may be printed on the auxiliary-  |
| Guidelines |     sheet page.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-originator                                            |
|------------|-----------------------------------------------------------|
| Input      | originator                                                |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Specifiable with the pdpr command.                        |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the user ID, or user ID and node, of the       |
|            | person who submitted the job, or the name of the program  |
|            | that initiated the job.                                   |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 that contains the global ID.      |
|------------|-----------------------------------------------------------|
| Default    | username@node of person submitting the job.               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-owner                                                 |
|------------|-----------------------------------------------------------|
| Input      | owner                                                     |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Specifiable with the pdpr command.                        |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the name or user ID of the person responsible  |
|            | for the print job.                                        |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 that contains the global ID of    |
|            | person that is to be responsible for this job.            |
|------------|-----------------------------------------------------------|
| Default    | The value of the job attribute job-originator.            |
|------------|-----------------------------------------------------------|
| Usage      | o   Use this attribute if you want to specify a person to |
| Guidelines |     be responsible for the job other than yourself.       |
|            | o   This identification may be printed on the auxiliary-  |
|            |     sheet.                                                |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-print-after                                           |
|------------|-----------------------------------------------------------|
| Input      | print-after                                               |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the time or time and calendar date after which  |
|            | the print job may be scheduled for printing.              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format; for USA HH:MM:SS or "HH:MM:SS          |
|            | mm/dd/yy".  The string must be quoted if the date is      |
|            | specified.                                                |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   If submitted before the specified time, job-state is  |
| Guidelines |     set to held and the job-state-reason is identified as |
|            |     job-print-after-specified for the job.                |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-priority                                              |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Specifies a number representing the scheduling priority   |
|            | for the job.  This attribute is used by queues that       |
|            | employ a priority based scheduler.  A higher value        |
|            | specifies a higher priority.                              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 1 to 100.                                 |
|------------|-----------------------------------------------------------|
| Default    | 50                                                        |
|------------|-----------------------------------------------------------|
| Usage      | o   A job submitter should not set this value higher than |
| Guidelines |     "50" unless the job submitter is an administrator.    |
|            |     If a value greater than 50 is specified, the value is |
|            |     set to "50".                                          |
|            | o   An administrator can set the value to any valid       |
|            |     value.                                                |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-sheets                                                |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Usage      | Values vary by printer model.                             |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the auxiliary sheets that are inserted into the |
|            | job.                                                      |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values:                        |
|            |                                                           |
|            | none                                                      |
|            | job-separators                                            |
|            | job-set-start                                             |
|            | job-set-end                                               |
|            | job-set-wrap                                              |
|            | job-set-start-copies-separate                             |
|            | job-set-end-copies-separate                               |
|            | job-set-wrap-copies-separate                              |
|            | job-copy-start                                            |
|            | job-copy-end                                              |
|            | job-copy-wrap                                             |
|------------|-----------------------------------------------------------|
| Default    | No default                                                |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated and scheduled against the        |
| Guidelines |     printer attribute job-sheets-supported.               |
|            |                                                           |
|            | Most printer models support the following 2 values:       |
|            |                                                           |
|            |    o none                                                 |
|            |                                                           |
|            |         No auxiliary sheets, or banner pages, are         |
|            |         printed with the job.                             |
|            |                                                           |
|            |    o job-set-start                                        |
|            |                                                           |
|            |         A banner page is printed at the start of each     |
|            |         job-result-set.  For most printers, this means    |
|            |         a single banner page is printed before the        |
|            |         job documents are printed.                        |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-retention-period                                      |
|------------|-----------------------------------------------------------|
| Input      | retention-period                                          |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the period of time following job completion     |
|            | that the job is to be retained before being discarded by  |
|            | the spooler.                                              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | [HH:]MM.  Unit is minutes; hours are optional.            |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-start-message                                         |
|------------|-----------------------------------------------------------|
| Input      | start-message                                             |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message that is to be sent to an operator when |
|            | the job is added to a queue conveying information about   |
|            | job processing.                                           |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains         |
|            | information about the job such as, "This job is very      |
|            | important; call me if there any problem."                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Validate and schedule the job against the             |
| Guidelines |     printer attribute start-message-supported.            |
|            | o   A message is sent if the physical printer attribute   |
|            |     start-message-supported is "true" for the physical    |
|            |     printer to which the job is submitted.                |
|            | o   The printer attribute notify-operator contains the    |
|            |     identity of the operators that are to receive the     |
|            |     message.                                              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-state-reasons                                         |
|------------|-----------------------------------------------------------|
| Input      | state-reasons, reasons                                    |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the reasons that a job is in the held,         |
|            | terminating, or retained state.  If this attribute value  |
|            | is blank, the job is not in one of these states.          |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | Any of the following fixed values:                        |
|            |                                                           |
|            | job-hold-set                                              |
|            | job-print-after-specified                                 |
|            | required-resources-not-ready                              |
|            | required-resources-not-supported                          |
|            | successful-completion                                     |
|            | cancelled-by-user                                         |
|            | cancelled-by-operator                                     |
|            | aborted-by-system                                         |
|            | checkpoint-not-supported                                  |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-submission-complete                                   |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Indicates whether all documents of the job have been      |
|            | received by the spooler.                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values:                        |
|            |                                                           |
|            | Fixed Value         Input Synonym                         |
|            | true                yes                                   |
|            | false               no                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | modification-time                                         |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the time this job was last modified.           |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format.  For the USA; "HH:MM:SS mm/dd/yy"      |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | name-of-last-accessor                                     |
|------------|-----------------------------------------------------------|
| Input      | last-accessor, last-modifier                              |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the person or name of the program that         |
|            | submitted the job, or most recently modified the job.  If |
|            | the job was submitted or modified by a person, the value  |
|            | is the login ID for that user.                            |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the      |
|            | login ID of the user or a global ID.  Set by HPDPS.       |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | new-job-identifier                                        |
|------------|-----------------------------------------------------------|
| Input      | new-identifier, new-id                                    |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the name of the spooler to which this job has  |
|            | been reassigned.  Also a new global job identifier, if a  |
|            | job was resubmitted to a logical printer on a different   |
|            | spooler.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | server-name:job-identifier or server-name.  Set by HPDPS. |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   If the job is submitted to a logical printer on the   |
| Guidelines |     same spooler, the job identifier remains the same.    |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | notification-profile                                      |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset or pdmod commands.          |
|------------|-----------------------------------------------------------|
| Explanation| Designates which persons are to be notified of specific   |
|            | events relating to this job, and how the persons are to   |
|            | be notified.                                              |
|------------|-----------------------------------------------------------|
| Value Type | Multiple Values                                           |
|------------|-----------------------------------------------------------|
| Values     | This is a complex attribute, which has the following      |
|            | components:                                               |
|            |                                                           |
|            | o   event-identifiers                                     |
|            | o   delivery-method                                       |
|            | o   event-comment                                         |
|            | o   delivery-address                                      |
|            | o   locale                                                |
|------------|-----------------------------------------------------------|
| Syntax     | -x "notification-profile={event-identifiers=value         |
|            | delivery-method=value event-comment='text'                |
|            | delivery-address=value locale=value}"                     |
|            |                                                           |
|            | For example:                                              |
|            |                                                           |
|            | -x "notification-profile={event-identifiers=class-error   | 
|            | delivery-method=electronic-mail                           |
|            | event-comment='fix problem' delivery-address=mary@travel  |
|            | locale=C}"                                                |
|------------|-----------------------------------------------------------|
| Component  | Description                                               |
|------------|-----------------------------------------------------------|
| event-     | Explanation: Specifies the events for which the user      |
| identifiers|     is to receive messages.                               |
|            | Value Type: Multiple values.                              |
|            | Values: A text string up to 4095 characters that          |
|            |     includes any of the values listed for the attribute   |
|            |     events-supported of a spooler (pd_att_spooler) or     |
|            |     supervisor (pd_att_supervisor).                       |
|            | Default:                                                  |
|            |         document-aborted-by-printer                       |
|            |         document-aborted-by-server                        |
|            |         document-cancelled-at-printer                     |
|            |         job-aborted-by-server                             | 
|            |         job-cancelled-by-operator                         | 
|            |         job-cannot-be-scheudled                           |
|            |         job-completed                                     |
|            |         job-discarded                                     |
|            |         printer-needs-attention                           | 
|            |         printer-needs-operator                            |
|            |         printer-paper-jam                                 |
|            |         printer-paper-out                                 |
|            |         printer-paper-output-problem                      |
|            |         printer-toner-low                                 |
|------------|-----------------------------------------------------------|
| delivery-  |  Explanation: Specifies how the person is to receive      |
| method     |     event messages.                                       |
|            |  Value Type: Single value.                                |
|            |  Values: One of the following fixed values:               |
|            |     Fixed Value         Input Synonym                     |
|            |     electronic-mail     e-mail, email                     |
|            |     message                                               |
|            |     none                                                  |
|            | Default: electronic-mail                                  |
|------------|-----------------------------------------------------------|
| event-     | Explanation: Supplies textual information that is         |
| comment    |     appended to the event message.                        |
|            | Value Type: Single value.                                 |
|            | Values: A text string up to 4095 characters that          |
|            |     supplies additional information concerning the event. |
|            | Default: No value.                                        |
|------------|-----------------------------------------------------------|
| delivery-  | Explanation: The address of the person to receive the     |
| address    |     event messages.                                       |
|            | Value Type: Single value.                                 |
|            | Values: A text string that contains the name and node     |
|            |     of the person that is to receive notification.        |
|            | Default: The login of the user that submitted the job     |
|            |     using the pdpr command.                               |
|------------|-----------------------------------------------------------|
| locale     | Explanation: Identifies the locale of the user that       |
|            |     is to receive the messages.                           |
|            | Value Type: Single value.                                 |
|            | Values: A text string that identifies the locale to       |
|            |     be used.  This is used to determine the language and  |
|            |     coded character set that the information is to be     |
|            |     sent in.                                              |
|            | Default: The locale of the user that submitted the        |
|            |     job with the pdpr command.                            |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | number-of-documents                                       |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Explanation| Identifies the number of documents in the job, including  |
|            | resource documents such as fonts.                         |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 1 to 2147483647.  Set by HPDPS.           |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | object-class                                              |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the object class to which this object belongs. |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The value of this attribute is job.                       |
|------------|-----------------------------------------------------------|
| Default    | job                                                       |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | octets-completed                                          |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Explanation| Reports the number of octets (bytes) in this job that     |
|            | have been printed.                                        |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 0 to 9223372036854775800.  Set by HPDPS.  |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is updated at the completion of each   |
| Guidelines |     result-set.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | output-bin-requested                                      |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the output-bin specified by the output-bin     |
|            | component of the job results-profile attribute.           |
|------------|-----------------------------------------------------------|
| Value Type | Single Value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string of up to 255 characters that describes the  |
|            | output bin, or any of the following fixed values:         |
|            |                                                           |
|            | top                                                       |
|            | middle                                                    |
|            | bottom                                                    |
|            | side                                                      |
|            | left                                                      |
|            | right                                                     |
|            | face-up                                                   |
|            | face-down                                                 |
|            | large                                                     |
|            | private                                                   |
|            | collator                                                  |
|            |                                                           |
|            | Implicitly set by HPDPS.                                  |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is intended for use in the ipmap       |
| Guidelines |     file to convert the output-bin component of the job   |
|            |     results-profile attribute to lp options.              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | pages-completed                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Reports the number of pages in this job that have been    |
|            | printed.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 0 to 2147483647.  Set by HPDPS.           |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |  o  This attribute may or may not be updated depending    |
| Guidelines |     on the requested physical printer.                    |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | physical-printers-requested                               |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset, or pdmod commands.         |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the physical printers that are being requested |
|            | to print this job.                                        |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters per physical printer   |
|            | that contains the name of the physical printer.           |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated and scheduled against the        |
| Guidelines |     printer attribute printer-name.                       |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | previous-job-state                                        |
|------------|-----------------------------------------------------------|
| Input      | previous-state                                            |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the state of the job before the last job state |
|            | change.                                                   |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | One of the following fixed values set by HPDPS:           |
|            |                                                           |
|            | cancelled                                                 |
|            | held                                                      |
|            | paused                                                    |
|            | pending                                                   |
|            | pre-processing                                            |
|            | processing                                                |
|            | retained                                                  |
|            | terminating                                               |
|            | timed-out                                                 |
|            | unknown                                                   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-locations-requested                               |
|------------|-----------------------------------------------------------|
| Input      | locations-requested                                       |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset, or pdmod commands.         |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the locations where the job is being requested |
|            | to be printed.                                            |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains the     |
|            | physical location of each printer requested.  The job     |
|            | will be printed on a printer at one of the locations if   |
|            | the validation is successful.                             |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated and scheduled against the        |
| Guidelines |     printer attribute printer-locations.                  |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-models-requested                                  |
|------------|-----------------------------------------------------------|
| Input      | models-requested                                          |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset, or pdmod commands.         |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the model ID of the printers requested to      |
|            | print the job.                                            |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters per printer that      |
|            | contains the printer model to be used to print the job.   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated and scheduled against the        |
| Guidelines |     printer attribute printer-model.  Only one value must |
|            |     match for the job to be validated and scheduled.      |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-types-requested                                   |
|------------|-----------------------------------------------------------|
| Input      | types-requested                                           |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset, or pdmod commands.         |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the type of the printer to be used for printing|
|            | the job.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values                                           |
|------------|-----------------------------------------------------------|
| Values     | Any of the following fixed values:                        |
|            |                                                           |
|            | other                                                     |
|            | electrographic-led                                        |
|            | electrographic-laser                                      |
|            | electrographic-other                                      |
|            | impact-moving-head-dot-matrix-9-pin                       |
|            | impact-moving-head-dot-matrix-24-pin                      |
|            | impact-moving-head-dot-matrix-other                       |
|            | impact-moving-head-fully-formed                           |
|            | impact-band                                               |
|            | impact-other                                              |
|            | inkjet-aqueous                                            |
|            | inkjet-solid                                              |
|            | inkjet-other                                              |
|            | pen                                                       |
|            | thermal-transfer                                          |
|            | thermal-sensitive                                         |
|            | thermal-diffusion                                         |
|            | thermal-other                                             |
|            | electro-erosion                                           |
|            | electro-static                                            |
|            | photographic-microfiche                                   |
|            | photographic-imagesetter                                  |
|            | photographic-other                                        |
|            | ion-deposition                                            |
|            | E-beam                                                    |
|            | typesetter                                                |
|------------|-----------------------------------------------------------|
| Default    | No default                                                |
|------------|-----------------------------------------------------------|
| Usage      | o   The job is validated and scheduled against the        |
| Guidelines |     printer attribute printer-types.                      |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-name-requested                                    |
|------------|-----------------------------------------------------------|
| Input      | printer-requested, logical-printer-requested              |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Specifiable with the pdpr command.                        |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the logical printer to which this job is to be |
|            | submitted.                                                |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the name |
|            | of the logical printer.                                   |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Default    | The PDPRINTER environment variable for the client.        |
|------------|-----------------------------------------------------------|
| Usage      | o   To move the job to a different logical printer, use   |
| Guidelines |     the pdresubmit command.                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printers-assigned                                         |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Explanation| Identifies the physical printer to which the job has been |
|            | assigned for printing.                                    |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The global ID of the printer.                             |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The global ID cannot contain the cell name.           |
| Guidelines | o   If the value for the attribute is blank, the job is   |
|            |     still waiting to be scheduled to a physical printer.  |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | processing-time                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Reports the amount of time that the job has been printing |
|            | on the physical printer device.  If printing has          |
|            | completed, this value is the total amount of time needed  |
|            | to print the job.                                         |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | [HH:]MM.  Unit is minutes.  Set by HPDPS.                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | queue-assigned                                            |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the queue to which the job has been assigned.  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters set by HPDPS that      |
|            | contains the name of the queue.                           |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   If this attribute is blank, the job is not currently  |
| Guidelines |     residing in a queue (it may be in the retained or     |
|            |     timed-out state).                                     |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | results-profile                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdpr, pdset, or pdmod commands.         |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the delivery method for the hardcopy output,    |
|            | and designates who is to receive output and the number of |
|            | copies (per recipient).                                   |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | This is a complex attribute which has the following       |
|            | components:                                               |
|            |                                                           |
|            | 1.  delivery-method                                       |
|            | 2.  results-set-comment                                   |
|            | 3.  delivery-address                                      |
|            | 4.  job-copies                                            |
|            | 5.  output-bin                                            |
|------------|-----------------------------------------------------------|
| Syntax     |-x "results-profile=\                                      |
|            |    dm value:rc value:da value:jc value:ob value"          |
|            |                                                           |
|            | For example: -x ":::2:top"                                |
|------------|-----------------------------------------------------------|
| Usage      | o   Only the job-copies and output-bin components are     |
| Guidelines |     used by HPDPS.                                        |
|------------|-----------------------------------------------------------|
| Component  | Description                                               |
|------------|-----------------------------------------------------------|
| delivery-  | Explanation: Specifies how the person is to receive       |
| method     |     the job output.                                       |
|            | Value Type: Single value.                                 |
|            | Values: The only value for this component is the          |
|            |     following fixed value:                                |
|            |        pickup                                             |
|            | Default: pickup                                           |
|------------|-----------------------------------------------------------|
| results-   | Explanation: Supplies a text string that describes        |
| set-comment|     the results-set value.                                |
|            | Value Type: Single value.                                 |
|            | Values: A text string up to 4095 characters that          |
|            |     provides information such as "Please staple this      |
|            |     document".  Or information such as "Please read       |
|            |     before meeting tomorrow" for the person that is to    |
|            |     receive the document.  This information may be        |
|            |     printed on start-sheets.                              |
|            | Default: No default.                                      |
|------------|-----------------------------------------------------------|
| delivery-  | Explanation: The address of the person that is to         |
| address    |     receive the job output.                               |
|            | Value Type: Single value.                                 |
|            | Values: A text string that contains the address.          |
|------------|-----------------------------------------------------------|
| job-copies | Explanation: Specifies how many copies of the job the     |
|            |     person is to receive.                                 |
|            | Value Type: Single value.                                 |
|            | Values: An integer (cannot be 0).                         |
|            | Default: 1                                                |
|------------|-----------------------------------------------------------|
| output-bin | Explanation: Specifies the output-bin to be used.         |
|            | Value Type: Single value.                                 |
|            | Values: One of the following fixed values:                |
| Values     | Values: A text string of up to 255 characters that        |
|            |     describes the output bin, or any of the following     |
|            |     fixed values:                                         |
|            |                                                           |
|            | top                                                       |
|            | middle                                                    |
|            | bottom                                                    |
|            | side                                                      |
|            | left                                                      |
|            | right                                                     |
|            | face-up                                                   |
|            | face-down                                                 |
|            | large                                                     |
|            | private                                                   |
|            | collator                                                  |
|            | Default: No default.                                      |
|            |                                                           |
|            | The value is validated against the printer attribute      |
|            | output-bins-supported.                                    |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | started-printing-time                                     |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the time the job was sent to the physical      |
|            | printer.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format; USA format is "HH:MM:SS mm/dd/yy".  Set|
|            | by HPDPS.                                                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | submission-time                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the time the job was added to the queue.       |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | Local time format; for USA, "HH:MM:SS mm/dd/yy".  Set by  |
|            | HPDPS.                                                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | total-job-octets                                          |
|------------|-----------------------------------------------------------|
| Input      | job-size                                                  |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| The size of the job determined by the sum total of all    |
|            | printable octets in the job.                              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | An integer from 0 to 9223372036854775800.  Set by HPDPS.  |
|------------|-----------------------------------------------------------|
| Default    | No default                                                |
|------------|-----------------------------------------------------------|
| Usage      | o   The server computes this value by totaling the size   |
| Guidelines |     of all printable documents.  It is based on the       |
|            |     number of printable octets and is computed as:        |
|            |                                                           |
|            | job-copies X (printable document octet-count X copy-count)|
|            |                                                           |
|            | o   The job is validated against the logical printer      |
|            |     attribute job-size-range-supported.                   |
|            | o   The job is scheduled against the physical printer     |
|            |     attribute job-size-range-ready.                       |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | user-locale                                               |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the language of the information that appears   |
|            | on the start, separator, and end sheets printed with the  |
|            | job and the messages for the job that are sent to the     |
|            | various people.                                           |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | The locale of the job submitter                           |
|------------|-----------------------------------------------------------|
| Default    | Set from the operation-locale, which is set from the      |
|            | user-locale.                                              |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | user-name                                                 |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the login ID of the job submitter.             |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string that contains the login of the job          |
|            | submitter; username@node.                                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Set by the client to username@node.                   |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|

.lg
.\"
.\" toc@\f3pd_att_job(5)\f1@@@list of attributes for a job object (HP Distributed Print Services)
.\"
.\" index@\f1pd_att_job \- list of attributes for a job object (HP Distributed Print Services)@@@\f3pd_att_job(5)\f1
.\"
