Update an existing file object in the CICS region control file.
UPDATE FILE .---,ADDIFNEW(-NO-)----. >>-UPDATE FILE(filename)--+----------------------+--------------> '-,ADDIFNEW(-+-YES-+-)-' '-NO--' >--+-----------------------------------------------------------------------------------------+--> '-,EXCLUDE(-+-YES--)--,EXCLUDEACTION(-+-IGNORE--)-------------------------------------+-+-' | +-TERMINATE--)----,EXCLUDERETCODE(returncode)---+ | | '-ABEND--)----,EXCLUDEABCODE(abendcode)---------' | '-NO--)---------------------------------------------------------------------' >--+----------------------------------+-------------------------> '-,STARTUPOPTS(-+-COLD---------+-)-' +-WARM---------+ +-EMER---------+ +-COLDWARM-----+ +-COLDWARMEMER-+ +-COLDEMER-----+ +-WARMEMER-----+ '-USECICS------' >--+---------------------------+--------------------------------> '-,PRIMARYDSN--(--dsname--)-' >--+-----------------------------+------------------------------> '-,ALTERNATEDSN--(--dsname--)-' >--+------------------------------------------------------------+--> '-,RLSOPTIONS(-+-IGNORE--)---------------------------------+-' +-PROCESS--)--------------------------------+ +-TERMINATE--)----,RLSRETCODE(returncode)---+ +-ABEND--)----,RLSABCODE(abendcode)---------+ '-TAKE--)-----------------------------------' >--+-------------------------------------------+----------------> '-,ADDTRANSIDS(transid1,transid2…,transidn)-' >--+----------------------------------------------+-------------> '-,REMOVETRANSIDS(transid1,transid2…,transidn)-' >--+---------------------------------------------------+--------> '-,ADDPROGRAMS | PROGRAMS(progid1,progid2…,progidn)-' >--+-------------------------------------------+--------------->< '-,REMOVEPROGRAMS(progid1,progid2…,progidn)-'
You can use the UPDATE FILE command to modify a file object record in a CICS region control file. If a record for the specified file 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.
The parameters on the UPDATE FILE command are mostly the same as on those the ADD file command, with the differences described below. For details of the parameters that are common, see the ADD FILE command.
If you enter more than one program name, separate the names with a comma or a blank.
For more information, see the PROCESSPROGRAMS parameter on the SET file command on page SET FILE).
If you enter more than one transaction ID, separate the IDs with a comma or a blank.
For more information, see the PROCESSTRANSIDS parameter on the SET file command on page SET FILE).