Modules

DFHEPC

Call mechanism

Branched to from DFHEIP.

Entry address

DFHEPCNA. Stored in the CSA in a field named CSAEPC.

Purpose

DFHEPC is DFHEIP’s program control interface. It supports the following EXEC CICS® requests

It routes a local request to the PG domain, or to DFHABAB (EXEC CICS ABEND) It routes a remote EXEC CICS LINK request to the intersystem module, DFHISP.

Called by

DFHEPC is called exclusively by DFHEIP.

Inputs

The application parameter list.

Outputs

Updated EIB.

Operation

LINK
If SYSID is remote, ships the link request through the DFHISP module.

If SYSID is local:

XCTL
Builds parameter list and calls DFHPGXE FUNCTION(PREPARE_XCTL_EXEC)

Checks the response

Sets up EIBRESP (and, if needed, EIBRESP2).

If the PGXE request failed, then returns control to DFHEIP

If the PGXE request was successful, then return control to DFHAPLI as for EXEC CICS RETURN. (DFHAPLI will then invoke the program specified on EXEC CICS XCTL).

RETURN
Builds parameter list and calls DFHPGRE FUNCTION(PREPARE_RETURN_EXEC) (this call is bypassed if there are no options (COMMAREA, TRANSID, INPUTMSG) specified on EXEC CICS RETURN

. Checks the response

. Sets up EIBRESP (and, if needed, EIBRESP2).

. If the PGRE request failed, then returns control to DFHEIP

. If the PGRE request was successful (or was bypassed), then return control to DFHAPLI which completes the return to the calling program or to Transaction Manager.

LOAD
Builds parameter list and calls DFHPGLD FUNCTION(LOAD_EXEC)

Checks the response

Sets up EIBRESP (and, if needed, EIBRESP2).

If the PGLD request was successful, then set the return parameters in the application parameter list.

Returns control to DFHEIP.

RELEASE
Builds parameter list and calls DFHPGLD FUNCTION(RELEASE_EXEC)

Checks the response

Sets up EIBRESP (and, if needed, EIBRESP2).

Returns control to DFHEIP.

HANDLE ABEND
For HANDLE ABEND PROGRAM, perform resource security check and check whether program name is known.

Builds parameter list and calls DFHPGHM FUNCTION(SET_ABEND)

Checks the response

Sets up EIBRESP (and, if needed, EIBRESP2).

Returns control to DFHEIP.

ABEND
Builds parameter list and calls DFHABAB FUNCTION(CREATE_ABEND_RECORD) and FUNCTION(START_ABEND).

DFHABAB START_ABEND does not normally return, as control is passed to a program or label specified on a HANDLE ABEND, or the program is terminated abnormally.

The XPCTA user exit can request retry. In this case DFHABAB START_ABEND returns to DFHEPC passing back the retry parameters. DFHEPC sets the registers and other values and branches to the specified retry address.

How loaded

At CICS startup, as part of the building of the CICS nucleus. The nucleus is built by DFHSIB1, which uses its nucleus build list to determine the content and characteristics of the CICS nucleus.

[[ Contents Previous Page | Next Page Index ]]