rmhost

You can use the rmhost command to delete a host object.

Syntax

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

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

Parameters

-force
Optionally forces the delete. This argument deletes the host object. Any WWPNs that are still active can be added to other hosts. The active WWPNs are then listed as unconfigured WWPNs.
host_name | host_id
Specifies the host object to delete, either by ID or by name.

Description

When executed, this command deletes the logical host object. The WWPNs that were contained by this host object (if 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 will fail unless you specify the force flag. When specified, this flag causes the command to delete the mappings before deleting the host object.

Possible failures

Examples

An invocation example

svctask rmhost host_one