The CEDA ALTER command

Use the CEDA ALTER command to change some or all of the attributes of an existing resource definition.

Syntax

Read syntax diagramSkip visual syntax diagramCEDA ALterAtomservice( 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

Important: 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. For example:
  • The command: 
    ALTER FILE(TEST) GROUP(ACT1) RLSACCESS()
    behaves as if RLSACCESS was not specified. The RLSACCESS attribute has a CVDA default value which is ignored.
  • The command: 
    ALTER FILE(TEST) GROUP(ACT1) DESCRIPTION()
    has the effect of blanking out the description, as there is no default value for the DESCRIPTION field, and it is option.
  • The command: 
    ALTER FILE(TEST) GROUP(ACT1) PROFILE()
    puts the default value of DFHCICSA into the PROFILE field. In this case, the default value is a character string, not a CVDA value.

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

You can use CEDA ALTER from a DISPLAY panel. If you use PF12 after making your alterations, CEDA gives you the DISPLAY panel again, with an 'ALTER SUCCESSFUL' message in the Date and Time fields. If you do this but do not make any alterations, an asterisk replaces your 'ALTER' command.

With a generic name, you can use one ALTER command to change the same attributes in the same way on more than one resource definition.

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 type and name of the resource whose attributes you want to alter.

Examples

  • To make a program resident: 
    ALTER PROGRAM(ERR01) GROUP(GENMODS) RESIDENT(YES)
      DATALOCATION()
    If you do not specify an attribute list and type in: 
    ALTER PROGRAM(ERR01) GROUP(GENMODS)
    CEDA gives an “ALTER SUCCESSFUL” message followed by the 'overtype to modify' panel.
  • To change the status of a whole group of programs: 
    ALTER PROGRAM(*) GROUP(GENMODS) STATUS(ENABLED)