Parameters:
Name Type Description Mandatory Default
host Object name Host name. N N/A
cluster Object name Cluster name. N N/A
vol Object name Volume name. Y N/A
lun Integer LUN identifier. Y N/A
override Boolean Override existing
mapping.
Nno
This command maps a volume to a host or to a cluster. It maps the volume to all
the hosts that are contained in the cluster.
The command fails if:
v The host specified is contained in a cluster (must be done through the cluster)
v Another volume is mapped to the same LUN for this cluster/host, and the
override parameter is not specified.
– If the override parameter is specified, the mapping is replaced, so the host
(or all hosts in the cluster) see continuous mapping of volume to this LUN,
only that the content is changing (and maybe size).
v Mapping to a cluster, if the LUN was defined as an exception.
– Whenever the LUN is defined as an exception, you have to map it directly to
the host.
Access Control:
User Category Permission Condition
Storage administrator Allowed N/A
Storage integration administrator Allowed N/A
Application administrator Conditionally Allowed This volume is a snapshot. The
master volume of this snapshot
is mapped to a host or cluster
that is associated with the user
executing this command. This
snapshot was created by an
application administrator.
Security administrator Disallowed N/A
Read-only users Disallowed N/A
Technicians Disallowed N/A
Warnings:
v ARE_YOU_SURE_YOU_WANT_TO_PERFORM_HOST_SPECIFIC_MAPPING
'Host' is part of a cluster. Are you sure you want to map this volume only for
that specific host?
v ARE_YOU_SURE_YOU_WANT_TO_MAP_VOLUME
Are you sure you want to map volume Volume, which is already mapped to
another host/cluster?
Completion Codes:
v HOST_BAD_NAME
Host name does not exist
20 IBM XIV Storage System User Manual