UPDATE TRANSID

Function

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

Syntax

Read syntax diagramSkip visual syntax diagramUPDATE TRANSID
 
                            .---,ADDIFNEW(-NO-)----.
>>-UPDATE TRANSID(transid)--+----------------------+------------>
                            '-,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 TRANSID command to modify a transaction object record in a CICS region control file. If a record for the specified transaction 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 TRANSID command are the same as on those the ADD TRANSID 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 transaction object is to be added if the transaction named on the UPDATE TRANSID command does not exist in the CICS region control file.