X'DB' through X'FA' trace entry

The X'DB' through X'FA' trace entries are shown.

The X'DB' through X'FA' trace entries

 TRACE ID   = X'DB' - X'FA'
 
       word 0 — byte 1 - X'DB' through X'FA'PSTFNCTN - Buffer handler trace - 
                         This is the function
                         from X'DB' thru X'FA' for which the trace
                         was written (see note 1 below).
                byte 2 - PST number (see note 2 below)
                bytes 3-4 - Trace sequence number               
       word 1 - bytes 1-2 - PSTDMBNM - DMB number.  This field
                            indicates which DMB is being used.  
                            The DMB directory (DDIR) gives the 
                            first DMB.
                byte 3 - PSTDCBNM - DCB number
                byte 4 - PSTRTCDE - Usually
                         indicates an error if nonzero.  If an error,
                         PSTDATA may contain residual data from the 
                         last call (see note 3 below)
       word 2 - byte 1 - PSTTRMID - ID of the module calling the buffer 
                         handler
                byte 2 - PSTTRMSC - Subcode of the module calling the
                         buffer handler
                byte 3 - PSTBHFLG - DL/I buffer handler flags
                byte 4 - PSTSUBCD - Buffer handler internal work byte
       word 3 - PSTDSGA - Address of the DSG 
       word 4 - PSTDATA - Address in real storage of the requested data.
                May point to the last retrieved data address in a call 
                (failed abend) (see note 4 below).
       word 5 - PSTBUFFA - Address of buffer header.  OSAM uses IBFPRF 
                DSECT.  VSAM uses IDABUFC DSECT.
       word 6 - PSTISAMW - Work area
       word 7 - PSTBYTNM - Relative byte number of data or 
                block number (see note 5 below).
      
Notes:
  1. The IMS internal function that was being performed.
  2. Use only the trace entries with the correct PST number.
  3. Shows how the call completed. (X'00' means successful completion.)
  4. Shows where the requested data is located in core only if the call completed successfully.
  5. The RBA or block number that the call requested.

    If the call failed, the PSTDATA field might contain the address of the last segment successfully retrieved.

    Example: PSTRTCDE = X'04' (RBA past end of data set).