pd_att_supervisor(5)

|------------------------------------------------------------------------| | Settable Attribute Listing | Specifiable attribute Listing | |------------------------------------|-----------------------------------| | descriptor | There are no specifiable | | job-submission-timer | attributes for a supervisor | | list-of-managers | server object. | | message | | | notification-profile | | | protected-attributes | | | security-level | | | server-resource-context-printer| | |------------------------------------------------------------------------| |------------------------------------------------------------------------| | Table 1-1. Supervisor Attributes | |------------------------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | cancel-individual-document-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Indicates whether this supervisor is capable of | | | cancelling individual documents within a multiple | | | document job. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | The only value is false. | |-------------|----------------------------------------------------------| | Default | false | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | descriptor | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Provides a description of this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string up to 4095 characters that describes this | | | supervisor. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | events-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Lists the events supported by this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | checkpoint-taken | | | class-aborted | | | class-error | | | class-physical-printer-attention | | | class-physical-printer-default | | | class-physical-printer-configuration | | | class-physical-printer-status | | | class-report | | | class-server-attention | | | class-server-default | | | class-server-configuration | | | class-server-status | | | class-state-changed | | | class-warning | | | detailed-messages | | | document-aborted-by-printer | | | document-aborted-by-server | | | document-cancelled-at-printer | | | document-content | | | file-transferred | | | internal-server-error | | | job-aborted-by-server | | | job-cancelled-by-operator | | | job-cancelled-by-user | | | job-completed | | | no-document | | | no-resource | | | object-cleaned | | | object-created | | | object-deleted | | | object-modified | | | object-paused | | | object-resumed | | | other-error | | | other-warning | | | printer-disabled | | | printer-enabled | | | printer-function-unavailable | | | printer-needs-administrator | | | printer-needs-attention | | | printer-needs-operator | | | printer-paper-jam | | | printer-paper-out | | | printer-paper-output-problem | | | printer-registered | | | printer-shutdown-job-requeued | | | printer-state-changed | | | printer-timed-out | | | printer-toner-low | | | printer-unregistered | | | processing-started | | | resource-needs-attention | | | resource-needs-operator | | | server-shutdown-complete | | | server-shutdown-started | | | server-startup-complete | | | server-state-changed | | | unable-to-register | | | unrecognized-resource | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | job-state-reasons-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the job-state reasons that are supported by | | | this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | successful-completion | | | cancelled-by-user | | | cancelled-by-operator | | | aborted-by-system | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | job-states-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the job-states supported by this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | cancelled | | | processing | | | terminating | |-------------|----------------------------------------------------------| | Default | | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | job-submission-timer | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Specifies the maximum time to wait for job submissions | | | to complete. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | [HH:]MM. The unit is minutes. | |-------------|----------------------------------------------------------| | Default | 30 minutes | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | list-of-managers | |-------------|----------------------------------------------------------| | Input | managers | | Synonym | | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Lists the people that are responsible for the | | | maintenance and operation of this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | A text string that contains the name or user IDs of the | | | people that are responsible for this supervisor. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | locale | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the locale of this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string up to 4095 characters that contains the | | | locale ID of this supervisor. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | o Derived from the environment variable for this | | Guidelines | supervisor at the startup time. The priority | | | sequence to obtain the locale from the environment | | | variables is: | | | 1. LC_ALL | | | 2. LC_MESSAGES | | | 3. LANG | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | message | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Information associated with this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string up to 4095 characters that contains the | | | information associated with this supervisor. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | multiple-documents-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Indicates whether multiple documents per job are | | | supported by the supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | The only value is true. | |-------------|----------------------------------------------------------| | Default | true | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | notification-delivery-methods-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the notification delivery methods supported | | | by this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | electronic-mail | | | message | | | file | | | file-add-to | | | none | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | notification-profile | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Designates which users are to be notified of specific | | | events related to the supervisor, and how they 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=events | | | delivery-method=value event-comment='text' | | | delivery-address=value locale=value}" | | | | | | For example: | | | | | | -x "notification-profile={event-identifiers= | | | object-cleaned object-deleted | | | delivery-method=electronic-mail | | | event-comment='Better check' | | | delivery-address=dave@final local=C}" | |-------------|----------------------------------------------------------| | Component | Description | |-------------|----------------------------------------------------------| | event- | Explanation: Specifies the events for which the | | identifiers | person is to receive messages. | | | Value Type: Multiple values. | | | Values: Any of the values listed for supervisor | | | attribute events-supported. | | | Default: | | | o internal-server-error | | | o object-cleaned | | | o object-deleted | | | o server-shutdown-complete | |-------------|----------------------------------------------------------| | delivery- | Explanation: Specifies how the user is to receive | | method | the event messages. | | | Value Type: Single value. | | | Values: One of the following fixed values: | | | Fixed Value Input Synonym | | | electronic-mail e-mail, email | | | message | | | file | | | file-add-to | | | none | | | Default: electronic-mail | |-------------|----------------------------------------------------------| |event-comment| Explanation: Information that is appended to the | | | event message. | | | Value Type: Single value. | | | Values: A text string up to 4095 characters that | | | contains the comment. | | | 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 user ID and | | | node of the person that is to receive the event | | | messages. | | | Default: The login of the person that created this | | | supervisor. | |-------------|----------------------------------------------------------| | locale | Explanation: Identifies the locale of the person to | | | receive the event messages. The locale is used to | | | determine which language the messages are to be sent | | | in. | | | Value Type: Single value. | | | Values: A text string that contains the locale of | | | the person that is to receive the messages. | | | Default: The locale of the person that created this | | | supervisor. | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | 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 server. | |-------------|----------------------------------------------------------| | Default | server | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | object-classes-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Lists the object classes supported by this server. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | job | | | document | | | printer | | | server | | | log | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | physical-printers-ready | |-------------|----------------------------------------------------------| | Type | Non Settable. | |-------------|----------------------------------------------------------| | Explanation | Identifies the physical printers contained within this | | | supervisor that are ready to accept jobs. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | A text string up to 255 characters that contains the ID | | | of the physical printers (per printer) that are ready to | | | accept jobs. Implicitly set when physical printers are | | | enabled and have a state of either idle, | | | connecting-to-printer, or printing. Implicitly reset | | | when a physical printer is disabled. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | physical-printers-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the physical printers that are contained in | | | this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any text string up to 255 characters that contains the | | | IDs of the physical printers that are contained within | | | this supervisor. Implicitly set and reset when physical | | | printers are created or deleted. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | printer-models-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the physical printer models that can be | | | created within this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any text string up to 255 characters that contains the | | | IDs of the physical printer models that can be created | | | within this supervisor. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | printer-states-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the printer states that are supported by this | | | supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | connecting-to-printer | | | idle | | | needs-attention | | | needs-key-operator | | | paused | | | printing | | | timed-out | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | problem-child | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies if one of the objects managed by this | | | supervisor has a problem or not. | |-------------|----------------------------------------------------------| | Value Type | Single values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | true | | | false | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | protected-attributes | |-------------|----------------------------------------------------------| | Type | Settable with the pdcreate or pdset commands. | |-------------|----------------------------------------------------------| | Explanation | Specifies one or more supervisor attributes that you do | | | not want HPDPS operators to set or change. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | One or more supervisor attribute names. | |-------------|----------------------------------------------------------| | Default | protected-attributes | |-------------|----------------------------------------------------------| | Usage | o Normally, anyone with DCE write permission for | | Guidelines | supervisor can set values for supervisor attributes. | | | By default, the pd_admin and pd_operator DCE groups | | | both have write permission. Once you define a | | | supervisor attribute as a protected attribute, DCE | | | delete permission is required to modify the | | | attribute. Members of the pd_operator DCE group do | | | not have delete permission unless modifications have | | | been made to the default permissions for that group. | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | security-level | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Identifies the security level for this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | The following value is the only supported value. | | | | | | medium | |-------------|----------------------------------------------------------| | Default | medium. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-hostname | |-------------|----------------------------------------------------------| | Input | hostname | | Synonym | | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Name of the host processor on which this supervisor is | | | running. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string up to 255 characters that contains the | | | name of the host on which this supervisor is running. | | | Implicitly set to the name of the host on which this | | | supervisor was created. | |-------------|----------------------------------------------------------| | Syntax | node.node.node | | | | | | For example: paper.endicott.jc.com | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-ip-address | |-------------|----------------------------------------------------------| | Input | ip-address, i-p-address | | Synonym | | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | The Internet Address of the host processor on which this | | | supervisor is running. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string that contains the Internet Address for | | | this supervisor. Implicitly set to the ip-address of | | | the host on which this supervisor was created. | |-------------|----------------------------------------------------------| | Syntax | nn.nn.nn.nn | | | Each integer can be from 0 to 255. | | | | | | For example: 15.1.1.1 | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-name | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Uniquely identifies this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | A text string up to 255 characters that contains the | | | name of this supervisor. Implicitly set from the name | | | specified by the startsuv utility when this supervisor | | | was created. | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-resource-context-printer | |-------------|----------------------------------------------------------| | Type | Settable with the pdset command. | |-------------|----------------------------------------------------------| | Explanation | Specifies the pathnames where printer model configuration| | | information reside. | |-------------|----------------------------------------------------------| | Value Type | Single Value | |-------------|----------------------------------------------------------| | Values | A text string up to 4095 characters that contains the | | | pathname(s). | |-------------|----------------------------------------------------------| | Default | /opt/pd/lib/model | |-------------|----------------------------------------------------------| | Usage | o The supervisor uses the value of this attribute to | | Guidelines | locate printer model information when creating a | | | physical printer object. | | | o Multiple paths are separated by a colon (":"). For | | | example, "/opt/pd/lib/model:/home/user/model". | | | The supervisor looks for printer model information | | | beneath each path in the order specified. | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-state | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the current state of this supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | One of the following fixed values: | | | | | | initializing | | | ready | | | terminating | | | unavailable | |-------------|----------------------------------------------------------| | Default | No default. | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | server-type | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the type of server, either spooler or | | | supervisor. | |-------------|----------------------------------------------------------| | Value Type | Single value. | |-------------|----------------------------------------------------------| | Values | The value is supervisor | |-------------|----------------------------------------------------------| | Default | supervisor | |-------------|----------------------------------------------------------| | Usage | | | Guidelines | | |-------------|----------------------------------------------------------| |-------------|----------------------------------------------------------| | Attribute | Description | |-------------|----------------------------------------------------------| | Name | transfer-methods-supported | |-------------|----------------------------------------------------------| | Type | Non Settable | |-------------|----------------------------------------------------------| | Explanation | Identifies the transfer-methods supported by this | | | supervisor. | |-------------|----------------------------------------------------------| | Value Type | Multiple values. | |-------------|----------------------------------------------------------| | Values | Any of the following fixed values: | | | | | | dce-pipe-pull | | | with-request | |-------------|----------------------------------------------------------| | Default | dce-pipe-pull | | | with-request | |-------------|----------------------------------------------------------| | Usage | o The document attribute transfer-method is compared | | Guidelines | to this attribute for validation and scheduling. | |-------------|----------------------------------------------------------|