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

7.4.2 Parameters

Organization of this subsection

(1) To place the path offline

(2) To display the format of the offline operation

(1) To place the path offline

-path

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.

Make sure, however, that you specify the target path in a subsequent parameter: -hba, -cha, or -pathid.
-hba host-port-number.bus-number

Use this parameter to place offline, at one time, all paths that pass through a specific HBA port. 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 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 offline all paths connected to the HBA port whose host port number is 0001 and bus number is 0001.
 
>dlnkmgr offline -hba 1.1
KAPL01055-I All the paths which pass the specified HBA will be changed to the Offline(C) status. Is this OK? [y/n]:y
KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified HBA are placed in the Offline(C) status, enter y.  Otherwise, enter n. [y/n]:y
KAPL01061-I 3 path(s) were successfully placed offline(C). 0 path(s) could not be placed offline(C). Operation name = offline
>
-cha -pathid AutoPATH_ID

Use this parameter to place offline, at one time, all paths that pass through a specific channel adapter port. The command will place offline 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 offline operation.
Example

The following example shows how to place offline all paths connected to the channel adapter port 0A. In this example, a path whose AutoPATH_ID is 000001 is connected to the target channel adapter port.
 
>dlnkmgr offline -cha -pathid 000001
KAPL01055-I All the paths which pass the specified CHA port will be changed to the Offline(C) status. Is this OK? [y/n]:y
KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified CHA port are placed in the Offline(C) status, enter y.  Otherwise, enter n. [y/n]: y
KAPL01061-I 2 path(s) were successfully placed offline(C). 0 path(s) could not be placed offline(C). Operation name = offline
>
-pathid AutoPATH_ID

Use this parameter to place a single path offline.

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 offline 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 000001, offline without asking for confirmation of command execution from the user.
 
>dlnkmgr offline -pathid 1 -s
KAPL01061-I 1 path(s) were successfully placed offline. 0 path(s) could not be placed offline. Operation name = offline
>

(2) To display the format of the offline operation

-help

Displays the format of the offline operation.
Example

The following example shows how to display the format of the offline operation.
 
>dlnkmgr offline -help
offline:
  Format
    dlnkmgr offline [-path] -hba HBAPortNumber.BusNumber [-s]
    dlnkmgr offline [-path] -cha -pathid AutoPATH_ID [-s]
    dlnkmgr offline [-path] -pathid AutoPATH_ID [-s]
  Valid value
    AutoPATH_ID     { 000000 - 999999 }(Decimal)
KAPL01001-I The HDLM command completed normally. Operation name = offline, 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 offline operation to place offline 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]