Previous Topic: CICSCMD SET CONNECTION—Set Connection Status

Next Topic: CICSCMD SET IRC—Set IRC Status

CICSCMD SET FILE—Set File Status

The CICSCMD SET FILE command controls the status of CICS files. The RCIW06 or RCIW20 message indicates the success or failure of the operation. The function is similar to that provided by the CICS CEMT SET FILE transaction.

This command has the following format:

CICSCMD cics_region_name SET FILE(file_name_mask) {ENA | DIS} {OPEN | CLOSED}
cics_region_name

Defines the CICS region that owns the files whose status is to be set.

file_name_mask

Specifies the files whose status is to be set. The value can be either the name or a mask. If you use a mask, it must be of the following form: file_name_prefix*.

ENA | DIS

Specifies whether CICS transactions can access the files.

ENA

Enables the files. Transactions can access an enabled file.

DIS

Disables the files. Transactions cannot access a disabled file. However, transactions that are already using the file can continue using the file.

OPEN | CLOSED

Specifies whether to open or close the files.

OPEN

Opens the files for data access. If the UNENABLED file attribute has been set by a previous CLOSED request, the OPEN request enables the file.

CLOSED

Closes the files to data access. If the file was enabled, the CLOSED request sets the UNENABLED attribute.

Example:

CICSCMD CICSA SET FILE(CUSTOMER) CLOSED
CICSCMD CICSA SET FILE(CUSTOMER) OPEN