z/OS DFSMSdfp Advanced Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return Codes from RENAME

z/OS DFSMSdfp Advanced Services
SC23-6861-01

Control returns to the instruction following the instructions generated by the RENAME macro. Register 15 contains the DADSM return code as shown in Table 1.

DADSM RENAME returns 4 bytes of diagnostic information in register 0. If an error occurs, DADSM issues message IEC614I, consisting of failure-related information including the return code and the 4 bytes of diagnostic information. See z/OS DFSMSdfp Diagnosis for a description of this information.

Each volume's volume list entry contains the rename status code as shown in Table 1. To determine whether the data set has been successfully renamed on each volume, check the rename status code, contained in the last byte of each entry in the volume list.

Table 1 describes the conditions indicated by the DADSM return code.

Table 1. DADSM RENAME Return Codes
Return Code Description
000 (X'00') If the 4 bytes of diagnostic information returned in register 0 are all zeros, the data set has been successfully renamed. If they are nonzero, use the DADSM RENAME diagnostic information tables in z/OS DFSMSdfp Diagnosis to determine the failure-related conditions.
004 (X'04') No volume containing any part of the data set was mounted. The data set can be a VIO data set but cannot be renamed.
008 (X'08') An unusual condition was encountered on one or more volumes. The diagnostic information is in register 0. Use the DADSM RENAME diagnostic information tables in z/OS DFSMSdfp Diagnosis to determine the failure-related conditions.
012 (X'0C') One of the following conditions occurred:
  • The DADSM RENAME parameter list is not valid.
  • The volume list is not valid.
  • At entry to RENAME, register 0 was not zero and did not point to a valid UCB. The address must be that of a UCB, not a UCB copy.

The RENAME status code will not have been set.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014