PAPL request and return codes
The trace examples given contain a number of 4-digit hexadecimal request codes issued by the participant adapter parameter list (PAPL). These request codes are a concatenation of a 2-digit PAPL function code and a 2-digit PAPL subfunction code. For further guidance on the contents of the PAPL, see the appropriate Exit routines in IMS product documentation.
Table 1 summarizes the PAPL request codes that are sent from CICS® to the DRA, and are displayed in CICS trace output as 4-digit request codes. See Trace entries produced by CICS for examples of traces containing these request codes.
| Event | Request code |
|---|---|
| Connection | 0100 |
| Disconnection | 0400 |
| Disconnection due to CICS failure | 0404 |
| PSB schedule | 0301 |
| DL/I request | 0303 |
| COMMIT request | 0307 |
| PREPARE request | 0304 |
| Single-phase SYNCPOINT request | 030A |
| ABORT request | 030D |
| Terminate thread | 030F |
| COMMIT request during resynchronization | 0201 |
| ABORT request during resynchronization | 0202 |
| Lost because CICS was initial started before resynchronization | 0203 |
| DBCTL should not be indoubt | 0204 |
Table 2 summarizes the PAPL return codes that are sent from the DRA to CICS. CICS intercepts these return codes and displays them as explanatory text in trace output.
| Event | Return code |
|---|---|
| Connection complete | 0500 |
| Identify failure | 0501 |
| Connection request (DRA INIT) canceled in reply to DFS690 message | 0502 |
| DBCTL has terminated abnormally | 0503 |
| The DRA has terminated abnormally | 0504 |
| /CHECKPOINT FREEZE or /CHECKPOINT PURGE command was issued to terminate DBCTL normally | 0505 |