PLIDUMP calls intermediate PL/I for MVS™ & VM library routines, which convert most PLIDUMP options to CEE3DMP options. The following list contains PLIDUMP options and the corresponding CEE3DMP option, if applicable.
Some PLIDUMP options do not have corresponding CEE3DMP options, but continue to function as PL/I for MVS & VM default options. The list following the syntax diagram provides a description of those options.
PLIDUMP now conforms to National Language Support standards.
PLIDUMP can supply information across multiple Language Environment® enclaves. If an application running in one enclave fetches a main procedure (an action that creates another enclave), PLIDUMP contains information about both procedures.
The syntax and options for PLIDUMP are shown below.
Syntax >>-PLIDUMP--(--char.-string-exp 1--,--char.-string-exp 2--)----><
- char.-string-exp 1
- A dump options character string consisting of one or more of the
following values. T, F, C, and A are the default options.
- A
- All. Results in a dump of all tasks including the ones in the WAIT state.
- B
- BLOCKS (PL/I for MVS & VM hexadecimal dump). Dumps the control blocks used in Language Environment and member language libraries. For PL/I for MVS & VM, this includes the DSA for every routine on the call chain and PL/I for MVS & VM "global" control blocks, such as Tasking Implementation Appendage (TIA), Task Communication Area (TCA), and the PL/I Tasking Control Block (PTCB). PL/I file control blocks and file buffers are also dumped if the F option is specified.
- C
- Continue. The routine continues after the dump.
- E
- Exit. The enclave terminates after the dump. In a multitasking environment, if PLIDUMP is called from the main task, the enclave terminates after the dump. If PLIDUMP is called from a subtask, the subtask and any subsequent tasks created from the subtask terminate after the dump. In a multithreaded environment, if PLIDUMP is called from the Initial Process Thread (IPT), the enclave terminates after the dump. If PLIDUMP is called from a non-IPT, only the non-IPT terminates after the dump.
- F
- FILE INFORMATION. A set of attributes for all open files is given. The contents of the file buffers are displayed if the B option is specified.
- H
- STORAGE in hexadecimal. A SNAP dump of the region is produced. A ddname of CEESNAP must be provided to direct the CEESNAP dump report.
- K
- BLOCKS (when running under CICS®).
The Transaction Work Area is included. Note: This option is not supported under Enterprise PL/I.
- NB
- NOBLOCKS.
- NF
- NOFILES.
- NH
- NOSTORAGE.
- NK
- NOBLOCKS (when running under CICS).
- NT
- NOTRACEBACK.
- O
- THREAD(CURRENT). Results in a dump of only the current task or current thread (the invoker of PLIDUMP).
- S
- Stop. The enclave terminates after the dump. In a multitasking environment, regardless of whether PLIDUMP is called from the main task or a subtask, the enclave terminates after the dump. In a multithreaded environment, regardless of whether PLIDUMP is called from the IPT or a non-IPT, the enclave terminates after the dump (in which case there is no fixed order as to which thread terminates first).
- T
- TRACEBACK. Includes a traceback of all routines on the call chain. The traceback shows transfers of control from either calls or exceptions. BEGIN blocks and ON-units are also control transfers and are included in the trace. The traceback extends backwards to the main program of the current thread.
- char.-string-exp 2
- A user-identified character string up to 80 characters long that is printed as the dump header.