FCFS gate, OPEN_FILE function

This function opens a named file.

Input Parameters

CURRENT_HIGH_KEY
Optional Parameter
The 16-character string that specifies the current high key.
FCTE_POINTER
Optional Parameter
A pointer to the file control table entry (FCTE).
FILE_NAME
Optional Parameter
The 8-character name of the file.
LOADER_ID
Optional Parameter
The fullword binary field that specifies the ID of the loader.
OPEN_OPTIONS
Optional Parameter
Values for the parameter are:
  • OPEN_BASE
  • OPEN_FOR_BACKOUT

Output Parameters

FCN_RETURN_CODE
The FCN return code.
R15_RETURN_CODE
The R15 return code.
VSAM_RETURN_CODE
The VSAM return code.
REASON
The following values are returned when RESPONSE is EXCEPTION:
  • FILE_NOT_FOUND
  • FILE_DISABLING
  • OPEN_ERROR
  • CFDT_OPEN_ERROR
  • CFDT_NO_DSNAME
  • CFDT_NOT_KSDS
  • CFDT_NO_READ_SERVREQS
  • CFDT_OPEN_MISMATCH
  • CFDT_SERVER_ERROR
  • CFDT_SERVER_NOT_AVAILABLE
  • CFDT_CONNECT_ERROR
  • CFDT_SERVER_NOT_FOUND
  • CFDT_SYSIDERR
  • EXIT_SUPPRESSED_REQUEST
  • SYSTEM_ID_ERROR
  • DT_INIT_FAILED
  • DT_CONNECT_FAILED
  • DATASET_UNAVAILABLE
  • DATASET_QUIESCING
  • DATASET_BEING_COPIED
  • DATASET_QUIESCED
  • DATASET_QUIESCED_LOST
  • RECOVERY_REQUIRED
  • RLS_NOT_SUPPORTED
  • COEXISTENCE_ERROR
  • NO_DSNAME
The following values are returned when RESPONSE is DISASTER:
  • CATALOG_WRITE_FAILED
  • LOADER_ACQUIRE_FAILED
  • LOADER_DEFINE_FAILED
  • DISPATCHER_WAIT_FAILED
  • SERIOUS_OPEN_CLOSE_ERROR
  • FCN_RETURNED_DISASTER
  • FCM_RETURNED_DISASTER
  • DISASTER_PERCOLATION
  • TM_UNLOCK_FAILED
  • DT_FAILED
  • DT_INVALID
  • ABEND
  • LOOP
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
Values for the parameter are:
  • OK
  • INVALID
  • EXCEPTION
  • DISASTER
  • PURGED


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