IEE459I (form 3 of 3)
hh.mm.ss DEVSERV QLIB [id]

Explanation

After the above message, DEVSERV displays the requested tape library information. There are several types of displays, depending on the request. For requests to display library configuration information the first message display is:

The following are defined in the cccccccc configuration:

Where cccccccc is either ACTIVE or INACTIVE, depending on whether the ACTIVE or INACTIVE parameter was specified (ACTIVE is the default if neither is specified).
  • ACTIVE indicates that the library configuration being displayed is the one currently in use by the system.
  • INACTIVE indicates that the library configuration being displayed is the one that will become ACTIVE following an IODF activate.

There are two display formats, depending on whether the request was for a list of library serial numbers or a list of library devices.

When a list of library serial numbers is requested, the display lists up to 10 library serial numbers per line as follows: 

The following are defined in the   ACTIVE configuration:
*11111 22222 *33333 *44444 55555 66666 77777 88888 99999 00000
Note: An asterisk preceding a library serial number indicates that the library has connectivity to the system (at least one device in the library is connected)

When a list of library devices is requested, the display lists up to 8 library devices per line as follows:

The following are defined in the ACTIVE configuration:

When specifying a composite library sequence number, for example “11111”, the following output is displayed:

LIBID PORTID DEVICES
11111 04     0940* 0941* 0942* 0943* 0944* 0945* 0946* 0947*
             0948* 0949* 094A* 094B* 094C* 094D* 094E* 094F*
      03     09A0  09A1  09A2  09A3  09A4  09A5  09A6  09A7
             09A8  09A9  09AA  09AB  09AC  09AD  09AE  09AF
      02     09D0* 09D1* 09D2* 09D3* 09D4* 09D5* 09D6* 09D7*
             09D8* 09D9* 09DA* 09DB* 09DC* 09DD* 09DE* 09DF*
      01     F990  F991  F992  F993  F994  F995  F996  F997
             F998  F999  F99A  F99B  F99C  F99D  F99E  F99F
DISTRIBUTED LIBID(S)
AAAAA* BBBBB* CCCCC
Note:
  1. LIBID is the five hexadecimal digit library serial number.
  2. PORTID is the hexadecimal identifier of a 'string' of library devices.
  3. An asterisk following a library device number indicates that the device has connectivity to the system. Devices without an asterisk are logically defined, but have not been initialized. Devices that have not been initialized were not connected to the system at IPL time and have never been varied ONLINE since IPL.
  4. If the specified library is a composite library, its distributed library names are also displayed.
  5. An asterisk following a distributed library serial number indicates that the distributed library has connectivity to the host system (at least one device in the distributed library is connected).

When specifying a distributed library sequence number, for example “AAAAA”, the following output is displayed if all of the distributed libraries that the host has connectivity to are at TS7700 release 1.5 microcode level or above:

LIBID PORTID DEVICES
AAAAA 04     0940* 0941* 0942* 0943* 0944* 0945* 0946* 0947*
             0948* 0949* 094A* 094B* 094C* 094D* 094E* 094F*
      03     09A0  09A1  09A2  09A3  09A4  09A5  09A6  09A7
             09A8  09A9  09AA  09AB  09AC  09AD  09AE  09AF
COMPOSITE LIBID
11111
Note: Only the devices that are associated with the specified distributed library are displayed.

When specifying a distributed library sequence number that has no connectivity to the host or none of its devices has been defined to the host (even though all of the distributed libraries in the grid-configuration are at TS7700 release 1.5 or above), the following output is displayed:

DEVSERV QLIB,CCCCC 

IEE459I 14.15.28 DEVSERV QLIB
No devices connected or configured to host
Composite LIBID
11111

When specifying a distributed library sequence number in a grid-configuration that has one or more of the distributed libraries at pre-release 1.5 microcode level of the TS7700, the following output is displayed:

DEVSERV QLIB,22222 

IEE459I 14.15.28 DEVSERV QLIB
Library libid=2222 not found

For a request to list the queued library orders, the following is displayed:

DS QL,LIST,QUEUE
IEE459I 10.19.40 DEVSERV QLIB 421
LIBID DEVICE REQUEST VOLSER CATEGORY TIME ON QUEUE
11111 F018   MOUNT   VOL001 000F     3 MINUTE(S)
11111 F020   MOUNT   VOL002 000F     1 MINUTE(S)
11111 F021   MOUNT          0001     1 MINUTE(S)
22222 F031   EJECT   VOL003 000F     8 MINUTE(S)
22222 F021   DEMOUNT VOL005 0001     3 MINUTE(S)
Note: The queue display lists asynchronous orders that have been accepted by the library, but have not yet completed. When asynchronous orders complete the library uses attention I/O to signal the host. At that time the order will be removed from the queue.

For a request to display the library partitioning category codes, below is an example showing the system default category code:

DS QL,CATS                                                 
IEE459I 09.56.42 DEVSERV QLIB 600                          
0001  0002  0003  0004  0005  0006  0007  0008  0009  000A  000E  000F

For a request to change the library partitioning category codes, the first 3 digits of the category can be modified with the last digit being fixed and representing the media type:

