Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

Using PLIDUMP

PLIDUMP usage notes
Locating variables in the PLIDUMP output
Locating AUTOMATIC variables
Locating STATIC variables
Locating CONTROLLED variables
Under NORENT WRITABLE
Under NORENT NOWRITABLE(FWS)
Under NORENT NOWRITABLE(PRV)
Saved Compilation Data
Timestamp
Saved options string

This section provides information about dump options and the syntax used to call PLIDUMP, and describes PL/I-specific information included in the dump that can help you debug your routine.

Note:
PLIDUMP conforms to National Language Support standards.

Figure 100 shows an example of a PL/I routine calling PLIDUMP to produce a z/OS Language Environment dump. In this example, the main routine PLIDMP calls PLIDMPA, which then calls PLIDMPB. The call to PLIDUMP is made in routine PLIDMPB.

Figure 100. Example PL/I routine calling PLIDUMP
%PROCESS MAP GOSTMT SOURCE STG LIST OFFSET LC(101);
 PLIDMP: PROC  OPTIONS(MAIN) ;

   Declare   (H,I) Fixed bin(31) Auto;
   Declare   Names Char(17) Static init('Bob Teri Bo Jason');
   H = 5;  I = 9;
   Put skip list('PLIDMP Starting');
   Call PLIDMPA;

     PLIDMPA:  PROC;
       Declare  (a,b)  Fixed bin(31)   Auto;
       a = 1;  b = 3;
       Put skip list('PLIDMPA Starting');
       Call PLIDMPB;

         PLIDMPB:  PROC;
           Declare  1 Name  auto,
                      2  First   Char(12) Varying,
                      2  Last    Char(12) Varying;
           First = 'Teri';
           Last  = 'Gillispy';
           Put skip list('PLIDMPB Starting');
           Call PLIDUMP('TBFC','PLIDUMP called from procedure PLIDMPB');
           Put Data;
         End PLIDMPB;

     End PLIDMPA;

 End PLIDMP;

The syntax and options for PLIDUMP are shown below.

Read syntax diagramSkip visual syntax diagram>>-PLIDUMP------------------------------------------------------>
 
>--(character-string-expression 1,character-string-expression 2)-><
 

character-string-expression 1
is a dump options character string consisting of one or more of the following:
A
Requests information relevant to all tasks in a multitasking program.
B
BLOCKS (PL/I hexadecimal dump).
C
Continue. The routine continues after the dump.
E
Exit from current task of a multitasking program. Program continues to run after requested dump is completed.
F
FILES.
H
STORAGE.

This includes all Language Environment storage, and hence all the BASED and CONTROLLED storage acquired via ALLOCATE statements.

Note:
A ddname of CEESNAP should be specified with the H option to produce a SNAP dump of a PL/I routine, but if this is omitted, Language Environment will issue a message but still produce a dump with much very useful information.
K
BLOCKS (when running under CICS). The Transaction Work Area is included.
NB
NOBLOCKS.
NF
NOFILES.
NH
NOSTORAGE.
NK
NOBLOCKS (when running under CICS).
NT
NOTRACEBACK.
O
Only information relevant to the current task in a multitasking program.
S
Stop. The enclave is terminated with a dump.
T
TRACEBACK.
T, F, and C are the default options.
character-string-expression 2
is a user-identified character string up to 80 characters long that is printed as the dump header.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)