CSD RENAME

Description

The CSD RENAME command renames an individual resource definition in a specified group.

A syncpoint is implicit in CSD RENAME 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 the 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 containing the resource definition to be renamed.

RESID(data-value)

Specifies the 8-character name of the resource to be renamed. Resource names that are only four characters in length must be padded with four blanks and passed in an 8-character field.

Conditions

CSDERR

RESP2 values:

1

The CSD cannot be read.

2

The CSD is read only.

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 specified resource definition already exists.

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 or AS option contains one or more characters that are 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 specified group is already locked to another user.

2

The 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 specified group cannot be found.