NAME
pd_att_log — list of attributes for an HPDPS log object
DESCRIPTION
The following is a list of valid attributes and values for the log object
class of the HP Distributed Print Service.
Log objects are automatically created when the server is initialized.
These logs contain and keep track of such things as error messages and
trace messages. These logs cannot be created or deleted, but they can be
enabled or disabled. A configuration file can be used to set the initial
values of attributes for error and trace logs when servers are
initialized.
The following are restrictions for log attributes:
The
log-severity
attribute is an attribute only for error logs.
The
log-trace-groups
attribute is an attribute only for trace
logs.
TP
•
The values for the attributes listed below cannot be set with the
pdset command for trace logs. Values can be specified using
configuration files during server initialization.
- log-address
- log-size
- log-wrap
Attributes for a Log Object
|------------------------------------------------------------------------|
| Settable Attribute Listing | Specifiable Attribute Listing |
|------------------------------------|-----------------------------------|
| descriptor | log-type |
| list-of-managers | |
| log-address | |
| log-severity | |
| log-size | |
| log-trace-groups | |
| log-wrap | |
| message | |
|------------------------------------------------------------------------|
|------------------------------------------------------------------------|
| Table 1-1. Log Attributes |
|------------------------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | associated-server |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Indicates the name of the server in which this log |
| | resides. |
|------------|-----------------------------------------------------------|
| Value Type | Single value. |
|------------|-----------------------------------------------------------|
| Values | The name of the server; set by HPDPS when this log is |
| | created. |
|------------|-----------------------------------------------------------|
| Default | No default. |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | descriptor |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command. |
|------------|-----------------------------------------------------------|
| Explanation| Provides a description of the object. |
|------------|-----------------------------------------------------------|
| Value Type | Single value. |
|------------|-----------------------------------------------------------|
| Values | A text string up to 4095 characters that describes this |
| | log. |
|------------|-----------------------------------------------------------|
| Default | If trace log: This is the standard trace log. |
| | |
| | If error log: This is the standard error log. |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | enabled |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Indicates if the log is enabled. An enabled log writes |
| | messages to a log file. |
|------------|-----------------------------------------------------------|
| Value Type | Single value. |
|------------|-----------------------------------------------------------|
| Values | One of the following fixed values: |
| | |
| | Fixed Value Input Synonym |
| | true yes |
| | false no |
|------------|-----------------------------------------------------------|
| Default | If error log: true |
| | |
| | If trace log: false |
|------------|-----------------------------------------------------------|
| Usage | o Implicitly set by the pdenable and pddisable |
| Guidelines | commands. |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | list-of-managers |
|------------|-----------------------------------------------------------|
| Input | managers |
| Synonym | |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command. |
|------------|-----------------------------------------------------------|
| Explanation| Lists the people responsible for the maintenance and |
| | operation of this log. |
|------------|-----------------------------------------------------------|
| Value Type | Multiple value. |
|------------|-----------------------------------------------------------|
| Values | A text string up to 255 characters per person that |
| | contains the user ID of the person responsible for this |
| | log. |
|------------|-----------------------------------------------------------|
| Default | No default |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-address |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the pathname where the log resides. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | A text string up to 4095 characters that contains the |
| | pathname. |
|------------|-----------------------------------------------------------|
| Default | The path defined by the PDBASE environment variable plus |
| | the ServerName ($PDBASE/ServerName). |
|------------|-----------------------------------------------------------|
| Usage | o This attribute defines only the path. |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-identifier |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Uniquely identifies this log. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | A text string up to 255 characters set by HPDPS that |
| | contains the file name of this log. |
|------------|-----------------------------------------------------------|
| Default | If trace log: default_tracelog |
| | If error log: default_errorlog |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-severity |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command. |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the severity level of the messages that are to |
| | be logged in this error log. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | One of the following fixed values: |
| | |
| | error |
| | warning |
| | audit |
| | debug |
| | info |
|------------|-----------------------------------------------------------|
| Default | audit |
|------------|-----------------------------------------------------------|
| Usage | o This attribute is only for error logs. |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-size |
|------------|-----------------------------------------------------------|
| Type | Non Settable for trace logs. |
| | |
| | Settable with the pdset for error logs. |
|------------|-----------------------------------------------------------|
| Explanation| Specifies how large (kilobytes) a log file is allowed to |
| | get before the file wraps, or the logging of events is |
| | halted. Whether a log file wraps or logging is halted is |
| | determined by the value of the attribute log-wrap. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | An integer from 1 to 2147483647 (value represents |
| | kilobytes) |
|------------|-----------------------------------------------------------|
| Default | If error log: 1024 |
| | If trace log: 8192 |
|------------|-----------------------------------------------------------|
| Usage | o The value specified in the configuration file, if one |
| Guidelines | is specified, will override the default value when |
| | the server is created. |
| | o If this attribute is changed, the current log file is |
| | renamed to error.log.BAK, and a new log file is |
| | created. |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-trace-groups |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command. |
|------------|-----------------------------------------------------------|
| Explanation| Specifies the active trace groups for the selective |
| | tracing of HPDPS component groups. |
|------------|-----------------------------------------------------------|
| Value Type | Multiple values. |
|------------|-----------------------------------------------------------|
| Values | Any text string up to 4095 characters that contains trace |
| | group IDs that are to be traced. |
|------------|-----------------------------------------------------------|
| Default | ???? -1 (Meaning all trace groups) |
|------------|-----------------------------------------------------------|
| Usage | o This attribute is only for trace logs and is only to |
| Guidelines | be used at the request of an HP Service |
| | Representative. |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-type |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the type of log. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | One of the following fixed values: |
| | |
| | errorlog |
| | tracelog |
|------------|-----------------------------------------------------------|
| Default | No default. |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | log-wrap |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command for error logs. |
|------------|-----------------------------------------------------------|
| Explanation| Specifies whether the log file should wrap or halt when |
| | the specified value in the log-size attribute is reached. |
|------------|-----------------------------------------------------------|
| Value Type | Single Value |
|------------|-----------------------------------------------------------|
| Values | One of the following fixed values: |
| | |
| | Fixed Value Input Synonym |
| | true yes |
| | false no |
|------------|-----------------------------------------------------------|
| Default | true |
|------------|-----------------------------------------------------------|
| Usage | o The value specified in the configuration file, if one |
| Guidelines | is specified, will override the default value when |
| | the server is created. |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | message |
|------------|-----------------------------------------------------------|
| Type | Settable with the pdset command. |
|------------|-----------------------------------------------------------|
| Explanation| Provides a message that is associated with this log |
| | object. |
|------------|-----------------------------------------------------------|
| Value Type | Single value. |
|------------|-----------------------------------------------------------|
| Values | A text string up to 4095 characters that contains |
| | information about this log. |
|------------|-----------------------------------------------------------|
| Default | No default. |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
|------------|-----------------------------------------------------------|
| Attribute | Description |
|------------|-----------------------------------------------------------|
| Name | object-class |
|------------|-----------------------------------------------------------|
| Type | Non Settable |
|------------|-----------------------------------------------------------|
| Explanation| Identifies the object class to which this object belongs. |
|------------|-----------------------------------------------------------|
| Value Type | Single value. |
|------------|-----------------------------------------------------------|
| Values | The value of this attribute is log. |
|------------|-----------------------------------------------------------|
| Default | log |
|------------|-----------------------------------------------------------|
| Usage | |
| Guidelines | |
|------------|-----------------------------------------------------------|
