Formatted PL/I dumps--PLIDUMP
You use PLIDUMP to obtain:
- Trace information that allows you to locate the point-of-origin
of a condition in your source program.
- File information, including: the attributes of the files open
at the time of the dump, the values of certain file-handling built-in
functions, and the contents of the I/O storage buffer.
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.