Example

In the following example, data set A.B.C is renamed D.E.F. The data set resides on two volumes.

         SR      0,0             SET REG 0 TO ZERO
         RENAME  DSABC           CHANGE DATA SET
                                 NAME A.B.C TO D.E.F
 
DSABC    CAMLST  RENAME,OLDNAME,NEWNAME,VOLIST
OLDNAME  DC      CL44'A.B.C'     OLD DATA SET NAME
NEWNAME  DC      CL44'D.E.F'     NEW DATA SET NAME
VOLIST   DC      H'2'            TWO VOLUMES
         DC      X'3030200E'     3380 DISK DEVICE CODE
         DC      CL6'000017'     VOLUME SERIAL NO.
         DC      H'0'            RENAME STATUS CODE
         DC      X'3030200E'     3380 DISK DEVICE CODE
         DC      CL6'000018'     VOLUME SERIAL NO.
         DC      H'0'            RENAME STATUS CODE

Recommendation: Check the return codes and RENAME status codes.

The RENAME macro instruction points to the CAMLST macro instruction. The RENAME operand specifies that a data set be renamed. OLDNAME specifies the virtual storage location of a 44-byte area where you have placed the fully-qualified name of the data set to be renamed. NEWNAME specifies the virtual storage location of a 44-byte area where you have placed the new name of the data set. VOLIST specifies the virtual storage location of the volume list you have built.