.\" $Header:
.TA p
.TH pd_att_ivjob 5
.SH NAME
pd_att_ivjob \- list of attributes for an HPDPS initial value job object
.SH DESCRIPTION
The following is a list of valid attributes and values for the initial value
job object class of the HP Distributed Print Service.
\f2Initial-value-job\fP objects are used to set values for job attributes.

.SS Attributes for an Initial Value Job Object         

.cs 1 22
.lg 0
.nf
|------------------------------------------------------------------------|
| Settable Attribute Listing         | Specifiable Attribute Listing     |
|------------------------------------|-----------------------------------|
|     descriptor                     | There are no specifiable          |
|     interface-program-method       | attributes for a                  |
|     job-comment                    | initial-value-document object.    |
|     job-client-id                  |                                   |
|     job-discard-time               |                                   |
|     job-end-message                |                                   |
|     job-hold                       |                                   |
|     job-message-to-operator        |                                   |
|     job-name                       |                                   |
|     job-originator                 |                                   |
|     job-owner                      |                                   |
|     job-print-after                |                                   |
|     job-priority                   |                                   |
|     job-retention-period           |                                   |
|     job-sheets                     |                                   |
|     job-start-message              |                                   |
|     list-of-managers               |                                   |
|     message                        |                                   |
|     notification-profile           |                                   |
|     physical-printers-requested    |                                   |
|     printer-locations-requested    |                                   |
|     printer-models-requested       |                                   |
|     printer-types-requested        |                                   |
|     results-profile                |                                   |
|------------------------------------------------------------------------|

   Note:  In the following table, the attributes are used to set job
          attributes or are used as defaults for a job unless otherwise
          noted.

