Library Automation Communication Services (LACS) return and reason codes

Return and Reason Codes for the LACS Mount Service

Tables Table 1, Table 2, Table 3, Table 4, Table 5, Table 6, Table 7, and Table 8 describe the CBRXLACS return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 1. CBRXLACS FUNC(MOUNT) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For an asynchronous request to an ATLDS, the mount order has been successfully scheduled for later execution by the library. For a synchronous request to an ATLDS, the mount completed without error. For a request to an MTL, the WTO/WTOR message has been issued, if requested. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library. If requested, the WTO/WTOR message has been issued. No No N/A
X'08' Execution of Library Function Complete with Warning X'0101' The requested ATLDS mount is complete, but the library vision system has failed, preventing verification of the external volume serial number. This code is set only after a synchronous request. Yes No CBR4001I
    X'0102' The requested ATLDS mount is complete, but the external label on the cartridge is either missing or unreadable. This code is set only after a synchronous request. Yes No CBR4002I
    X'010C' The ATLDS mounted the scratch volume as requested, but during the attempt to load the volume into the drive, it was determined that the cartridge is damaged. The scratch mount can be retried. This code is set only after a synchronous request. Yes No CBR4012I
X'0C' Invalid Parameter List X'0121' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0122' A VOLSER value has not been supplied, or the volume serial number is all blanks. N/A N/A CBR4034I
    X'0123' A TOKEN address has not been supplied. N/A N/A CBR4035I
    X'0125' Either a WTOCONS value or a WTOCART value has been supplied, but a WTOPTR value has not. N/A N/A CBR4037I
    X'0127' More than one synchronization option (ECBPTR, EXITPTR, or WAIT) has been supplied. N/A N/A CBR4039I
    X'012C' Either a WTOCONS value or a WTOCART value has been supplied, but the WTO parameter list is in the normal (WPL) format, rather than the extended (WPX) format. N/A N/A CBR4044I  
    X'0130' A DEVTYPE address for tape device selection information has not been supplied. N/A N/A CBR4048I
    X'0131' The tape device selection information media type is invalid. N/A N/A CBR4049I
    X'0132' The volume serial number supplied is invalid. The volume serial number must consist of all alphanumeric characters, national characters ( @, $, # ) or special characters ( , . / ' ( ) * & + — = ) with no imbedded blanks. No Yes CBR4050I
X'10' Environmental Error None CBRXLACS FUNC(MOUNT) does not use the environmental error return code.      
X'14' Execution Failed with Permanent Error X'0161' The library where the mount is to be performed is offline. Yes No CBR4097I
    X'0162' The library where the mount is to be performed is not operational. Yes No CBR4098I
    X'0163' A permanent I/O error was detected by the Asynchronous Operations Manager; a library sense record is not available. Yes No CBR4099I
    X'0164' An equipment check occurred in the library attachment facility or the library manager. Yes No CBR4100I
    X'0165' The microcode levels in the control unit and the library manager cannot coexist. Yes No CBR4101I
    X'0166' One of the following situations has occurred:
  • The library responded to the mount order with a unit check. The code in the sense record is an unexpected and inappropriate response to the order; for example, a code appropriate to a scratch mount was received in response to a specific mount.
  • The attention message that signaled the completion of the mount order contained an undefined mount completion code.
Yes No CBR4102I
    X'0167' The requested volume is currently in use. One of the following conditions is present in the library:
  • The volume is already mounted on some drive in the library.
  • A mount of the volume is pending on some drive in the library.
Yes No CBR4103I
    X'0168' The requested volume is not in the library. Yes Yes CBR4104I  
    X'0169' There are no volumes in the library that are assigned to the required scratch category or categories. Yes No CBR4105I
    X'016A' An invalid sequence of orders has been sent to the library. One of the following conditions is present in the library:
  • A volume is already mounted on the drive, and no demount request is pending.
  • A mount request is already queued for the drive.
Yes No CBR4106I
    X'016B' The requested volume is not in the location assigned to it in the library manager inventory. Yes No CBR4107I
    X'0170' An incompatible function has been requested of the library. The control unit supports library commands, but the library attachment interface is not installed. Yes No CBR4112I
    X'0171' No libraries are defined in the current configuration. Yes No CBR4113I
    X'0172' The library configuration has not yet been set. Yes No CBR4114I
    X'0174' The library manager is offline. Yes No CBR4116I
    X'0175' The requested volume is inaccessible in the library. Yes No CBR4117I
    X'0176' The drive on which the volume was to have been mounted is no longer available. It was made unavailable by the library manager after repeated device errors or by the library operator. This code is set only after a synchronous request. Yes No CBR4118I
    X'0177' The request cannot be completed because the library name associated with the tape drive cannot be determined. No Yes CBR4119I
    X'0178' The mount request was sent to the library, but no response has been received from the library. Either the request completed and the completion message was lost, or the request was lost in the library. This code is set only after a synchronous request. Yes No CBR4120I
    X'0179' The requested cartridge is damaged in such a way that it cannot be loaded into a tape drive. This code is set only after a synchronous request. Yes No CBR4122I
    X'017A' The library mounted the volume as requested, however the attempt to load the volume into the drive failed. This code is set only after a synchronous request. Yes No CBR4011I
    X'017B' An incompatible function has been requested of the library. The media type of the volume to be mounted cannot coexist with the drive. The media type in the library manager database is inconsistent with the media type of the volume in the tape configuration database. Yes No CBR4123I
    X'017C' The drive on which volume was to have been mounted was left in stand-alone mode at the library. Yes No CBR4124I
    X'017D' A valid copy of the requested volume is inaccessible in the library. Yes No CBR4125I
    X'017E' The drive on which the scratch volume was to have been mounted is in read-only mode. Yes No CBR4126I
    X'0191' The library does not have enough physical drives available. Yes No CBR4127I
    X'0192' The library is out of empty stacked volumes. Yes No CBR428I
    X'0193' The previous (clone) volser of the multivolume dataset does not reside in the library. Yes No CBR4170I
    X'0194' The library encountered a failure when attempting to mount the logical volume. This code is only set after a synchronous request. Yes No CBR4171I
    X'0195' The mount request was cancelled at the library and could not be completed prior to the library being varied offline by an operator at the library manager. This code is only set after a synchronous request. Yes No CBR4172I
    X'0196' The specified I/O VTS in the PtP VTS subsystem is not available. Yes No CBR4173I
    X'0197' The library could not obtain volume ownership information. Yes No CBR4174I
    X'0198' Selective Device Access Control Group denied request. Yes No CBR4175I
    X'0199' Selective Device Access Control Group is not valid. Yes No CBR4176I
    X'019A' WORM volume metadata is inconsistent between the library and the volume. This code is set only after a synchronous request. Yes No CBR4177I
    X'019B' Library is not WORM enabled. Yes No CBR4178I
X'18' Execution failed due to system service failure X'0181' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0183' LACS was unable to write the caller's message to the requested destination. The WTO return code is stored in the LAPL in field LAPSRET. This reason code is associated only with a non-ATLDS mount request; failure to write to the system log does not cause failure of an ATLDS mount request. No Yes CBR4131I
    X'0184' LACS was unable to send the mount order to the library using the LIBSERV service. The LIBSERV return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4132I
X'1C' Abnormal Termination in LACS X'01A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I  

Return and Reason Codes for the LACS Demount Service

CBRXLACS FUNC(DEMOUNT) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 2. CBRXLACS FUNC(DEMOUNT) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For a request to an ATLDS, the demount order has been scheduled for later execution by the library. For a request to an MTL, the WTO/WTOR message has been issued, if requested. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library. If requested, the WTO/WTOR message has been issued. No No N/A
X'08' Execution of Library Function Complete with Warning X'0203' The demount request has been scheduled, or the WTO/WTOR message has been issued, but the error status code was not successfully recorded in the tape volume record. An error return code was received from the CBRXVOL service. Yes Yes CBR4003I
    X'0204' The demount request has been scheduled, or the WTO/WTOR message has been issued, but the volume was not successfully returned to scratch status. An error return code was received from the CBRXLCS service. Yes Yes CBR4004I
X'0C' Invalid Parameter List X'0221' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0223' A TOKEN address has not been supplied. N/A N/A CBR4035I
    X'0225' Either a WTOCONS value or a WTOCART value has been supplied, but a WTOPTR value has not. N/A N/A CBR4037I
    X'0228' Both an ERRCODE value and the SCRATCH option have been supplied. N/A N/A CBR4040I
    X'022C' Either a WTOCONS value or a WTOCART value has been supplied, but the WTO parameter list is in the normal (WPL) format, rather than the extended (WPX) format. N/A N/A CBR4044I
X'10' Environmental Error None CBRXLACS FUNC(DEMOUNT) does not use the environmental error return code.      
X'14' Execution Failed with Permanent Error X'0261' The library where the demount is to be performed is offline. Yes No CBR4097I
    X'0262' The library where the demount is to be performed is not operational. Yes No CBR4098I
    X'0263' A permanent I/O error was detected by the Asynchronous Operations Manager; a library sense record is not available. Yes No CBR4099I
    X'0264' An equipment check occurred in the library attachment facility or the library manager. Yes No CBR4100I
    X'0265' The microcode levels in the control unit and the library manager cannot coexist. Yes No CBR4101I
    X'0266' The library responded to the demount order with a unit check. The error code in the sense record is an unexpected and inappropriate response to the order. Yes No CBR4102I
    X'026A' An invalid sequence of orders has been sent to the library. One of the following conditions is present in the library:
  • No volume is mounted on the drive, and no mount request is pending.
  • A demount request is already queued for the drive.
Yes No CBR4106I
    X'0270' An incompatible function has been requested of the library. The control unit supports library commands, but the library attachment interface is not installed. Yes No CBR4112I
    X'0271' No libraries are defined in the current configuration. Yes No CBR4113I
    X'0272' The library configuration has not yet been set. Yes No CBR4114I
    X'0274' The library manager is offline. Yes No CBR4116I
    X'0275' The volume to be demounted is inaccessible in the library. Yes No CBR4117I
X'18' Execution Failed Due to System Service Failure X'0281' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0283' LACS was unable to write the caller's message to the requested destination. The WTO return code is stored in the LAPL in field LAPSRET. This reason code is associated only with a non-ATLDS demount request; failure to write to the system log does not cause failure of an ATLDS demount request. No Yes CBR4131I
    X'0284' LACS was unable to send the demount order to the library using the LIBSERV service. The LIBSERV return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4132I
X'1C' Abnormal Termination in LACS X'02A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS Wait Service

CBRXLACS FUNC(WAIT) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 3. CBRXLACS FUNC(WAIT) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For a request to an ATLDS, the requested mount completed without error. For a request to an MTLDS, no action has been taken. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library. No action has been taken. No No N/A
X'08' Execution of Library Function Complete with Warning X'0301' The requested mount is complete, but the library vision system has failed, preventing verification of the external volume serial number. Yes No CBR4001I
    X'0302' The requested mount is complete, but the external label on the cartridge is either missing or unreadable. Yes No CBR4002I
    X'030C' The library mounted the scratch volume as requested, but during the attempt to load the volume into the drive, it was determined that the cartridge is damaged. The scratch mount can be retried. Yes No CBR4012I
X'0C' Invalid Parameter List X'0321' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0323' A TOKEN address has not been supplied. N/A N/A CBR4035I
    X'032D' The requested drive resides in a library, and the LACS token value is zero. Yes No CBR4045I
    X'032E' The mount request specified either ECBPTR or EXITPTR as the synchronization option. A FUNC(WAIT) request requires that mount completion be posted in the UCB library automation extension Yes No CBR4046I
X'10' Environmental Error X'0342' The token mount request was not found. The request is not pending, and it is not the most recently completed library order. Yes No CBR4066I
X'14' Execution Failed with Permanent Error X'0364' An equipment check occurred in the library attachment facility or the library manager. Yes No CBR4100I
    X'0366' The attention message that signaled the completion of the mount order contained an undefined mount completion code. Yes No CBR4102I
    X'0369' There are no volumes in the library that are assigned to the required scratch category. Yes No CBR4105I
    X'036B' The requested volume is not in the location assigned to it in the library manager inventory. Yes No CBR4107I
    X'0375' The requested volume is inaccessible in the library. Yes No CBR4117I
    X'0376' The drive on which the volume was to have been mounted is no longer available. It was made unavailable by the library manager after repeated device errors or by the library operator. Yes No CBR4118I
    X'0378' The mount request was sent to the library, but no response has been received from the library. Either the request completed and the completion message was lost, or the request was lost in the library. Yes No CBR4120I
    X'0379' The requested cartridge is damaged in such a way that it cannot be loaded into a tape drive. Yes No CBR4122I
    X'037A' The library mounted the volume as requested, however the attempt to load the volume into the drive failed. Yes No CBR4011I
    X'0394' The library encountered a failure when attempting to mount the logical volume. Yes No CBR4171I
    X'0395' The mount request was cancelled at the library and could not be completed prior to the library being varied offline by an operator at the library manager. Yes No CBR4172I
    X'039A' WORM volume metadata is inconsistent between the library and the volume. Yes No CBR4177I
X'18' Execution Failed Due to System Service Failure X'0381' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0385' LACS was unable to determine whether the mount request was still pending using the AOMQUE service. The AOMQUE return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4133I
X'1C' Abnormal Termination in LACS X'03A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS Verify Service

CBRXLACS FUNC(VERIFY) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 4. CBRXLACS FUNC(VERIFY) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For a scratch mount request on an ATLDS drive, the internal and external volume serial numbers match. For a specific volume mount request on an ATLDS drive, the requested, internal, and external volsers all match. For a scratch mount request on an MTLDS drive, an acceptable scratch volume has been mounted. For a specific volume mount request on an MTLDS drive, the requested and internal volsers match. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library. No action has been taken. No No N/A
X'08' Execution of Library Function Complete with Warning X'0405' The internal and external volume serial numbers do not match for a scratch volume mount on an ATLDS drive. Yes No CBR4005I
    X'0406' The internal and external volume serial numbers do not match for a specific volume mount performed while the ATLDS was in manual mode. Yes No CBR4006I
    X'0407' The volume mounted by the operator in response to a mount scratch request for an MTLDS drive is not defined in the tape configuration database No Yes CBR4007I
    X'0408' The volume mounted by the operator in response to a mount scratch request for an MTLDS drive is defined in the TCDB but does not reside in the MTLDS. No Yes CBR4008I
    X'0409' The volume mounted by the operator in response to a mount scratch request for an MTLDS drive is defined in the TCDB and resides in the MTLDS but is not a scratch tape. No Yes CBR4009I
    X'040A' The internal and requested volume serial numbers do not match for a specific volume mount on an MTLDS drive. No Yes CBR4010I
X'0C' Invalid Parameter List X'0421' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0422' A VOLSER value has not been supplied. N/A N/A CBR4034I
    X'0423' A TOKEN address has not been supplied. N/A N/A CBR4035I
    X'042D' The requested drive resides in a library, and the LACS token value is zero. N/A N/A CBR4045I
    X'0432' The volume serial number supplied is invalid. The volume serial number must consist of all alphanumeric characters, national characters ( @, $, # ) or special characters ( , . / ' ( ) * & + — = ) with no imbedded blanks. No Yes CBR4050I
X'10' Environmental Error X'0442' The token mount request was not found. The request is not pending in the library, and it is not the most recently completed library order. Yes No CBR4066I
    X'0443' The token mount request is still pending in the library. Yes No CBR4067I
X'14' Execution Failed with Permanent Error X'046C' The external volume serial number of the cartridge mounted on the ATLDS drive cannot be determined. The information is not in the UCB and is not available from LIBSERV. Yes No CBR4108I
    X'046D' The external volume serial number of the volume mounted by the ATLDS does not match the VOLSER requested in the mount order, and the ATLDS has not provided any error indication. Yes No CBR4109I
    X'046E' The internal and external volume serial numbers do not match for a specific volume mount performed while the ATLDS was in automatic mode. Yes No CBR4110I
    X'046F' The internal and external volume serial numbers do not match for AVR volume mount verification. Yes No CBR4111I
    X'0477' The request cannot be completed because the library name associated with the tape drive cannot be determined. No Yes CBR4119I
X'18' Execution Failed Due to System Service Failure X'0481' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0484' LACS was unable to determine the external volume serial number of the volume currently mounted on the drive, using the LIBSERV service. The LIBSERV return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4132I
    X'0485' LACS was unable to determine whether the mount request was still pending using the AOMQUE service. The AOMQUE return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4133I
    X'0487' LACS was unable to read the tape volume record for the mounted volume from the tape configuration database using the CBRXVOL service. The CBRXVOL return code is stored in the LAPL in field LAPSRET. No Yes CBR4135I
X'1C' Abnormal Termination in LACS X'04A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS Cancel Service

CBRXLACS FUNC(CANCEL) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 5. CBRXLACS FUNC(CANCEL) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For a request to an ATLDS, the mount request represented by the token was successfully canceled. For a request to an MTL, the operator message represented by the token, if any, has been DOMed. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library. The operator message represented by the token, if any, has been DOMed. No No N/A
X'08' Execution of Library Function Complete with Warning None CBRXLACS FUNC(CANCEL) does not use the warning return code.      
X'0C' Invalid Parameter List X'0521' A UCB address has not been supplied, or the UCB address is invalid. The error may be in the LAPL, or in an entry in the UCB/token list. N/A N/A CBR4033I
    X'0523' A token address has not been supplied. The error may be in the LAPL, or in an entry in the UCB/token list. N/A N/A CBR4035I
    X'0526' Neither a UCBPTR value nor a UCBTLIST value has been supplied in the LAPL. N/A N/A CBR4038I
    X'0529' Both a UCBPTR value and a UCBTLIST value have been supplied in the LAPL. N/A N/A CBR4041I
    X'052D' The requested drive resides in a library, and the LACS token value is zero. The error may be in the LAPL, or in an entry in the UCB/token list. Yes No CBR4045I
X'10' Environmental Error X'0542' The token mount request was not found. The request is not pending in the library, and it is not the most recently completed mount order. Yes No CBR4066I
X'14' Execution Failed with Permanent Error X'0561' The library where the mount is to be canceled is offline. Yes Yes CBR4097I
    X'0562' The library where the mount is to be canceled is not operational. Yes No CBR4098I
    X'0563' A permanent I/O error was detected by the Asynchronous Operations Manager; a library sense record is not available. Yes No CBR4099I
    X'0564' An equipment check occurred in the library attachment facility or the library manager. Yes No CBR4100I
    X'0565' The microcode levels in the control unit and the library manager cannot coexist. Yes No CBR4101I
    X'0566' The library responded to the demount order with a unit check. The error code in the sense record is an unexpected and inappropriate response to the order. Yes No CBR4102I
    X'056A' An invalid sequence of orders has been sent to the library. One of the following conditions is present in the library:
  • No volume is mounted on the drive, and no mount request is pending.
  • A demount request is already queued for the drive.
Yes No CBR4106I
    X'0574' The library manager is offline. Yes No CBR4116I
X'18' Execution Failed Due to System Service Failure X'0581' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0584' LACS was unable to send the demount order to the library using the LIBSERV service. The LIBSERV return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4132I
    X'0585' LACS was unable to manipulate the AOM queue element for the mount request using the AOMQUE service. The AOMQUE return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. Yes No CBR4133I
X'1C' Abnormal Termination in LACS X'05A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS WTO Service

CBRXLACS FUNC(WTO) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 6. CBRXLACS FUNC(WTO) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' For a request to an ATLDS, the WTO/WTOR message has been written to the system log, or the WTO/WTOR message has been successfully issued. For a request to an MTLDS, the WTO/WTOR message has been successfully issued.   Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The WTO/WTOR message has been successfully issued. No No N/A
X'08' Execution of Library Function Complete with Warning None CBRXLACS FUNC(WTO) does not use the warning return code.      
X'0C' Invalid Parameter List X'0621' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0623' A TOKEN address has not been supplied. N/A N/A CBR4035I
    X'0625' A WTOPTR value has not been supplied. N/A N/A CBR4037I
    X'062C' Either a WTOCONS value or a WTOCART value has been supplied, but the WTO parameter list is in the normal (WPL) format, rather than the extended (WPX) format. N/A N/A CBR4044I
X'10' Environmental Error None CBRXLACS FUNC(WTO) does not use the environmental error return code.      
X'14' Execution Failed with Permanent Error None CBRXLACS FUNC(WTO) does not use the permanent error return code.      
X'18' Execution Failed Due to System Service Failure X'0681' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0683' LACS was unable to write the caller's message to the requested destination. The WTO return code is stored in the LAPL in field LAPSRET. Yes Yes CBR4131I
X'1C' Abnormal Termination in LACS X'06A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS DOM Service

CBRXLACS FUNC(DOM) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 7. CBRXLACS FUNC(DOM) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' The operator message has been successfully DOMed. Yes Yes N/A
X'04' Successful Execution of Non-Library Function X'0000' The operator message has been successfully DOMed. No No N/A
X'08' Execution of Library Function Complete with Warning None CBRXLACS FUNC(DOM) does not use the warning return code.      
X'0C' Invalid Parameter List X'0721' A UCBPTR value has not been supplied, or the UCB address is invalid. N/A N/A CBR4033I
    X'0723' A TOKEN address has not been supplied. N/A N/A CBR4035I
X'10' Environ- mental Error None CBRXLACS FUNC(DOM) does not use the environmental error return code.      
X'14' Execution Failed with Permanent Error None CBRXLACS FUNC(DOM) does not use the permanent error return code.      
X'18' Execution Failed Due to System Service Failure X'0781' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
X'1C' Abnormal Termination in LACS X'07A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I

Return and Reason Codes for the LACS Error Message Construction Service

CBRXLACS FUNC(ERRTEXT) sets the following return and reason codes. AL pertains to automated library. ML pertains to manual library.

Table 8. CBRXLACS FUNC(ERRTEXT) Return and Reason Codes
Return Code Error Type Reason Code Description AL ML Message
X'00' Successful Execution of Library Function X'0000' The drive resides in a library; the requested messages have been constructed and placed into the message buffer. Yes Yes N/A  
X'04' Successful Execution of Non-Library Function X'0000' The drive does not reside in a library; the requested messages have been constructed and placed into the message buffer. No No N/A
X'08' Execution of Library Function Complete with Warning None CBRXLACS FUNC(ERRTEXT) does not use the warning return code.      
X'0C' Invalid Parameter List X'0824' A BTOKPTR value has not been supplied. N/A N/A CBR4036I
    X'082A' Either the return code or the reason code is invalid. N/A N/A CBR4042I
    X'082F' The input return code and reason code do not represent an error or warning condition. There is no LCS error message for this situation.   N/A N/A CBR4047I  
X'10' Environmental Error None CBRXLACS FUNC(ERRTEXT) does not use the environmental error return code.      
X'14' Execution Failed with Permanent Error None CBRXLACS FUNC(ERRTEXT) does not use the permanent error return code.      
X'18' Execution Failed Due to System Service Failure X'0881' LACS was unable to establish an ESTAE exit routine. The ESTAE return code is stored in the LAPL in field LAPSRET. N/A N/A CBR4129I
    X'0882' LACS was unable to construct an error message using the OAM message construction service. The return code from the service is stored in the LAPL in field LAPSRET. N/A N/A CBR4130I
    X'0886' LACS was unable to place an error message into the message buffer using the IEEMIFSV service. The IEEMIFSV return code and reason code are stored in the LAPL in fields LAPSRET and LAPSREAS, respectively. N/A N/A CBR4134I
X'1C' Abnormal Termination in LACS X'08A1' An abnormal termination occurred during LACS execution. The system completion code is stored in the LAPL in field LAPSRET. The ABEND reason code, if any, is stored in the LAPL in field LAPSREAS. N/A N/A CBR4161I