z/VM: CP Commands and Utilities Reference - z/VM - IBM

VARY PATH
VARY PATH
►►
VARY
Authorization
Purpose
Operands
ONline
OFFline
Usage Notes
PATH
PATH
yy
yy
TO
FROM
Privilege Class: B
▼ rdev
rdev1-rdev2
ALL
▼ rdev
rdev1-rdev2
ALL
FORCE
Use VARY PATH to enable or disable a logical connection between the host system
and one or more real devices.
ONline
OFFline
enables or disables the logical connection.
yy identifies the path to become logically available or logically unavailable for use
by the system to communicate with the specified device or devices.
Note: If the specified path is the last available path to the specified device, CP
attempts to vary the device offline. If the device cannot be varied offline,
the VARY OFFLINE PATH request is denied.
rdev
rdev1-rdev2
is the real device number of the devices to which the specified path is made
logically available or logically unavailable. You may specify a single device, a
list, or a range of devices. If you specify a range of real device numbers, all the
valid devices in the range, including the first and last devices you specified, will
be processed. The maximum number of devices allowed in a range is 256.
1702 z/VM: CP Commands and Utilities Reference
ALL
specifies that the path be made logically available or logically unavailable to all
real devices that have access to it.
FORCE
specifies that an attempt be made to bring the path online even if another
function had previously varied it offline.
1. The VARY PATH command does not start the service processor or cause any
hardware functions to be performed.
►◄