|------------------------------------------------------------------------|
| Table  1-1. Initial Value Job Attributes                               |
|------------------------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | associated-server                                         |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the name of the spooler in which this          |
|            | initial-value-job object resides.                         |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string that contains the server name.  Set to the  |
|            | server name of the pdcreate command argument              |
|            | ServerName:InitialValueJobName when this object is        |
|            | created.                                                  |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | descriptor                                                |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides a description of this initial-value-job.         |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that describes this   |
|            | initial-value-job object.                                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | initial-value-job-identifier                              |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Identifies this initial-value-job object within the       |
|            | spooler.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the name |
|            | of this initial-value-job object.  Set to the name used   |
|            | in the pdcreate command argument                          |
|            | ServerName:InitialValueJobName when this object was       |
|            | created.                                                  |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|            | o   The value for this attribute must be unique within a  |
|            |     spooler.                                              |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| 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       | job-client-id                                             |
|------------|-----------------------------------------------------------|
| Input      | local-id                                                  |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| The local job identifier.                                 |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the      |
|            | local ID (an integer).  This value is generated           |
|            | automatically by the DPS client program and is unique for |
|            | a given user ID.  The local ID is mapped to a global ID   |
|            | (the job-identifier job attribute) that is unique for the |
|            | system.                                                   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-comment                                               |
|------------|-----------------------------------------------------------|
| Input      | comment                                                   |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
|------------|-----------------------------------------------------------|
| Explanation| Provides information that is associated with this print   |
|            | job.                                                      |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that provides some    |
|            | information about the job.                                |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-discard-time                                          |
|------------|-----------------------------------------------------------|
| Input      | discard-time                                              |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the time and calendar date or time at which     |
|            | this 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 mm/dd/yy" or   |
|            | HH:MM:SS.  The string must be enclosed in quotes if the   |
|            | date is used.                                             |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-end-message                                           |
|------------|-----------------------------------------------------------|
| Input      | end-message                                               |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides the message that is to be sent to an operator    |
|            | when this job completes printing.                         |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains         |
|            | information on how the printed output is to be handled,   |
|            | such as special delivery instructions.                    |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Validate and schedule against the printer attribute   |
| Guidelines |     end-message-supported.                                |
|            | o   This message is sent if the                           |
|            |     physical printer attribute end-message-supported is   |
|            |     "true" for the physical printer the job is submitted  |
|            |     to.                                                   |
|            | o   The physical printer attribute notify-operator        |
|            |     determines which operators receives the message.      |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-hold                                                  |
|------------|-----------------------------------------------------------|
| Input      | hold                                                      |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Indicates whether a 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    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   If true, the job-state of the job is set to hold and  |
| Guidelines |     the 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-message-to-operator                                   |
|------------|-----------------------------------------------------------|
| Input      | message-to-operator                                       |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message that is to be sent to an operator when |
|            | a job is added to a queue.                                |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that contains         |
|            | information about this job such as job processing         |
|            | requirements or some type of special handling.            |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The person that is to receive this message is         |
| Guidelines |     identified by the queue attribute notify-operator.    |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-name                                                  |
|------------|-----------------------------------------------------------|
| Input      | name                                                      |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides an identifier that may be printed on the job     |
|            | start sheet.                                              |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains human    |
|            | readable job identification.                              |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This identification may be printed on the auxiliary-  |
| Guidelines |     sheet page.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-originator                                            |
|------------|-----------------------------------------------------------|
| Input      | originator                                                |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the user ID of the person who submits a job.   |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the user |
|            | ID.  This value is set automatically by the DPS client    |
|            | program so this attribute is not used by a job that uses  |
|            | this initial-value-job.                                   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      |                                                           |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-owner                                                 |
|------------|-----------------------------------------------------------|
| Input      | owner                                                     |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the name or user ID of the person responsible  |
|            | for this print job.                                       |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters that contains the      |
|            | global ID of a person that is to be responsible for this  |
|            | job.                                                      |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Use this attribute if you want to specify a person to |
| Guidelines |     be responsible for a job other than the person who    |
|            |     submits the job.                                      |
|            | o   This identification may be printed on the auxiliary-  |
|            |     sheet page.                                           |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-print-after                                           |
|------------|-----------------------------------------------------------|
| Input      | print-after                                               |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset 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; USA format is HH:MM:SS or "HH:MM:SS    |
|            | mm/dd/yy".  The string must be enclosed in quotes if the  |
|            | date is used.                                             |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job-state for this job is set to held and the     |
| Guidelines |     job-state-reason is set to job-print-after-specified. |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-priority                                              |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset 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    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This value should not be set higher than "50" for     |
| Guidelines |     initial-value-job objects to be used by all users.    |
|            |     If a value greater than 50 is specified, the value is |
|            |     lowered to "50" when the job is submitted.            |
|            | o   A job submitted by an administrator can have any      |
|            |     valid value.                                          |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-retention-period                                      |
|------------|-----------------------------------------------------------|
| Input      | retention-period                                          |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the period of time following job completion     |
|            | that a 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-sheets                                                |
|------------|-----------------------------------------------------------|
| Input      | job-sheets                                                |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| 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.               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | job-start-message                                         |
|------------|-----------------------------------------------------------|
| Input      | start-message                                             |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message that is to be sent to an operator when |
|            | a job is sent to a physical printer conveying information |
|            | about job processing.                                     |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that provides some    |
|            | information about the job such as this job is very        |
|            | important.                                                |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   Validate and schedule against the printer attribute   |
| Guidelines |     start-message-supported.                              |
|            | o   This message is sent if the                           |
|            |     physical printer attribute start-message-supported is |
|            |     "true" for the physical printer the job is submitted  |
|            |     to.                                                   |
|            | o   The persons that are to receive this message are      |
|            |     identified in the physcial printer attribute          |
|            |     notify-operator.                                      |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | list-of-managers                                          |
|------------|-----------------------------------------------------------|
| Input      | managers                                                  |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the persons responsible for the maintenance of |
|            | this initial-value-job object.                            |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters per person that        |
|            | contains the name or user ID of the person responsible.   |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | logical-printers-ready                                    |
|------------|-----------------------------------------------------------|
| Type       | Non Settable                                              |
|------------|-----------------------------------------------------------|
| Explanation| Lists the enabled logical printers that reference this    |
|            | initial-value-job object.                                 |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string that contains the global IDs of the logical |
|            | printers that are enabled and reference this              |
|            | initial-value-job object.                                 |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|            | o   Values are added when other logical printers are      |
|            |     enabled and reference this initial-value-job through  |
|            |     their printer-initial-value-job attribute.            |
|            | o   Values are removed when logical printers that         |
|            |     reference this initial-value-job are disabled.        |
|            | o   This initial-value-job object cannot be deleted until |
|            |     all printers have been removed from this list.        |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | message                                                   |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message associated with the initial-value-job  |
|            | object.                                                   |
|------------|-----------------------------------------------------------|
| Value Type | Single value.                                             |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters that provides         |
|            | information about this object.                            |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | notification-profile                                      |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Designates the people that are to be notified when        |
|            | specified events relating to this job and how the people  |
|            | 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-state-changed job-completed                         |
|            | delivery-method=electronic-mail                           |
|            | event-comment='job progressing'                           |
|            | delivery-address=joe@newhope                              |
|            | locale=C}"                                                |
|------------|-----------------------------------------------------------|
| Component  | Description                                               |
|------------|-----------------------------------------------------------|
| event-     |     Explanation: Specifies the events for which the user  |
| identifiers|     is to receive notification that something has taken   |
|            |     place.                                                |
|            |     Value Type: Multiple values.                          |
|            |     Values: Any of the values listed for spooler          |
|            |        attribute events-supported in pd_att_spooler.      |
|            |     Default: No default.                                  |
|------------|-----------------------------------------------------------|
| delivery-  |     Explanation: Specifies if or how the user is to       |
| method     |     receive the information.                              |
|            |     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: This textual information is appended to  |
| comment    |     the event message.                                    |
|            |     Value Type: Single value.                             |
|            |     Values: A text string up to 4095 characters that      |
|            |     supplies additional information.                      |
|            |     Default: No default.                                  |
|------------|-----------------------------------------------------------|
| delivery   |     Explanation: The address of the person that is to     |
| -address   |     receive the event messages.                           |
|            |     Value Type: Single value.                             |
|            |     Values: A text string that contains the name and node |
|            |     of the person that is to receive the information.     |
|            |     Default: No default.                                  |
|------------|-----------------------------------------------------------|
| locale     |     Explanation: Identifies the locale of the person that |
|            |     is to receive the message.                            |
|            |     Value Type: Single value.                             |
|            |     Values: A text string that contains the locale        |
|            |     identification of the person that is to receive the   |
|            |     notification.  This information is used to determine  |
|            |     the language and coded character set that the         |
|            |     notification is sent in.                              |
|            |     Default: No default.                                  |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| 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 initial value job.         |
|------------|-----------------------------------------------------------|
| Default    | initial-value-job                                         |
|------------|-----------------------------------------------------------|
| Usage      | o   This attribute is used by the initial-value-job       |
| Guidelines |     object.                                               |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | physical-printers-requested                               |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the physical printers requested for printing   |
|            | the job.                                                  |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 255 characters per printer that       |
|            | contains the name of the physical printer.                |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job will be printed on one of the requested       |
| Guidelines |     physical printers, if possible.                       |
|            | o   Validate and schedule against the printer attribute   |
|            |     printer-name.                                         |
|            | o   Validate and schedule against the printer attribute   |
|            |     start-message-supported.                              |
|            | o   This message is sent if the                           |
|            |     physical printer attribute start-message-supported is |
|            |     "true" for the physical printer the job is submitted  |
|            |     to.                                                   |
|            | o   The persons that are to receive this message are      |
|            |     identified in the physcial printer attribute          |
|            |     notify-operator.                                      |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-locations-requested                               |
|------------|-----------------------------------------------------------|
| Input      | locations-requested                                       |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the locations where a job has been requested   |
|            | to be printed.                                            |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters per printer that      |
|            | contains the physical location of the printer being       |
|            | requested.                                                |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job will be printed on a printer at one of the    |
| Guidelines |     requested locations, if possible.                     |
|            | o   The job is validated and scheduled against the        |
|            |     printer attribute printer-locations.                  |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute  | Description                                               |
|------------|-----------------------------------------------------------|
| Name       | printer-models-requested                                  |
|------------|-----------------------------------------------------------|
| Input      | models-requested                                          |
| Synonym    |                                                           |
|------------|-----------------------------------------------------------|
| Type       | Settable with the pdcreate or pdset commands.             |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the model IDs of the printers on which the job  |
|            | is to be printed.                                         |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values.                                          |
|------------|-----------------------------------------------------------|
| Values     | A text string up to 4095 characters per printer that      |
|            | contains the model of the printer that can be used to     |
|            | print this job.                                           |
|------------|-----------------------------------------------------------|
| Default    | No default.                                               |
|------------|-----------------------------------------------------------|
| Usage      | o   The job will be printed on a requested model, if      |
| Guidelines |     possible.                                             |
|            | o   The job is validated and scheduled against the        |
|            |     printer-atribute printer-model.                       |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| 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       | 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 job-copies and output-bin components are used.   |
| Guidelines |                                                           |
|------------|-----------------------------------------------------------|
| 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.  The    |
|            |    job is validated against the physical printer attribute|
|            |    output-bins-supported.                                 |
|            | Value Type: Single value.                                 |
|            | Values: One of the following fixe valued:                 |
|            |                                                           |
|            | top                                                       |
|            | middle                                                    |
|            | bottom                                                    |
|            | side                                                      |
|            | left                                                      |
|            | right                                                     |
|            | face-up                                                   |
|            | face-down                                                 |
|            | large                                                     |
|            | private                                                   |
|            | collator                                                  |
|            | Default: No default.                                      |
|            |                                                           |
|            | The job is validated against the printer attribute        |
|            | output-bins-supported.                                    |
|------------------------------------------------------------------------|
.lg
.\"
.\" toc@\f3pd_att_ivjob(5)\f1@@@list of attributes for an initial value job object (HP Distributed Print Service)
.\"
.\" index@\f1pd_att_ivjob \- list of attributes for an initial value job object (HP Distributed Print Service)@@@\f3pd_att_ivjob(5)\f1
.\"
