IEA437I
TAPE LIBRARY DEVICE(dev), text

Explanation

Initialization for an ATLDS device failed. The device will not be brought online until the cause of the failure is corrected. In the message text:
dev
The number of the failing ATLDS device
text
One of the following:
LIBRARY INTERFACE IS OFFLINE
The hardware communication path between the tape control unit and the library manager has not been established.

Recovery Action: Contact your hardware service representative to restore the communication path to the library manager.

RETURNED A ZERO LIBRARY-ID
The hardware communication path between the tape control unit and the library manager has been established, but the library manager returned an incorrect library-id (zeros) to the host.

Recovery Action: Contact your hardware service representative to repair the library manager.

INITIALIZATION FAILURE
The device was defined with HCD as a LIBRARY device, but the host was unable to obtain library information from the device. The channel program command that failed was Read Device Characteristics (RDC).

Recovery Action: Contact your hardware service representative to determine the cause of the RDC failure.

UNAVAILABLE TO LIBRARY MANAGER
The hardware communication path between the tape control unit and the library manager has been established, but the library manager has 'marked' the device unavailable.

Recovery Action: Contact your hardware service representative to repair the device and restore its availability to the library manager.

HCD(xxxxx-xx),DEVICE(xxxxx-xx)
During device initialization, it was found that the LIBRARY-ID and LIBPORT-ID specified to HCD do not match the LIBRARY-ID and LIBPORT-ID that were assigned to the hardware during installation.
Recovery Action: Correct either the hardware or HCD. If the hardware was in error (or was incorrectly attached to the system), correct the hardware and then VARY the device ONLINE. Use the command DS QT,dddd,RDC to determine the library-ID and libport-ID assigned to the hardware. In the following example, device 2C80 is assigned library-ID BA067 and libport-ID 01:
  DS QT,2C80,RDC
 READ  DEVICE CHARACTERISTICS
 34905434905400E0 1FD8808004000000  00000000 00000000
 0BA0670100000000 4281000000000000  00000000 00000000
ACTIVATE IODF=XX, IS REQUIRED
The device was unavailable when the currently active eligible device tables (EDTs) were built; the EDTs are used for device allocation. Although the device is now available to this system, it cannot be allocated until the EDTs are rebuilt. EDTs are rebuilt during IODF activation.

Recovery Action: Activate the current IODF, then VARY the device ONLINE.

TAPE LIBRARY DEVICE aaaa (bbbbb-cc) IS A DUPLICATE OF DEVICE xxxx (yyyyy-xx) AND IS BEING MARKED FOR DELETION
A device with CUU=xxxx, LIBRARY-ID=yyyyy, and LIBPORT-ID=zz is being processed and another device with CUU=aaaa, LIBRARY-ID= bbbbb, and LIBPORT-ID=cc has been found that:
  • has the same hardware reported sequence number, or
  • has the same CUU, that is, xxxx=aaaa.

It is determined to be the same device and the device with CUU=aaaa is not allowed online.

This can occur in a variety of situations, for example, when two control units are physically uncabled from the library, and when recabled, the port cables are switched.

Recovery Action: Correct either the hardware or HCD. If the hardware was in error (or was incorrectly attached to the system), correct the hardware and then vary the device online. Use the command DS QT,dddd,RDC to determine the library-ID and libport-ID assigned to the hardware.

TAPE LIBRARY DEVICE aaaa (bbbbb-cc) IS A DIFFERENT DEVICE TYPE THAN DEVICES PREVIOUSLY DEFINED IN THE SAME STRING. THE DEVICE IS NOT ALLOWED ONLINE
A device with CUU=aaaa, LIBRARY-ID=bbbbb, and LIBPORT-ID=cc is a different device type than those that were previously defined for the same string.

Recovery Action: Correct either the hardware or HCD. If the hardware was in error (or was incorrectly attached to the system), correct the hardware and then vary the device online. Use the DS QT,dddd,RDC command to determine the library-ID and libport-ID assigned to the hardware.

