ADD APPGROUP

Function

Add a new application group object to the target CICS region control file.

Syntax

Read syntax diagramSkip visual syntax diagram
ADD APPGROUP

                            .---,REPLACE(-NO-)----.   
>>-ADD APPGROUP(groupname)--+---------------------+------------->
                            '-,REPLACE(-+-YES-+-)-'   
                                        '-NO--'       

>--+-----------------------------------------------+------------>
   '-,FILES(filename-1[,filename-2,..,filename-n])-'   

>--+--------------------------------------------+--------------->
   '-,PROGRAMS(progid-1[,progid-2,..,progid-n])-'   

>--+-----------------------------------------+------------------>
   '-,TDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])-'   

>--+-----------------------------------------------+-----------><
   '-,TRANSIDS(transid-1[,transid-2,..,transid-n])-'   

Description

When you have created CICS region definitions and related resource object definitions, you can associate some of them with a specific application, such as a payroll application. You give the application group a name that is identifies it with the application, and add objects that are used by the application. You can also remove objects that are no longer applicable to the application.
Note: A resource object does not necessarily have to be defined in the control file to be included in an application group. You can add a resource to a group that is not defined in the control file, and it will be processed as part of a SET GROUP command if the CICS region undefined object processing options permit it. See the UNDEFINEDxxxx set of parameters on the UPDATE REGION command on page UPDATE REGION.

Parameters

Note: When adding file names, program names, TD queue IDs, transaction IDs to a group, the total number of all objects cannot exceed 512.
APPGROUP(groupname)
Specifies the name of the application group that is to contain the names of the resources that make up the application group.
FILES(filename-1[,filename-2,..,filename-n])
Specifies the name of one or more files to be added to the application group. File names must be valid CICS file names up to a maximum of 8 characters.

If you enter more than one file name, separate the names with a comma or a blank.

PROGRAMS(progid-1[,progid-2,..,progid-n])
Specifies the name of one or more programs to be added to the application group. Program names must be valid CICS program names up to a maximum of 8 characters.

If you enter more than one program name, separate the names with a comma or a blank.

REPLACE({NO|YES})
Specifies the action the file maintenance utility is to take if an application group object record already exists for the application group name you are trying to add.
NO
If there is already an application group object in the CICS region control file for this application group name, reject the ADD APPGROUP command.
YES
If there is already an application group object in the CICS region control file for this application group name, replace it with the information in this ADD APPGROUP command.
TDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])
Specifies the name of one or more TD queues to be added to the application group. TD queue IDs must be valid CICS TD queue IDs up to a maximum of 4 characters.

If you enter more than one TD queue ID, separate the IDs with a comma or a blank.

TRANSIDS(transid-1[,transid-2,..,transid-n])
Specifies the name of one or more transaction IDs to be added to the application group. Transaction IDs must be valid CICS transaction IDs up to a maximum of 4 characters.

If you enter more than one transaction ID, separate the IDs with a comma or a blank.