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

PLIDUMP example

When you run the program shown in Figure 5, a formatted dump is produced as shown in Figure 6.

Figure 5. PL/I code that produces a formatted dump
  TestDump: proc options(main);
     declare
        Sysin input file,
        Sysprint stream print file;
     open file(Sysprint);
     open file(Sysin);
     put skip list('AbCdEfGhIjKlMnOpQrStUvWxYz');
     call IssueDump;

     IssueDump: proc;
        call plidump( ' ', 'Testing PLIDUMP');
     end IssueDump;

  end TestDump;

The call to PLIDUMP in the IssueDump procedure does not specify any PLIDUMP options (they appear as the first of the two character strings), so the defaults are used. Also note that the PL/I default files SYSIN and SYSPRINT have been explicitly opened so that the formatted dump displays the contents of their portions of the I/O buffer.

Figure 6. Example of PLIDUMP output
 1     * * * PLIDUMP * * *  Date = 910623  Time = 142249090                   Page 0001

 2   User identifier: Testing PLIDUMP


 3                                           * * * Calling trace * * *
     IBM0092I The PL/I PLIDUMP Service was called with Traceback (T) option
     At offset +00000024 in procedure with entry ISSUEDUMP
     From offset +0000010B in procedure with entry TESTDUMP
                                             * * * End of calling trace * * *

                                         * * * File Information * * *
                         Attributes of file SYSIN
 4   STREAM INPUT EXTERNAL
 5   ENVIRONMENT( CONSECUTIVE RECSIZE(80) LINESIZE(0) )
 6   I/O Built-in functions:  COUNT(0) ENDFILE(0)
 7   I/O Buffer:          000D9008  00000000 00000000 00000000 00000000   '................'
                          000D9018  00000000 00000000 00000000 00000000   '................'
                          000D9028  00000000 00000000 00000000 00000000   '................'
                          000D9038  00000000 00000000 00000000 00000000   '................'
                          000D9048  00000000 00000000 00000000 00000000   '................'
                          000D9058  0000                                  '..'

                         Attributes of file SYSPRINT
     STREAM OUTPUT PRINT EXTERNAL
     ENVIRONMENT( CONSECUTIVE RECSIZE(124) LINESIZE(120) PAGESIZE(60) )
     I/O Built-in functions:  PAGENO(1) COUNT(1) LINENO(1)
 8   I/O Buffer:          000D8008  20416243 64456647 68496A4B 6C4D6E4F   ' AbCdEfGhIjKlMnO'
                          000D8018  70517253 74557657 78597A20 0D0A0000   'pQrStUvWxYz ....'
                          000D8028  00000000 00000000 00000000 00000000   '................'
                          000D8038  00000000 00000000 00000000 00000000   '................'
                          000D8048  00000000 00000000 00000000 00000000   '................'
                          000D8058  00000000 00000000 00000000 00000000   '................'
                          000D8068  00000000 00000000 00000000 00000000   '................'
                          000D8078  00000000 00000000 00000000            '............'

                                     * * * End of File Information * * *
                                           * * * End of Dump * * * * * *

 1 
Time and date when PLIDUMP is called. Each separate PLIDUMP call has this information.
 2 
Character string specified in the PLIDUMP call (the second of the two strings provided to PLIDUMP) that is useful in helping to identify the dump if a number of dumps are produced.
 3 
Trace information, delineated by * * * Calling trace * * * and * * * End of calling trace * * *. This information allows you to trace back through the procedures from which PLIDUMP was called. In the example above, PLIDUMP was called from the procedure ISSUEDUMP which is nested in the TESTDUMP procedure. The hexadecimal offsets of each procedure are also provided in the trace information.

The trace information is provided by default as the T option and can be suppressed by specifying the NT option for PLIDUMP.

 4 
File attributes of SYSIN (opened explicitly in the program).
 5 
ENVIRONMENT options for the file SYSIN.
 6 
Values of relevant I/O built-in functions for the file SYSIN.
 7 
Contents of the I/O buffer for the SYSIN file. The first column is the hexadecimal address, the following columns are the hexadecimal contents of memory.
 8 
Contents of the I/O buffer for SYSPRINT. Notice that the second character string supplied to PLIDUMP (AbCd...) is contained in the I/O buffer, as seen by the text representation of the I/O buffer at the right-hand side of the row.
Rational Developer for System z
PL/I for Windows, Version 8.0, Programming Guide