UPDATE APPGROUP

Function

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

Syntax

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

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/cbka1f18.html