This SAS Note provides supplementary information about the RENAME function under z/OS for the "RENAME Function" section of SAS 9.4 Functions and CALL Routines: Reference.

Native-cataloged data sets under z/OS are not currently supported by the RENAME function. However, the RENAME function does work for some native-cataloged data sets, but it might incorrectly generate a return code (RC) of 1. Here is a detailed description of how the RENAME function performs in the various environments under z/OS:

• Under zFS, which is the UNIX File System under Open-Edition MVS (OMVS), the RENAME function works as expected. For example, when the rename for a file is successfully performed, the RC from the function is set to 0. When the rename fails, the RC from the function is set to 1, and no error message is returned.
• Single-volume native file-system data sets under z/OS are successfully renamed using the RENAME function. However, the RC from the function is incorrectly set to 1, and no error message is returned.
• Multi-volume native file-system data sets under z/OS are not renamed using the RENAME function. The RC from the function is set to 1, and no error message is returned.

Note: When the RENAME function is unable to rename a z/OS native-cataloged data set and generates a nonzero RC, the RC for the job step is not affected. The programmer must test all the function RCs and address any issues.

It is recommended that you do not use the RENAME function for z/OS native-cataloged data sets at this time.