Program control
The program control program, DFHPCP, is an interface routine which supports DFHPC LINK, ABEND, SETXIT and RESETXIT calls issued in other CICS® modules and invokes the appropriate program manager domain function.
Design overview: Services in response to requests
The following services are performed by DFHPCP in response to DFHPC requests from other CICS functions, where
those functions have not been converted to use domain interfaces:
- Link (LINK)
- Builds a parameter list and issues DFHPGLK FUNCTION(LINK) domain call.
- Handle Abend (SETXIT)
- If SETXIT macro specifies an abend routine address, then DFHPCP builds a parameter list and issues a DFHPGHM FUNCTION(SET_ABEND) OPERATION(HANDLE) call. If SETXIT macro does not specify an abend routine address, then DFHPCP builds a parameter list and issues a DFHPGHM FUNCTION(SET_ABEND) OPERATION(CANCEL) call.
- RESETXIT
- DFHPCP builds a parameter list and issues a DFHPGHM FUNCTION(SET_ABEND) OPERATION(RESET) call. If SETXIT macro does not specify an abend routine address, then DFHPCP builds a parameter list and issues a DFHPGHM CANCEL call.
- Abend (ABEND)
- If it is an ABEND request without an existing TACB, then the parameter list is built for this abend. A DFHABAB(CREATE_ABEND_RECORD) is issued to build the TACB. Else a DFHABAB(UPDATE_ABEND_RECORD) is issued with the name of the failing program is issued. A DFHABAB(START_ABEND) call is then made to issue the abend. If the DFHABAB(START_ABEND) call returns control to this module, it is because the exit XPCTA has been invoked and modified the return address. Control is passed to the modified address in the requested execution key.
Modules
| Module | Description |
|---|---|
| DFHEPC | DFHEIP’s program control interface |
Exits
| Program | Global user exit points |
|---|---|
| DFHEPC |
XPCERES
XPCREQ XPCREQC |
| DFHABAB |
XPCABND
XPCTA |
| DFHAPLI1 |
XPCFTCH
XPCHAIR |
| DFHERM | XPCHAIR |
| DFHUEH | XPCHAIR |
Trace
The following point IDs are provided for entry to and exit from DFHPCPG:
- AP 2000, for which the trace level is PC 1
- AP 2001, for which the trace level is PC 1