File Control’s call back gates

Table 8 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 8. 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 chapters on the recovery manager, log manager, and domain manager.

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.

[[ Contents Previous Page | Next Page Index ]]