CEMT SET FILE
Change some attributes of one or more VSAM or BDAM files.
In the CICS Explorer, the Files operations view provides a functional equivalent to this command.
Description
Use the CEMT transaction to modify files that are defined in the CICS® system definition (CSD) file and installed in the running CICS system.
- CICS bundles that were deployed on their own or with a platform can be updated individually.
- If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.
To change the status of a FILE resource that was defined and installed in a CICS bundle, change the status of the CICS bundle or the application with which it is deployed. When you perform the disable action on a CICS bundle that defines a FILE resource, the action completes when the file is no longer in use and any retained locks have been resolved.
If you are experiencing a problem with disabling a CICS bundle that defines a FILE resource, you may issue the CEMT SET FILE command with the FORCECLOSE option against the dynamically generated resource, if this action is required. Follow the troubleshooting procedure in Diagnosing application errors to diagnose the problem and take suitable action.
Syntax
- Type
CEMT SET FILE
(or suitable abbreviations for the keywords), followed by a value that corresponds to a file name, or ALL. The resulting display lists the current status, similar to that obtained by CEMT INQUIRE FILE. You can tab to the highlighted or blank fields and overtype them with the required values. - Type
CEMT SET FILE
(or suitable abbreviations for the keywords), followed by a value that corresponds to a file name or ALL, then followed by one or more attribute settings that you want to change. For example,cemt s fi al op en
attempts to set all files open and enabled for use.
Typing ?
at the beginning of either the first or second line gives a
syntax prompt. Reset values take effect immediately.
Options
- (value)
- One or more file names (1 - 8 characters).
- ADDABLE
- You can add records to the file.
- ALL
- Any change you request is made to all files that you are authorized to access.
- BROWSE
- You can browse records in the file.
- CFDTPOOL (value)
- Specifies the name of the CFDT pool in which the coupling facility data table resides.
- CFTABLE
- The file name represents a coupling facility data table.
- CICSTABLE
- The file name represents a CICS-maintained data table.
- CLOSED
- The file is closed; the access
method does not allow accesses to the data until the file is opened. The file can be opened either
explicitly by the user or, if the file has the ENABLED attribute, implicitly by CICS on the next reference to the file.
When the SET FILE CLOSED command is used, the file is closed and also disabled (set UNENABLED). (A file disabled in this way prevents access requests from implicitly opening the file again.) The close is effected at the time of the command only if there are no tasks currently accessing the file. If there are current users, the display indicates CLOSE requested. This means that, when the last user finishes using the file, it effects the close.
A file that has been disabled by a SET FILE CLOSED command becomes enabled again by a subsequent SET FILE OPEN command. To distinguish a file that has been disabled by a SET FILE CLOSED from one that has been disabled by a SET FILE DISABLED command, the SET FILE CLOSED command closes the file with the UNENABLED attribute.
A file with the DISABLED attribute can be enabled only by a SET FILE ENABLED command. A file with the UNENABLED attribute can be enabled by a SET FILE ENABLED or SET FILE OPEN command.
- CONTENTION (CFDT ONLY)
- The coupling facility data table is to use the contention model, in which records are not locked when they are read for update, but an error is returned on a subsequent REWRITE or DELETE if the record has changed or been deleted since it was read for update.
- DELETE
- You can delete records from the file.
- DISABLED
- The file is not available for
use by transactions except for those that are currently using it. If there are any such users,
BEING DISABLED
is also displayed. The CEMT SET FILE DISABLED command has no effect on existing users; it prevents new users from accessing the file.The file can be reenabled by a SET FILE ENABLED command. (See also UNENABLED.)
It is not possible to disable a remote file.
- DSNAME (value)
- Specifies the name (1 - 44
characters) of the VSAM or BDAM data set with which this file is associated. CEMT SET
FILE(value) DSNAME(value) associates the data set with the
file and causes the FILECOUNT of the data set to be incremented by 1. You can use CEMT SET
FILE DSNAME with a null DSNAME value to dissociate a file from its current data set.
Note: DSNAME replaced OBJECTNAME.
- EMPTYREQ (VSAM only)
- Applies only to a VSAM file
that has been defined to VSAM as a cluster with the REUSE parameter, and which is opened in non-RLS
access mode. It indicates that when a file is next opened, its data is erased.
If the file is opened in RLS access mode this parameter has no effect.
A CEMT SET FILE EMPTYREC command can be applied only to files that are closed and either disabled or unenabled, and has no effect on the data until the file is opened. A SET FILE EMPTYREQ command can be canceled by a SET FILE NOEMPTYREQ command.
- ENABLED
- The file is available for use by transactions and, if closed, it is opened on the first request. If the command CEMT SET FILE(value) CLOSED ENABLED is given while the file is in use, the status of the file becomes closed-unenabled. If the command CEMT SET FILE(value) CLOSED is given while the file is in use, the file is disabled to prevent new users accessing the file.
- EXCLUSIVE
- Records on the file are protected from simultaneous update by being placed under exclusive control when a read for update is issued.
- FORCECLOSE
- Similar to SET FILE CLOSED,
except that any existing users of the file are abended (abend code AKC3 or ATCH). As for CLOSED, the
close is effected by the last of these users. Note: Closing a file using the FORCECLOSE option causes tasks of any current users of the file to be terminated immediately by the CICS task FORCEPURGE mechanism. Data integrity is not guaranteed with this mechanism. In some extreme cases (for example, if an error occurs during backout processing) CICS might terminate abnormally. For this reason, closing files using the FORCECLOSE option should be restricted to exceptional circumstances.
- KEYLENGTH (value)
- Specifies the key length of
records in a coupling facility data table that does not require pre-loading from a source data set.
To set a key length, specify a value in the range 1 through 16. To clear a key length (set it to
null values), specify KEYLENGTH(0).
You can specify the key length for a file that does not currently refer to a coupling facility data table, but which could be switched to use a coupling facility data table at a later date.
- LOAD
- The coupling facility data table requires loading from a source data set before it is fully usable; the transactions that use this coupling facility data table rely on it containing the records from the specified source data set.
- LOCKING (CFDT ONLY)
- The coupling facility data table is to use the locking model, in which records are locked when they are updated.
- MAXNUMRECS (value)
- Specifies the maximum
number of records that the data table for this file can hold.
For any type of table, if you want to set a limit, specify a value in the range 1 through 99999999. If you do not want any limit to apply, specify MAXNUMRECS(0), which CICS interprets as no limit, and sets internally to the maximum positive fullword value (+2147483647 or X'7FFFFFFF').
Note: The new value takes effect only when a new data table is created. This happens on each file open for a CICS-maintained or user-maintained data table, but only when the table does not already exist for a CF data table. Once a coupling facility data table has been created, you can change the maximum number of records only through the CFDT server MVS™ command interface.To specify MAXNUMRECS for a recoverable coupling facility data table, use a value that is between 5% and 10% more than the maximum number of records that the table is expected to contain. This allows for additional records that might be created internally for processing recoverable requests. The margin to be left for this internal processing depends on the level of use of the coupling facility data table, and the nature of that use. An effect of this is that the NOSPACE condition (with a RESP2 of 102) can be raised on a WRITE or REWRITE request to a recoverable coupling facility data table that apparently has fewer records than the MAXNUMRECS limit specifies.
- NOADDABLE
- You cannot add records to the file.
- NOBROWSE
- You cannot browse records in the file.
- NODELETE
- You cannot delete records from the file.
- NOEMPTYREQ (VSAM only)
- Applies only to VSAM files.
Specifies that when a file is next opened, its data is not erased.
A CEMT SET FILE NOEMPTYREC command can be applied only to files that are closed and either disabled or unenabled, and cancels the implicit request in a previous SET FILE EMPTYREQ command.
- NOEXCLUSIVE
- Records on the file are not protected from simultaneous update.
- NOLOAD
- The coupling facility data table does not require loading from a source data set. It is fully usable as soon as it is created, and is populated entirely by the transactions that use it.
- NOREAD
- You cannot read records in the file.
- NOTRLS (VSAM only)
- The file is defined to be
accessed in a non-RLS mode (LSR or NSR).
For information about switching from RLS to non-RLS mode, see the Troubleshooting for recovery processing.
- NOTTABLE
- The file name does not represent a data table.
- NOUPDATE
- You cannot update records in the file.
- OLD
- The disposition of the data set associated with the file is defined as unshared for dynamic allocation.
- OPEN
- The file is open. If the file is
OPEN ENABLED, it is available for data accesses by CICS
transactions. If it is OPEN DISABLED, it must first be enabled before it is available.
If the file was unenabled by a previous SET FILE CLOSED command, the SET FILE OPEN command reenables the file implicitly.
- READ
- You can read records in the file.
- RECORDSIZE
- Specifies the maximum
record size for a coupling facility data table that does not require pre-loading from a source data
set.
You can specify the record size for a file that does not currently refer to a coupling facility data table, but which could be switched to use a coupling facility data table at a later date. Specify a record size of 1 to 32767 bytes, or specify a record size of zero to remove a previously defined value.
- RLS (VSAM only)
- The file is defined to be accessed in RLS mode.
- SHARE
- The disposition of the data set associated with the file is defined as shared for dynamic allocation.
- TABLENAME (value)
- Specifies the name of the table for a coupling facility data table.
- UPDATE
- You can update records in the file.
- USERTABLE
- The file name represents a user-maintained data table.