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.
Supplied Parameters |
 |
Parameter name Type Length Default
[query_sna_net]
num_entries decimal 1
list_options constant LIST_INCLUSIVE
server_name character 64 (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.
Returned Parameters |
|
Parameter name Type Length
security constant
domain_name character 64
server_name character 64
|
If the command executes successfully, SNAplus2 returns the
following parameters:
- security
The level of security for Windows clients accessing SNAplus2
servers. This parameter is specified during installation, or can
be modified later using the snapwinsec program. For more information about security for Windows
clients, refer to the HP-UX SNAplus2 Administration Guide.
Possible values are:
- SECURITY_OFF
No security restrictions.
- SECURITY_DOMAIN
Login IDs and passwords used by Windows Client users
must be defined on the HP-UX system.
- domain_name
The name of the TCP/IP domain containing the SNAplus2
LAN. This name was specified during installation of the master server.
For each server, the following parameter is included:
- server_name
Name of the server listed in the file.
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.
No parameter errors occur for this command.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters:
- primary_rc
STATE_CHECK
- secondary_rc
- RECORD_NOT_FOUND
The list_options parameter was set to LIST_INCLUSIVE or LIST_FROM_NEXT to
list entries starting from the supplied server name, but the server_name parameter did not match an entry in the file.
Printable version
