PREP request

You can use the PREP request to make a phase 1 sync-point request to ask IMS DB if it is ready to commit this UOR.

You must fill in the following input fields of the PAPL:

Field
Contents
PAPLFUNC
PAPLTFUN
PAPLSFNC
PAPLPREP, sync-point prepare subfunction code
PAPLCTOK
DRA request token (output from an INIT request)
PAPLCTK2
Thread Token number 2. This is the DRA request token which is output from a SCHED request.
PAPLTTOK
The thread token set up by the CCTL
PAPLRTOK
A 16-byte UOR token (RTOKEN).
PAPLSDPL
A one-bit flag. Set this bit to 1 to indicate to IMS that this thread is part of a distributed unit of work.

In addition to the required input parameters, the optional input parameters include:

Field
Contents
PAPLTECB
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.

The following are output fields that are returned in the PAPL to the:

Field
Contents
PAPLRETC
Code returned
PAPLSTCD
Fast Path status code

If the value in the PAPLRETC field is decimal 35, the PAPLSTCD field contains a status code that further describes the error.