DBCTL DRA return codes

Unlike a CCTL, the ODBA interface does not use the PAPL parameter list. The ODBA interface uses the AERTDLI interface to communicate its requests to the DRA. Therefore, this information does not apply when ODBA is used. For information about using ODBA, see Writing ODBA application programs.

The coordinator controller initiates a request to connect to the Database Control Subsystem (DBCTL). The Database Resource Adapter (DRA) establishes and maintains the connection to DBCTL and handles all communication between the CCTL and DBCTL. Once the connection has been established, the DRA is ready to process requests from the CCTL for DBCTL services. The CCTL uses a parameter list called the DFSPAPL to communicate its requests to the DRA. (For the layout of DFSPAPL, see Problem diagnosis.) DBCTL responds to requests from the CCTL with a code in field PAPLRETC of DFSPAPL that tells whether the request was successfully completed. The format of PAPLRETC is hhsssuuu, where hh indicates a system abend, IMS abend, or DBCTL return code.

hh

Meaning

80

Either a system abend code or an IMS abend code was returned: sss contains the system abend code and uuu contains the IMS abend code (in hexadecimal). Either sss or uuu contains a code; the other field contains zeros. For an explanation of system abend codes, see z/OS® MVS™ System Codes.

For system or IMS abend codes, DBCTL typically dumps (SDUMP or SNAP) storage for diagnosis. However, if DBCTL determines that a dump (SDUMP or SNAP) is not necessary, it sets hh to X'88'. But if a SNAP (not an SDUMP) is wanted, then it sets hh to X'84'. For more information about DRA dumps, see IMS system definition information.

When a Fast Path prepare call fails, DBCTL returns a status code in field PAPLSTCD in addition to the IMS abend code 35 in PAPLRETC.

00

A hexadecimal DBCTL return code was returned in field uuu.

For more information about DBCTL DRA codes, see the following information: