|
Device numbers and coupling facility names can be specified in any combination. If you specify only one device number or coupling facility name, you do not need to enter the parentheses.
A device number is 3 to 5 hexadecimal digits, optionally preceded by a slash (/). You can precede the device number with a slash to prevent ambiguity between the device number and a coupling facility name. Five-digit logical device numbers consist of a one-digit subchannel set ID plus a four-digit device number. If a 3-digit or 4-digit device number is entered in the command, then the device information representing subchannel set 0 is used for the display even if the actual subchannel connected to the device is in subchannel set 1. If a 5-digit device number is entered, the device information representing the specified subchannel set is displayed. If a range of device numbers is found and the first number is 5 digits, the second number in the range must be 5 digits and vice-versa.
If a path is offline for port decommissioning reasons when the VARY PATH(devnum,chpd),ONLINE command is issued, the system does not attempt to bring the path online and the setting of the flag offline by switch remains unchanged.
If the path was taken offline by Enterprise System Connection Manager (ESCM), then use ESCM to bring the path back online. Use the VARY PATH,ONLINE,FORCE command only if ESCM is not available and the path is physically available.
If the path is quiesced by Control Unit Initiated Reconfiguration (C.U.I.R.), the VARY PATH,ONLINE,FORCE command can be used to bring the path back online.
If FORCE is specified and the path is offline for port decommissioning reasons, the system attempts to bring the path online and clear the conditions for which the path is offline. However, the path cannot be brought online if either the ingress or egress switch ports used by this path are still offline (for example, blocked, in maintenance mode, or service required).
In other words, adding the UNCOND keyword to the VARY PATH,OFFLINE command requests that the system take offline those last paths to devices that are online but unallocated.
Example :
V PATH((130,133-135,140),2),OFFLINE
The system issues a message describing the path status for each device.
Assume that channel path 2 represents the last paths to device 134, which is online and allocated, and device 135, which is online and unallocated. A VARY PATH((134,135),2),OFFLINE,UNCOND command would remove the last path to device 135 but not 134. The jobs using device 134 must end or be terminated before the last path can be removed.