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

DESTAGE
DESTAGE
►►
DESTAGE
Authorization
Purpose
Operands
Usage Notes
Responses
SUBSYStem
Privilege Class: B
Use DESTAGE to force the transfer of modified data in a direct access subsystem
cache or nonvolatile storage (NVS) to the backing storage device. This command is
valid for cache storage subsystems that support the cache fast write or DASD fast
write functions.
The DESTAGE command can be used as part of a shutdown process.
SUBSYStem
specifies that data for the entire storage subsystem is to be destaged,
regardless of which device within the subsystem receives the destage order.
This is the default (and only) value.
rdev
rdev1-rdev2
is the real device number, a list of real device numbers, or a range of real
device numbers, of devices to which the destage order is to be sent.
1. This command may produce delayed responses. For more information, see
“Delayed Responses to CP Commands” on page 8.
2. The DESTAGE command is only valid for cache storage subsystems that
support cache fastwrite or DASD fastwrite functions. An error message is
generated if the subsystem containing the specified device does not support any
of these functions.
Response 1:
▼ rdev
rdev1-rdev2
Immediate Response: If the transfer of subsystem data occurs immediately, the
following response is issued to the originator of the command. This response is
repeated for each unique subsystem identified by the devices specified on the
command line.
rdev Subsystem data has been destaged.
230 z/VM: CP Commands and Utilities Reference
rdev
is the real device number of one of the specified devices in a subsystem being
destaged.
►◄