Displays (in message IEE459I) the requested DEVSERV library
information. You use two classes of QLIB parameters
to control the scope of the display: parameters and sub-parameters.
- QLIB Parameters
- LIST
- Indicates that QLIB should display a list of the ACTIVE library-ids
(the default). You can optionally generate a list of INACTIVE library-ids
or QUEUE'd library orders. LIST uses the sub-parameters ACTIVE, INACTIVE,
and QUEUE.
- LISTALL
- Produces a detailed list of all libraries, including the devices
and port-ids within each library. LISTALL uses the sub-parameters
ACTIVE and INACTIVE.
- LIBID
- Indicates that the request is for a specific library. LIBID
uses the sub-parameters ACTIVE, INACTIVE, VALIDATE, QUEUE, and DELETE.
- DDDD
- Indicates that the request is either for the library that contains
device dddd, or is for the device dddd itself. A sub-parameter is
required when DDDD is specified. DDDD uses the sub-parameter SS.
- DDR
- Displays the limit on storage usage for tape DDR swap.
- SS
- Indicates that QLIB should issue a diagnostic state save to
the library containing device DDDD. This command is intended to be
used at the request of IBM® Support Center. For example, SS
can be used to diagnose a hardware error that results in a mount failure
message. Automated Operator code can extract the failing device number
from the failure message, then insert the device in a QLIB SS command.
- CATS | CATS(xxx*)
- Displays or updates the library partitioning category codes.
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. If the library partitioning
category codes are modified using the DS
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.
For
example:
DS QL,CATS
IEE459I 10.31.30 DEVSERV QLIB
0001 0002 0003 0004 0005 0006 0007 0008 0009 000A 000E 000F
This command will change the first three characters
of ALL the categories:
DS QL,CATS(003*)
IEE459I 10.32.12 DEVSERV QLIB
0031 0032 0033 0034 0035 0036 0037 0038 0039 003A 003E 003F
- IEA438I
- Displays the device number and error code of any devices that
fail device initialization during IPL.
- ?
- Causes QLIB to display the command syntax.
- QLIB Sub-parameters
- ACTIVE
- Displays information about the library configuration that is
currently in use by the system.
- INACTIVE
- Displays information about the library configuration that becomes active following the next IODF activate.
The INACTIVE configuration is similar to ACTIVE, but may contain additional
devices or libraries.
- VALIDATE
- Displays the same information as the INACTIVE configuration.
However, before the configuration is displayed, I/O is issued to each
device in the configuration to validate connectivity to the host.
- DELETE
- Indicates that QLIB should delete the INACTIVE control blocks
for library LIBID and not affect the existing ACTIVE library definition.
The DELETE command is used to remove incorrectly defined library
control blocks so that they can be rebuilt. DEVSERV DELETE provides
an alternative to the method described in information APAR II09065,
which requires two IODF activates.
The DEVSERV QLIB method is as
follows:
- Use QLIB DELETE to delete all of the devices from the incorrect
control blocks.
- Choose one action depending on whether you have
LIBID and LIBPORT coded in the IODF:
- Use ACTIVATE IODF to redefine the devices.
- Use QLIB LIST to display that the ACTIVE control blocks are properly
defined.
- QUEUE
- Lists the library orders that are waiting to be completed. Such
orders include:
- MOUNT
- DEMOUNT
- EJECT
- AUDIT
When an order completes, the library notifies the host and the
order is removed from the queue. This QLIB display can list orders
for all libraries, or be limited for a single library.