Varying a real optical library online or offline

Before OAM can allow a library to be brought online to an instance of OAM, 3995 library processing verifies that the 3995 optical library is not online to another instance of OAM in the OAMplex, or that the OAM that owns the library is failed (the XCF member name is not defined or is no longer valid for the OAMplex).

Library vary processing must also check drive status of the optical drives that are physically attached to this library and make certain that the drives are not online to another instance of OAM, or that the OAM that controls the drive has terminated or does not have a valid XCF member defined. It also checks the status of associated libraries and controller and the status of the drives in those libraries.

SMS validates the specified system ID targeted for the vary request, and verifies that the specified drive is defined as connected to the target system ID in the ACDS.

The following SMS command syntax varies optical libraries online and offline:


>>-+-VARY-+----------------------------------------------------->
   '-V----'   

                                   .-*---------.                       
>--SMS,-+-LIBRARY-+-(library-name,-+-system_id-+-)-,-+-+-ONLINE-+--+-><
        '-LIB-----'                '-*---------'     | '-ON-----'  |   
                                                     '-+-OFFLINE-+-'   
                                                       '-OFF-----'

LIBRARY(library-name): Specifies the name of the real optical library that is 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.
Restriction: Pseudo libraries cannot be varied online or offline. If a pseudo library name is used to attempt to vary a library online or offline, an error message is displayed.
system-id: Specifies the MVS system that is the target of the vary request.
For optical libraries, only one system ID can be specified.
*: Indicates that the target for the library vary request is the current OAM system.
ONLINE: Specifies that the optical library is varied online.
OFFLINE: Specifies that the optical library is varied offline.

Recommendation: To change the system where an optical library is online, the library and drives must be first varied offline to the system where they are currently online. After you successfully bring the 3995 device addresses online to z/OS, you can vary online the optical library and drives to OAM.

Here is an example of the command to vary an optical library online:

VARY SMS,LIBRARY(library-name,system-id),ONLINE

This results in MODIFY OAM,VARY,libname,ONLINE.

Here is an example of the command to vary an optical library offline:

VARY SMS,LIBRARY(library-name,system-id),OFFLINE

This results in MODIFY OAM,VARY,libname,OFFLINE.

Varying an optical library offline does not occur immediately if the drives are active or on the queue to be processed. The vary command activates immediately but does not complete until after the activity on the drives has completed. Once the library is pending offline, all library specific activity to that library fails. Write activity to a storage group that spans multiple libraries including the offline library is scheduled to one of the other libraries.