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.
Note: This command deletes the associated host
throttle if that host is removed.
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