|
|
|
|
The define_cn command defines a connection network (also known as a virtual routing node or VRN). The command provides the network qualified name of the connection network along with its Transmission Group (TG) characteristics. Also provided is a list of the names of the local ports that can access this connection network.
This command can also be used to add new ports to an existing connection network. (Ports can be removed from an existing connection network by issuing delete_cn.)
This command is valid only at a network node or an end node, and not at a LEN node.
Parameter name Type Length Default [define_cn] fqcn_name character 17 description character 32 (null string) effect_cap decimal 3686400 connect_cost decimal 0 byte_cost decimal 0 security constant SEC_NONSECURE prop_delay constant PROP_DELAY_LAN user_def_parm_1 decimal 0 user_def_parm_2 decimal 0 user_def_parm_3 decimal 0 port_name character 8 (null string)
(1-239 port_name entries can be included)
Supplied parameters are:
Fully qualified name of the connection network. Specify 3-17 type-A characters that consist of a 1-8 character network name, followed by a period, and followed by a 1-8 character connection network name.
A text string describing the connection network. SNAP-IX uses this string for information only. It is stored in the node's configuration file and returned on the query_cn command.
A decimal value representing the line speed in bits per second.
Cost per connect time. Valid values are integer values in the range
0-255, where
Cost per byte. Valid values are integer values in the range
0-255, where
Security level of the network. Possible values are:
No security.
Data is transmitted over a public switched network.
Data is transmitted over secure underground cable.
Data is transmitted over a line in a secure conduit that is not guarded.
Data is transmitted over a line in a conduit that is protected against physical tapping.
Data is encrypted before transmission over the line.
Data is transmitted over a line that is protected against physical and radiation tapping.
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:
Minimum propagation delay.
Delay is less than .5 microseconds (typical for a LAN).
Delay is in the range .5-50 microseconds (typical for a telephone network).
Delay is in the range 50-250 microseconds (typical for a packet-switched network).
Delay is greater than 250 microseconds (typical for a satellite link).
Maximum propagation delay.
User-defined parameters, which you can use to include other characteristics not covered by the previous parameters. Each of these parameters must be set to a value in the range 0-255.
Array of port names defined on the connection network. Each port name is an 8-byte string consisting of locally displayable characters that must match the name of a previously-defined port. If the fqcn_name parameter identifies an existing connection network, the new ports are added to it (without changing any ports already defined on the connection network).
No parameters are returned by SNAP-IX when this command executes successfully.
If the command cannot be executed, SNAP-IX 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, SNAP-IX returns the following parameters:
PARAMETER_CHECK
Possible values are:
The security parameter was not set to one of the valid values.
Adding the specified ports would exceed the maximum total number of ports on a CN.
The fqcn_name parameter contained a character that was not valid or was not in the correct format.
One or more of the port names specified did not match the name of a defined port.
One or more of the specified ports cannot be on a CN because its DLC type is a point-to-point type (such as SDLC) rather than a network type.
If the command does not execute because of a state error, SNAP-IX returns the following parameters:
STATE_CHECK
The port specified by the port_name parameter cannot be modified because it is currently active.
If the command does not execute because the node's configuration does not support it, SNAP-IX returns the following parameters:
The local node is a LEN node. This command is valid only at a network node or an end node.
(This parameter is not used.)
Common Return Codes from snaadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.
|
|
|
 |
|