DFHFCRF (file control function shipping interface module)

Call mechanism

Kernel subroutine call. Automatic stack storage acquired as part of the call.

Entry address

FC_FCRF_ADDRESS stored in FC Static Storage.

Purpose

DFHFCRF is the function shipping interface module. It is called by the access method independent module DFHFCFR for record management requests (e.g. reads, writes, rewrites, etc.) that are to be directed to files that are defined as remote.

DFHFCRF is called with the FCFR parameter list. From this it constructs an FCRF parameter list, which is subsequently passed to DFHISP and, in turn, either to DFHXFX (the MRO transformer) or to DFHXFFP (the ISC transformer).

DFHFCRF executes the following requests from the DFHFCFRR parameter list:

  • Simple read requests
    • READ_INTO and READ_SET
  • The read update family
    • READ_UPDATE_INTO and READ_UPDATE_SET
    • REWRITE
    • REWRITE_DELETE
    • UNLOCK
  • The browse family
    • START_BROWSE
    • RESET_BROWSE
    • READ_NEXT_SET, READ_NEXT_INTO, READ_PREVIOUS_SET, READ_NEXT_UPDATE_SET, READ_NEXT_UPDATE_INTO, READ_PREVIOUS_UPDATE_SET, and READ_PREVIOUS_UPDATE_INTO
    • END_BROWSE
  • Write requests
    • WRITE
  • Delete requests
    • DELETE

Called by

DFHFCFR, the File Control file request handler.

Inputs

The FCFR parameter list, as defined by the DFHFCFRA DSECT.

Outputs

The FCRF parameter list, as defined by the DFHFCRFA DSECT.

Operation

Traces module entry.

Checks for an explicit SYSID specified on the request and sets the remote system and remote file name in the DFHFCRF parameter list ready for function shipping.

Increments statistics for the type of request.

Checks request specific parameters

Ships the request.

Handles return codes.

Finally, traces the module exit.

How loaded

By FCRP at file control initialization.