rmhost

The rmhost command deletes a host object.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- rmhost -- --+----------+-- ------------------->
                              '- -force -'      

>--+- host_name -+---------------------------------------------><
   '- host_id ---'   

Parameters

-force
(Optional) Specifies that you want the system to delete the host object even if mappings still exist between this host and virtual disks (VDisks). When the -force parameter is specified, the mappings are deleted before the host object is deleted.
host_name | host_id
(Required) Specifies the host object to delete, either by ID or by name.

Description

The rmhost command deletes the logical host object. The WWPNs that were contained by this host object (if it is still connected and logged in to the fabric) are returned to the unconfigured state. When you issue the svcinfo lshbaportcandidate command, the host objects are listed as candidate ports.

If any mappings still exist between this host and virtual disks, the command fails unless you specify the -force parameter. When the -force parameter is specified, the rmhost command deletes the mappings before the host object is deleted.

An invocation example

svctask rmhost host_one

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.