Administration Commands

query_node_all

node_name

Name of the node to be used as an index into the list. This parameter is ignored if list_options is set to FIRST_IN_LIST.

If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name.

2.156.2 Returned Parameters

Parameter name

Type

Length

node_name

character

128

config_role

constant

 

If the command executes successfully, SNAplus2 returns the following parameters:

node_name

The name of the SNAplus2 node.

config_role

The configuration file role of the server where the node is running. For more information about configuration file roles, refer to the HP-UX SNAplus2 Administration Guide. Possible values are:

MASTER

The server holds the master configuration file.

BACKUP

The server holds a backup configuration file.

NONE

The server does not share its copy of the configuration file.

2.156.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_NODE_NAME

The list_options parameter was set to LIST_INCLUSIVE or LIST_FROM_NEXT to list all entries starting from the supplied node name, but the node_name parameter was not specified or was not valid.

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.

491

Page 491
Image 491
HP UX Internet and Networking Software manual Nodename, Configrole