Use the rmhostiogrp command to delete mappings between one or more
input/output (I/O) groups and a specified host object.
Syntax
rmhostiogrp { -iogrpiogrp_list | -iogrpall } [ -force ] { host_name | host_id }
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.
An invocation
example
rmhostiogrp -iogrp 1:2 host0
The resulting output:
No feedback