X'CA' trace entry

The X'CA' trace entry is shown.

The X'CA' trace entry

 TRACE ID   = X'CA' 
 
       word 0 — byte 1 - X'CA' - Exclusive control ENQ/DEQ (PI - Program
                             Isolation) trace entry
                byte 2 - PST number (see note 1 below)
                bytes 3-4 - Trace sequence number               
       word 1 — byte 1 - Record type (see note 8 below)
                byte 2 - Class for Q command operation
                byte 3 - Requested function (Use PRM DSECT (PRMFNCTN) - see 
                         note 2 below)
                byte 4 - PRMLEVEL - Level of control requested
                         (1 =Read only, 2=Share, 3=Update, 
                         4=Exclusive - see note 3 below)                           
       word 2 - bytes 1-2 - Wait count (how many times this task had to
                            wait - see note 7 below)
                bytes 2-4 - Waited for count (number of tasks waiting for this
                            resource)
       word 3 - PITIME relative to 00:00:00 on PIDATE (SCDPITIME)
       word 4 - bytes 1-2 - Feedback from DFSFXC10 (Use PRM DSECT, PRMFBK 
                            field.  See note 5 below)
                byte 3 - Return code from DFSFXC10 (see note 6 below)
                byte 4 - PSFUNCT (function codes DSECT)
       word 5 - Token from DFSFXC10 (pointer to control block enqueued resource)
       word 6 - RBA or RBN (see note 4 below)
       word 7 - bytes 1-2 - DMB number
                byte 3 - DCB number
                byte 4 - Not used

Notes:

Use the entries for the PST in question. If you are checking a PI problem, you might have to find this entry and then scan up the trace table using the field in note 4 (below) as a search field to find the other PST that is using the resources.
The requested PI function.
The level at which the resource was requested.
The RBA or RBN of the resource requested by PI (relates to X'04' in the X'CC' trace entry).
The 2 bytes of feedback from DFSFXC10 (X'0C' and X'0D' in PRM DSECT).
The return code. DFSFXC10 RETURN CODES: 0 - Successful 4 - Wait required - usually has CB trace related to it 8 - Pseudoabend, either lost deadlock (U0777) or out of ENQ/DEQ space (U0775) C - Invalid call
If a resource (RBA or RBN) is currently owned and the task (PST) must wait, the wait count (2 bytes) is incremented in a X'CA' trace entry for the task (PST) that owns the resource. The waited for count (2 bytes) is incremented to show that another task is waiting for the resource. This wait should also cause a X'CA', X'CB' pair of trace entries to show the wait occurred. (See the X'CB' trace entry for more details on PI waits.)
This shows the type of X'CA' record this is. (X'CA-08' trace entry follows.)

X'00'

Standard trace PI record

X'01'

Timing ACT/ENQ wait - may have CB trace entry associated with it

X'04'

Lock MGR trace record

X'08'

DL/I call record - see X'CA' - X'08' trace entry