SET FILE

Change attributes of a VSAM or BDAM file, including files that refer to CICS shared data tables and coupling facility data tables.

Read syntax diagramSkip visual syntax diagramSET FILE
 
>>-+-SET FILE(data-value)----+--| options |--------------------><
   '-SET DATASET(data-value)-'
 

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

Read syntax diagramSkip visual syntax diagramoptions:
 
                                     .-WAIT-------.
|--+------------+--+--------------+--+------------+------------->
   +-ADD(cvda)--+  +-BROWSE(cvda)-+  +-BUSY(cvda)-+
   +-ADDABLE----+  +-BROWSABLE----+  +-FORCE------+
   '-NOTADDABLE-'  '-NOTBROWSABLE-'  '-NOWAIT-----'
 
>--+----------------------+--+--------------+------------------->
   '-CFDTPOOL(data-value)-'  +-DELETE(cvda)-+
                             +-DELETABLE----+
                             '-NOTDELETABLE-'
 
>--+-------------------+--+------------------------+------------>
   +-DISPOSITION(cvda)-+  +-DSNAME(data-value)-----+
   +-OLD---------------+  '-OBJECTNAME(data-value)-'
   '-SHARE-------------'
 
                          .--------------------------------.
                          V                                |
>--+-------------------+----+----------------------------+-+---->
   +-EMPTYSTATUS(cvda)-+    '-+-+-ENABLESTATUS(cvda)-+-+-'
   +-EMPTY-------------+      | +-DISABLED-----------+ |
   +-EMPTYREQ----------+      | '-ENABLED------------' |
   '-NOEMPTYREQ--------'      '-+-OPENSTATUS(cvda)-+---'
                                +-CLOSED-----------+
                                '-OPEN-------------'
 
>--+-----------------+--+-----------------------+--------------->
   +-EXCLUSIVE(cvda)-+  '-KEYLENGTH(data-value)-'
   +-EXCTL-----------+
   '-NOEXCTL---------'
 
>--+----------------+--+-----------------------+---------------->
   +-LOADTYPE(cvda)-+  '-LSRPOOLID(data-value)-'
   +-LOAD-----------+
   '-NOLOAD---------'
 
>--+------------------------+--+-------------+------------------>
   '-MAXNUMRECS(data-value)-'  +-READ(cvda)--+
                               +-NOTREADABLE-+
                               '-READABLE----'
 
>--+------------------------+--+-----------------+-------------->
   '-RECORDSIZE(data-value)-'  +-READINTEG(cvda)-+
                               +-UNCOMMITTED-----+
                               +-CONSISTENT------+
                               '-REPEATABLE------'
 
>--+-----------------+--+---------------------+----------------->
   +-RLSACCESS(cvda)-+  '-STRINGS(data-value)-'
   +-RLS-------------+
   +-NOTAPPLIC-------+
   '-NOTRLS----------'
 
>--+-------------+--+-----------------------+------------------->
   +-TABLE(cvda)-+  '-TABLENAME(data-value)-'
   +-CFTABLE-----+
   +-CICSTABLE---+
   +-NOTTABLE----+
   '-USERTABLE---'
 
>--+--------------+--+-------------------+----------------------|
   +-UPDATE(cvda)-+  +-UPDATEMODEL(cvda)-+
   +-NOTUPDATABLE-+  +-CONTENTION--------+
   '-UPDATABLE----'  '-LOCKING-----------'
 

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Note:
This command replaces the SET DATASET command. The DATASET keyword is supported by the translator as a synonym for FILE, but you should use FILE for all new applications. Similarly, OBJECTNAME is supported as a synonym for DSNAME.

Any combination of the options can be set on one command. All changes, other than to close and disable the file, require that the file be in a CLOSED state, with an ENABLESTATUS of either DISABLED or UNENABLED, and they do not take effect until the file is next opened.

