rmhost

Use the rmhost command to delete a host object.

Syntax

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 volumes. 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 lsfcportcandidate or lssasportcandidate command, the host objects are listed as candidate ports.

Remember: This command is unsuccessful if:

Volume protection is enabled (using the chsystem command)
The host being deleted is mapped to any volume that has received I/O within the defined volume protection time period

If any mappings still exist between this host and volumes, 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

rmhost host_one

The resulting output:

No feedback