The DFHCSDUP ALTER command

Change some or all of the attributes of an existing resource definition.

Read syntax diagramSkip visual syntax diagram
ALTER syntax

>>-ALter----+-CONnection(name)---+----Group--(--groupname--)---->
            +-CORbaserver(name)--+                             
            +-DB2Conn(name)------+                             
            +-DB2Entry(name)-----+                             
            +-DB2Tran(name)------+                             
            +-DJar(name)---------+                             
            +-DOctemplate(name)--+                             
            +-Enqmodel(name)-----+                             
            +-File(name)---------+                             
            +-Journalmodel(name)-+                             
            +-LSRpool(name)------+                             
            +-Mapset(name)-------+                             
            +-PARTItionset(name)-+                             
            +-PARTNer(name)------+                             
            +-PIpeline(name)-----+                             
            +-PROCesstype(name)--+                             
            +-PROFile(name)------+                             
            +-PROGram(name)------+                             
            +-Requestmodel(name)-+                             
            +-Sessions(name)-----+                             
            +-TCpipservice(name)-+                             
            +-TDqueue(name)------+                             
            +-TErminal(name)-----+                             
            +-TRANClass(name)----+                             
            +-TRANSaction(name)--+                             
            +-TSmodel(name)------+                             
            +-TYpeterm(name)-----+                             
            +-Urimap(name)-------+                             
            '-Webservice(name)---'                             

>--attribute list--(--new value--)-----------------------------><

Description

For information about the attributes that you can specify on the ALTER command for the various resource types, and for a description of the attributes and default values of each resource type, see **** MISSING FILE ****.

Do not use ALTER to change the value of the attributes of a TYPETERM definition on which other attributes depend. If you make a mistake with DEVICE, SESSIONTYPE, or TERMMODEL, delete the definition and define a new one with the correct values.

You can specify null attribute values, for example:
ALTER FILE(TEST) GROUP(ACT1) DESCRIPTION()
If an attribute for which you have specified a null value has a default, the value used depends upon the type of field:
  • The command:
    ALTER FILE(TEST) GROUP(ACT1) RLSACCESS() DESCRIPTION()
    uses the default value of NO for RLSACCCESS and the description is blanked out.
  • The command:
    ALTER FILE(TEST) GROUP(ACT1) PROFILE()
    uses the default value DFHCICSA for the PROFILE field.

Changes to resource definitions in the CSD file do not take effect, in a running CICS® system, until you install the group in which the resource definition resides.

Options

Attribute list
specifies the attributes to be altered.
Group(groupname)
specifies the name of the group containing the resource to be altered.
Resource(name)
specifies the resource whose attributes you want to alter. You can specify a generic name by using the characters + and *.

Examples

To make a program resident:
ALTER PROGRAM(ERR01) GROUP(GENMODS) RESIDENT(YES)
     DATALOCATION()
To make all programs in the group GENMOD resident:
ALTER PROGRAM(*) GROUP(GENMOD) RESIDENT(YES)
    DATALOC()