The DFHCSDUP ALTER command

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

ALTER syntax

Read syntax diagramSkip visual syntax diagramALterAtomservice( name)Bundle( name)CONnection( name)CORbaserver( name)DB2Conn( name)DB2Entry( name)DB2Tran( name)DJar( name)DOctemplate( name)Enqmodel( name)File( name)Ipconn( name)JOurnalmodel( name)JVmserver( name)LIbrary( name)LSRpool( name)MApset( name)MQconn( 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)Group(groupname )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 RDO resources.

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.

Generic naming in the ALTER command

The ALTER command accepts both generic resource names and group names.

For each resource in the CSD file matching the specified combination of resource name and group name, an ALTER is attempted. In the case of an individual ALTER failing, processing terminates when all attempts for the command have been processed.

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