FCMT gate, ADD_FILE function
This function builds a new FCT entry for a VSAM file or data table.
Input Parameters
- ADD
- A binary parameter that indicates whether records can be added to the file.
- Values for the parameter are:
- NO
- YES
- BROWSE
- A binary parameter that indicates whether records can be retrieved sequentially from the file.
- Values for the parameter are:
- NO
- YES
- CATALOG_FCTE
- A binary parameter that indicates whether the file definition should be written to the catalog.
- Values for the parameter are:
- NO
- YES
- DELETE
- A binary parameter that indicates whether records can be deleted from the file.
- Values for the parameter are:
- NO
- YES
- DSN_SHARING
- Specifies whether VSAM data set name sharing is used for the VSAM file.
- Values for the parameter are:
- ALL_REQUESTS
- MODIFY_REQUESTS
- FILE_NAME
- The name of the FILE resource.
- FILE_TYPE
- The location of the file.
- Values for the parameter are:
- LOCAL
- REMOTE
- IMAGE
- Indicates whether backup images are to be fuzzy or sharp.
- Values for the parameter are:
- FUZZY
- SHARP
- JOURNAL_ID
- The identifier of the journal used for automatic journaling records.
- JOURNAL_READ_ONLY
- A binary parameter that indicates whether READ ONLY operations, and not READ UPDATE operations, are to be written to the journal.
- Values for the parameter are:
- NO
- YES
- JOURNAL_READ_SYNC
- A binary parameter that indicates whether the automatic journaling records that are written for READ operations are to be written synchronously.
- Values for the parameter are:
- NO
- YES
- JOURNAL_READ_UPDATE
- A binary parameter that indicates whether READ UPDATE operations, and not READ ONLY operations, are to be written to the journal.
- Values for the parameter are:
- NO
- YES
- JOURNAL_WRITE_NEW_AFTER
- A binary parameter that indicates whether new records are to be written to the journal before they are written to the VSAM file.
- Values for the parameter are:
- NO
- YES
- JOURNAL_WRITE_NEW_BEFORE
- A binary parameter that indicates whether new records are to be written to the journal after they are written to the VSAM file.
- Values for the parameter are:
- NO
- YES
- JOURNAL_WRITE_SYNC
- A binary parameter that indicates whether the automatic journaling records that are written for WRITE operations are to be written synchronously.
- Values for the parameter are:
- NO
- YES
- JOURNAL_WRITE_UPDATE
- A binary parameter that indicates whether the automatic journaling records that are written for REWRITE and DELETE operations are to be written synchronously.
- Values for the parameter are:
- NO
- YES
- LSR_POOL_ID
- The identity of the local shared resource (LSR) pool.
- OPEN_TIME
- Specifies whether the file is opened immediately after CICS initialization, or on first reference.
- Values for the parameter are:
- ASAP
- FIRST_REFERENCE
- READ
- A binary parameter that indicates whether records on this file can be read.
- Values for the parameter are:
- NO
- YES
- READ_INTEGRITY
- Specifies the level of read integrity required for RLS files.
- Values for the parameter are:
- CR
- NRI
- RR
- RECORD_FORMAT
- The format (fixed- or variable-length) of records on the file.
- Values for the parameter are:
- FIXED
- VARIABLE
- RECOVERY
- The type of recovery required for the file.
- Values for the parameter are:
- ALL
- BACKOUT_ONLY
- NONE
- RLS
- A binary parameter that indicates whether CICS is to open the file in RLS mode.
- Values for the parameter are:
- NO
- YES
- STRING_NUMBER
- The number of concurrent requests that can be processed against the file.
- UPDATE
- A binary parameter that indicates whether records on this file can be updated.
- Values for the parameter are:
- NO
- YES
- BASE_NAME
- Optional Parameter
- The name of the VSAM base cluster.
- CF_LOAD
- Optional Parameter
- A binary parameter that indicates whether a coupling facility data table load is required.
- Values for the parameter are:
- NO
- YES
- CF_POOL
- Optional Parameter
- The name of the coupling facility data table pool containing the table defined by this file definition.
- CF_UPDATE_MODEL
- Optional Parameter
- The type of update model to be used for a coupling facility data table.
- Values for the parameter are:
- CONTENTION
- LOCKING
- DATA_BUFFERS
- Optional Parameter
- The number of buffers to be used for data.
- DISPOSITION
- Optional Parameter
- The disposition of this file.
- Values for the parameter are:
- OLD
- SHARE
- DT_NAME
- Optional Parameter
- The name of the coupling facility data table that is accessed through this file definition.
- ENABLE_STATUS
- Optional Parameter
- Indicates that the initial state of the file is unenabled.
- Values for the parameter are:
- UNENABLED
- FORWARD_RECOVERY_LOG
- Optional Parameter
- The journal that corresponds to the MVS system logger log stream that is to be used for forward recovery.
- INDEX_BUFFERS
- Optional Parameter
- The number of buffers to be used for the index.
- KEY_LENGTH
- Optional Parameter
- The length in bytes of the logical key of records in remote files, and in coupling facility data tables that are not loaded when they are first loaded.
- OBJECT_NAME
- Optional Parameter
- When the file is associated with a data set that is a VSAM base, the name of the base data set.
- RECORD_SIZE
- Optional Parameter
- The maximum length in bytes of records in a remote file or a coupling facility data table.
- REMOTE_NAME
- Optional Parameter
- The name by which the file is known in the remote region.
- REMOTE_SYSTEM
- Optional Parameter
- The name of the remote system where the file is located.
- TABLE_SIZE
- Optional Parameter
- The maximum number of records (entries) to be accommodated in the data table.
- TABLE_TYPE
- Optional Parameter
- The type of data table.
- Values for the parameter are:
- CFDT
- CICS
- NOT_TABLE
- USER
- VSAM_PASSWORD
- Optional Parameter
- The VSAM password for the file.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- CATALOG_WRITE_FAILED
- CONNECT_DSNB_FAILED
- GETMAIN_FAILED
- TM_ADD_FAILED
- TM_LOCATE_FAILED
- TM_UNLOCK_FAILED
- The following values are returned when RESPONSE is EXCEPTION:
- DUPLICATE_FILE_NAME
- The following values are returned when RESPONSE is INVALID:
- INVALID_PARAMETERS
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.