Placing devices online or offline to JES3 *VARY

Function

Use the *VARY command to make JES3, and JES3-managed devices available or unavailable for JES3 scheduling. These devices include RJP lines, devices at BSC RJP or SNA RJP workstations, logical senders used by JES3 networking, and mains.

Use the *VARY command to vary SMS-managed devices online or offline to any processor in the JES3 complex.

The *VARY command is equivalent to the *MODIFY,V command; either can be used to accomplish the same functions.

Syntax

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

>--+-+-,--devname-+--+-,--OFFLINE-+---------------------------------------------+-><
   | +-,--lname---+  +-,--OFF-----+                                             |   
   | +-,--lsender-+  +-,--ONLINE--+                                             |   
   | '-,--main----'  '-,--ON------'                                             |   
   |       .-,-------.                                                          |   
   |       V         |                                                          |   
   +-,--(----devname-+--)--+-,--OFFLINE-+---------------------------------------+   
   |                       +-,--OFF-----+                                       |   
   |                       +-,--ONLINE--+                                       |   
   |                       '-,--ON------'                                       |   
   +-,--+---+--devnum--+-,--ONLINE------+--+-------------------+----------------+   
   |    '-⁄-'          +-,--ON----------+  +-,--main-----------+                |   
   |                   +-,--OFFLINE-----+  |       .-,----.    |                |   
   |                   +-,--OFF---------+  |       V      |    |                |   
   |                   |            (1) |  +-,--(----main-+--)-+                |   
   |                   '-,--RECOVER-----'  '-,--ALL------------'                |   
   |       .-,-------------.                                                    |   
   |       V               |                                                    |   
   +-,--(----+---+--devnum-+--)--+-,--ONLINE------+--+---------+----------------+   
   |         '-⁄-'               +-,--ON----------+  +-,--main-+                |   
   |                             +-,--OFFLINE-----+  '-,--ALL--'                |   
   |                             +-,--OFF---------+                             |   
   |                             |            (1) |                             |   
   |                             '-,--RECOVER-----'                             |   
   '-,--(--+---+--devnum-- ---+---+--devnum--)--+-,--ONLINE------+--+---------+-'   
           '-⁄-'              '-⁄-'             +-,--ON----------+  +-,--main-+     
                                                +-,--OFFLINE-----+  '-,--ALL--'     
                                                +-,--OFF---------+                  
                                                |            (1) |                  
                                                '-,--RECOVER-----'                  

1. You cannot code RECOVER with ALL. You must code main one or more times with RECOVER.

Parameters

devname

Specifies the name of a device, as defined in a DEVICE initialization statement.

lname

Specifies a networking or an RJP line name, as defined in the NJERMT or RJPLINE initialization statement.

lsender

Specifies the name of a logical sender used by JES3 networking. The names are defined by JES3 during initialization processing.

OFFLINE or OFF

Specifies that the designated device, main, or line be made unavailable for JES3 scheduling, RJP usage, or JES3 networking usage.

ONLINE or ON

Specifies that the designated device, main, or line be returned to availability for JES3 scheduling, RJP usage, or JES3 networking usage.

devnum (where devnum is optionally preceded by a slash (/) )

Specifies the number of a device (by 3-digit or 4-digit hexadecimal number). Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd
ddX
dddX
/ddX
/dddX

where ddd and dddd represent the device numbers. If the last digit in ddd or dddd is specified as X, all devices in the range dd0-ddF or ddd0-dddF are varied.

RECOVER

Use the RECOVER parameter to logically move a permanently resident volume to a new address. The RECOVER parameter forces vary online and volume verification processing for a single direct access set-up device. The device that you specify on this command is treated as if it has a device characteristic of removable. Other devices that have the same volume serial as the specified device are also treated as removable devices.

RESTRICTIONS:

• The issuing console must have level 15 authority.
• You must specify a main name.
• You cannot move non-DASD volumes.
• You cannot move JES3 spool volumes.
• You cannot move a DASD volume that has a mount pending.
• You cannot move a DASD volume that is involved in an active DDR swap.

CAUTION:

Use this parameter only with the approval of your system programmer. Improper use can damage your JES3 system.

main

Specifies the name of a global or local main, as defined in the MAINPROC initialization statement. Although the designated main can be placed offline or online to all JES3 scheduling, jobs currently running are not affected.

(main1,main1....)

Specifies the name of a global or local main(s) as defined by the MAINPROC initialization statement. The requested setup devices and virtual units are to be varied online or offline to the main(s) specified in this parameter. This parameter is required if the online status of a real setup device or execution device is being changed. Entering the command without specifying the main1 parameter changes the online/offline status of a JES3 device.

ALL

Specifies all mains in the complex. The specified devices are varied online or offline to every main to which the devices are defined.

devnum–devnum (where each devnum is optionally preceded by a slash (/) )

Specifies a range of device numbers (by 3-digit or 4-digit hexadecimal number). Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

Examples

*V,(180,181),OFFLINE,SY1
      or
*F,V,(180,181),OFFLINE,SY1

*V,SY1,OFF
    or
*F,V,SY1,OFF