SCF Reference Manual for the Storage Subsystem (G06.28+, H06.05+, J06.03+)

STOP Command
The STOP command terminates access to a storage device in a orderly manner. When the STOP
command finishes, configured devices are left in the STOPPED state, substate DOWN. The devices
remain in the system configuration database.
Supported objects are:
• “STOP DISK Command” (page 290)
• “STOP MON Command” (page 291)
• “STOP POOL Command” (page 291)
• “STOP SCSI Command” (page 292)
• “STOP TAPE Command” (page 292)
STOP is a sensitive command.
STOP DISK Command
The STOP DISK command terminates access to a disk. The command syntax is:
STOP [ / OUT file-spec / ] DISK $disk[-P |-B |-M |-MB ]
[ , FORCED ] [ , POOL $pool ] [ , SEL state ]
[ , SUB { ALL | MAGNETIC | VIRTUAL } ]
Wild-card characters are supported.
OUT file-spec
directs all SCF output to the specified file.
DISK $disk[-P |-B |-M |-MB ]
is the disk name and, optionally, the path (primary, backup, mirror, or mirror backup).
FORCED
specifies that the command be executed without any interaction with the user, even if the
command stops the last path to the device or files are open on the device.
If you use this attribute on a physical disk, you must first stop all processes that use the disk to
store object code (programs) or swap files. Otherwise, a %5113 halt could occur.
POOL $pool
specifies that the command is performed only on disks associated with the specified storage
pool.
SEL state
specifies that the command affects only devices in the specified state.
SUB { ALL | MAGNETIC | VIRTUAL }
specifies that the command affects only disks of the specified type. The default is ALL.
See “Attribute Descriptions for Disk Commands” (page 198) for descriptions of all attributes for disk
commands.
STOP DISK Examples
See the procedure for “Stopping a Disk” (page 101) and the procedure for “Stopping a Virtual
Disk” (page 151).
• To stop access to the mirror half of a volume:
-> STOP $DATA01-M
• To stop a disk (even if there are open files) without further interaction with the operator:
-> STOP $DATA00, FORCED
290 Storage Subsystem Commands