SET GROUP & SET LIST

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

Read syntax diagramSkip visual syntax diagram
SET GROUP

>>-SET GROUP--(--group_name--)---------------------------------->

>--+-----------------------------+------------------------------>
   '-,OPENSTATUS--(-+-OPEN---+-)-'   
                    '-CLOSED-'       

>--+--------------------------------+--------------------------->
   '-,ENABLESTATUS--(-+-ENABLE--+-)-'   
                      '-DISABLE-'       

>--+------------------------+--+-------------------------+------>
   |              .-NO--.   |  '-,DSN--(-+-PRIMARY---+-)-'   
   '-,IMMQUIESCE(-+-YES-+-)-'            '-ALTERNATE-'       

>--+---------------------+-------------------------------------><
   '-,CICS--(--applid--)-'   

Syntax

Read syntax diagramSkip visual syntax diagram
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.

Reference Reference

Feedback


Timestamp icon Last updated: Monday, 2 December 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic/com.ibm.cics.bac.doc/cbka1/cbka1c08.html