The CEDA COPY command
Use the CEDA COPY command to copy a resource definition, either within the same group or to a different group on the CSD.
Syntax
Description
If you do not specify either MERGE or REPLACE, a message warns you that you are attempting to create duplicate resources, and your COPY will be unsuccessful.
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.
- MErge
- This applies when there are duplicate definition names in the groups named in the COPY command. If you specify MERGE, duplicate definitions in the TO group are not replaced.
- Replace
- This applies when there are duplicate definition names in the groups named in the COPY command. If you specify REPLACE, the definitions being copied replace those in the group named in the TO operand.
- resource(name)
- specifies the type and name of the resource whose attributes you want to copy.
- TO(newgroupname)
- You can copy definitions to a different group, using TO to specify the new group.
Examples
You can copy a single resource definition
into a new group, using the TO option to specify the new group. For example:
COPY SESSIONS(L122) GROUP(CICSC1) TO(CICSC2)
You
can copy a resource definition within the same group. If you do this, you
must rename it using the AS option. For example:
COPY TERMINAL(TD12) AS(TD34) GROUP(TERMVDU1)
When
copying between groups, you can give the copy a new name, using the AS option
to specify the new name.
COPY PROGRAM(ABC01) GROUP(XYZ) AS(ABC02) TO(NEWXYZ)
(If you leave the copy with the same name as the original definition, be careful that you install the one you want when the time comes.)
Using the ALL
option, without a name, you can copy all the resource definitions in the group
to the new group. For example:
COPY ALL GROUP(N21TEST) TO(N21PROD)
You can copy more than one resource definition to a new group, using the TO option to specify the new group.
Using a generic resource definition name,
you can copy all or some definitions of the same resource type to the new
group. For example:
COPY CONNECTION(*) GROUP(CICSG1) TO(CICSG2)
COPY PROGRAM(N21++) GROUP(NTEST) TO(NPROD)
Using the ALL
option with a generic name, you can copy all or some of the resource definitions
in the group to the new group. For example:
COPY ALL(N21*) GROUP(N21OLD) TO(N21NEW)
Using
the ALL option with a specific name, you can copy all the resource definitions
of that name (which must necessarily be for different resource types) in the
group to the new group. For example:
COPY ALL(XMPL) GROUP(EXAMPLE) TO(EX2)
If
you are copying a number of definitions into another group, and the groups
contain duplicate resource names, you must specify either MERGE or REPLACE.
For example:
COPY ALL GROUP(TAX1) TO(TAX2) MERGE
COPY ALL GROUP(TAX1NEW) TO(TAX1) REPLACE
The following
example copies a group named GA001 to a group named GA002, which already exists,
replacing any duplicate resource definitions by those in group GA001.
COPY GROUP(GA001) TO(GA002) REPLACE
The
following example copies group GA003 to group GA004, but if any duplicate
definitions occur, preserves the group GA004 definitions.
COPY GROUP(GA003) TO(GA004) MERGE