Dataset Services Interface › $DSCALL OPT=RENMEM

$DSCALL OPT=RENMEM

Renames a member of a PDS.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL    OPT=RENMEM 
                DSN=dataset_name 
                MEMBER=member_name 
                NEWNAME=member_name

This call is used to rename a member of a PDS. This call fails if the specified member is in use by another user, or if a member with the new name already exists.

Operands:

OPT=RENMEM

Specifies that a member be renamed.

DSN=dataset_name

Specifies the name of the PDS containing the member. No member name is specified.

MEMBER=member_name

Specifies the member to be renamed. A member name must be provided.

NEWNAME=member_name

Specifies the new name for the member.

Return Codes:

Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.

Example: OPT=RENMEM

EXEC $DSCALL OPT=RENMEM DSN=CUSTOMER.DATA MEMBER=DEV01 +
   NEWNAME=TEST01