Administration Commands

query_dlus

The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the pu_name parameter value was not valid.

INVALID_FILTER_OPTION

The filter parameter was not set to a valid value.

State Check

No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.

Function Not Supported

If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the following parameters:

primary_rc

FUNCTION_NOT_SUPPORTED

The local node does not support DLUR; this support is defined by the dlur_support parameter on the define_node command.

secondary_rc

(This parameter is not used.)

Other Conditions

Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.

2.126 query_dlus

The query_dlus command returns information about dependent LU server (DLUS) nodes known to the dependent LU requester (DLUR) feature of SNAplus2. This command can be used to obtain information about a specific DLUS or about multiple DLUSs, depending on the options used. This command also returns pipe statistics (SSCP-PU and SSCP-LU session statistics); the query_isr_session command can be used to obtain PLU-SLU session statistics.

If this command is issued to an inactive node, it returns information only about DLUS nodes defined using define_internal_pu or define_dlur_defaults. If this command is issued to a running node, it returns information about DLUS nodes defined using define_internal_pu or define_dlur_defaults and active DLUS nodes. The query_dlus command does not return information about the backup DLUS that was defined using define_dlur_defaults, unless the backup DLUS is active.

2.126.1 Supplied Parameters

Parameter name

Type

Length

Default

[query_dlus]

 

 

 

num_entries

decimal

 

1

list_options

constant

 

LIST_INCLUSIVE

dlus_name

character

17

(null string)

Supplied parameters are:

num_entries

365

Page 365
Image 365
HP UX Internet and Networking Software manual Querydlus, Supplied Parameters