rmhostiogrp

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