UPDATE TDQUEUE

Function

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

Syntax

Read syntax diagramSkip visual syntax diagram
ADD TDQUEUE

                       .---,ADDIFNEW(-NO-)----.   
>>-ADD TDQUEUE(tdqid)--+----------------------+----------------->
                       '-,ADDIFNEW(-+-YES-+-)-'   
                                    '-NO--'       

>--+---------------------------------------------------------------------------------------+-->
   '-,EXCLUDE(-+-YES--)--EXCLUDEACTION(-+-IGNORE--)------------------------------------+-+-'   
               |                        +-TERMINATE--)----EXCLUDERETCODE(returncode)---+ |     
               |                        '-ABEND--)----EXCLUDEABCODE(abendcode)---------' |     
               '-NO--)-------------------------------------------------------------------'     

>--+----------------------------------+------------------------->
   '-,STARTUPOPTS(-+-COLD---------+-)-'   
                   +-WARM---------+       
                   +-EMER---------+       
                   +-COLDWARM-----+       
                   +-COLDWARMEMER-+       
                   +-COLDEMER-----+       
                   +-WARMEMER-----+       
                   '-USECICS------'       

>--+------------------------------------------+----------------->
   '-ADDTRANSIDS(transid1,transid2…,transidn)-'   

>--+---------------------------------------------+-------------->
   '-REMOVETRANSIDS(transid1,transid2…,transidn)-'   

>--+---------------------------------------+-------------------->
   '-ADDPROGRAMS(progid1,progid2…,progidn)-'   

>--+------------------------------------------+----------------><
   '-REMOVEPROGRAMS(progid1,progid2…,progidn)-'   

Description

You can use the UPDATE TDQUEUE command to modify a TD queue object record in a CICS region control file. If a record for the specified TD queue 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 TDQUEUE command are mostly the same as on those the ADD TDQUEUE command, with the differences described below. For details of the parameters that are common, see the ADD TDQUEUE command.

ADDIFNEW({NO|YES})
Specifies whether or not a new TD queue object is to be added if the TD queue named on the UPDATE TDQUEUE 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 TD queue 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 TDQUEUE command.
ADDTRANSIDStransid-1,transid-2…,transid-n
Specifies one or more transactions to be added to the list of transactions in the TD queue 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.
Note: This is the equivalent of the TRANSIDS parameter on the ADD TDQUEUE 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).