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:
- The IMS internal function that was being performed.
- Use only the trace entries with the correct PST number.
- Shows how the call completed. (X'00' means successful completion.)
- Shows where the requested data is located in core only if the call completed successfully.
- 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).