TAPE LIBRARY DEVICE aaaa (bbbbb-cc) DEFINED AS MTL BUT DEVICE xxxx (yyyy-zz) IS REAL ATL/VTS DEVICE. DEVICE NOT ALLOWED ONLINE.
The tape drive at address aaaa, with HCD defined LIBRARY-ID bbbbb and LIBPORT-ID cc is defined as an MTL resident drive (for example, MTL=YES was specified with LIBRARY-ID and LIBPORT-ID), but the RDC data indicates that the drive resides in the ATLDS. The device is treated as a valid ATL resident drive.

Recovery Action: Review the HCD definition for the device.

TAPE LIBRARY DEVICE aaaa (bbbbb-cc) EMULATING 3490 NOT ALLOWED ONLINE IN AN MTL.
The tape drive at address aaaa, with HCD defined LIBRARY-ID bbbbb and LIBPORT-ID=cc, is defined as an MTL resident drive but is emulating a 3490 device which is not supported in an MTL. The device is not allowed online.

Recovery Action: Review the HCD definition for the device.

MTL DEVICE aaaa (bbbbb-cc) IS ATTACHED TO A CONTROL UNIT THAT IS DIFFERENT THAN THAT FOR OTHER DEVICES ALREADY IN THE POOL.
The tape drive at address aaaa, with HCD defined LIBRARY-ID bbbbb and LIBPORT-ID cc, is attached to a control unit different than that for devices already in the pool. The device is not allowed online.

Recovery Action: Review the HCD definition for the device, and other devices with the same LIBRARY-ID and LIBPORT-ID values. Ensure that all devices for the same LIBRARY-ID and LIBPORT-ID values are connected to the same control unit.

If you are replacing old or broken hardware with new hardware, all of the devices in the device pools affected by the hardware change must be OFFLINE. If any of the devices fail to go OFFLINE or are in PENDING OFFLINE, and the drives are not in use by the system, cause the devices to become OFFLINE and BOXED by issuing the VARY OFFLINE,FORCE command. After all of the devices are offline, you can replace the hardware.

TAPE LIBRARY DEVICE aaaa (bbbbb-cc) NOT ALLOWED ONLINE, UNABLE TO ADD LIBRARY TO CONTROL BLOCK.
The tape drive at address aaaa, with HCD defined LIBRARY-ID bbbbb and LIBPORT-ID cc, cannot be added to the existing device pool because it is full (that is, it already has 16 devices defined) or because the number of device pool subsystems has reached the library limit of 128. The device is not allowed online. The MTL device pool subsystem limit remains at 32.

Recovery Action: Review the HCD definition for the device, and other devices with the same LIBRARY-ID and LIBPORT-ID values. Ensure that MTL devices are not overgenned.

PROBLEM OBTAINING DISTRIBUTED LIBRARY DATA. LIBRARY MAY BE IN SERVICE MODE.
During initialization of a device in a Peer-to-Peer VTS or the TS7700 Virtualization Engine, the I/O operation requesting configuration data for the distributed library either failed or returned invalid information. Also, for a device associated with the TS7700 Virtualization Engine, it could also mean that the library is in service mode. This message is issued when an RDC command returned data indicating that the device is in a Peer-to-Peer VTS library or in a TS7700 Virtualization Engine. However, the subsequent request to obtain configuration data failed or returned invalid data.

Recovery Action: Contact your hardware service representative to determine the cause of the failure.

System action

The device is not available for use by the system.

System programmer response

When the condition has been corrected, attempt to VARY the device ONLINE. If the device was previously defined to HCD as a library device, with the proper library-ID and libport-ID, the device will come ONLINE.

If the device is not defined with HCD as a library device, the device will not be allowed ONLINE if an IODF activate is required. Message ACTIVATE IODF=XX, IS REQUIRED indicates that because of previous failure, the library-ID and libport-ID were not known when the systems EDTs were build. Now that these IDs are known, an activate is required in order to cause the EDTs to be rebuilt.

Source

Tape Device Initialization Exit (DSE)

Module

IECTDSR2