ADD APPLIST

Function

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

Syntax

Read syntax diagramSkip visual syntax diagram
ADD APPLIST

                          .---,REPLACE(-NO-)----.   
>>-ADD APPLIST(listname)--+---------------------+--------------->
                          '-,REPLACE(-+-YES-+-)-'   
                                      '-NO--'       

>--+------------------------------------------------------+----><
   '-,GROUPS(groupname-1[, groupname-2, ...,groupname-n])-'   

Description

If you have multiple application groups in a CICS region control file, you can combine them into an application list that can be processed as a single object during batch request utility job steps.

Parameters

APPLIST(listname)
Specifies the name of the application list that is to contain one or more application group names.
GROUPS(groupname-1[, groupname-2, ...,groupname-n])
Specifies the names of the application groups that are to comprise the application list. If you specify more than one group name, separate the names with a comma or a blank.

The maximum number of group names you can add is 512.

REPLACE({NO|YES})
Specifies the action the file maintenance utility is to take if an application list object record already exists for the application list name you are trying to add.
NO
If there is already an application list object in the CICS region control file for this application list name, reject the ADD APPLIST command.
YES
If there is already an application list object in the CICS region control file for this application list name, replace it with the information in this ADD APPLIST command.