Spool File Attributes

The Spool File attribute group contains attributes that you can use to monitor the spool and jobs in the spool. Coding the following compare values reduces the amount of data IBM Tivoli Monitoring for i5/OS has to handle (improving performance).

Certain circumstances (especially on large systems), failing to specify one or more of these attributes may overload IBM Tivoli Monitoring for i5/OS. The result is that IBM Tivoli Monitoring for i5/OS will not evaluate the situation. In this case, you are notified by a message in the IBM Tivoli Monitoring message log that the situation did not evaluate. To view the IBM Tivoli Monitoring message log, use the DSPOMALOG command.


Copies The remaining number of copies to be produced on the printer. The page number may be lower or higher than the page number actually being printed because of buffering done by the system. The valid value is an integer in the range 0 through 255. The attribute can be used with the *AVG, *MAX, *MIN, and *SUM functions.

Current Page The page number or record number currently being written. The page number may be lower or higher than the page number actually being printed because of buffering done by the system. The valid value is an integer in the range 0 through 1000000. The attribute can be used with the *AVG, *MAX, *MIN, and *SUM functions. The page number shown may be zero if these conditions exits.

Date and Time The date and time that the file was opened. The valid value is a date and time in the format CYYMMDDHHmmSSmmm; for example, 0961002103000000 indicates a century bit of 0, a date of October 2, 1996, and a time of 10:30:00:000.

Device The name of the device file used to create the spooled file. The valid value is an alphanumeric string with a maximum 10 characters.

Form Type The type of form to be loaded in the printer to print this file. The valid value is an alphanumeric string with a maximum of 10 characters.

Job Name The name of the job that created the spooled file. The valid value is an alphanumeric string with a maximum of 10 characters.

Job Number The number of the job that created the spooled file. The valid value is an alphanumeric string with a maximum of 6 characters. The attribute can be used with the *AVG, *MAX, *MIN, and *SUM functions.

Job User The name of the user that created the spooled file. The valid value is an alphanumeric string with a maximum of 10 characters.

ORIGINNODE The host name for the monitored system. The valid value is an alphanumeric string with a maximum length of 64 characters.

Output Queue Name The name of the output queue where the file is located. The valid value is an alphanumeric string with a maximum of 10 characters.

Output Queue Library The name of the library that contains the output queue. The valid value is an alphanumeric string with a maximum of 10 characters.

Page The number of pages this printer file contains. The valid value is an integer in the range 0 through 1000000. The attribute can be used with the *AVG, *MAX, *MIN, and *SUM functions.

Priority The priority of the spooled file (or importance of printing order). The valid value is an integer in the range 1 (highest priority) to 9 (lowest priority).

Status Indicates the status of the file. The valid values include:

*CLOSED

The program completely processed the file but SCHEDULE(*JOBEND) was specified and the job that produced the file has not yet finished.

*HELD

The file is held.

*MESSAGE

The file has a message requiring a reply or an action.

*OPEN

The file was not completely processed and is not ready for a writer.

*PENDING

The file is waiting to be printed.

*PRINTER

The complete file was sent to the printer but a print complete status was not sent back.

*READY

The file is available to be written.

*SAVED

The file was written and is saved. This file remains saved until it is released.

*WRITING

The writer is writing the file on a diskette or a printer device.

Time The time that the file was opened. The valid value is a time in the format HHMMSS; for example, 102000 indicates a time of 10:30:00 a.m.

User Data The ten characters of user-specified data that describes the file. The valid value is an alphanumeric string with a maximum of 10 characters.