Use the rmhostiogrp command
to delete mappings between one or more input/output (I/O) groups and
a specified host object.
Syntax
rmhostiogrp { -iogrp iogrp_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.
Remember: Using the force parameter might result in a loss of access. Use it only under the
direction of your product support information.
- 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