DS QL,CATS(111*)                                           
IEE459I 09.57.01 DEVSERV QLIB 603                          
1111  1112  1113  1114  1115  1116  1117  1118  1119  111A  111E  111F
Note: If the library partitioning category codes are modified using the DQ QL,CATS command, the corresponding changes must also be reflected in the DEVSUPxx PARMLIB member. If not, an IPL reverts the category codes to what is specified in DEVSUPxx.

After the category codes have been updated, issue the DS QL,CATS command to reflect the updated categories:

DS QL,CATS                                                 
IEE459I 09.57.11 DEVSERV QLIB 606                          
1111  1112  1113  1114  1115  1116  1117  1118  1119  111A  111E  111F
Note: APAR OA24965 of Device Service is needed before you use the DEVSERV QLIB,CATS command. This APAR is needed to additionally recognize and support media types MEDIA9 and MEDIA10.

When a list of library devices that failed initialization during IPL is requested, the display lists up to 8 library devices per line as follows: 

DS QL,IEA438I                                                        
IEE459I 11.58.04 DEVSERV QLIB 620                                    
Device initialization errors detected during IPL                                           
  9AFA-09 9A1A-09 9ABA-09 9ADA-09 9A9A-09 9A5A-09 9A3A-09 9A7A-09  
  9A1B-09 9A3B-09 9A5B-09 9A7B-09 9A9B-09 9ABB-09 9ADB-09 9AFB-09  
  9A1C-09 9A3C-09 9A5C-09 9A7C-09 9A9C-09 9ABC-09 9ADC-09 9AFC-09  
  9A1D-09 9A3D-09 9A7D-09 9A5D-09 9A9D-09 9ADD-09 9ABD-09 9AFD-09
The number following the dash identifies the error that was detected during IPL. The failures that can be reported are:
2
The library interface is offline.
4
The device returned a library ID of all zeros (in Read Device Characteristics).
6
The device is unavailable to the library manager.
9
The HCD defined library ID and pool ID do not match the hardware ID.
12
The device type (EPI) is different from other devices in the same pool.
15
An I/O error occurred trying to read distributed library data.

For errors 2, 4 and 6, when the hardware condition is corrected, the device can be varied online.

For error 9, insure that the HCD defined library ID and pool ID (also called port ID) matche the hardware ID.

For error 12, search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM hardware representative. All of the devices in a pool must be of the same type as determined by the device EPI (physical identifier). The EPI for a device can be displayed using DEVSERV QT, as follows (the EPI is 13 below):

DS QT,07D0,RDC 
IEE459I 10.18.37 DEVSERV QTAPE 532                                      
UNIT DTYPE  DSTATUS CUTYPE  DEVTYPE  CU-SERIAL  DEV-SERIAL ACL LIBID    
07D0 3590L  OFFLINE 3592C06 3592E05* 0178-C5008 0178-C5008 I   CA002    
  READ DEVICE CHARACTERISTIC                                            
3592063590100190 4EDC0000B4D7FD5C 69F8000000000000 3592063592140013     
0CA0020300000300 4683800004000000 0400001122C00000 0000000000000000

For error 15, an I/O error occurred while trying to obtain data about the distributed libraries in a composite library. This might be caused by an I/O timeout. During IPL, I/O is terminated if it does not complete in 15 seconds. If the library is busy it might have taken too long to respond to the initialization I/O. If the device is defined to be varied online during IPL, that vary will fail. After IPL, the device can be varied online.

LIBID
Displays the 5 hexadecimal digit library serial number.
DEVICE
Displays the UCB device number associated with the queued request.
REQUEST
Asynchronous requests are: MOUNT,DEMOUNT,EJECT and AUDIT.
VOLSER
Displays the volume serial number associated with the request. For a scratch mount the volser will be blank.
CATEGORY
Displays the hexadecimal category code of the volume.
TIME ON QUEUE
Displays the approximate time that the request has been on the queue.
One of the following messages may be received:
  • NO cccccccc configuration is defined to the system.

    Where cccccccc is either ACTIVE or INACTIVE. This message indicates that no library control blocks are defined for the configuration that was specified (either ACTIVE or INACTIVE).

  • State save issued to dddd.

    Where dddd identifies the device that was used to perform a state save. dddd may not be the same device specified by the DS QL,dddd,SS command. Because state save is used to diagnose device errors DEVSERV QLIB attempts to issue the state save using another device in the same control unit.

  • State save failed.
  • An attempt to issue state save to the library identified by DS QL,dddd,SS was not successful.
  • Library not found for device dddd.
  • dddd was specified in the command DS QL,dddd,SS and there is no library defined to the system that contains device dddd.
  • Reply 'YES' to delete the INACTIVE configuration for library lllll, any other reply to quit.

    This message is issued following the command DS QL,lllll,DELETE. Reply 'YES' and devserv will delete the control blocks that define the INACTIVE library lllll. Deleting INACTIVE library definitions should only be done in order to recover from an incorrect control block definition. After the deletion, when an IODF is activated that properly defines the configuration, both the INACTIVE and ACTIVE control blocks will be rebuilt.

  • STORAGE LIMIT FOR TAPE DDR SWAP IS SET TO xxxxM.

    Displays the storage limit for a tape DDR SWAP. The value xxxxM is the number from 1 - 1000 MB of main storage that is allowed to be used in a swap. This value is saved in the data facilities area (DFA).

Source

DFSMSdfp

Module

IGUDSL01

Parent topic: IEE messages (IEE400I - IEE699I)