Checking for Spooler Errors

This topic describes the use of English to look at spooler error records in the SYSTEM-LOG file.

Checking for Spooler Errors

If errors occur during the execution of a Despooler, the Spooler records these errors in the SYSTEM-LOG file.

To display information about Despooler errors, you can display an English list of the SYSTEM-LOG file using the DSP.ERRORS or DSP.DETAIL macros.

Syntax

LIST SYSTEM-LOG DSP.ERRORS {DSP.DETAIL} {(options}

Command class

English

Syntax elements

DSP.ERRORS A macro that generates a general report of Despooler errors.

DSP.DETAIL A macro that generates a detailed report of Despooler errors.

Options

N No page.  Suppress automatic paging.

P Printer.  Send output to printer assigned to your port.

General report headings

Heading	Description
DATE	Date the error was recorded.
Time	Time the error was recorded.
Err	Error number. The ERRORS item in the file SPOOLER.MSGS (SYSFILES account) contains the messages associated with these error numbers.
Dsplr iid	Despooler item-id.
Port#	Number of port that requested output.
Que iid	Name of the form queue the Despooler was working with.
Job iid	Job-id of the job the Despooler was outputting.
Str 1	Yes if there is a string; otherwise, No.
Str 2	Yes if there is a string; otherwise, No.

Detailed report headings

The detailed report is listed vertically because of the large number and sizes of the fields.  In addition to the general report headings, the detailed report uses the following headings:

Heading	Description
Dsp sts	Despooler status.
Que sts	Form queue status.
Job sts	Job status.
RtnStk	Contents of the system return stack.
String 1	If a string is displayed, it is diagnostic information for support personnel.
String 2	If a string is displayed, it is diagnostic information for support personnel.
Error	The error text corresponding to the Despooler error.

For an explanation of the values in the status columns, refer to Status Conditions and Values.