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

DELETE CHPID / PATH
DELETE CHPID / PATH
►►
DELete
Authorization
Purpose
Operands
CHPID
PATH
Usage Notes
nn
CSS 0
CSS
Privilege Class: B
218 z/VM: CP Commands and Utilities Reference
nn
Use DELETE CHPID or PATH to delete an existing channel path identifier (CHPID)
from the I/O configuration.
nn is the number of the channel path ID that you want to delete. The variable nn
must be a 1- to 2-digit hexadecimal number between X'00' and X'FF'.
CSS nn
is the channel-subsystem ID from which the channel path is to be deleted. The
variable nn must be a 1- to 2-digit hexadecimal number between X'00' and
X'0F'. See Usage Note 2.
Note: This parameter and other parameters that identify different
channel-subsystem IDs require that the logical channel-subsystem facility
be installed.
1. Before you can delete a channel path from your I/O configuration, you must:
a. Delete all of the devices attached to all the control units attached to that
channel path using the DELETE DEVICE or IODEVICE command. (See
page 223.)
b. Delete all of the control units attached to that channel path using the
DELETE CU or CNTLUNIT command (see page 221) or use the MODIFY
CU or CNTLUNIT command (see page 604) to delete channel path access.
c. Take that channel path logically offline using the VARY PATH command.
(See page 1702.)
d. Take that channel path physically offline using the VARY CHPID command.
(See page 1700.)
2. On a machine with multiple logical channel-subsystem images, the DELETE
CHPID and DELETE PATH commands are effective only for channel paths in a
single channel-subsystem image. To delete channel paths that are in more than
one channel-subsystem image, you must first enter MODIFY CHPID or MODIFY
PATH commands to remove all but one channel-subsystem image. Then a
DELETE CHPID or DELETE PATH command can be entered.
3. After successfully entering this command, you will have changed the software’s
view of the I/O configuration and part of the hardware’s view: the active I/O
configuration in the hardware system area (HSA). You should also change the
other part of the hardware’s view: the active I/O configuration data set (IOCDS)
file on the support element (SE) hard disk.
►◄