CBRXLCS return and reason codes

Note:
  1. The return code is placed in register 15 and in the LCSPL in field LCSRCODE.
  2. The reason code is placed in register 0 and in the LCSPL in field LCSREAS.
  3. If an asterisk ("*") appears after a reason code in the table below, additional diagnostic information is available in the LCSPL.
Table 1. CBRXLCS Return and Reason Codes
Return Code Error Type Reason Code Meaning
0 Successful 0 Successful execution.
4 Warning 4 Request was to change to scratch but volume was already scratch.
    5 Request was to change to private but volume was already private.
    8 Scratch volume threshold processing did not successfully complete. Check the console log for further diagnostic information.
    48 Storage group state is not connected, disabled new, or disabled all.
    51 Specific volume serial request for a scratch volume.
    52 Volume is not library resident.
    55 Volume is not eligible because it is library resident but the device is not defined to the same tape library.
    61 Unable to access library manager inventory. If VOLINFO keyword was specified, TVI contains only TCDB information.
    63 Volume record not found in the TCDB.
    70 Volume is not found in library manager inventory. If VOLINFO keyword was specified, TVI contains only TCDB information.
    120 Volume is not eligible because the type of media defined in the volume record cannot be mounted on the specified device.
    121 Volume is not eligible because the type of media specified in the TDSI does not match the media type in the volume record.
    122 Volume is not eligible because the volume record reflects an error status.
    123 Volume is ineligible because the specified recording technology is incompatible with the volume media type or the specified drive type.
    131 Scratch volume threshold processing not performed because library was not operational.
    134 No volume record was found in the TCDB; volume resides in specified library. If VOLINFO was specified, TVI contains only library manager information.
    135 Volume resides in specified library; volume record library and specified library do not match. If VOLINFO was specified, TVI contains TCDB information and library manager information from the specified library.
    136 Volume does not reside in specified library; volume record library and specified library do not match. If VOLINFO was specified, TVI contains only volume TCDB information.
    137 Unable to access the library manager of the specified library; volume record library and specified library do not match. If VOLINFO was specified, TVI contains only volume TCDB information.
    138 Library scratch count was not updated in TCDB.
    139 Specified library and volume record MTL library name do not match.
    322 Command rejected by the library.
    323 Unable to retrieve policy names from the library
8 Invalid request 9 Required type parameter not specified.
    10 Mutually exclusive required parameters specified.
    11 Invalid value specified for type.
    12 Required function parameter not specified.
    13 Invalid value specified for function.
    14 Required use parameter not specified.
    15 Invalid value specified for use.
    16 Required volume parameter not specified.
    17 Invalid volume serial specified.
    18 Required UCB address not specified.
    19 Invalid address specified for UCB.
    20 Required volume list not specified.
    21 Invalid header value specified in volume list.
    22 Invalid header value specified in storage group list.
    23 Required library name parameter not specified.
    24 Invalid volume list, mixed media, rewritable and worm volumes.
    25 Invalid expiration date specified.
    26 Library is not defined to a storage group in the active configuration.
    27 Invalid library name specified.
    28 Invalid write protection date specified.
    29 Invalid address specified for parameter list or mapping macro.
    30 Specified storage not aligned on fullword boundary.
    31 Required TDSI parameter not specified.
    32 Required library ID or library name not specified.
    33 Invalid library ID specified.
    34 Invalid storage group name specified.
    35 Required media type not specified for MCE volume.
    38 Invalid compaction type specified in TDSI.
    39 Invalid value specified for special attribute in TDSI.
    40 Invalid combination of TDSI values specified.
    41 Ambiguous TDSI combination specified.
    42 Special attribute specified where not allowed or not applicable.
    43 Invalid pointer to TDSI specified.
    44 Invalid value specified for the DISP keyword.
    47 Not all volumes in input list associated with same storage group.
    51 Specific volume serial request for a scratch volume.
    53 Library not defined to active configuration.
    54 Storage group not of type tape.
    92 Library specified for the MCE function is not a manual tape library.
    94 Specified volume already resides in another library.
    97 Volume of same volser is a known DASD volume.
    130 Specified volume already resides in this tape library.
    201 Volume already ejected (not in library).
    202 Invalid value specified for eject option.
    203 Invalid value specified for bulk eject.
    204 Invalid TSO/E user ID specified.
    215 Not all volumes have same recording technology.
    216 MTL cannot be specified as LIBNAME with TCDBCHK= NO specification.
    217 At least one optional keyword must be specified with the function.
    218 Required datatype not specified.
    219 Invalid policy name specified.
    220 Mutually exclusive optional keywords specified.
    221 Invalid storage header and/or length specified.
