CCTL-initiated DRA function requests

Certain requests are available to the CCTL that allow it to communicate with DBCTL. For all DRA requests, there are PAPL fields that the CCTL must fill in. The PAPLUSER field is a field to be used at the CCTL's discretion. One possible use for it is to pass data to exit routines.

This topic contains General-use Programming Interface information.

For all DRA requests, there are PAPL fields that the CCTL must fill in. When the DRA completes the request, there are some output PAPL fields that the DRA fills in. Some fields in the returned PAPL might contain the original input value.

(The PAPLTTOK and PAPLUSER fields retain the original input values.)

The PAPLUSER field is a field to be used at the CCTL's discretion. One possible use for it is to pass data to exit routines.

The DRA returns a code (in the PAPLRETC field) to the CCTL after processing a DRA request. The code indicates the status of the request and can be either an IMS code, a DRA code, or a z/OS® code. Failed DRA requests return a nonzero value in the PAPLRETC field.

To use the default Suspend exit routine and Resume exit routine, each DRA request must have the field PAPLTECB set with the address of a CCTL ECB to be used if the thread is waited or posted. If your CCTL does not provide Suspend and Resume exit routines, the DRA default exit routines will be used.