DELETE CHPID / PATH

Authorization

Privilege Class: B

Purpose

Use DELETE CHPID or PATH to delete an existing channel path identifier (CHPID) from the I/O configuration.

Operands

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.

Usage Notes

1. Before you can delete a channel path from your I/O configuration, you must:
   1. Delete all of the devices attached to all the control units attached to that channel path using the DELETE DEVICE or IODEVICE command. (See DELETE DEVICE / IODEVICE.)
   2. Delete all of the control units attached to that channel path using the DELETE CU or CNTLUNIT command (see DELETE CU / CNTLUNIT) or use the MODIFY CU or CNTLUNIT command (see MODIFY CU / CNTLUNIT) to delete channel path access.
   3. Take that channel path logically offline using the VARY PATH command. (See VARY PATH.)
   4. Take that channel path physically offline using the VARY CHPID command. (See VARY CHPID.)
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.

   To change the IOCDS file on the SE hard disk, you must:

   1. Update the IOCP source file.
   2. Run the IOCP utility against the updated IOCP file. If the IOCP utility runs without errors, it downloads the new IOCDS file to the SE hard disk.
   3. Issue the SET IOCDS_ACTIVE command to make the new IOCDS file the active file that the processor will use during the next power-on reset (POR).
   For more information, see IOCP and SET IOCDS_ACTIVE.
4. For more information about deleting channel paths from your I/O configuration during initialization, see Dynamically Deleting Channel Paths (CHPIDs) in z/VM®: I/O Configuration.
5. To define a new channel path ID on the system, use the DEFINE CHPID or PATH command. See DEFINE CHPID / PATH.
6. To change the definition of an existing reconfigurable channel path ID on the system, use the MODIFY CHPID or PATH command. (See MODIFY CHPID / PATH.) There is no MODIFY command to change the definitions of the other types of channel paths. If you need to change their definitions, you must:
   1. Delete the existing channel path definition, using the DELETE CHPID or PATH command.
   2. Redefine the channel path definition, using the DEFINE CHPID or PATH command.
7. To display the status of a specific logical channel path and the devices with that logical channel path installed, or to display the type of a specific logical channel path, use the QUERY CHPID command. (See QUERY CHPID.)
8. To display the physical status of all 256 of the machine's channel paths, use the QUERY CHPIDS command. (See QUERY CHPIDS.)
   Note: If the channel path is in single channel service (SCS) mode, it will appear as not configured in the display.
9. To display the logical and physical status of the channel paths installed on one or more devices, use the QUERY PATHS command.(See QUERY PATHS.)

Responses

Response 1:

delete chpid 32
Channel path configuration change completed successfully
Ready;

Response 2:

delete chpid 43 css 3
Channel path configuration change completed successfully
Ready;

Messages

• HCP1006E Command processing cannot complete because the system does not support the logical-channel-subsystem facility.
• HCP6805E Cannot find RDEV for TYPE 1 subchannel
• HCP6806E Dynamic I/O change request [for channel path|for control unit|for device] failed with return code nnnn
• HCP6809E This processor does not support dynamic I/O changes
• HCP6815E Command failed in the channel subsystem
• HCP6816E Dynamic I/O changes are not allowed {on this system|for CSS nn}
• HCP6818E Delete command failed. Channel path nn is physically available
• HCP6819E A dynamic I/O command is currently executing for user userid