Move one or more resource definitions from the
group named by the GROUP option to the group named by the TO option.
Syntax

.-All----------------.
>>-CEDA--Move--+--------------------+--------------------------->
+-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)-+
+-PROCesstype(name)--+
+-PROFile(name)------+
+-PROGram(name)------+
+-Requestmodel(name)-+
+-Sessions(name)-----+
+-TCpipservice(name)-+
+-TDqueue(name)------+
+-TErminal(name)-----+
+-TRANClass(name)----+
+-TRANSaction(name)--+
+-TSmodel(name)------+
'-TYpeterm(name)-----'
>--Group(groupname)-+--------+---------------------------------->
'-REMove-'
>--+-AS(newname)------------------+--+---------+---------------><
+-TO(newgroupname)-------------+ +-REPlace-+
'-AS(newname) TO(newgroupname)-' '-MErge---'
Description
This command has the effect of copying
the resource definitions from the first group into the second, followed by
the deletion of the resource definitions from the first group.
When
you MOVE the last resource in a group TO a different group, the group is automatically
deleted. An empty group cannot exist.
If you do not specify either
MERGE or REPLACE, a message warns you that you are attempting to create duplicate
resource definitions. The definitions are not moved.
Options
- AS(newname)
- If you move 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 moved.
- MErge
- This applies when there are duplicate definition names in the groups named
in the MOVE command. If you specify MERGE, duplicate definitions in the TO
group are not replaced.
- REMove
- specifies that, when a group is deleted because the last resource in
the group is moved elsewhere, the group is to be removed from all lists that
had contained it.
- REPlace
- This applies when there are duplicate definition names in the groups named
in the MOVE command. If you specify REPLACE, the definitions being moved replace
those in the group named in the TO operand.
- resource(name)
- specifies the resource you want to move. The default is ALL, which moves
all the resource definitions in a group to another group.
- TO(newgroupname)
- You can move definitions to a different group, using TO to specify the
new group.
Examples
When you move a single resource definition,
you can simultaneously rename it, using the AS option to specify the new name.
For example:
MOVE PARTITIONSET(PSETQ1) GROUP(PSET1) AS(PSETQ4)
TO(PSET2)
A generic resource definition name can be specified,
to move all or some definitions of the same resource type. For example:
MOVE TRANSACTION(*) GROUP(DENTRY) TO(TEST1)
MOVE MAPSET(ACCT+++) GROUP(ACCOUNTS1) TO(ACCOUNTS2)
To
move all the resource definitions in a group to the new group, you can use
ALL. For example:
MOVE ALL GROUP(N21TEST) TO(N21PROD)
You
can use ALL with a generic name, to move all qualifying resource definitions
in the group to the new group. For example:
MOVE ALL(N21*) GROUP(N21OLD) TO(N21NEW)
You
can use ALL with a specific name, to move all the resource definitions of
that name (which must be for different resource types) in the group to the
new group. For example:
MOVE ALL(XMPL) GROUP(EXAMPLE) TO(EXAMPLE2)
To
merge definitions from group X in with the definitions in group Y, keeping
the Y version of any duplicates:
MOVE GROUP(X) TO(Y) MERGE
To
combine definitions from group X in with definitions in group Y, keeping the
X version of any duplicates:
MOVE GROUP(X) TO(Y) REPLACE