SETCICS (Update the status of CICS® files) -- batch only

Purpose
Change the status of files for a CICS® region from a batch job.
Usage notes
The function requires the following information to be supplied:
  • The APPLID of the CICS® region
  • A list of names for the CICS files to be updated
  • A list of the status values to be applied to the files
The CICS File Status Update Report lists the CICS files that were updated and their file status. Any errors that occurred are also shown in the report.
Related functions
None.
Figure 1. Syntax

1 SETCICS APPLID=applid FILE=(+ ,file_n) STATUS=(+ ,stat_n)
applid

The APPLID of the CICS region for the files.

file_n
The name of a single CICS file or a file name pattern representing one or more CICS files.

A CICS file name pattern can consist of any characters that are valid in a file name and the following two special pattern characters:

asterisk (*)
Represents any number of characters. As many asterisks as required can appear anywhere in a file name pattern. For example, if you enter *d*, all files for the CICS region whose name contains d are processed.
percent sign (%)
A place-holding character representing a single character. As many percent symbols as necessary may appear anywhere in a file name pattern. For example, if you enter %%%%, all files for the CICS region whose name is four characters in length is displayed.
file_n
The new status that the selected CICS files must be changed to:
OPE
Open
CLO
Closed
ENA
Enabled
DIS
Disabled
REA
Read
NOR
Remove read status
UPD
Update
NOU
Remove update status
ADD
Add
NOA
Remove add status
BRO
Browse
NOB
Remove browse status
DEL
Delete
NOD
Remove delete status

Example

For a CICS region with APPLID C68D1FM2, update files whose name begins with BIG and the file named ESDSPATH to be open and available for update.

//FMBAT EXEC PGM=FILEMGR
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
$$FILEM SETCICS APPLID=C68D1FM2,                
$$FILEM FILE=(BIG*,ESDSPATH),STATUS=(OPE,UPD)   
/*

The following report is produced:

IBM File Manager for CICS                                                                         4/29/2020 (2020.120) 14:10  Page 3
                                        CICS File Status Update Report for APPLID C68D1FM2                                          
File     Data Set                                     Attributes                  Errors                                            
------------------------------------------------------------------------------------------------------------------------------------
BIGESDS1 FMN.REGTEST.CICS.TEST.BIGESDS1               OPE ENA REA UPD ADD BRO                                                       
BIGKSDS1 FMN.REGTEST.CICS.TEST.BIGKSDS1               OPE ENA REA UPD ADD BRO DEL                                                   
BIGKSDS2 FMN.REGTEST.CICS.TEST.BIGKSDS2               OPE ENA REA UPD ADD BRO DEL                                                   
ESDSPATH FMN.REGTEST.BASE.ESDS.PATH2                  OPE ENA REA UPD ADD BRO DEL