Function
The SET GROUP command enables you to set the attributes
of all the objects, files, TD queues, transactions, and programs,
in the specified group.
The SET LIST command operates on a list of groups,
all of which are processed as in the SET GROUP command.
Syntax

SET GROUP
>>-SET GROUP--(--group_name--)---------------------------------->
>--+-----------------------------+------------------------------>
'-,OPENSTATUS--(-+-OPEN---+-)-'
'-CLOSED-'
>--+--------------------------------+--------------------------->
'-,ENABLESTATUS--(-+-ENABLE--+-)-'
'-DISABLE-'
>--+------------------------+--+-------------------------+------>
| .-NO--. | '-,DSN--(-+-PRIMARY---+-)-'
'-,IMMQUIESCE(-+-YES-+-)-' '-ALTERNATE-'
>--+---------------------+-------------------------------------><
'-,CICS--(--applid--)-'
Syntax

SET LIST
>>-SET LIST--(--list_name--)--+-----------------------------+--->
'-,OPENSTATUS--(-+-OPEN---+-)-'
'-CLOSED-'
>--+--------------------------------+--------------------------->
'-,ENABLESTATUS--(-+-ENABLE--+-)-'
'-DISABLE-'
>--+------------------------+--+-------------------------+------>
| .-NO--. | '-,DSN--(-+-PRIMARY---+-)-'
'-,IMMQUIESCE(-+-YES-+-)-' '-ALTERNATE-'
>--+---------------------+-------------------------------------><
'-,CICS--(--applid--)-'
Note: Although all the options in the SET GROUP and SET LIST syntax diagrams are shown as optional,
you must specify at least either the OPENSTATUS parameter
or
the ENABLESTATUS parameter. For example, as a minimum, the command
could be:
SET GROUP(GROUPX),OPENSTATUS(CLOSED)
or
SET LIST(LISTY),ENABLESTATUS(ENABLED)
Description
The SET GROUP and SET LIST commands apply the specified attributes,
as appropriate, to each object in the group, or each object in all
the groups in the list, as follows:
- DSN applies only to files
- OPENSTATUS applies to files and TD queues
- ENABLESTATUS applies to files, TDQueues, programs, and
transactions
Parameters
- CICS(applid)
- Specifies the applid of the CICS® region
to which this command is to be routed. If you omit this
option, the batch request utility routes the command to the default CICS region specified by the most recent DEFAULT command.
- DSN({PRIMARY | ALTERNATE})
- Specifies which data set the OPENSTATUS or ENABLESTATUS parameter
is to be applied, using the information defined in the CICS BAC control
file. The values you can specify are:
- PRIMARY
- Specify this value if you want to change the data set name associated
with the CICS file definition to the primary data set name
defined in the CICS BAC control file object record.
- ALTERNATE
- Specify this value if you want to change the data set name associated
with the CICS file definition to the alternate data set
name defined in the CICS BAC control file object record.
- ENABLESTATUS({ENABLED | DISABLED})
- Specifies whether the objects in the group or list are to be
enabled or disabled to CICS.
- OPENSTATUS({OPEN | CLOSED})
- Specifies whether all the files and TD queues in the group or
list are to be opened or closed in the CICS region.
- IMMQUIESCE({NO | YES})
- Specifies the type of quiesce command CICS BAC issues when it
determines that it must issue a quiesce for a file that references
an RLS data set. This is the equivalent of the IMMQUIESCED parameter
on the EXEC CICS SET DSNAME(name) SPI command.
See CICS BAC support for record-level sharing (RLS) for more information.