File Control's call back gates

Table 1 summarizes file control's call back gates. It shows the FC level-1 trace point IDs of the modules providing the functions for the gate, the functions provided by the gate, and the format for calls to the gate.

Table 1. File control's call back gates
Gate Trace Function Format
RMRO

FC 0BE0
FC 0BE1

PERFORM_PREPARE
PERFORM_COMMIT
START_BACKOUT
DELIVER_BACKOUT_DATA
END_BACKOUT
PERFORM_SHUNT
PERFORM_UNSHUNT

RMRO
RMKP

FC 0BE0
FC 0BE1

TAKE_KEYPOINT

RMKP
RMLK

FC 24A0
FC 24A1

PREPARE
COMMIT
SEND_DO_COMMIT
SHUNT
UNSHUNT

RMLK
RMDE

FC 0BE0
FC 0BE1

START_DELIVERY
DELIVER_RECOVERY
DELIVER_FORGET
END_DELIVERY

RMDE
LGGL

FC 2350
FC 2351

ERROR

LGGL
DMEN

FC 0BD0
FC 0BD1

NOTIFY_SMSVSAM_AVAILABLE

DMEN
You can find descriptions of these functions and their input and output parameters, in the following topics:

The functions of the RMRO gate are processed by DFHFCRC. For PERFORM_PREPARE and PERFORM_COMMIT, DFHFCRC performs prepare and commit processing respectively for any file resources involved in the unit of work. For START_BACKOUT, DELIVER_BACKOUT_DATA and END_BACKOUT, DFHFCRC backs out changes made to file resources by the unit of work. For PERFORM_SHUNT and PERFORM_UNSHUNT, DFHFCRC respectively shunts and unshunts the file control structures representing recoverable parts of the unit of work.

The functions of the RMKP gate are processed by DFHFCRC. For TAKE_KEYPOINT, DFHFCRC performs processing required for forward recovery of BWO-eligible non-RLS files.

The functions of the RMLK gate are processed by DFHFCDW, which performs syncpoint and recovery functions for recoverable coupling facility data tables.

The functions of the RMDE gate are passed through by DFHFCRC to DFHFCIR. For START_DELIVERY, DFHFCIR takes no action. For DELIVER_RECOVERY and DELIVER_FORGET, DFHFCIR uses the log records that are delivered to it to rebuild file control structures representing the recoverable parts of each unit of work, and also rebuilds locks for non-RLS files. For END_DELIVERY, DFHFCIR notifies file control that the rebuilding of recovery information at CICS® restart is now complete.

The functions of the LGGL gate are processed by DFHFCLF. For ERROR, DFHFCLF takes actions to handle a log stream failure for a general log used by file control.

The functions of the DMEN gate are processed by DFHFCES. For NOTIFY_SMSVSAM_AVAILABLE, DFHFCES calls DFHFCRR with a function of RESTART_RLS and TYPE_OF_RESTART as DYNAMIC.



bryan.html | Timestamp icon Last updated: Monday, 5 June 2017