Varying a tape library online or offline

Use the VARY SMS command to vary libraries online or vary them offline. The syntax of the command to vary the libraries follows:


>>-+-VARY-+--SMS,--+-LIBRARY-+---------------------------------->
   '-V----'        '-LIB-----'   

>--(library_name-+---------------------+-),--+-ONLINE--+-------><
                 |   .-*-------------. |     +-ON------+   
                 '-,-+-ALL-----------+-'     +-OFFLINE-+   
                     |           (1) |       '-OFF-----'   
                     +-system_id-----+                     
                     '-*-------------'

Notes:

You can specify up to eight system_ids (each must be separated by a comma).

OAM does not set the library offline until all the tape drives in the library are set offline. Such drives are considered offline for library reasons. When an individual drive is marked offline as a result of the VARY ddd,OFFLINE command, it is considered offline for operator reasons. Each offline state must be separately reset before the drive is again online. A VARY SMS,LIB command does not bring a drive online if the drive is currently offline for operator reasons. A VARY ddd,ONLINE command does not bring a drive online if the drive is currently offline for library reasons.

Note: A composite and distributed VTS library can be varied online and offline like any VTS library, though varying a distributed library offline from the host really has no meaning (does not prevent outboard usage of the library). Message CBR3016I warns the user when a distributed library is initialized or varied offline.

LIBRARY | LIB(library_name): Specifies the name of the library to be varied online or offline. If the name is not specified or the specified library is not defined in the SMS configuration, an error message is displayed.
ALL: Varies the state of the tape library on all systems in the SMS complex to which the library is connected.
*: Varies the state of the tape library only on the system or system group from which the VARY command is issued. If the system or system group on which the VARY command is issued is not connected to the named library, an error message is displayed. This is the default.
system_id: Varies the state of the tape library only on the systems or system groups that are specified. If a specified system is not connected to the named tape library, an error message is displayed.
Note: To specify a system or system group that is named ALL, surround it with parentheses; for example, VARY SMS,LIBRARY(library_name,(ALL)),ONLINE.
ONLINE | ON: Specifies that the library be varied online.
OFFLINE | OFF: Specifies that the library be varied offline.

An example of the command to vary a tape library online:

        VARY SMS,LIBRARY(ATL01),ONLINE

An example of the command to vary a tape library offline:

        VARY SMS,LIBRARY(ATL01),OFFLINE