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

SET RDEVICE CLEAR
►►
Set
Authorization
Purpose
RDEVice
Operands
Usage Notes
Examples
rdev
rdev1-rdev2
Privilege Class: B
Use SET RDEVICE CLEAR to clear the information in the real device control block
(RDEV) for a specific device or range of devices. After you issue this command, CP
clears out all of the information in the RDEV except for the:
v Count of granted lock requests
v Count of deferred lock requests
v Device number
v Enqueued task
v Free storage RDEV indicator
v Missing Interrupt Handler control block
v Monitor flags
v RDEV lock
v Size of RDEV
v Subchannel disabled indicator
v Subchannel identifier
v Subchannel measurement block address
v Subchannel measurement block index
v Task requesting lock
v Valid device indicator
rdev
rdev1-rdev2
specifies the real device number or a range of real device numbers that you
want cleared. The variable rdev must be a hexadecimal number between
X'0000' and X'FFFF'.
1. Only devices whose characteristics can be determined dynamically (sensed),
can be directly varied online after a clear has been performed.
2. For those devices whose characteristics cannot be determined dynamically,
another SET RDEVICE must be performed to define the device before it can be
varied online.
Note: To determine if the given device(s) can be dynamically sensed, see 'Defining
I/O Devices in the System Configuration File' in the z/VM: CP Planning and
Administration.
Example 1:
CLear
SET RDEVICE CLEAR
►◄
Chapter 2. CP Commands 1341