Function
Update an existing application group object record in the target
CICS region control file.
Syntax

UPDATE APPGROUP
.---,ADDIFNEW(-NO-)----.
>>-UPDATE APPGROUP(groupname)--+----------------------+--------->
'-,ADDIFNEW(-+-YES-+-)-'
'-NO--'
>--+--------------------------------------------------+--------->
'-,ADDFILES(filename-1[,filename-2,..,filename-n])-'
>--+-----------------------------------------------+------------>
'-,ADDPROGRAMS(progid-1[,progid-2,..,progid-n])-'
>--+--------------------------------------------+--------------->
'-,ADDTDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])-'
>--+--------------------------------------------------+--------->
'-,ADDTRANSIDS(transid-1[,transid-2,..,transid-n])-'
>--+-----------------------------------------------------+------>
'-,REMOVEFILES(filename-1[,filename-2,..,filename-n])-'
>--+--------------------------------------------------+--------->
'-,REMOVEPROGRAMS(progid-1[,progid-2,..,progid-n])-'
>--+-----------------------------------------------+------------>
'-,REMOVETDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])-'
>--+-----------------------------------------------------+-----><
'-,REMOVETRANSIDS(transid-1[,transid-2,..,transid-n])-'
Description
You can use the UPDATE APPGROUP command to modify an application
group object record in a CICS region control file. If a record for
the specified application group that you are trying to update does
not exist in the region control file, the action taken by the file maintenance utility is
determined by the ADDIFNEW parameter.
Parameters
- ADDFILES(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.
- ADDIFNEW({NO|YES})
- Specifies whether or not a new application group object is to
be added if the application group named on the UPDATE APPGROUP command
does not exist in the CICS region control file.
- ADDPROGRAMS(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 application program
names up to a maximum of 8 characters.
- ADDTDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])
- Specifies the ID 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.
- ADDTRANSIDS(transid-1[,transid-2,..,transid-n])
- Specifies ID 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.
- REMOVEFILES(filename-1[,filename-2,..,filename-n])
- Specifies the name of one or more files to be removed from the
application group. File names must be valid CICS file names up to
a maximum of 8 characters.
- REMOVEPROGRAMS(progid-1[,progid-2,..,progid-n])
- Specifies the name of one or more programs to be removed from
the application group. Program names must be valid CICS application
program names up to a maximum of 8 characters.
- REMOVETDQUEUES(tdqid-1[,tdqid-2,..,tdqid-n])
- Specifies the ID of one or more TD queues to be removed from
the application group. TD queue IDs must be valid CICS TD queue IDs
up to a maximum of 4 characters.
- REMOVETRANSIDS(transid-1[,transid-2,..,transid-n])
- Specifies ID of one or more transaction IDs to be removed from
the application group. Transaction IDs must be valid CICS transaction
IDs up to a maximum of 4 characters.