You can use the SET FILE command to set combinations of attributes that are relevant to more than one file type, to simplify switching between different types of file. Attributes that are not relevant to the current type of file are ignored. You can use this capability to set up dual-purpose file definitions, for example, by defining both local and remote attributes, or set attributes that make it easy to switch the file from accessing a user-maintained data table within a single MVS image to accessing a coupling facility data table within a Parallel Sysplex.

If a coupling facility data table already exists, and the table attributes specified on the SET FILE command do not match those with which it was created, an attempt to open the file fails with an error message.

If you use the SET FILE command to switch the file from referencing a coupling facility data table to a different object (for example from CFTABLE to NOTTABLE), the CFDT is not deleted and remains in existence in its pool (the coupling facility list structure).

The requested changes are applied in the following order: NOEMPTYREQ, CLOSED, DISABLED, miscellaneous, OPEN, ENABLED.

Read syntax diagramSkip visual syntax diagramSET FILE ENABLED
 
>>-EXEC CICS SET--FILE(data-value)--ENABLED--------------------><
 

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

Read syntax diagramSkip visual syntax diagramSET FILE DISABLED
 
                                              .-WAIT---.
>>-EXEC CICS SET--FILE(data-value)--DISABLED--+--------+-------><
                                              +-NOWAIT-+
                                              '-FORCE--'
 

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

Read syntax diagramSkip visual syntax diagramSET FILE OPEN
 
>>-EXEC CICS SET--FILE(data-value)--OPEN--+-------+------------><
                                          '-EMPTY-'
 

Conditions: FILENOTFOUND, IOERR, NOTAUTH

Read syntax diagramSkip visual syntax diagramSET FILE CLOSED
 
>>-EXEC CICS SET--FILE(data-value)--CLOSED--+-------+----------->
                                            '-EMPTY-'
 
   .-WAIT---.
>--+--------+--------------------------------------------------><
   +-NOWAIT-+
   '-FORCE--'
 

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

Description

The SET FILE command allows you to change some of the attributes of a named VSAM or BDAM file. A security check is made and an unauthorized command attempt is given a NOTAUTH response. If any retained locks are associated with the file, the only attributes that you are allowed to change are the ENABLESTATUS and the OPENSTATUS. Attempting to specify any other attribute when there are retained locks causes an INVREQ condition to be raised.

Options

ADD(cvda)
specifies whether new records are to be added to the file. CVDA values are:
ADDABLE
New records are to be added to the file.
NOTADDABLE
New records are not to be added to the file.
BROWSE(cvda)
specifies whether the file is to be browsable. CVDA values are:
BROWSABLE
The file is to be browsable.
NOTBROWSABLE
The file is not to be browsable.
BUSY(cvda)
specifies what CICS is to do if the file is in use when you issue the SET command. The BUSY option is valid only for requests to SET the file DISABLED or CLOSED, and is ignored for any other request. CVDA values are:
FORCE
All tasks using the file are abended, the file is immediately DISABLED or CLOSED, and control returns to the issuing application.
NOWAIT
The same as WAIT, except that CICS returns control to the issuing application as soon as the SET request has been queued.
WAIT
CICS is to wait until all activity on the file has quiesced before setting the file DISABLED or CLOSED. CICS then returns control to the application that is issuing this command. WAIT is the default.
Note:
Closing a file using the FORCE 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 FORCE option should be restricted to exceptional circumstances.
CFDTPOOL(data-area) (CFDT only)
specifies the name of the pool in which the coupling facility data table resides. You can specify the CFDT pool name 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.
DELETE(cvda) (VSAM only)
specifies whether records can be deleted from the file. CVDA values are:
DELETABLE
Records are deletable from the file.
NOTDELETABLE
Records are not deletable from the file.
DISPOSITION(cvda)
specifies the disposition for this file. When you issue a SET FILE DISPOSITION command, you override the current DISPOSITION value, which can have been taken from the installed file definition, or from any JCL statement for this file, if the file has been opened. CVDA values are:
OLD
The disposition value is to be OLD.
SHARE
The disposition value is to be SHARE.
DSNAME(data-value)
specifies the data set name of the data set associated with this file, as defined to the access method and the operating system. The name can be up to 44 characters long. If no JCL statement exists for this file when it is opened, the open is preceded by a dynamic allocation of the file using this data set name. If there is a JCL statement, it takes precedence over the data set name specified this option.

