HiCommand Dynamic Link Manager (HDLM) for Windows Systems User's Guide (HIT5201-96001, January 2008)

218 Chapter 7 Command Reference
7.4 The Offline Operation
The dlnkmgr command's offline operation places online paths offline. Specify the paths
you want to place offline by specifying a HBA port or channel adapter port to which the
target paths are connected, or by specifying a single path.
The last path accessing each LU cannot be placed offline.
Placing too many paths offline may prevent path switching if an error occurs. Before placing
a path offline, use the view operation to check how many online paths remain. For details
about the view operation, see section
7.7.
In a cluster configuration, an offline operation requested during reserve processing is put
into the waiting-to-execute state (Online(P), Online(EP), or Offline(P)), and does not
execute until the reserve processing finishes.
7.4.1 Format
To place the path offline:
dlnkmgr offline
[-path]
{-hba host-port-number.bus-number
|-cha -pathid AutoPATH_ID
|-pathid AutoPATH_ID}
[-s]
To display the format of the offline operation:
dlnkmgr offline -help
7.4.2 Parameters
To place the path offline, the -path parameter indicates that the target of the operation is
a path or paths managed by HDLM. This parameter is optional because the offline
operation is only effective on paths. You must specify the target path in a subsequent
parameter: -hba, -cha, or -pathid.
To place offline, at one time, all paths that pass through a specific HBA port, use -hba
host-port-number.bus-number. The command will place offline all paths connected to
the HBA port that has the specified host port number and bus number. Specify the host port
number and bus number of the target HBA port: the numbers are found in the PathName
field displayed using the view operation. Enter a period between these two parameter
values. For details about the view operation, see section
7.7. Leading zeros of each
parameter value can be omitted; however, when the host port number or bus number of the
target HBA port is 0000, enter 0000 or 0 for the corresponding parameter value. The
following example shows how to place offline all paths connected to the HBA port whose
host port number is 0001 and bus number is 0001.