Rational Developer for System z
PL/I for Windows, Version 8.0, Programming Guide

Formatted PL/I dumps--PLIDUMP

You use PLIDUMP to obtain:

To get a formatted PL/I dump, you must include a call to PLIDUMP in your program. The statement CALL PLIDUMP can appear wherever a CALL statement appears. It has the following form:

  call plidump('dump options string', 'dump title string');
dump options string
An expression specifying a string consisting of any of the following dump option characters:
T-Trace
PL/I generates a calling trace.
NT-No trace
The dump does not give a calling trace.
F-File information
The dump gives a complete set of attributes for all open files, plus the contents of all accessible I/O buffers.
NF-No file information
The dump does not give file information.
S-Stop
The program ends after the dump.
E-Exit
The current thread or the program (if it is the main thread) ends after the dump.
K
Ignored.
NK
Ignored.
C-Continue
The program continues after the dump.

PL/I reads options from left to right. It ignores invalid options and, if contradictory options exist, takes the rightmost options.

dump title string
An expression that is converted to character if necessary and printed as a header on the dump. The string has no practical length limit. PL/I prints this string as a header to the dump. If the character string is omitted, PL/I does not print a header.

If the program calls PLIDUMP a number of times, the program should use a different user-identifier character string on each occasion. This simplifies identifying the point at which each dump occurs. In addition to this header, each new invocation of PLIDUMP prints another heading above the user-identifier showing the date, time, and page number 1.

Rational Developer for System z
PL/I for Windows, Version 8.0, Programming Guide