HiCommand Dynamic Link Manager User's Guide (for Windows(R))

7.5.2 Parameters

Organization of this subsection

(1) To place the path online

(2) To display the format of the online operation

(1) 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.
-hba host-port-number.bus-number

Use this parameter to place online, at one time, all paths that pass through a specific HBA port. 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 7.7 view (Displays information). 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.
Example

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
>
-cha -pathid AutoPATH_ID

Use this parameter to place online, at one time, all paths that pass through a specific channel adapter port. The command will place online all paths that pass through the channel adapter port to which the path with the specified AutoPATH_ID is connected. You can specify this parameter only when the HDLM management-target device is the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V.

Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see 7.7 view (Displays information). Leading zeros can be omitted (000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value.

AutoPATH_IDs are re-assigned every time the host is restarted. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the online operation.
Example

The following example shows how to place online the paths connected to the channel adapter port 0A. In this example, a path whose AutoPATH_ID is 000002 is connected to the target channel adapter port.
  
>dlnkmgr online -cha -pathid 000002
KAPL01057-I All the paths which pass the specified CHA port will be changed to the Online status. Is this OK? [y/n]:y
KAPL01061-I 2 path(s) were successfully placed online. 0 path(s) could not be placed online. Operation name = online
>
-pathid AutoPATH_ID

Use this parameter to place a single path online.

Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see 7.7 view (Displays information). Leading zeros can be omitted(000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value.

AutoPATH_IDs are re-assigned every time the host is restarted. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the online operation.
-s

Executes the command without displaying the message asking for confirmation of command execution from the user. Specify this parameter if you want to skip the response to the confirmation message: for example, when you want to execute the command in a shell script or batch file.
Example

The following example shows how to place a path, whose AutoPATH_ID is 000002, online without asking for confirmation of command execution from the user.
 
>dlnkmgr online -pathid 2 -s
KAPL01061-I 1 path(s) were successfully placed online. 0 path(s) could not be placed online. Operation name = online
>

(2) To display the format of the online operation

-help

Displays the format of the online operation.
Example

The following example shows how to display the format of the online operation.
 
>dlnkmgr online -help
online:
  Format
    dlnkmgr online [-path] -hba HBAPortNumber.BusNumber [-s]
    dlnkmgr online [-path] -cha -pathid AutoPATH_ID [-s]
    dlnkmgr online [-path] [-pathid AutoPATH_ID] [-s]
  Valid value
    AutoPATH_ID     { 000000 - 999999 }(Decimal)
KAPL01001-I The HDLM command completed normally. Operation name = online, completion time = yyyy/mm/dd hh:mm:ss
>
Reference

Using the view operation together with Windows commands enables you to filter the path information listed for a specific HBA port or channel adapter port. For details about the view operation, see 7.7 view (Displays information).

We recommend that you use the following command and verify the information on the target paths before you execute the online operation to place online all paths connected to a specific HBA port or channel adapter port.
Example 1

The following example shows how to filter and display the information on all paths that pass through the HBA port whose host port number is 0004 and bus number is 0001.
 
>dlnkmgr view -path | find "0004.0001"
 
The above commands will display information on all the paths that pass through the specified HBA port.
Example 2

The following example shows how to filter and display the information on all paths that pass through the channel adapter port 0A of the Thunder 9500V Series.
 
>dlnkmgr view -path -stname | find "9500V" | find "0A"
 
The above commands will display information pertaining to only those paths that pass through the specified channel adapter port.
Note

When the LU dynamic deletion functionality is used, a path might be deleted due to an error such as a path error. In this case, when you attempt to change the path status, an error occurs. Confirm that the path of which you attempt to change the status has been deleted, and then take actions for the path error. For details, see 4.6.2 Deleting an LU dynamically.

[Contents][Back][Next]

[Trademarks]