LIBS (Library Task Entries)

The LIBS (Library Task Entries) command lists all frozen libraries, including both server libraries and connection libraries.

Syntax

<wild card>

<delim>

Use one of the following characters

/ \ I ~ ! @ # $ % ^ & * '

The first delimiter must be the same as the second delimiter.

<wild-card string>

A string of characters used to search for a task name. The string can include the following special characters.

Character

Description

Equal sign (=)

Matches any sequence of characters

Question mark (?)

Matches any single character

Tilde (~)

Matches any sequence of characters except a slash (/)

The wild-card string is automatically uppercased, except for characters enclosed in quotation marks, and the system stops processing the string when it encounters a space character.

You can include lowercase characters and space characters by prefixing the wild-card string with LIT and enclosing the wild-card string in delimiters.

For example, if you enter the following syntax, the system returns entries that contain the string "PACK":

LIBS NAME =pack=

If you enter the following syntax, the system returns entries that contain the string "pack":

LIBS NAME LIT^=pack=^

Explanation

LIBS

LIBRARIES

Display all unsuppressed frozen library stack entries.

LIBS ALL

Displays all frozen library stack entries, including suppressed ones.

LIBS NAME <wild-card string>

Displays one or all library names that contain the specified wild-card string, including any that were suppressed.

LIBS MCSNAME = <MCS name>

LIBS MCS = <MCS name>

Display only libraries initiated from the specified MCS.

LIBS Q

Shows all libraries that were originally initiated from a job through a job queue.

LIBS Q <job queue number>

Shows all libraries that were originally initiated from a job through the specified job queue number.

LIBS USER <usercode>

Displays only libraries running with the specified usercode.

Examples

Example 1

This example shows output from the LIBS command:

LIBS
  ---Mix--Frz---Shr---Usr--- 10 FROZEN LIBRARIES ---------------------
  * 1908 Temp  All     1 SL     *SYSTEM/TADSSUPPORT ON PACK
  * 1626 Perm  Run     2 SL     *SYSTEM/COMS/UTILITY/FORMATS ON PACK
  * 1595 Perm  Priv    1    Job *SYSTEM/SCREENDESIGN/INTERFACE ON PACK
  * 1593 Temp  All     2    Job *SYSTEM/SCREENDESIGN/FORMATS ON PACK
  * 1921 Perm  All     1 SL Job *SYSTEM/SCREENDESIGN/MANAGER ON PACK
    1490 Temp  All     1    Job *SYSTEM/MARC/AGENDA/TDXXX
    1482 Perm  All     8 SL Job *SYSTEM/COMS ON PACK
    1493 Conn  Priv         Job *SYSTEM/NXSERVICES/SERVER
    1489 Perm  All     2 SL     *SYSTEM/MARC/COMMANDER
    1485 Ctrl  All     5        (MACS)TEST/FREEZE/CONTROL

An asterisk (*) at the beginning of an entry line indicates that the entry is being displayed for the first time. The Mix field gives the mix number of the library stack entry. The Frz (Freeze Type) field shows whether the library is a permanent server library (Perm), temporary server library (Temp), control server library (Ctrl), or connection library (Conn).

The Shr (Shared Specifications) field contains one of the following values.

Value

Meaning

All

Shared by All

Run

Shared by Run Unit

Priv

Private

The Usr (Users) field shows the number of clients linked to a server library. No value is listed for connection libraries.

The letters SL after the User Count field indicate a support library.

Example 2

This example shows output from a LIBS command that uses the NAME option with a wild-card string:

LIBS NAME=SERV=  
  ---Mix--Frz---Shr---Usr-------- 5 FROZEN LIBRARIES (ALL) =SERV=--
  19287 Temp  All     2 SL Job *SYSTEM/TCPHOSTSERVICES
  19243 Ctrl  All     0    Job *SYSTEM/MCPSERVER/SUPPORT
  19222 Ctrl  All     1 SL Job *SYSTEM/NXSERVICES/NAMESERVER
  19170 Ctrl  All     0 SL Job *SYSTEM/NXSERVICES/ADMINCENTER
  19144 Perm  All     1 SL Job *SYSTEM/NXSERVICES/CREDENTIALSUPPORT