EXEC CICS commands for data tables

This section contains General-use Programming Interface and Associated Guidance Information.

You can use the EXEC CICS® SET FILE command to change the definition of an existing file, and the EXEC CICS INQUIRE FILE command to check the definition of an existing file. For programming information, including details of how to use these commands and the parameters described here, see CICS System Programming Reference. The parameters that are relevant to data tables are described below.

SET FILE

The following parameters are relevant to data tables; you can use them only when the file is closed and disabled. You can specify a data table attribute of a file in a CICS-value data area (cvda):

TABLE(cvda)
specify a cvda value of CICSTABLE to define the file as a CICS-maintained data table.

specify a cvda value of USERTABLE to define the file as a user-maintained data table.

specify a cvda value of NOTTABLE to indicate that the file is not a data table.

Note:
You can also specify CFTABLE to indicate a coupling facility data table.

MAXNUMRECS(value)
specifies the maximum number of records that can be contained in the data table, in the range 1 through 99999999. The value of zero means no limit.

INQUIRE FILE

The following parameters are relevant to data tables. You can request that each data table attribute of a file is returned in a CICS-value data area (cvda) by specifying:

TABLE(cvda)
If the value CICSTABLE is returned, the file has been defined as a CICS-maintained data table.

If the value USERTABLE is returned, the file has been defined as a user-maintained data table.

If the value CFTABLE is returned, the file has been defined as a coupling facility data table.

If the value NOTTABLE is returned, the file is not currently defined as a data table.

If the value NOTAPPLIC is returned, the option is not applicable because the file is a remote file.

MAXNUMRECS(cvda)
The value returned indicates the maximum number of records that can be contained in the data table. The value of zero means no limit.

Related concepts
Resource definition for data tables
Using the DEFINE FILE command to define data tables
CEMT commands for data tables
[[ Contents Previous Page | Next Page Index ]]