Varying an optical drive online or offline

Before OAM can allow a drive to be brought online to an instance of OAM, 3995 drive processing must verify that the drive is not online to another instance of OAM in the OAMplex, or that the OAM that controls the drive has terminated or does not have a valid XCF member defined.

Drive vary processing must check the status of the optical library to which this drive is physically attached. If this drive is brought online, the library where it resides must not be online to another OAM in the OAMplex. It also checks the status of all the other libraries associated with the drive and the drives associated with those libraries.

Drive vary processing must also check the status of other drives in the optical library to which this drive is attached. If this drive is brought online, no other drives in the library where the drive resides can be online to another instance of OAM in the OAMplex.

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

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


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

                               .-*---------.                       
>--SMS,-+-DRIVE-+-(drive-name,-+-system_id-+-)-,-+-+-ONLINE-+--+-><
        '-DRI---'              '-*---------'     | '-ON-----'  |   
                                                 '-+-OFFLINE-+-'   
                                                   '-OFF-----'

DRIVE(drive-name): Specifies the name of the optical drive to be varied online or offline. If the name is not specified or the specified drive is not defined in the SMS configuration, an error message is displayed.
*: Indicates that the target of the drive vary request is the current OAM.
system-id: Specifies the MVS system that is the target of the vary request.
For optical drives, only one system ID can be specified.
ONLINE: Specifies that the optical drive is varied online.
OFFLINE: Specifies that the optical drive is varied offline.

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

VARY SMS,DRIVE(drive-name,system-id),ONLINE

This results in MODIFY OAM,VARY,drivename,ONLINE

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

VARY SMS,DRIVE(drive-name,system-id),OFFLINE

This results in MODIFY OAM,VARY,drivename,OFFLINE

Tip: You can demount an optical disk cartridge on an operator-accessible drive by varying the drive offline.