- Add
- specifies whether records can be added to the file.
- Backuptype
- 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.
- Browse
- specifies whether records can be retrieved sequentially from the file.
- Cfdtpool
- specifies the name of the coupling facility data table pool containing the table defined by
this file definition. This attribute is required if you specify TABLE(CF).
- Databuffers
- specifies 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.
- Delete
- specifies whether records can be deleted from the file.
- Description
- (Optional.) Specifies a 1- to 30-character description of the resource.
- Disposition
- specifies the disposition of this file.
- OLD
- Equivalent to the DISP=OLD parameter in JCL.
- SHARE
- Equivalent to the DISP=SHR parameter in JCL.
- Dsname
- specifies 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. The characters allowed are A-Z 0-9 @ # $
and -. Lowercase characters are treated as uppercase characters.
- Dsnsharing
- 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.
- Name
- specifies the name of the file. The name can be up to eight characters
in length.
- Fwdrecovery
- For files with a Recovery value of ALL, specify
which journal you want the after images for forward recovery written to:
If you leave this field blank, CICSPlex SM uses the default value for
your CICS environment, if there is one.
- RESGROUP
- specifies the group name, which can be up to eight characters in length.
The characters allowed are A-Z 0-9 @ # and $.
- Indexbuffers
- specifies 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.
- Jnladd
- specifies 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.
- Jnlread
- specifies 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).
- Jnlsyncread
- specifies whether you want the automatic journaling records, written
for READ operations to the journal specified by JOURNAL, to be written synchronously
or asynchronously.
- Jnlsyncwrite
- specifies whether you want the automatic journaling records, written
for WRITE operations to the journal specified by JOURNAL, to be written synchronously
or asynchronously.
- Jnlupdate
- specifies whether you want REWRITE and DELETE operations recorded on
the journal nominated by the JOURNAL attribute.
- Journal
- 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.
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.
Note:
In CICS Transaction Server for OS/390®, Version 1 Release 1, and subsequent releases,
DFHJ01 is not the system log.
If you leave this field blank, CICSPlex SM uses the default value for your CICS
environment, if there is one.
- Keylength
- specifies the length in bytes of the logical key of records in remote
files, in the range 1 through 255.
There is no
default value for this attribute. If KEYLENGTH is not defined here, the length
option must be specified on file control API commands in the application programs
that refer to this file.
- Load
- specifies whether the coupling facility data table is to be loaded from a source data set
when first opened.
- NO
- Means the coupling facility data table does not require loading from a source data set; it
is fully usable by application programs as soon as it is open. The table is
loaded by the application programs that use it, which is the default method
for a coupling facility data table.
- YES
- Means the coupling facility data table has to be loaded from a source data set before it is
fully usable; the application programs that use this coupling facility data table rely on it containing
the records from a source data set. Loading does not have to be completed
before data can accessed.
Ensure that the value for this attribute is the same throughout the
sysplex in all file definitions that reference the same coupling facility data table.
- Lsrpoolid
- specifies the identity of the local shared resource pool. The default
value for LSRPOOLID is 1, unless a value has been specified for the NSRGROUP
attribute, in which case the default value for LSRPOOLID is NONE.
- NONE
- Specifies that the data set associated with this file uses VSAM nonshared
resources (NSR).
- 1|2|3|4|5|6|7|8
- The value, in the range 1 through 8, 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 LSRPOOLID.
If you leave this field blank, CICSPlex SM uses the default
value for your CICS environment, if there is one.
- Maxnumrecs
- For CICS and USER tables, specify the maximum number of entries in the
data table, in the range 16 through 16777215. If you leave this field blank,
there is no default value.
- Nsrgroup
- For files referencing data sets that use VSAM non-shared resources (NSR),
specify a 1- to 8-character symbolic name to group together file definitions
that refer to the same VSAM base data set.
- Opentime
- specifies when the file is opened. Possible values are:
- FIRSTREF
- The file remains closed until a request is made to open it by:
- A master terminal command
- An EXEC CICS SET FILE OPEN command in an application program
- 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
when the file is left closed.
- Password
- specifies the 1-to 8-character password that is used to verify user
access to the file.
The passwork does not appear while
you are typing it and it is not displayed on the update or browse panel. If
you specify a password, the Password field appears highlighted on the update
and browse panels to indicate a password exists; the field itself contains
blanks. You can use the update panel to change an existing password or add
a new password.
- Read
- specifies whether records on this file can be read.
- Readintegrity
- specifies 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.
Notes:
- UNCOMMITTED is the same level of integrity that is provided by those releases
of CICS that do not support the READINTEG attribute.
- Recordformat
- specifies the format of the records on the file.
- F
- The records are fixed length.
- V
- The records are variable length.
- Recordsize
- specifies the maximum length in bytes of records in a remote file .
The size specified can be in the range 1 through 32767.
- Recovery
- specifies 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.
- Remotename
- (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.
- RemoteSystem
-
(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, RemoteSystem is derived directly from the
CICS system id of the related system, and 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.
- Ressecnum
- For CICS/ESA 3.3 system, specifies the resource security value to be associated
with the file:
- 0
- Transactions with RSL checking specified are not allowed to access the
file.
- value
- A resource security value, in the range 1 through 24.
- PUBLIC
- Any transaction is allowed to access the file.
- Rlsaccess
- 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.
- Status
- specifies the initial status of the file following a CICS initialization
with START=COLD or START=INITIAL.
- 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.
- Strings
- specifies 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.
- Table
- specifies the type of data table that you require.
- CICS
- A CICS-maintained data table. This automatically reflects all modifications
made to the table in its source data set. If you specify CICS, also specify:
- LSRPOOLID with a value of 1 through 8
- MAXNUMRECS with the value you require.
- NO
- Data table not required.
- USER
- A user-maintained table. This remains independent of its source data
set, and changes to the user-maintained table are not reflected in corresponding
source data set. If you specify USER, also specify:
- LSRPOOLID with a value of 1 through 8
- RECORDFORMAT as VARIABLE (or let this default to VARIABLE)
- MAXNUMRECS with the value you require.
- Tablename
- specifies the name of the coupling facility data table that is accessed through this file
definition.
If you omit this attribute when TABLE(CF)
is specified, it defaults to the name specified for the FILE.
- User data
- (Optional.) Three 8-character fields provided for any site-specific
data related to the DB2® entry. CICSPlex SM makes no use of this user data.
- Update
- specifies whether records on this file can be updated.
- specifies 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.
The value for this attribute must be the same throughout the sysplex
in all file definitions that reference the same coupling facility data table.
- User data
- (Optional.) Three 8-character fields provided for any site-specific
data related to the DB2 entry. CICSPlex SM makes no use of this user data.
- Version
- (Optional.) Specify an integer in the range 1 through 15. Specify 0
or leave blank for CICSPlex SM to assign the first available version id in the
range 1 through 15.