Administration Commands
query_sna_net
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.169 query_sna_net
The query_sna_net command returns information about servers that can act as backup master servers, as defined in the sna.net file. This command can be used to obtain information about a specific server or about multiple servers, depending on the options used.
The order of server names in this file is significant; the first server listed in the file will always be the master if it is active, the second will be the master if the first is inactive, the third will be the master if the first and second are both inactive, and so on. Because of this ordering, the list of server names returned on query_sna_net is in the same order as it is in the file; the returned names are not ordered by name length and lexicographical ordering, as with other query_* commands.
This command must be issued without specifying a node name.
2.169.1 Supplied Parameters
Parameter name | Type | Length | Default |
[query_sna_net] |
|
|
|
num_entries | decimal |
| 1 |
list_options | constant |
| LIST_INCLUSIVE |
server_name | character | 128 | (null string) |
Supplied parameters are:
num_entries
Maximum number of server names for which data should be returned. You can specify 1 to return data for a specific server name, a number greater than 1 to return data for multiple server names, or 0 to return data for all server names.
list_options
The position in the list of server names from which SNAplus2 begins to return data. The server names are listed in the same order as in the file, not in order of name length, lexicographical order, or both, as for other query_* commands.
Possible values are:
FIRST_IN_LIST
Start at the first entry in the list
LIST_INCLUSIVE
Start at the entry specified by the server_name parameter
LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the server_name parameter
server_name
Name of the server for which information is required, or the name to be used as an index into the list of servers. The server name is ignored if list_options is set to FIRST_IN_LIST.
537
