rmhostiogrp
Use the rmhostiogrp command to delete mappings between one or more input/output (I/O) groups and a specified host object.
Syntax
Parameters
- -iogrp iogrp_list
- (Required) Specifies a set of one or more I/O group mappings that will be deleted from the host. You cannot use this parameter with the iogrpall parameter.
- -iogrpall
- (Optional) Specifies that all the I/O group mappings that are associated with the specified host must be deleted from the host. You cannot use this parameter with the iogrp parameter.
- -force
- (Optional) Specifies that you want the system to remove the specified I/O group mappings on
the host even if the removal of a host to I/O group mapping results in the loss of host
mappings. Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM® support personnel.
- host_id | host_name
- (Required) Specifies the identity of the host either by ID or name from which the I/O group mappings must be deleted.
Description
The rmhostiogrp command deletes the mappings between the list of I/O groups and the specified host object.
Remember: This command is unsuccessful if:
- Volume protection is enabled (using the chsystem command)
- The host I/O group being removed is mapped to any volume that has received I/O within the defined volume protection time period
If a host is defined in two I/O groups, and has access to a volume through both
I/O groups, an attempt to remove the host from just one of those I/O groups fails, even with
-force specified. To resolve this problem, do one of the following:
- Delete the host mappings that are causing the error
- Delete the volumes or the host
Note: When all I/O groups are removed from an Internet Small Computer System Interface
(iSCSI) host, and you want to add an iSCSI port to the host, refer to the
addhostport and chhost commands.
Note: Hosts
associated with a partition are by default in all I/O groups and cannot have I/O groups added or
removed. The maximum number of I/O groups is hardware type dependent.
An invocation example
rmhostiogrp -iogrp 1:2 host0
The resulting output:
No feedback