?LIBS

Syntax

── ? ─┬───────┬─ LIBS ─────────────────────────────────────────────────%
      ├─<LSN>─┤
      └─ * ───┘

Explanation

The ?LIBS command displays a list of the frozen libraries under the usercode of the station. The information about each library includes the following:

  • Mix number

  • Library name

  • Number of users

The syntax and results of this command are controlled to some extent by the CANDE ALLMSG option, the value of which is assigned by the CANDE network control command ?OP (refer to the CANDE Configuration Reference Manual for information about ?OP).

If ALLMSG is RESET, a syntax error is issued if <LSN> or asterisk (*) is specified. The only information returned pertains to those libraries with the user's <usercode> that originate from the user's <LSN>.

If ALLMSG is SET, information about any <LSN> can be requested. The asterisk (*) is a shorthand method for specifying the <LSN> to which the user is signed on. If no <LSN> is specified, all information pertaining to libraries for the user making the request, regardless of origination point, is returned.

Note that the system libraries accessed by user programs are not visible through the ?LIBS command. The only visible libraries are those that were associated with a user's <usercode> when they were frozen. For those libraries visible through the ?LIBS command, other relevant CANDE control commands such as ?DS, ?TI, ?Y, ?OT, and ?CU are allowed. The system command THAW is also allowed. The CANDE control command ?AX can be used after the library is thawed.

Example

?LIBS
---- 2 FROZEN LIBRARIES ---------
* 7216 JOB (1) (SMITH)OBJECT/LIB on PACK1
* 7232 JOB (2) (SMITH)OBJECT/LIB2 on PACK2 

In the preceding example, the number enclosed in parentheses indicates the number of users of that library.