Administration Commands

query_session

description

An optional string of 0–31 characters.

num_users

Number of user names in the list.

For each user name in the list, a security_user_data subrecord is returned with the following information:

user_name

Name of the user. This is a user ID defined using the define_userid_password command.

2.167.3 Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

PARAMETER_CHECK

secondary_rc

Possible values are:

INVALID_LIST_NAME

The list_options parameter was set to LIST_INCLUSIVE, but the list_name parameter did not match the name of any defined security access list.

INVALID_USER_NAME

The list_options parameter was set to LIST_INCLUSIVE, but the user_name parameter did not match a user name defined for the specified security access list.

State Check

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

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.168 query_session

The query_session command returns information about sessions for a particular local LU. This command can be used to obtain summary or detailed information about a specific session or a range of sessions, depending on the options used.

This command must be issued to a running node.

2.168.1 Supplied Parameters

Parameter name

Type

Length

Default

[query_session]

530

Page 530
Image 530
HP UX Internet and Networking Software manual Querysession, Numusers