 |
» |
|
|
|
The query_cn command returns information about adjacent connection networks.
This command can be used to obtain information about a specific
connection network or about multiple connection networks, depending
on the options used. The command is valid only at an end node; it is not valid
at a LEN node. Supplied Parameters | |
Parameter name Type Length Default
[query_cn]
num_entries decimal 1
list_options constant LIST_INCLUSIVE
fqcn_name character 17 (null string)
|
Supplied parameters are: - num_entries
Maximum number of CNs for which data should be returned.
You can specify 1 to return data for a
specific CN, a number greater than 1 to
return data for multiple CNs, or 0 (zero)
to return data for all CNs. - list_options
The position in the list of CNs from which SNAplus2 begins
to return data. Possible values are: - FIRST_IN_LIST
Start at the first entry in the list - LIST_INCLUSIVE
Start at the entry specified by the fqcn_name parameter - LIST_FROM_NEXT
Start at the entry immediately following the entry specified
by the fqcn_name parameter
- fqcn_name
Fully qualified name of the CN for which information
is required, or the name to be used as an index into the list of
CNs. This value is ignored if list_options is set to FIRST_IN_LIST. Specify
3-17 type-A characters consisting of a 1-8 character
network name, followed by a period, followed by a 1-8 character
CN name.
Returned Parameters | |
Parameter name Type Length
fqcn_name character 17
num_act_ports decimal
description character 31
num_ports decimal
effect_cap decimal
connect_cost decimal
byte_cost decimal
security constant
prop_delay constant
user_def_parm_1 decimal
user_def_parm_2 decimal
user_def_parm_3 decimal
|
If the command executes successfully, the following parameters
are returned: - fqcn_name
Fully qualified name of the CN. - num_act_ports
The number of active ports on the connection network. - description
A text string describing the CN, as specified in
the definition of the CN. - num_ports
The total number of ports on the connection network. - effect_cap
A decimal value representing the line speed in bits
per second. - connect_cost
Cost per connect time. - byte_cost
Cost per byte. - security
Security level of the network. Possible values are: - SEC_NONSECURE
No security. - SEC_PUBLIC_SWITCHED_NETWORK
Data is transmitted over a public switched network. - SEC_UNDERGROUND_CABLE
Data is transmitted over secure underground cable. - SEC_SECURE_CONDUIT
Data is transmitted over a line in a secure conduit
that is not guarded. - SEC_GUARDED_CONDUIT
Data is transmitted over a line in a conduit that
is protected against physical tapping. - SEC_ENCRYPTED
Data is encrypted before transmission over the line. - SEC_GUARDED_RADIATION
Data is transmitted over a line that is protected against
physical and radiation tapping.
- prop_delay
Propagation delay (the time that a signal takes
to travel the length of the link). Specify one of the following
values, according to the type of link: - PROP_DELAY_MINIMUM
Minimum propagation delay. - PROP_DELAY_LAN
Delay is less than .5 microseconds (typical for
a LAN). - PROP_DELAY_TELEPHONE
Delay is in the range .5-50 microseconds
(typical for a telephone network). - PROP_DELAY_PKT_SWITCHED_NET
Delay is in the range 50-250 microseconds
(typical for a packet-switched network). - PROP_DELAY_SATELLITE
Delay is greater than 250 microseconds (typical
for a satellite link). - PROP_DELAY_MAXIMUM
Maximum propagation delay.
- user_def_parm_1 through user_def_parm_3
User-defined parameters that you can use to include other
characteristics not covered by the above parameters. Each of these
parameters has a value in the range 0-255.
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. 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_CN_NAME
The list_options parameter was set to LIST_INCLUSIVE to
list all entries starting from the supplied name, but the value
specified in the fqcn_name parameter was not valid.
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 is a LEN node. This command is valid only
at an end node.
- secondary_rc
(This parameter is not used.)
|
Printable version