12 Failure 6 Request failed because change use attribute processing has been disabled.
    7 Request failed because installation exit vetoed the change.
    45 Library name not defined in tape configuration database.
    46 No enabled storage groups.
    48 Storage group state is not connected, disabled all, or disabled new.
    49 No device pools exist to fulfill request for TDSI specification.
    52 Volume is not library resident.
    53 Library not defined to active configuration.
    56 No library associated with input storage groups or the library is unknown.
    58 Failure accessing volume record in tape configuration database.
    59 Failure accessing library record in tape configuration database.
    60 Failure accessing SMS storage group constructs.
    61 Device services failure.
    62 Specified library is not defined to the active SMS configuration.
    63 Volume record not found for requested volume.
    64 Library record not found.
    65 Library logical type not defined.
    66 No device pools exist to fulfill request for recording technology.
    67 No device pools exist to fulfill request for media type.
    69 Request failed because volume not in library installation exit (CBRUXVNL) said to cancel the job.
    70 Failure because volume not in library manager inventory.
    74 Request failed because volume serial number already exists in library manager inventory.
    75 * Unexpected UCBSCAN error encountered while validating volume serial number.
    78 * Error encountered when attempting to retrieve volume record.
    79 * Error encountered when attempting to update volume record.
    81 LCS external services unable to obtain storage.
    82 Installation exit abended.
    83 Installation exit returned invalid return code or data.
    84 * Abend occurred during LCS external services processing.
    93 Library is offline, pending offline, or not operational.
    95 Installation exit vetoed the entry of the volume into the library.
    96 Installation exit said to ignore the volume.
    300 OAM abend during eject request processing.
    302 Eject request already pending for volume.
    303 Unable to make user address space nonswappable.
    304 Tape configuration database access error.
    305 Tape configuration database authorization error.
    306 OAM internal error.
    307 Specified volume serial not in tape configuration database.
    310 Media type or recording technology not supported at this software level.
    312 Requested function is incompatible with the library
    313 Requested volume is currently in use
    314 Import/Export operation is already in progress or host processing of the operation is not complete.
    315 There are not enough physical drives available in the VTS to perform Import/Export operation
    316 Cancel operation for Import/Export failed because the operation is not in progress
    317 Import operation requested but there are no import volumes; Import/Export operation requested but there are no scratch physical volumes to perform the operation
    318 The maximum number of logical volumes is already defined to the VTS; therefore, no volumes can be imported into the library.
    319 Volume does not reside in specified library; no volume record retrieved. No TVI information is returned.
    320 Unable to access the library manager of the specified library; no volume record retrieved. No TVI information is returned.
    321 Manual cartridge entry failed; the media type specified by CBRUXENT does not match the media type stored in the existing volume record.
    322 Command rejected by the library.
    323 Unable to retrieve policy names from the library.
    324 Volume expiration time has not elapsed.
    325 I/O terminated due to timeout detection.
    326 Selective Device Access Control Group denied request.
    327 Selective Device Access Control Group is not valid.
16 Environment 2 OAM control block structure not available.
    80 LCS external services unable to establish ESTAE.
    81 LCS external services unable to obtain storage.
    90 Cartridge entry disabled due to an error in the installation exit.
    91 Cartridge entry temporarily suspended.
    93 Library offline, pending offline, or not operational.
    400 OAM initialized with null configuration (no libraries).
    401 Library not accessible – offline, pending offline, or not operational.
    402 Vision system inoperative.
    403 Eject processing disabled because of an error in the installation exit
    404 OAM address space not available.