If the file is associated with a coupling facility data table, DSNAME specifies the name of the source data set from which the table is loaded when the file definition specifies LOAD(YES).

Note:
When you add a data set name to a file definition for a coupling facility data table, LSR pool size calculations may be involved when the file is opened. This occurs when the file refers to an LSRPOOL that CICS builds using default values, and the first data set using the LSR pool is opened to load the table. CICS issues message DFHFC0208 indicating that a delay might occur while the LSR pool size is being calculated. If you specify a data set name on a file that refers to an LSR pool that is already built using default values, the data set will not have been included in the LSR pool calculation. This means the existing LSR pool may not be adequate for the new data set. To resolve any problems associated with an LSR pool used in this way, you can close all files that reference the pool, which causes CICS to discard the pool and rebuild it using new calculations the next time a file is opened that refers to the pool. Alternativley, define the LSR pool explicitly specifying the appropriate values. See the CICS® Resource Definition Guide for information about defining LSR pools.

With the SET FILE command, you can dissociate the file from any DSNAME by supplying a DSNAME value that begins with a null character (hexadecimal zeros).

EMPTY
is equivalent to EXEC CICS SET FILE EMPTYSTATUS(EMPTYREQ). It is supported for compatibility reasons only. This does not apply to files operating in RLS mode.
EMPTYSTATUS(cvda) (VSAM only)
specifies whether the data set is to be emptied when a file that references it is next opened. This is valid only for data sets that are defined as reusable, and that are accessed in either LSR or NSR mode. CVDA values are:
EMPTYREQ
If the data set is defined as reusable, it is set to empty the next time a file that references it is opened in non-RLS mode.
Notes:
  1. If you specify EMPTYREQ for a nonreuseable data set, CICS accepts it, but a subsequent attempt to open the file fails.
  2. If you specify EMPTYREQ for a file defined with RLSACESS(YES), CICS accepts it, but the option does not have any effect unless the file is subsequently opened in non-RLS mode.
  3. If you specify EMPTYREQ for a file that refers to a coupling facility data table that requires preloading from a data set and is specified with RLSACCESS(NO), and opening the file triggers the table load, the data set is set to empty.
  4. If you specify EMPTYREQ for a file that refers to a coupling facility data table that does not require loading from a source data set, the option is ignored.
  5. If you specify EMPTYREQ for a file that refers to a coupling facility data table that is already loaded from a source data set, the option is ignored.
