FILEDEFRecordType
FILEDEF Record
Fields
String)
The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
String)
Specifies whether records can be added to the file.
String)
CICS VSAM files can be defined as eligible for backup while open for update. Possible values are:
- DYNAMIC - Specify this along with the RECOVERY attribute of ALL to make the file eligible for backup while open for update.
- STATIC - The file is not eligible for backup while open for update.
String)
Specifies whether records can be retrieved sequentially from the file.
String)
The change agent identifier that made the last modification.
- CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
- CSDBATCH - The resource was last changed by a DFHCSDUP job.
- DREPAPI - Resource was last changed by a CICSPlex SM API command.
- N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
String)
The CICS release level of the agent that made the last modification.
String)
The local date and time when the definition was last changed.
String)
The user ID that made the last modification.
String)
The local date and time when the definition was created.
Long)
The number of buffers to be used for data. Use a value in the range 2 (the default) through 32767. The minimum value you may specify is one more than the number of strings defined in the STRINGS attribute. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
String)
Specifies whether records can be deleted from the file.
Long)
The code page of the description field. This field is ignored for CICS CSD resource definitions.
String)
A description of the file definition.
String)
The disposition of this file:
- OLD - Equivalent to the DISP=OLD parameter in JCL.
- SHARE - Equivalent to the DISP=SHR parameter in JCL.
String)
The data set name (as known to the operating system) to be used for this file. DSNAME can be 1 through 44 characters, conforming to the rules for MVS data set names.
String)
Specifies whether VSAM data set name sharing is used for the VSAM file. The possible values are:
- ALLREQS - Data set name sharing is set in the ACB when the file is opened and is therefore used for all file requests.
- MODIFYREQS - Data set name sharing is set in the ACB when the file is opened only if an operation of DELETE, ADD, or UPDATE is set for the file.
CSDINGRPRecordsType!)
References to this FILEDEF from CSDINGRP, by the attributes 'csdgroup', 'defname', 'deftype'.
RESINGRPRecordsType!)
References to this FILEDEF from RESINGRP, by the attributes 'definitionName', 'definitionType', 'definitionVersion'.
FILEDEF_FWDRECOVLOGValueType)
The journal that corresponds to the MVS system logger log stream that is to be used for forward recovery. This attribute is ignored for coupling facility data tables and, if there are any recovery attributes defined in the ICF catalog for a source data set associated with the table, these also are ignored. A CFDT is not forward recoverable.
- NO - Forward recovery logging is not required for this file.
- journal - The number that identifies the journal that CICS is to use for the forward recovery log. CICS journal names are of the form DFHJnn where nn is in the range 1 through 99. The after images for forward recovery are written to the MVS log stream that corresponds to journal name DFHJnn.
Long)
The number of buffers to be used for the index. Use a value in the range 1 through 32767. The minimum value you may specify is the number of strings defined in the STRINGS attribute. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
String)
The add operations you want recorded on the journal nominated by the JOURNAL attribute. Possible values are:
- AFTER - Journal the file control write operation after the VSAM I/O operation.
- ALL - Journal the file control write operation both before and after the VSAM I/O operation has completed.
- BEFORE - Journal the file control write operation before the VSAM I/O operation.
- NONE - Do not journal add operations.
String)
The read operations you want recorded on the journal nominated by the JOURNAL attribute. Possible values are:
- ALL - Journal all read operations.
- NONE - Do not journal read operations.
- READONLY - Journal only READ ONLY operations (not READ UPDATE operations).
- UPDATEONLY - Journal only READ UPDATE operations (not READ ONLY operations).
String)
Specifies whether you want the automatic journaling records, written for READ operations to the journal specified by JOURNAL, to be written synchronously or asynchronously.
String)
Specifies whether you want the automatic journaling records, written for WRITE operations to the journal specified by JOURNAL, to be written synchronously or asynchronously.
String)
Specifies whether you want REWRITE and DELETE operations recorded on the journal nominated by the JOURNAL attribute.
FILEDEF_JOURNALValueType)
Specifies whether you want automatic journaling for this file. The journaled data is in the format of the VSAM record and is used for user controlled journaling. The data to be journaled is identified by the JNLADD, JNLREAD, JNLSYNCREAD, JNLSYNCWRITE, and JNLUPDATE attributes. Possible values are:
- NO - No automatic journaling is to take place for this file.
- number - The number that identifies the journal that CICS is to use for the autojournal. CICS journal names are of the form DFHJnn, where nn is in the range 1 through 99.
Long)
The length in bytes of the logical key of records in remote files, and in coupling facility data tables that are specified with LOAD(NO). If KEYLENGTH is not defined here, the KEYLENGTH option must be specified on file control commands in the application programs that refer to this file. If KEYLENGTH is not defined here and not specified in the application program, and the key is longer than 4 characters, the default value is 4.
String)
The load type for a coupling facility data table. The values are:
- Load - The coupling facility data table is, or is to be, preloaded from a source data set.
- Noload - The coupling facility data table is not preloaded from a source data set.
FILEDEF_LSRPOOLIDValueType)
The identity of the local shared resource pool. The default value for LSR Pool number is 1, unless a value has been specified for the NSRGROUP attribute, in which case the default value for LSR Pool number is NONE. Options are:
- NONE - Specifies that the data set associated with this file uses VSAM nonshared resources (NSR).
- number - The value, in the range 1 through 255, identifies the number of the VSAM shared resource pool that is used by the VSAM data set associated with this file. The data set is defined as using VSAM local shared resources (LSR). You are recommended to define the buffers, strings, and other resources explicitly in an LSRPOOL resource definition that corresponds to this LSR Pool number.
FILEDEF_MAXNUMRECSValueType)
For CICS and USER tables, the maximum number of entries in the data table, in the range 1 through 99999999. If NOLIMIT is specified the number of entries is unlimited. NOLIMIT is the default value.
String)
The name of the file definition.
String)
For files referencing data sets that use VSAM non-shared resources (NSR), a 1- to 8-character symbolic name to group together file definitions that refer to the same VSAM base data set.
String)
Specifies when the file is opened. Possible values are
- FIRSTREF - The file remains closed until a request is made to open it by: a main terminal command, an EXEC CICS SET FILE OPEN command in an application program, or an implicit open.
- STARTUP - The file is opened immediately after CICS initialization by an automatically initiated CICS transaction (CSFU), unless the status of the file is UNENABLED, in which case the file is left closed.
String)
The 1-to 8-character password that is used to verify user access to the file. This attribute is obsolete from CICS Transaction Server 5.3 onwards.
String)
The name of the coupling facility data table pool in which the coupling facility data table resides.
String)
Specifies whether records on this file can be read.
String)
The level of read integrity required for files defined with RLSACCESS(YES):
- CONSISTENT - The record is read with consistent read integrity. CONSISTENT is valid only if you also specify RLSACCESS(YES)-the resource definition is rejected with an error if you specify CONSISTENT for a non-RLS file.
- REPEATABLE - The record is read with repeatable read integrity.
- UNCOMMITTED - The record is read without read integrity. UNCOMMITTED is the same level of integrity that is provided by those releases of CICS that do not support the READINTEG attribute.
String)
The format of the records on the file:
- Fixed - The records are fixed length.
- Variable - The records are variable length.
Long)
The maximum length in bytes of records in a remote file . The size specified can be in the range 1 through 32767.
String)
The type of recovery required for the file:
- ALL - Before images are recorded in the system log, and after images in the journal specified in the FWDRECOVLOG attribute.
- BACKOUTONLY - Before images are recorded in the system log.
- NONE - There is no recovery logging for this file.
String)
(Optional.) Specifies, if the file resides on a remote system, the name by which this file is known in the system or region in which it is resident. The name can be up to eight characters in length.
String)
(Optional.) Specifies, if the file resides on a remote system, the name of the connection that links the target (local) system to the related (remote) system where the file resides. If this attribute is not supplied, this is derived directly from the CICS system ID of the related system. The connection that links the target system to the related system must have the same name as the CICS system ID of the related system.
String)
Specifies whether CICS is to open the file in RLS mode:
- NO - The file is not to be opened in RLS mode.
- YES - The file is to be opened in RLS mode.
String)
The initial status of the file following a CICS initialization with START=COLD or START=INITIAL. Options are:
- DISABLED - Any request against this file from a command-level application program causes the DISABLED condition to be passed to the program.
- ENABLED - Normal processing is allowed against this file.
- UNENABLED - This prevents the file being opened by an implicit open from an application program. Any such attempt to access the file raises the NOTOPEN condition. By contrast, an explicit request to open the file (for example, a CEMT or EXEC CICS SET FILE OPEN command) changes the status to ENABLED before attempting to open the file.
Long)
The number, in the range 1 through 255, of concurrent requests that can be processed against the file. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
String)
Indicates whether a file represents a data table: Values are:
- NO - The file does not represent a data table.
- CICS - The file represents a CICS-maintained data table.
- USER - The file represents a user-maintained data table.
- CF - The file represents a coupling facility data table.
String)
The 8-character table name specified for the coupling facility data table on the file resource definition or the file name if the table name is omitted from the file resource definition. This is blank if the file does not refer to a coupling facility data table.
String)
Specifies whether records on this file can be updated.
String)
The type of update model to be used for a coupling facility data table:
- LOCKING - specifies that the CFDT is updated using the locking model.
- CONTENTION - specifies that the CFDT is updated using the contention model.
String)
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
String)
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
String)
Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
Long)
The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.