To display program information

Dynamic Link Manager (for Linux®) User Guide

Version
9.0.x
Audience
anonymous
Part Number
MK-92DLM113-64
ft:lastEdition
2025-11-06
-sys [-sfunc|-msrv|-adrv|-pdrv|-lic|-audlog|-lbpathusetimes|-expathusetimes|-exrndpathusetimes|-pstv]

Displays the HDLM program information.

Use one of the sub-parameters (following -sys) to specify the program information that you want to display. If you do not specify a sub-parameter, the command displays all of the program information except the information about the audit log data collection settings, the number of times the same path can be used for load balancing, the number of times the same path can be used for extended load balancing, and the value of the display-of-the-physical-storage-system-information setting.

Table 1 shows the parameters you can specify and the displayed information.

-t

Does not display the title for each information item.

Table. Displayed program information

Parameter and program information to be displayed

Item

Description

-sfunc

Information about the HDLM function settings

HDLM Version

HDLM version number

Service Pack Version

HDLM SP version number. This item is blank if no SP is present.

Load Balance

Settings for load balancing

  • Setting status:

    on: Enabled

    off: Disabled

  • Algorithm:

    When the setting status of load balancing is on, one of the following types of algorithms is used for load balancing is displayed in the parentheses following on.

    rr: The Round Robin algorithm

    extended rr: The Extended Round Robin algorithm

    lio: The Least I/Os algorithm

    extended lio: The Extended Least I/Os algorithm

    lbk: The Least Blocks algorithm

    extended lbk: The Extended Least Blocks algorithm

Support Cluster

Blank#

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 level or higher (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

  • Settings 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 following on. The time is in minutes.

Auto Failback

  • Settings for an 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 following on. The time is in minutes.

Reservation Status

Blank

Intermittent 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 will be shown as on. When the automatic failback function is on, intermittent error monitoring will be enabled.

  • Intermittent error monitoring interval and number of times that the error needs to occur

    When intermittent error monitoring is on, the specified intermittent error monitoring interval and number of times that the error needs to occur are displayed within the 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 manager

HDLM Manager

Status of the HDLM manager:

Alive: Normal

Dead: Stopped

Ver

Version number of the HDLM manager

WakeupTime

Startup time of the HDLM manager

-adrv

Information about the HDLM alert driver

HDLM Alert Driver

Status of the HDLM alert driver:

Alive: Normal

Dead: Stopped

Ver

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. Number of error log files.

-pdrv

Information about the HDLM driver

HDLM Driver

Status of the HDLM driver:

Alive: Normal

Dead: Stopped

Ver

Version number of the HDLM driver

WakeupTime

Startup time of the HDLM driver

-lic

Information about the HDLM license

License Type

License type

  • Permanent

  • Temporary

  • Emergency

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 (ndays after). When the view -sys -lic operation is executed, (ndays after) appears if there are n days left until the license period expires.

  • For example, when there are 100 days left until the license period (2006/08/21) expires, the following appears:

    2006/08/21(100days after)

-audlog

Information about audit log data collection settings

Audit Log

Settings for audit log data collection:

  • Whether collection is enabled

    on: Enabled

    off: Disabled

  • Audit log data collection level:

    When audit log data collection is on, the collection level that has been set is displayed within the parentheses following on. The collection level indicates a severity level. A value from 0 to 7 is displayed as the collection value.

Audit Log Category

The categories of audit log data to be output are displayed. When more than one category is displayed, commas (,) are used as separators.

ss: StartStop

a: Authentication

ca: ConfigurationAccess

If all the above categories are specified, all is displayed.

If the collection of audit log data is disabled, a hyphen (-) is displayed.

Audit Log Facility

The name of the audit log facility is displayed. user, local0, local1, local2, local3, local4, local5, local6, or local7 is displayed.

If the collection of audit log data is disabled, a hyphen (-) is displayed.

-lbpathusetimes

The number of times the same path can be used for load balancing

Times Same Path Was Used

The number of times the same path can be used for I/O operations when the Round Robin (rr), Least I/Os (lio), or Least Blocks (lbk) algorithm is used for load balancing.

If you set the number of times the same path can be used in units of LUs, an asterisk (*) is added after the value.

-expathusetimes

The number of times the same path can be used for extended load balancing (sequential I/O)

Times Same ExPath Was Used

The number of times the same path can be used for sequential I/O operations when the extended Round Robin (exrr), Least I/Os (exlio), or Least Blocks (exlbk) algorithm is used for load balancing.

If you set the number of times the same path can be used in units of LUs, an asterisk (*) is added after the value.

-exrndpathusetimes

The number of times the same path can be used for extended load balancing (random I/O)

Times Same ExPath Was Used(R)

The number of times the same path can be used for random I/O operations when the extended Round Robin (exrr), Least I/Os (exlio), or Least Blocks (exlbk) algorithm is used for load balancing.

If you set the number of times the same path can be used in units of LUs, an asterisk (*) is added after the value.

-pstv

The display-of-the-physical-storage-system-information setting

Physical Storage View

The value of the display-of-the-physical-storage-system-information setting is displayed.

on: Enabled

off: Disabled

#

When you use cluster software, the settings of the cluster function and the kinds of cluster servers are not displayed. However, the cluster function will operate normally.

Examples

Example 1

The following example shows how to display information about the HDLM function settings.:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -sfunc
HDLM Version                   : x.x.x-xx
Service Pack Version           :
Load Balance                   : on(extended lio)
Support Cluster                :
Elog Level                     : 3
Elog File Size(KB)             : 9900
Number Of Elog Files           : 2
Trace Level                    : 0
Trace Files Size(KB)           : 1000
Number Of Trace Files          : 4
Path Health Checking           : on(30)
Auto Failback                  : on(1)
Reservation Status             :
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:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -msrv
HDLM Manager Ver       WakeupTime
Alive        x.x.x-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:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -adrv
HDLM Alert Driver Ver     WakeupTime            ElogMem Size
Alive              x.x.x-xx    yyyy/mm/dd hh:mm:ss 1000
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:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -pdrv
HDLM Driver Ver       WakeupTime
Alive       x.x.x-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:

# /opt/DynamicLinkManager/bin/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
#
Example 6

The following example shows how to display information about the audit log settings:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -audlog
Audit Log                      : off
Audit Log Category             : -
Audit Log Facility             : -
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss
#
Example 7

The following example shows how to display the number of times the same path can be used for load balancing:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -lbpathusetimes
Times Same Path Was Used    : 32
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss
#
Example 8

The following example shows how to display the number of times the same path can be used for extended load balancing (sequential I/O):

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -expathusetimes
Times Same ExPath Was Used    : 100
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss
#
Example 9

The following example shows how to display the number of times the same path can be used for extended load balancing (random I/O):

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -exrndpathusetimes
Times Same ExPath Was Used(R) : 1
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss
#
Example 10

The following example shows how to display the value of the display-of-the-physical-storage-system-information setting:

# /opt/DynamicLinkManager/bin/dlnkmgr view -sys -pstv
Physical Storage View    : off
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss
#