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.


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