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

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 UNDEFINED
xxxx 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.