The CEDA RENAME command

Rename a resource definition to the new name specified in the AS option.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-CEDA--REName--+--------------------+--+------------------+--->
                 +-ALl(name)----------+  '-Group(groupname)-'   
                 +-Connection(name)---+                         
                 +-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)------+                         
                 +-PROCesstype(name)--+                         
                 +-PROFile(name)------+                         
                 +-PROGram(name)------+                         
                 +-REQuestmodel(name)-+                         
                 +-Sessions(name)-----+                         
                 +-TCpipservice(name)-+                         
                 +-TDqueue(name)------+                         
                 +-TErminal(name)-----+                         
                 +-TRANClass(name)----+                         
                 +-TRANSaction(name)--+                         
                 +-TSmodel(name)------+                         
                 '-TYpeterm(name)-----'                         

>--+-------------+--+------------------+--+--------+-----------><
   '-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.

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 copy 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 copied. 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 resource you want to copy. 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 copy 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)

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