PIMSG

Specifies whether you want PSF messages printed and also specifies the maximum number of errors that can occur before printing is stopped. PSF messages have these characteristics:

• A primary message and possibly other, associated environmental messages are generated for an error.
• A group of messages is generated for an error that stops a process. For example, the messages for an I/O error contain:
  • A message identifier and the I/O error description
  • Additional message identifiers with their descriptions of the environment in which the error occurred
• Message groups are separated with a blank line in the printed output.

You can specify the PIMSG parameter in an OUTPUT statement, as follows:

PIMSG=YES | NO | (YES,nnn) | (NO,nnn) | (,nnn)

The values are:

Y or YES

Specifies that all message groups generated in the processing of a data set are to be printed at the end of the data set, preceding any trailer pages. If a data set is left incomplete because of an error, message groups generated up to this error are printed, including the message group describing the error that stops processing the data set. YES is the default.

N or NO

Specifies that no message groups are to be printed unless an error occurs that forces printing to stop prematurely. If that happens, only the message group describing the error that stops processing is printed.

nnn

Specifies that PSF is to stop processing the data set after nnn message groups are generated. The default value is 16. The final count of printed messages might be larger than nnn if errors are reported for pages sent to the printer before the message count is reached. A value of 0 for nnn allows printing of the data set to continue regardless of the number of message groups generated, unless an error that stops processing occurs.

If PIMSG is not specified, the default is either:

• If a default is defined in the PSF startup procedure, PSF uses it. For the "Page-Printer Defaults" form used to record the system defaults, see Page-printer defaults form.
• If a default is not defined in the PSF startup procedure, PSF uses PIMSG=(YES,16).

See Specifying whether you want error messages to be printed for examples of using the PIMSG parameter.