UPDATE FILE

Function

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

Syntax

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

Description

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.

Parameters

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.

ADDIFNEW({NO|YES})
Specifies whether or not a new file object is to be added if the file named on the UPDATE FILE command does not exist in the CICS region control file.
ADDPROGRAMS(progid1,progid2…,progidn
Specifies one or more programs to be added to the list of programs in the file object record in the CICS region control file.
If you enter more than one program name, separate the names with a comma or a blank.
Note: This is the equivalent of the PROGRAMS parameter on the ADD FILE command.
ADDTRANSIDStransid-1,transid-2…,transid-n
Specifies one or more programs to be added to the list of programs in the file object record in the CICS region control file.
If you enter more than one program name, separate the names with a comma or a blank.
Note: This is the equivalent of the TRANSIDS parameter on the ADD FILE command.
REMOVEPROGRAMS(progid-1,progid-2…,progid-n])
Specifies one or more programs to be removed from the list of programs in the file object record in the CICS region control file.

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).

REMOVETRANSIDS(transid1,transid2…,transidn])
Specifies one or more transactions to be removed from the list of transactions in the file object record in the CICS region control 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).


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