The CEDA RENAME command

Use the CEDA RENAME command to change the name of a resource on the CSD or move it to a different group.

Syntax

Read syntax diagramSkip visual syntax diagram
                 .-ALl(name)--------------.   
>>-CEDA--REName--+------------------------+--------------------->
                 '-+-Atomservice(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)-'  '-AS(newname)-'   

>--+------------------+--+--------+----------------------------><
   '-TO(newgroupname)-'  '-REMove-'   

Description

You can also rename a resource definition by using the DISPLAY command or the EXPAND command with the RENAME option. See The CEDA DISPLAY command and The CEDA EXPAND command for information about these commands.

You cannot rename a resource definition to a name that already exists in the target group.

Options

AS(newname)
If you copy a definition within a group, you must use AS to rename it. You can also use AS if you want to move a definition to another group and rename it at the same time. You cannot use a generic name when using AS.
Group(groupname)
specifies the group containing the definitions to be renamed or moved. A generic group name is not accepted.
REMove
specifies that, when a group is deleted, the group is to be removed from all lists that had contained it.
resource(name)
specifies the type and name of the resource you want to move or rename. The default is ALL, which copies all the resource definitions in a group to another group. A generic resource definition name is not accepted.
TO(newgroupname)
You can move definitions to a different group, using TO to specify the new group.

Examples

  • To rename a resource and keep it in its current group:
    RENAME PROFILE(PROF1) AS(NEWPROF) GROUP(PROFS)
  • You can rename all resource definitions which share the same name, to a new name, using the ALL option instead of a resource type. For example:
    RENAME ALL(TVA) AS(XTVA) GROUP(XTVA1)
    RENAME ALL(USER) AS(OLDU) GROUP(USERDEF)
  • You can move a resource definition to a new group, which you specify in the TO option, at the same time as renaming it. (You can also do this with the MOVE command.) For example:
    RENAME PROGRAM(N20ZA) AS($SOSERR) GROUP(N20) TO($MODULES)
  • You can move all the resource definitions of the same name from one group to another, using the TO option, at the same time as renaming them. For example:
    RENAME ALL(USER) GROUP(USERDEF) AS(TEMP) TO(TEMPGRP)


dfha4_rename.html | Timestamp icon Last updated: Monday, 5 June 2017