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