UPDATE PROGRAM

Function

Update an existing program object in the CICS region control file.

Syntax

Read syntax diagramSkip visual syntax diagramUPDATE PROGRAM
 
                             .---,ADDIFNEW(-NO-)----.
>>-UPDATE PROGRAM(progname)--+----------------------+----------->
                             '-,ADDIFNEW(-+-YES-+-)-'
                                          '-NO--'
 
>--+-----------------------------------------------------------------------------------------+-->
   '-,EXCLUDE(-+-YES--)--,EXCLUDEACTION(-+-IGNORE--)-------------------------------------+-+-'
               |                         +-TERMINATE--)----,EXCLUDERETCODE(returncode)---+ |
               |                         '-ABEND--)----,EXCLUDEABCODE(abendcode)---------' |
               '-NO--)---------------------------------------------------------------------'
 
>--+----------------------------------+------------------------><
   '-,STARTUPOPTS(-+-COLD---------+-)-'
                   +-WARM---------+
                   +-EMER---------+
                   +-COLDWARM-----+
                   +-COLDWARMEMER-+
                   +-COLDEMER-----+
                   +-WARMEMER-----+
                   '-USECICS------'
 

Description

You can use the UPDATE PROGRAM command to modify a program object record in a CICS region control file. If a record for the specified program 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

The parameters on the UPDATE PROGRAM command are the same as on those the ADD PROGRAM command, with the exception of the ADDIFNEW parameter instead of REPLACE. For details of the parameters that are common, see the ADD PROGRAM command.

ADDIFNEW({NO|YES})
Specifies whether or not a new program object is to be added if the program named on the UPDATE PROGRAM command does not exist in the CICS region control file.