CBRXVOL is an internal macro used to manipulate the volume records in the tape configuration database (TCDB). Table 1 describes the return codes.
| Return Code | Error Type | Description |
|---|---|---|
| 0 | Successful | Successful execution. |
| 4 | Request not executed | For tape volume record creation, a tape volume record with the same volume serial number is already present in the TCDB. For tape volume record update, replacement, or deletion, the requested tape volume record is not present in the TCDB. For tape volume record retrieval, the TCDB does not exist, the tape volume record is not present in the TCDB, or the tape volume record is present in the TCDB but is for an up-level volume. To distinguish between the latter two cases, flag VCP_UPLEVEL_TDSI is set if the volume record contains up-level TDSI information. For sequential tape-volume record retrieval, there are no (more) records to retrieve or the TCDB does not exist. |
| 8 | Parameter list error | Parameter list invalid for requested function. |
| 12 | Environmental error | Internal processing error. The request could not be completed due to the failure of a system service. |
| 16 | Catalog authorization error | The user of CBRXVOL does not have the SAF/RACF authority to perform the requested function on the user catalog that contains the TCDB. The return code, module ID, and reason code from the catalog service routine are contained in the VCPL, in fields VCPCTRET, VCPCTMOD, and VCPCTRSN, respectively. |
| 20 | Catalog access error | The return code, module ID, and reason code from the catalog service routine are contained in the VCPL, in fields VCPCTRET, VCPCTMOD, and VCPCTRSN, respectively. |
| 24 | Cancel the job | Either the volume not in library installation exit (CBRUXVNL) was invoked and returned with RC=8 (the installation wants to cancel the job immediately), or the volume record contains up-level TDSI information. This return code is only applicable when the EXIT keyword is specified with FUNC(RETRIEVE). |