CSD COPY
Copy a resource definition in a group to a different group, or copy an entire group.
Description
The CSD COPY command performs
the following operations:
- Copy an individual resource definition to the same group with a new name by using the RESTYPE, RESID and AS options but not TO.
- Copy an individual resource definition to a different group by using the RESTYPE, RESID and TO options.
- Copy an entire group by using the TO option without RESTYPE and RESID.
A syncpoint is implicit in CSD COPY processing, except when an exception condition is detected early in processing the command. Uncommitted changes to recoverable resources made up to that point in the task are committed if the command is successful, and rolled back if not.
Options
- AS(data-value)
- Specifies the new 8-character name of an individual resource definition. For resources with 4-character names, the first four characters of this value are used.
- GROUP(data-value)
- Specifies the 8-character name of the group to be copied, or the group that contains the individual resource definition to be copied.
- DUPACTION(cvda)
- Specifies the required action when there are duplicate definitions
in the target group. The default value is DUPERROR. CVDA values are
as follows:
- DUPERROR
- Raises the DUPRES condition for duplicate definitions.
- DUPNOREPLACE
- Specifies that duplicate definitions in the target group are not replaced.
- DUPREPLACE
- Specifies that duplicate definitions in the target group are replaced.
- RESID(data-value)
- Specifies the 8-character name of the individual resource definition to be copied. Resource names such as TRANSACTION that are only four characters must be padded with four blanks and passed in an 8-character field.
- RESTYPE(cvda)
- Specifies the type of resource definition to be copied. CVDA values are the resource type names.
- TO
- Specifies the 8-character name of the group to which the individual resource definition or whole group is to be copied. If an individual resource definition is specified and the TO option is not, the resource definition is copied in the same group. In this case you must specify the AS option. You must use the TO option if a whole group is to be copied. In all cases, the TO group is created if it does not exist.
Conditions
- CSDERR
- RESP2 value:
- 1
- The CSD could not be read.
- 2
- The CSD is read only.
- 3
- The CSD is full.
- 4
- The CSD is being used by another CICS system and is not configured for sharing
- 5
- Insufficient VSAM strings (CSDSTRNO system initialization parameter value) are available to run the EXEC CICS CSD command.
- DUPRES
- RESP2 value:
- 1
- The group exists already (for a whole group copy) or one or more of the resource definitions to be created by the COPY already exists and DUPACTION was set or defaulted to DUPERROR.
- 2
- The name specified in the GROUP or TO option is present in the CSD as a list.
- INVREQ
- RESP2 values:
- 1
- The resource type specified for RESTYPE is not valid.
- 2
- The GROUP option contains one or more characters that are not valid.
- 4
- The RESID option contains one or more characters that are not valid.
- 7
- The TO option contains one or more characters that are not valid.
- 9
- The DUPACTION value is not valid.
- 200
- The command was run in a program defined with an EXECUTIONSET value of DPLSUBSET or in a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
- LOCKED
- RESP2 values:
- 1
- The target group is locked to another user.
- 2
- The target group is IBM protected.
- NOTAUTH
- RESP2 value:
- 100
- The user associated with the issuing task is not authorized to use this command.
- NOTFND
- RESP2 values:
- 1
- The specified resource definition cannot be found.
- 2
- The source group cannot be found.