HiCommand Dynamic Link Manager User's Guide (for Windows(R))
This section describes the parameters for the view operation, in the following order:
(1) Parameters used when displaying program information
(2) Parameters used when displaying HDLM management-target device information
(3) Parameters used when displaying path information
(4) Parameters used when displaying LU information
(5) Parameter used when displaying the format of the view operation
- Organization of this subsection
- (1) Parameters used when displaying program information
- (2) Parameters used when displaying HDLM management-target device information
- (3) Parameters used when displaying path information
- (4) Parameters used when displaying LU information
- (5) Parameter used when displaying the format of the view operation
(1) Parameters used when displaying program information
- -sys [-sfunc|-msrv|-adrv|-pdrv|-lic]
- Displays the HDLM program information.
- Use one of the subsequent parameters (following -sys) to specify the program information that you want to display. If you do not specify a subsequent parameter, the command displays all program information.
- Table 7-8 Displayed program information describes the specifiable parameters, displayed information, displayed items, and a corresponding description.
- -t
- Does not display the title for each information item.
Parameter and program information Item Description -sfunc
Information about the HDLM function settingsHDLM Version HDLM version number. Service Pack Version HDLM SP version number. This item is blank if a SP is not installed. Load Balance Setting for load balancing
- Setting status
on: Enabled
off: Disabled
- Algorithm
When the setting status of load balancing is on, the type of algorithm used for load balancing is displayed after the on.
rr: Round robin
extended rr: Extended round robin
Support Cluster Setting for cluster support# and the type of the cluster server
- on MSCS: when MSCS is used for the cluster server
- off: when no cluster is used or a cluster other than MSCS is used
Elog Level Error logging level
- 0: Collects no error information.
- 1: Collects error information at the Error level or higher.
- 2: Collects error information at the Warning level or higher.
- 3: Collects error information at the Information level or higher.
- 4: Collects error information at the Information or higher level (including maintenance information).
Elog File Size (KB) Size of the error log file in kilobytes Number Of Elog Files Number of error log files. Trace Level Trace output level
- 0: Does not output any trace.
- 1: Only outputs error information.
- 2: Outputs a summary of program operation.
- 3: Outputs details of program operation.
- 4: Outputs all information.
Trace File Size(KB) Trace file size in kilobytes. Number Of Trace Files Number of trace files Path Health Checking
- Setting for path health checking
on: Enabled
off: Disabled
- Checking interval
When the setting of the path health checking is on, the checking interval of path health checking is displayed within the parentheses, ( ), after on. The time is in minutes.
Auto Failback
- Setting for automatic failback
on: Enabled
off: Disabled
- Checking interval
When the setting of the automatic failback is on, the checking interval of automatic failback is displayed within the parentheses, ( ), after on. The time is in minutes.
Remove LU Setting for Remove LU
on: Enabled
off: DisabledIntermittent Error Monitor
- Setting for intermittent error monitoring
on: Enabled
off: Disabled
When automatic failback is off, intermittent error monitoring is disabled although Intermittent Error Monitor shows on. When automatic failback becomes on, intermittent error monitoring becomes enabled.
- Intermittent error monitoring interval and number of times that the error is to occur
When intermittent error monitoring is set to on, the specified intermittent error monitoring interval and number of times that the error is to occur are displayed in parentheses, (), following on. The format is number-of-times-error-is-to-occur/monitoring-interval. The time is in minutes.
-msrv
Information about the HDLM managerHDLM Manager Status of the HDLM manager
Alive: Normal
Dead: StoppedVer Version number of the HDLM manager WakeupTime Startup time of the HDLM manager -adrv
Information about the HDLM alert driverHDLM Alert Driver Status of the HDLM alert driver
Alive: Normal
Dead: StoppedVer Version number of the HDLM alert driver WakeupTime Startup time of the HDLM alert driver ElogMem Size Size of error log memory for the HDLM alert driver in kilobytes -pdrv
Information about the HDLM driverHDLM Driver Status of the HDLM driver
Alive: Normal
Dead: StoppedVer Version number of the HDLM driver WakeupTime Startup time of the HDLM driver -lic
Information about the HDLM licenseLicense Type License type
- Permanent: permanent license
- Temporary: temporary license
- Emergency: emergency license
Expiration License expiration
- When using a permanent license: -
- When using a temporary license or emergency license: The license expiration period is displayed in the format: yyyy/mm/dd(n days after). When the view -sys -lic operation is executed, (ndays after) appears if there are n days left until the license period expires.
When there are 100 days left until the license period (2006/08/21) expires
2006/08/21(100days after)
- #
- When the HDLM manager starts, HDLM cluster servers are automatically recognized.
- Example 1
- The following example shows how to display information about the HDLM function settings.
>dlnkmgr view -sys -sfunc HDLM Version : xx-xx Service Pack Version : Load Balance : on(rr) Support Cluster : off Elog Level : 3 Elog File Size(KB) : 9900 Number Of Elog Files : 2 Trace Level : 0 Trace File Size(KB) : 1000 Number Of Trace Files : 4 Path Health Checking : on(30) Auto Failback : off Remove LU : on Intermittent Error Monitor : off KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
- Example 2
- The following example shows how to display information about the HDLM manager.
>dlnkmgr view -sys -msrv HDLM Manager Ver WakeupTime Alive xx-xx yyyy/mm/dd hh:mm:ss KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
- Example 3
- The following example shows how to display information about the HDLM alert driver.
>dlnkmgr view -sys -adrv HDLM Alert Driver Ver WakeupTime ElogMem Size Alive xx-xx yyyy/mm/dd hh:mm:ss 128 KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
- Example 4
- The following example shows how to display information about the HDLM driver.
>dlnkmgr view -sys -pdrv HDLM Driver Ver WakeupTime Alive xx-xx yyyy/mm/dd hh:mm:ss KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
- Example 5
- The following example shows how to display information about the HDLM license.
>dlnkmgr view -sys -lic License Type Expiration Permanent - KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
(2) Parameters used when displaying HDLM management-target device information
- -stinfo
- Use this parameter to display information about a HDLM management-target device (except the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V) that was set when HDLM was installed.
- Table 7-9 HDLM management-target device information describes the displayed items.
Item Description HDLM management-target device Name of the HDLM management-target device (except the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V) Setting Status Setting status of the HDLM management-target device (except the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V).
on: enabled
off: disabled
- The HDLM management-target device (except the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V) can be set when the OS is one of the following. Otherwise, this item always displays off.
- Windows Server 2003 (IA32) SP1 or later
- Windows Server 2003 (IPF) SP1 or later
- -t
- Does not display the title for each information item.
- Example
>dlnkmgr view -stinfo EMC Symmetrix DMX Series, CLARiiON CX Series : on HP StorageWorks EVA Series : on KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >
(3) Parameters used when displaying path information
When displaying path information, if the -item parameter or the -c parameter is specified at the same time as the -path parameter, you can select the items to display and display a summary of path information. This section describes each parameter, path information and displayed items.
Parameters (to display path information)
- -path
- When you specify the -path parameter and do not specify either the -c or -item parameter, the command displays information about the paths without abbreviating or selecting items.
- In the subsequent sub-parameters (following -path), you can filter the paths to be listed (-hdev) and sort the list (-srt). When you omit both parameters, the command displays information for all the paths in order of ascending AutoPATH_IDs.
- For details on what is displayed in each item, see Table 7-11 Displayed path information.
- AutoPATH_IDs displayed by the -path parameter depend on the sequence in which HDLM detects the paths when a host is started. Because of this, make sure that you use the path name (PathName) to identify a path.
- The subsequent sub-parameters (following -path) are:
- -hdev host-device-name
- Filters the information only for the paths accessing the specified host device.
- Specify a drive letter to indicate the desired host device. You cannot specify the host device unless a drive letter has been assigned. The host-device-name string is case-sensitive. If the command finished by displaying the KAPL01064-W or KAPL01013-E message, follow the action recommended in the message.
- -stname
- Use this parameter for the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V to display the model ID of the storage subsystem in the product ID element of the DskName field. When this parameter is omitted, the command displays the product ID or emulation type of the storage subsystem instead.
- For more information pertaining to the storage subsystem and corresponding product ID, see Table 7-13 Product ID displayed by the view -path operation.
- -iem
- Use this parameter to add IEP to path information and display information about intermittent errors.
- -srt {pn|lu|cp}
- Use this parameter to sort the list of path information in ascending order, according to the specified sorting keys.
- The sorting keys are as follows: the first sorting key is the name of the storage subsystem (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID.
- The parameter values available to specify the second sorting key are:
- pn: Path name
- lu: LU number of the storage subsystem
- cp: Port number of the channel adapter
- When the -srt parameter is omitted, the path information is listed in order of ascending AutoPATH_IDs.
- -exlu
- When an HDLM management-target device contains the EMC DMX series, EMC CX series, or HP EVA series
If this parameter is specified, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is configured of only the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V
16 digits are displayed for the iLU even if this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- When the -exlu parameter is not specified:
- When the -exlu parameter is specified:
Parameters (to display path information, by selecting a display item)
- -path -item
- When you specify the -path parameter together with the -item parameter, the command only displays the items specified by the value of the -item parameter.
- If you specify no value for the -item parameter, only the PathID and the Status fields are displayed.
- Table 7-10 Items that can be selected by the -path -item parameter and parameter values that can be specified after the -path -item parameter shows the items that can be selected by using the -item parameter and the parameter values that can be specified after the -item parameter.
Table 7-10 Items that can be selected by the -path -item parameter and parameter values that can be specified after the -path -item parameter
Selectable items Parameter values that can be specified after the -path -item parameter PathID# None Status# None PathName pn DskName dn iLU lu ChaPort cp Type type IO-Count ic IO-Errors ie DNum dnu HDevName hd IEP iep
- #
- Because both PathID and Status are always displayed, they do not require any parameters to be specified.
- In the subsequent sub-parameters (following -path -item), you can filter the paths to be listed (-hdev) and sort the list (-srt). When you omit both parameters, the command displays information for all the paths in order of increasing AutoPATH_IDs.
- The subsequent sub-parameters (following -path -item) are:
- -hdev host-device-name
- Filters the information only for the paths accessing the specified host device.
- Specify a drive letter to indicate the desired host device. You cannot specify the host device unless a drive letter has been assigned.
- The host-device-name string is case-sensitive.
- When you specify this parameter, HDevName is displayed by default. Therefore, it is not necessary to specify hd for the -item parameter.
- -stname
- Use this parameter for the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V to display the model ID of the storage subsystem in the product ID element of the DskName field. When this parameter is omitted, the command displays the product ID or emulation type of the storage subsystem instead.
- For more information pertaining to the storage subsystem and corresponding product ID, see Table 7-13 Product ID displayed by the view -path operation.
- When you use this parameter, DskName is displayed by default. Therefore, it is not necessary to specify dn for the -item parameter.
- -srt {pn|lu|cp}
- Use this parameter to sort the list of path information in ascending order, according to the specified sorting keys.
- The sorting keys are as follows: the first sorting key is the name of the storage subsystem (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID.
- The parameter values available to specify the second sorting key are:
- pn: Path name
- lu: LU number of the storage subsystem
- cp: Port number of the channel adapter
- When the -srt parameter is omitted, the path information is listed in order of ascending AutoPATH_IDs.
- When you use this parameter, the items used for the sorting keys (DskName, AutoPATH_ID, and the item specified by this parameter) are displayed by default. Therefore, it is not necessary to specify these items for the -item parameter.
- -exlu
- When an HDLM management-target device contains the EMC DMX series, EMC CX series, or HP EVA series
If this parameter is specified, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is configured of only the Thunder 9200/9500V Series, Lightning 9900/9900V Series,TagmaStore, or,Universal Storage Platform V
16 digits are displayed for the iLU even if this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- In the following example, IO-Count is selected as the display item and the path information is sorted in ascending order of the LUs.
Parameters (to display a summary of path information)
- -path -c
- If the -c parameter is specified at the same time as the -path parameter, only PathID, DskName, iLU, CP, Status, and Type are displayed from the path information managed by HDLM. The displayed contents are shortened so that each instance of path information is displayed on a single line.
- The items that are displayed are PathID, DskName, iLU, CP, Status, and Type.
- For details on what is displayed in each item, see Table 7-11 Displayed path information.
- When you use the -c parameter, the number of characters that can be displayed in the product ID element of the DskName field is limited to 10. Therefore, when there are 11 or more characters in the product ID, the 8th and following characters are abbreviated to ellipses (...).
- The subsequent sub-parameters (following -path -c) are:
- -stname
- Use this parameter for the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V to display the model ID of the storage subsystem in the product ID element of the DskName field. When this parameter is omitted, the command displays the product ID or emulation type of the storage subsystem instead.
- For more information pertaining to the storage subsystem and corresponding product ID, see Table 7-13 Product ID displayed by the view -path operation.
- -srt {lu|cp}
- Use this parameter to sort the list of path information in ascending order, according to the specified sorting keys.
- The sorting keys are as follows: the first sorting key is the name of the storage subsystem (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID.
- The parameter values available to specify the second sorting key are:
- lu: LU number of the storage subsystem
- cp: Port number of the channel adapter
- When the -srt parameter is omitted, the path information is listed in order of ascending AutoPATH_IDs.
- -t
- Does not display the title for each information item.
- Example
- The following example shows how to display a summary of the path information in order of iLUs.
Table 7-11 Displayed path informationdescribes the displayed path information. The following explains the table headings:
- No summary displayed: The user specifies the -path parameter or -path -item parameter.
- Summary displayed: The user specifies the -path -c parameter.
Table 7-11 Displayed path information
Displayed Item Description No summary displayed Summary displayed Paths Total number of displayed paths, indicated by a decimal number. OnlinePaths Number of available paths in the displayed paths, indicated by a decimal number. When the value of Paths equals the value of OnlinePaths, all paths are online. If the value of OnlinePaths is less than that of Paths, some paths might have an error status, in which case you should check the status of individual paths and take appropriate action for any paths that have an error status. PathStatus Status of the displayed paths. The displayed status indicates the following:
Reduced means that some paths might have an error status, in which case you should check the status of individual paths and take appropriate action for any paths that have an error status.
- Online: All paths are available.
- Reduced: Some paths are not available.
IO-Count Total I/O count for the displayed paths, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O count reaches the maximum value, it is reset, and the count is re-started from 0. IO-Errors Total I/O error count for the displayed paths, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0. PathID AutoPATH_ID indicated by a decimal number.
AutoPATH_ID is assigned when the host is restarted.PathName#1 - The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the physical path that will be affected by the change. Path name consists of the following four elements, separated by periods:
For details about each element of the path name and its representation in Windows, see Table 7-12 Elements of a path name.
- Host port number (hexadecimal number)
- Bus number (hexadecimal number)
- Target ID (hexadecimal number)
- Host LU number (hexadecimal number)
DskName#1 DskName The storage subsystem name, which identifies the storage subsystem that is accessed by a path.
A storage subsystem name consists of the following three elements, separated by periods:
For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V, you can identify an actual storage subsystem by referencing the above information from the storage subsystem management program.
- Vendor ID: The name of the storage subsystem vendor (for example, HITACHI).
- Product ID: Indicates the storage subsystem product ID, emulation type, or model ID (for example, DF600F).
For more details, see Table 7-13 Product ID displayed by the view -path operation.
- Serial number: For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V, the serial number of the storage subsystem (for example, 0051)
For the EMC DMX series, EMC CX series, and HP EVA series, a hyphen (-) is displayed.
iLU#1 iLU
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
LU number of the storage subsystem.
This number combined with the storage subsystem name (shown in DskName) identifies the LU that is accessed by a path.
For Lightning 9900 Series, Lightning 9900V Series, and TagmaStore USP, the first two characters of iLU are the CU (Control Unit) number, and the last two characters are the internal LU number within the CU. Indicated by a hexadecimal number. For the Thunder 9200 Series, and Thunder 9500V Series, and TagmaStore AMS/WMS series the entire value of iLU is the internal LU number within the storage subsystem. You can identify an actual LU by referencing iLU from the storage subsystem management program. Indicated by a decimal number. For Universal Storage Platform V, indicated by a hexadecimal number. The first two characters of iLU are the number of the logical DKC (Disk Controller), the middle two numbers are the CU (Control Unit) number, and the last two characters are the internal LU number within the CU.
- For the EMC DMX series, EMC CX series, and HP EVA series:
The ID that differs from the LU number in the storage subsystem and that identifies the LU is indicated by a hexadecimal number. The value of iLU consists of 32 digits. The first 13 digits of iLU are displayed, and periods (...) are displayed for the 14th to 16th digits. When the -exlu parameter is specified, the entire value of iLU is displayed.
ChaPort#1 CP
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
The port number of the channel adapter, which identifies the CHA port that is mounted on the storage subsystem.
You can identify an actual CHA port by referencing this number from the storage subsystem management program.
- For the EMC DMX series, EMC CX series, and HP EVA series:
A hyphen (-) is displayed.
Status Status of the path
Paths that are Offline(E) or Online(E) require corrective action. The appropriate action can be determined by referring to 5.3 Actions taken for a path error.
- Online: Online
- Offline(C): Placed offline using the Path Management window of the HDLM GUI or by a command
- Offline(E): Offline due to an error
- Online(E): Failure has occurred (If none of the paths accessing one LU have an Online status, one of those paths is changed to the Online(E) status.)
- Online(P): offline operation on an Online path is waiting to execute#2
- Offline(P): offline operation on an Offline(E) path is waiting to execute#2
- Online(EP): offline operation on an Online(E) path is waiting to execute#2
Type#1 Type
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
Attribute of the path
Own: Owner path
Non: Non-owner path
When connecting to Lightning 9900 Series, Lightning 9900V Series, TagmaStore USP, or Universal Storage Platform V all paths are owner paths.
- For the EMC DMX series, EMC CX series, and HP EVA series:
A hyphen (-) is displayed.
IO-Count#1 - Total I/O count for the path, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O count reaches the maximum value, it is reset, and the count is re-started from 0.
To reset the IO-Count value to zero, execute the dlnkmgr command's clear operation. Executing the clear operation also resets the number of I/O errors (IO-Errors) to zero. For details about the clear operation, see 7.2 clear (Clears the path statistics to the initial value).IO-Errors#1 - Total I/O error count for the path, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0.
To reset the IO-Errors value to zero, execute the dlnkmgr command's clear operation. Executing the clear operation also clears the number of I/O operations (IO-Count) to zero.
For details about the clear operation, see 7.2 clear (Clears the path statistics to the initial value).DNum#1 - 0 is displayed as Dev indicating the entire LU. HDevName#1#3 - Host device name.
A drive letter is displayed. If no drive letter has been assigned, a hyphen (-) is displayed.
The drive letter is displayed in the HDevName field even if the value of the DNum field is 0. Note, however, that the displayed drive letter is the drive letter for one of the Devs included in the LU.IEP - Information about the intermittent error.
This item is displayed only when you specify -iem with the -path parameter.
One of the following values is displayed for each path:
- -
Indicates that intermittent error monitoring is disabled or the monitoring time for an intermittent error is out of range (the path status is Online(E) or Offline(E)).
- A value of at least 0
Indicates the number of errors that occurred during intermittent error monitoring (the path status is Online(E), Offline(E), or Online).
- *
Indicates that an intermittent error occurred (automatic failback does not check the path) (the path status is Online, Online(E), or Offline(C)).
- Legend:
- - : Not displayed
- #1
- The path information is displayed only when a value is specified for the -path -item parameter.
- #2
- In a cluster configuration, an offline operation requested during reserve processing is put into the waiting-to-execute state, and does not execute until the reserve processing finishes.
- #3
- The drive letter assigned to a dynamic disk volume is not displayed.
Table 7-12 Elements of a path name
Element Windows representation Host port number (hexadecimal) (example: 0004, 0005) SCSI port number Bus number (example: 0001) SCSI bus number Target ID (example: 0000000000000000, 000000000000007A) Target Id Host LU number(example: 0001) Logical Unit ID or LUN - The path name corresponds to the following information:
- Information shown in the Computer Management window
- The information in the following registry:
HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\Scsi
- Note
- When an FC connection is used, the target ID of a SCSI is determined based on the HBA configuration. For details on the target ID, see the relevant documentation, such as the HBA manual.
Model names of storage subsystems Product ID Without the -stname parameter With the -stname parameter
(Displays the following for the model ID)EMC DMX series Product identifier EMC CX series HP EVA series Thunder 9200 Product identifier# 9200 Thunder 9500V Series 9500V TagmaStore AMS AMS TagmaStore WMS WMS Lightning 9900 Series Emulation type# 9910/9960 Lightning 9900V Series 9970/9980 SVS SVS
- Hitachi TagmaStore Universal Storage Platform 100
- Hitachi TagmaStore Universal Storage Platform 600
- Hitachi TagmaStore Universal Storage Platform 1100
- TagmaStore NSC55
USP Hitachi Universal Storage Platform V USP_V XP128 XP128 XP1024 XP1024 XP10000 XP10000 XP12000 XP12000 XP24000 XP24000 #
- When a summary is displayed by specifying the -path -c parameter and there are more than 11 characters in the summary string, characters after the 9th character are displayed as an ellipsis (...).
- For command devices, "-CM" is added to the end of the emulation type of the storage subsystem (for example, DF600F-CM).
(4) Parameters used when displaying LU information
When displaying LU information, If the -item parameter, -c parameter, or the -c -item parameter is specified at the same time as the -lu parameter, you can add and display items and display a summary of LU information. This section describes each parameter and the LU information and displayed items.
Parameters (to display LU information)
- -lu
- When neither the -c nor -item parameter is specified with the -lu parameter, the information about the LU recognized by HDLM is displayed. The sorting key is iLU and its configuration information is displayed for each LU.
- Note that:
- In the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V, LU information is displayed for each storage subsystem.
- In the EMC DMX series and EMC CX series, LU information is displayed for each vendor ID.
- In the HP EVA series, LU information is displayed for each vendor_ID_product_ID.
- By using the subsequent parameter (-hdev or -pathid), you can filter the LU information to be displayed. If you do not specify -hdev or -pathid, the information about all LUs recognized by HDLM is displayed. For details on the contents of each displayed item, see Table 7-16 Displayed LU information.
- The subsequent parameters are:
- -hdev host-device-name
- Filters the information only for the paths accessing the specified host device.
- Specify a drive letter to indicate the desired host device. You cannot specify the host device unless a drive letter has been assigned.
- The host-device-name string is case-sensitive. If the command finished by displaying the KAPL01064-W or KAPL01013-E message, follow the action recommended in the message.
- -pathid AutoPATH_ID
- Use this parameter to display only the information about the LU to which the path with the specified AutoPATH_ID is connected.
- -exlu
- When an HDLM management-target device is the EMC DMX series ,EMC CX series, or HP EVA series
If this parameter is specified when a device managed by HDLM is the EMC DMX series, EMC CX series, and HP EVA series, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V
Less than 16 digits are always displayed for the iLU whether or not this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- When the -exlu parameter is not specified:
>dlnkmgr view -lu Product : 9500V SerialNumber : 0329 LUs : 2 iLU HDevName PathID Status 0000 P 000006 Online 000014 Online 0001 Q 000007 Online 000015 Online Product : DGC SerialNumber : - LUs : 2 iLU HDevName PathID Status 6006016099C50... F 000004 Online 000008 Online 6006016099C50... G 000005 Online 000009 Online Product : EMC SerialNumber : - LUs : 4 iLU HDevName PathID Status 6006048000018... L 000000 Online 000010 Online 6006048000018... M 000001 Online 000011 Online 6006048000018... N 000002 Online 000012 Online 6006048000018... O 000003 Online 000013 Online KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >- When the -exlu parameter is specified:
>dlnkmgr view -lu -exlu Product : 9500V SerialNumber : 0329 LUs : 2 iLU HDevName PathID Status 0000 P 000006 Online 000014 Online 0001 Q 000007 Online 000015 Online Product : DGC SerialNumber : - LUs : 2 iLU HDevName PathID Status 6006016099C50E0028CB54C558CDD911 F 000004 Online 000008 Online 6006016099C50E008C70FDB358CDD911 G 000005 Online 000009 Online Product : EMC SerialNumber : - LUs : 4 iLU HDevName PathID Status 6006048000018781000153594D423031 L 000000 Online 000010 Online 6006048000018781000153594D423032 M 000001 Online 000011 Online 6006048000018781000153594D423033 N 000002 Online 000012 Online 6006048000018781000153594D423034 O 000003 Online 000013 Online KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >Parameters (to display LU information (by adding items to be displayed))
- -lu -item
- The items specified with the -item option are added to the items to be displayed by the -lu option and displayed.
- If no value or all is specified for the -item parameter, all the items that can be added are displayed.
- Table 7-14 Items that can be added by using the -lu -item parameter and parameters that can be specified after the -lu -item parameter shows the items that can be added by using the -item parameter and the parameters that can be specified after the -item parameter.
Table 7-14 Items that can be added by using the -lu -item parameter and parameters that can be specified after the -lu -item parameter
Item that can be added Subsequent parameter SLPR slpr PathName pn ChaPort cp CLPR clpr Type type IO-Count ic IO-Errors ie DNum dnu IEP iep All items are displayed all - In the subsequent sub-parameters (-hdev or -pathid), you can filter the LU information to be displayed. When you omit both parameters, the command displays the information about all the LUs recognized by HDLM.
- For details on the contents of each displayed item, see Table 7-16 Displayed LU information.
- The subsequent sub-parameters are:
- -hdev host-device-name
- Filters the information only for the paths accessing the specified host device.
- Specify a drive letter to indicate the desired host device. You cannot specify the host device unless a drive letter has been assigned.
- The host-device-name string is case-sensitive. If the command finished by displaying the KAPL01064-W or KAPL01013-E message, follow the action recommended in the message.
- -pathid AutoPATH_ID
- Use this parameter to display only the information about the LU to which the path with the specified AutoPATH_ID is connected.
- -exlu
- When an HDLM management-target device is the EMC DMX series, EMC CX series, or HP EVA series
If this parameter is specified when a device managed by HDLM is the EMC DMX series, EMC CX series, and HP EVA series, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V
Less than 16 digits are always displayed for the iLU whether or not this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- The following example shows how to add SLPR, PathName, ChaPort, CLPR, Type IO-Count, IO-Errors, DNum, and IEP to the displayed items for LU information.
Parameters (to display a summary of LU information)
- -lu -c
- When the -c parameter is specified with the -lu parameter, a summary of LU configuration information is displayed on a line. The total number of paths recognized by HDLM and the number of online paths are displayed for each LU.
- Note that:
- In the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V, LU information is displayed for each storage subsystem.
- In the EMC DMX series and EMC DMX, LU information is displayed for each vendor ID.
- In the HP EVA series, LU information is displayed for each vendor_ID_product_ID.
- You cannot specify the -c parameter together with the -hdev or -pathid parameter.
- For details on the contents of each display item, see Table 7-16 Displayed LU information.
- -exlu
- When an HDLM management-target device contains the EMC DMX series, EMC CX series, or HP EVA series
If this parameter is specified, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is configured of only the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V
16 digits are displayed for the iLU even if this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- When the -exlu parameter is not specified:
- When the -exlu parameter is specified:
Parameters (to display a summary of LU information (by adding items to be displayed))
- -lu -c -item
- The items specified with the -item option are added to the items to be displayed by the -lu -c option and displayed.
- If no value is specified for the -item parameter, all the items that can be added are displayed. See Table 7-16 Displayed LU informationfor the contents of each displayed item.
- Table 7-15 Items that can be added by using the -lu -c -item parameter and parameters that can be specified after the -lu -c -item parameter shows the items that can be added by using the -item parameter and the parameters that can be specified after the -item parameter.
Table 7-15 Items that can be added by using the -lu -c -item parameter and parameters that can be specified after the -lu -c -item parameter
Item that can be added Subsequent parameter SLPR slpr - The subsequent sub-parameter is:
- -exlu
- When an HDLM management-target device contains the EMC DMX series, EMC CX series, or HP EVA series
If this parameter is specified, the entire 32 digits of the iLU are displayed without truncating it to 13 digits. If this parameter is not specified, the iLU of the EMC DMX series, EMC CX series, and HP EVA series is displayed as 16 digits with the 14th to 16th digits displayed as periods (...).
- When an HDLM management-target device is configured of only the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, or Universal Storage Platform V
16 digits are displayed for the iLU even if this parameter is specified.
- -t
- Does not display the title for each information item.
- Example
- The following example describes how to add and display a summary of SLPR.
Table 7-16 Displayed LU information describes the displayed LU information. The following explains the table headings:
- No summary displayed: The user specifies the -lu parameter or -lu -item parameter.
- Summary displayed: The user specifies the -lu -c parameter or -lu -c -item parameter.
Table 7-16 Displayed LU information
Displayed item Description No summary displayed Summary displayed Product
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
Model name of the storage subsystem
- For the EMC DMX and series, EMC CX series:
Vendor ID
- For the HP EVA series:
Vendor ID_Product ID
Serial Number S/N
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
Serial number of the storage subsystem
- For the EMC DMX series, EMC CX series, and HP EVA series:
A hyphen (-) is displayed.
LUs Total number of LUs managed by HDLM among the LUs in the storage subsystem iLU
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
LU number in the storage subsystem
This number combined with the storage subsystem name (shown in DskName) identifies the LU that is accessed by a path.
For the Lightning 9900 Series, Lightning 9900V Series, and TagmaStore USP, the first two characters of iLU are the CU (Control Unit) number, and the last two characters are the internal LU number within the CU. Indicated by a hexadecimal number. For the Thunder 9200 Series, and Thunder 9500V Series, and TagmaStore AMS/WMS series, the entire value of iLU is the internal LU number within the storage subsystem. You can identify an actual LU by referencing iLU from the storage subsystem management program. Indicated by a decimal number. For Universal Storage Platform V, indicated by a hexadecimal number. The first two characters of iLU are the number of the logical DKC (Disk Controller), the middle two numbers are the CU (Control Unit) number, and the last two characters are the internal LU number within the CU.
- For the EMC DMX series, EMC CX series, and HP EVA series:
The ID that differs from the LU number in the storage subsystem and that identifies the LU is indicated by a hexadecimal number. The value of iLU consists of 32 digits. The first 13 digits of iLU are displayed, and periods (...) are displayed for the 14th to 16th digits.
SLPR#1 SLPR#2 The number of the SLPR to which the LU belongs, indicated by a decimal number from 0 to 31. A hyphen (-) is displayed if the storage logical partition functionality for the storage subsystem for the target LU is not supported. HDevName#1#3 - Host device name.
A drive letter is displayed. If no drive letter has been assigned, a hyphen (-) is displayed.
The drive letter is displayed in the HDevName field even if the value of the DNum field is 0. Note, however, that the displayed drive letter is the drive letter for one of the Devs included in the LU.PathID - AutoPATH_ID indicated by a decimal number.
AutoPATH_ID is assigned when the host is restarted.PathName#1 - The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the path that will be affected by the change. Path name consists of the following four elements, separated by periods:
For details about each element of the path name and its representation in Windows, see Table 7-12 Elements of a path name
- Host port number (hexadecimal number)
- Bus number (hexadecimal number)
- Target ID (hexadecimal number)
- Host LU number (hexadecimal number)
ChaPort#1 -
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
Port number of the channel adapter, which identifies the CHA port that is mounted on the storage subsystem.
You can identify an actual CHA port by referencing this number from the storage subsystem management program.
- For the EMC DMX series, EMC CX series, and HP EVA series:
A hyphen (-) is displayed.
CLPR#1 - The number of the CLPR to which the CHA port belongs, indicated by a decimal number from 0 to 31. Note that a hyphen (-) is displayed if the following items are subject to display:
- CHA ports in the storage subsystem that do not support cache logical partition functionality
- Paths connected to the Snapshot Image of the Copy-on-write Snapshot of the TagmaStore AMS/WMS series
Status - Status of the path
Paths that are Offline(E) or Online(E) require corrective action. The appropriate action can be determined by referring to 5.3 Actions taken for a path error
- Online: Online
- Offline(C): Placed offline by using the Path Management window of the HDLM GUI or by a command
- Offline(E): Offline due to an error
- Online(E): Failure has occurred (If none of the paths accessing one LU have an Online status, one of those paths is changed to the Online(E) status.)
- Online(P): offline operation on an Online path is waiting to execute#4
- Offline(P): offline operation on an Offline(E) path is waiting to execute#4
- Online(EP): offline operation on an Online(E) path is waiting to execute#4
Type#1 -
- For the Thunder 9200/9500V Series, Lightning 9900/9900V Series, TagmaStore, and Universal Storage Platform V:
Attribute of the path
Own: Owner path
Non: Non-owner path
When connected to the Lightning 9900 Series, Lightning 9900V Series, TagmaStore USP, or Universal Storage Platform V, all paths are owner paths.
- For the EMC DMX series, EMC CX series, and HP EVA series:
A hyphen (-) is displayed.
IO-Count#1 - Total I/O count for the path, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O count reaches the maximum value, it is reset, and the count is re-started from 0.
To reset the IO-Count value to zero, execute the dlnkmgr command's clear operation. Executing the clear operation also resets the number of I/O errors (IO-Errors) to zero. For details about the clear operation, see 7.2 clear (Clears the path statistics to the initial value).IO-Errors#1 - Total I/O error count for the path, indicated by a decimal number. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0.
To reset the IO-Errors value to zero, execute the dlnkmgr command's clear operation. Executing the clear operation also clears the number of I/O operations (IO-Count) to zero.
For details about the clear operation, see 7.2 clear (Clears the path statistics to the initial value).DNum#1 - 0 is displayed as Dev indicating the entire LU. IEP#1 - The displayed paths are assumed to be in an intermittent error status and checked whether those paths are to be operated for automatic failback.
One of the following values is displayed for each path:
- -: Indicates that intermittent error monitoring is disabled or the monitoring time for an intermittent error is out of range.
- A value of at least 0: Indicates the number of errors that occurred during intermittent error monitoring.
- *: Indicates that an intermittent error occurred (automatic failback does not check the path).
- Paths Total number of the paths recognized by HDLM for the LU to be displayed, indicated by a decimal number - OnlinePaths Number of available paths among the paths recognized by HDLM for the LU to be displayed, indicated by a decimal number. When the value of Paths is equal to the value of OnlinePaths, all paths are online. If the value of OnlinePaths is less than that of Paths, some paths may have an error status, in which case you should check the status of individual paths and take appropriate action for any paths that have an error status.
- Legend:
- - : Not displayed
- #1
- This information is displayed when one of the following conditions exist:
- - The user selected the item to be displayed by using the -lu -item parameter.
- - all was specified.
- - No value was specified for the parameter.
- #2
- This information is displayed when one of the following conditions exist:
- - The user selected the item to be displayed by using the -lu -c -item parameter.
- - No value was specified for the parameter.
- #3
- The drive letter assigned to a dynamic disk volume is not displayed.
- #4
- In a cluster configuration, an offline operation requested during reserve processing is put into the waiting-to-execute state, and does not execute until the reserve processing finishes.
(5) Parameter used when displaying the format of the view operation
- -help
- Use this parameter to display the view operation format.
- Example
All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.