Specifying whether you want error messages to be printed
The PIMSG parameter specifies whether you want error messages to
be printed and also specifies the maximum number of errors that can
occur before printing is stopped (see PIMSG). The
PIMSG count applies only to errors that would not, in themselves,
cause the data set to stop printing. Data set printing is always stopped
if an error occurs that stops processing, regardless of the setting
of PIMSG.
Values for the PIMSG parameter are assigned in the PSF startup
procedure. To override these values, code the PIMSG parameter in the
JCL for your print job.
Examples:
- The first example specifies that all error messages are to be
printed and that printing is to be stopped after 10 errors occur.
//OUT1 OUTPUT PIMSG=(YES,10)
//DD1 DD SYSOUT=A,OUTPUT=*.OUT1
- For this example, the system does not print messages unless an
error occurs that stops printing, and then prints only the message
group caused by that error. The PIMSG count, which is not coded, defaults
to 16. If 16 errors that do not stop processing occur, printing
is stopped because the PIMSG count was exceeded. The only message
group printed indicates that PIMSG count was exceeded.
//OUT2 OUTPUT PIMSG=NO
//DD2 DD SYSOUT=A,OUTPUT=*.OUT2
- This example sets the PIMSG count to zero and specifies that no
messages are to be printed unless an error that stops processing occurs,
so that the data set continues to print regardless of how many errors
that do not stop processing occur. If an error that stops processing
occurs, PSF prints the message group caused by that error.
//OUT3 OUTPUT PIMSG=(NO,0)
//DD3 DD SYSOUT=A,OUTPUT=*.OUT3
PSF issues messages to one or more of these destinations, depending
on which is the most appropriate:
- Operator’s console
- Messages that the operator or system programmer must address.
- Security administrator’s console
- Messages reporting security violations or errors in the processing
of security functions.
- Job submitter’s console
- Messages reporting the completion of a job or its failure to
print.
- In the printed output
- Messages reporting the position from which data is retransmitted
during a recovery.
- Following the printed output or elsewhere
- Messages describing data stream errors. Also, a duplicate copy
of any message issued within the printed output.
Note:
Your system programmer might redirect
the messages associated with your print job. Consult your programmer
to determine where the messages for your job are sent.
|
PSF for z/OS: User's Guide
Copyright IBM Corporation 1990, 2014