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

HiCommand
®
Dynamic Link Manager (HDLM) for Windows
®
Systems User’s Guide 221
7.5 The Online Operation
The dlnkmgr command's online operation places offline paths online. You can specify the
paths you want to place online by specifying a HBA port or channel adapter port to which
the target paths are connected, or by specifying a single path.
7.5.1 Format
To place the path online:
dlnkmgr online
[-path]
[-hba host-port-number.bus-number
|-cha -pathid AutoPATH_ID
|-pathid AutoPATH_ID]
[-s]
To display the format of the online operation:
dlnkmgr online -help
7.5.2 Parameters
To place the path online, -path indicates that the target of the operation is a path
managed by HDLM. This parameter is optional because the online operation is only
effective on paths. You can specify the target path in a subsequent parameter: -hba, -cha,
or -pathid. If you do not specify any of these parameters, the command places all the
offline paths online. If there is a path that cannot be placed online, a message asks whether
you would like to continue processing. To ignore the offline path that cannot be placed
online and to continue processing, enter y. To stop the processing, enter n.
To place online, at one time, all paths that pass through a specific HBA port, use -hba
host-port-number.bus-number. The command will place online all paths connected to
the HBA port with 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 online all paths connected to an HBA port whose host
port number is 0001 and bus number is 0001.
>dlnkmgr online -hba 1.1
KAPL01057-I All the paths which pass the specified HBA will be changed to the Online
status. Is this OK? [y/n]:y
KAPL01061-I 3 path(s) were successfully placed online. 0 path(s) could not be placed
online. Operation name = online
>