NOEMPTYREQ
The data set has been defined as reusable but is not set empty the next time a file that references it is opened. Specify NOEMPTYREQ for a coupling facility data table.
ENABLESTATUS(cvda)
specifies whether application programs can access the file. CVDA values are:
DISABLED
The file is unavailable for access by application programs.
ENABLED
The file is available for access by application programs.
EXCLUSIVE(cvda) (BDAM only)
specifies whether records on this file should be placed under exclusive control when a read for update is issued. CVDA values are:
EXCTL
Records on this file are to be under exclusive control.
NOEXCTL
Records on this file are not to be under exclusive control.
FILE(data-value)
specifies the 8-character file name defined in the file control table (FCT).
KEYLENGTH(data-value) (CFDT only)
specifies, as a fullword binary value, the key length of records in a coupling facility data table. To set a keylength, specify a value in the range 1 through 16. To clear a keylength (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.

LOADTYPE(data-value) (CFDT only)
specifies whether the coupling facility data table associated with the file requires pre-loading from a source data set. CVDA values are:
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.
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 by the transactions that use it.

You can specify the load type for a file that does not currently refer to a coupling facility data table, but which might be switched to use a coupling facility data table at a later date.

LSRPOOLID(data-value) (VSAM only)
specifies, as a fullword binary value, the number of the LSR pool associated with this file. LSR pool IDs are in the range 1-8.

If the file is not to share buffers, set this value to 0.

For a CICS-maintained or user-maintained data table, the value must be 1 or greater. Both these types of CICS shared data table must use LSR access mode (unless the file is defined to be opened in RLS access mode).

For a coupling facility data table, you can set this value to 0.

MAXNUMRECS(data-value)
specifies, as a fullword binary value, the maximum number of records the data table for this file can hold. Using this parameter enables you to control the use of storage.

For any type of table, if you want to set a limit, specify a value in the range 1 to 99 999 999. 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').

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 value 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.

OPENSTATUS(cvda)
specifies whether the file is to be open or closed. CVDA values are:
CLOSED
The file is to be closed.

The close request is deferred until all UOWs that hold repeatable read locks reach their syncpoint.

Note:
A coupling facility data table remains in existence (in the coupling facility) after the file is closed, unlike a user-maintained data table, which ceases to exist when the file in the file-owning region is closed. Closing a file for a coupling facility data table does not prevent it being accessed through another file or by other CICS regions.

You can use the MVS MODIFY command to issue CFDT server commands that:

  • Set the table unavailable (MODIFY server-name,SET TABLE=tablename,AVAILABLE=NO) so that no other files can issue opens against it
  • Delete the table from the coupling facility (MODIFY server-name,DELETE TABLE=table-name) if you do not want it to exist after the last file using it has been closed.
OPEN
The file is to be opened.

For a coupling facility data table, open processing causes the coupling facility data table server to create the table if it does not exist when CICS processes the open request. If the installed file definition specifies the name of a source data set, the coupling facility data table is created by loading the data from the source data set.

If a SET FILE(filename) OPEN command refers to a file that specifies LOAD(YES), but which does not name the source data set, the CFDT can be created and loaded only by opening a file that defines the source data set name.

If a recoverable data set is to be closed, the task the task issuing the close must commit any prior changes to that data set, or the request is rejected by file control.

READ(cvda)
specifies whether records can be read from the file. CVDA values are:
NOTREADABLE
Records are not to be readable from the file.
READABLE
Records are to be readable from the file.
READINTEG(cvda)
specifies the default level of read integrity for the file. CVDA values are:
CONSISTENT
Consistent read integrity is required for this file.
REPEATABLE
Repeatable read integrity is required for this file.
UNCOMMITTED
No read integrity is required for this file.
Note:
These default read integrity values are used only when the file read request does not specify read integrity options explicitly on the EXEC CICS command.

CICS ignores a READINTEG option specified for a coupling facility data table.

RECORDSIZE(data-area) (CFDT only)
specifies, as a fullword binary value, the maximum record size for a coupling facility data table in the range 1 through 32767.

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 zero to remove a previously defined value.

RLSACCESS(cvda)
specifies whether the file is to be accessed in RLS mode. The file must be closed, and either disabled or unenabled, to change the access mode to RLS access or to non-RLS access.

The non-RLS mode becomes either LSR or NSR, depending on the value specified for LSRPOOLID in the file resource definition.

CVDA values are:

NOTAPPLIC
The file is not eligible to be accessed in RLS mode because:
  • It is a remote file, or
  • It refers to a BDAM data set.
NOTRLS
The file is to be opened in LSR or NSR mode when it is next opened.
RLS
The file is to opened in RLS access mode when it is next opened.

See the CICS Recovery and Restart Guide for information about switching between RLS and non-RLS modes.

STRINGS(data-value) (VSAM only)
specifies, as a fullword binary value, the maximum number of concurrent operations to allow on this file, in the range 1-255.
TABLE(cvda) (VSAM and CFDT only)
specifies whether the file name specified on the FILE parameter represents a data table. CVDA values are:
CFTABLE
The file name refers to a coupling facility data table.
CICSTABLE
The file name represents a CICS-maintained data table.
NOTTABLE
The file name does not represent a data table.
USERTABLE
The file name represents a user-maintained data table.
TABLENAME(data-area) (CFDT only)
specifies the 1- to 8-character name of the coupling facility data table to which this file refers. If TABLENAME is not specified, the table name defaults to the name of the file.

You can specify the table name 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.

UPDATE(cvda)
specifies whether the file is read-only or read/write. CVDA values are:
NOTUPDATABLE
You can only read the records.
UPDATABLE
You can read, write, or delete the records.
UPDATEMODEL(cvda) (CFDT only)
specifies the type of update model to be used for a coupling facility data table. CVDA values are:
CONTENTION
The CFDT 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.
LOCKING
The CFDT is to use the locking model, in which records are locked when they are read for update.

You can specify the update model 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.

Conditions

FILENOTFOUND
RESP2 values:
18
The named file cannot be found.
INVREQ
RESP2 values:
1
The named file is REMOTE.
2
The named file is not CLOSED.
3
The named file is not DISABLED or UNENABLED.
4
ADD has an invalid CVDA value.
5
BROWSE has an invalid CVDA value.
6
BUSY has an invalid CVDA value.
7
DELETE has an invalid CVDA value.
8
DISPOSITION has an invalid CVDA value.
9
EMPTYSTATUS has an invalid CVDA value.
10
LSRPOOLID is specified for a non-VSAM data set.
11
LSRPOOLID is not in the range 1-8, or the corresponding buffer is not defined.
12
READ has an invalid CVDA value.
13
STRINGS value is not in the range 1-255, or this is not a VSAM file.
14
UPDATE has an invalid CVDA value.
16
OPENSTATUS has an invalid CVDA value.
17
ENABLESTATUS has an invalid CVDA value.
19
DELETE has been specified for a non-VSAM file.
20
EMPTYSTATUS has been specified for a non-VSAM file.
21
CLOSED or DISABLED has been specified by a task that has issued one or more recoverable requests within the current unit of work.
22
ENABLED was specified for a file that is currently DISABLING or UNENABLING.
23
EXCLUSIVE has an invalid CVDA value.
24
EXCLUSIVE has been specified for a non-BDAM file.
28
OPEN, CLOSE, ENABLE, or DISABLE has been specified but an exit program running at exit point XFCSREQ instructed CICS not to carry out the command.
29
TABLE has an invalid CVDA value.
30
MAXNUMRECS value is out of range.
31
The TABLE option is not valid for a BDAM file (must be VSAM for a data table).
32
The TABLE option is not valid for a file defined with the REUSE option.
33
The TABLE option is invalid for a file defined as UNBLOCKED.
34
The MAXNUMRECS option is invalid for a BDAM file (must be VSAM for a data table).
35
The MAXNUMRECS option is invalid for a file defined with the REUSE option.
36
The MAXNUMRECS option is invalid for a file defined as UNBLOCKED.
37
The TABLE option is invalid when LSRPOOL=0 is specified.
39
The USERTABLE option is invalid when record format is not variable.
40
CONSISTENT or REPEATABLE is specified for a file that is not accessed in RLS mode.
41
The DSNB cannot be disconnected, nor a new DSNB connected, for this file because the file has deferred work outstanding, for which there are retained or repeatable read locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file.
42
The SET FILE request cannot be satisfied because the file has deferred work outstanding, for which there are retained or repeatable read locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file. The only valid options when a file has deferred work pending are those that change the file state. File state changes are permitted because they may be required to enable the deferred work to be completed.
43
The file cannot be discarded because it has deferred work outstanding, for which there are retained or repeatable read locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file.
44
A file open request cannot be satisfied because the file references a data set that has been marked as unavailable by a SET DSNAME UNAVAILABLE command.
45
A file open request cannot be satisfied because the file references an RLS-mode data set that has been quiesced by a SET DSNAME QUIESCED command.
46
A file open request cannot be satisfied because the file references an RLS-mode data set that is being copied by a DFSMSdss-initiated non-BWO backup.
47
A file open request cannot be satisfied because the file references an RLS-mode data set that is in the process of quiescing by a SET DSNAME QUIESCED command.
48
A file open request cannot be satisfied because the file references a data set for which its ICF Catalog entry indicates that a recovery is pending, or is in progress (for example, a CICSVR job is running).
49
An invalid CVDA is specified for the READINTEG option.
50
An attempt has been made to open an RLS file when RLS is not supported, either because the level of VSAM does not support RLS or because RLS=NO has been specified during system initialization.
51
An invalid CVDA is specified for the RLSACCESS option.
52
An attempt has been made to specify RLS access for a BDAM data set.
53
An attempt has been made to specify a CICS-maintained data table for a file defined with RLS access.
54
A file open request cannot be satisfied because of one of the following reasons:
  • the file is being opened in RLS mode and this region has other files open in non-RLS mode against the data set which it references.
  • the file is being opened in non-RLS mode and this region has other files open in RLS mode against the data set which it referenDATAces.
  • the file is being opened in non-RLS mode and this region has unresolved RLS recovery work against the data set which it references.
55
LOADTYPE has an invalid CVDA value.
56
UPDATEMODEL has an invalid CVDA value.
57
EMPTYSTATUS has a CVDA value that is not allowed for a coupling facility data table. EMPTYSTATUS must be NOEMPTYREQ for a coupling facility data table.
58
CFDTPOOL is not specified for a file that refers to a coupling facility data table.
59
KEYLENGTH is not specified for a file that refers to a coupling facility data table, and which specifies LOAD=NO.
60
An invalid KEYLENGTH is specified. The KEYLENGTH must be in the range 1 through 16 for a coupling facility data table.
61
RECORDSIZE is not specified for a file that refers to a coupling facility data table that specifies LOAD=NO.
62
An invalid RECORDSIZE is specified. RECORDSIZE must be in the range 0 through 32767 bytes.
63
OPEN is specified for a file that refers to a coupling facility data table, but OPEN processing has failed because:
  • The file attributes do not match those specified when the CFDT was created, or
  • A keylength or recordsize has been specified that exceeds the maximum supported.
64
OPEN is specified for a file that refers to a coupling facility data table, but OPEN processing has failed because the server is not available.
65
An invalid CFDTPOOL name is specified.
66
An invalid TABLE name is specified.
67
An UPDATEMODEL of CONTENTION is specified for a recoverable coupling facility data table. The update model must be LOCKING for a coupling facility data table that is recoverable.
69
The DSNAME is invalid.
IOERR
RESP2 values:
0
The command failed before the request was passed to the resource management system4.
*
OPEN has failed outside file control. The RESP2 field contains the response that was returned to file control by the external resource management system4.
*
CLOSE has failed outside file control. The RESP2 field contains the response that was returned to file control by the external resource management system4.

In all cases of IOERR, the CICS console should be examined for messages providing more information on the error.

Depending on how you are viewing the RESP2 value, you should be aware that it may contain the decimal equivalent of the response returned to file control.

NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.

Examples

EXEC CICS SET FILE ('FILE12')
              WAIT
              CLOSED
              DISABLED
              DELETABLE
              LSRPOOLID(7)
              STRINGS(50)
EXEC CICS SET FILE ('FILE12')
              OPEN
              ENABLED

On the first command, the WAIT option tells CICS to allow all activity on FILE12 to quiesce before closing the file, and to return control to the issuing application only when this request has been started. When the file has been CLOSED, it is to be DISABLED. The records on FILE12 are then to be marked DELETABLE, LSRPOOL number 7 is to be associated with the file, and up to 50 concurrent operations are to be allowed.

The second of the two commands opens and then enables the file. Setting a file CLOSED and DISABLED makes the file eligible for deletion (DISCARD) or reinstallation by another task. Thus it is possible for another task to delete the file after the first SET command but before the second SET command.


4.
Resource management system refers to any of the catalogue management systems such as VSAM, BDAM, or DFSMS, or to an external resource management system such as CFDT or SDT (Coupling facility data tables, or Shared data tables).

[[ Contents Previous Page | Next Page Index ]]