[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference


Previous | Contents

Arguments:
adjacency name The name of the adjacency to which the event refers.
adjacent node Node IDs of the adjacent node.
new adjacency state Current state of the adjacency.
down Adjacency state is now down.
up Adjacency state is now up.
reason Reason why the adjacency state changed to down.
address out of range The adjacency address is invalid.
area mismatch The adjacent node's area address is incorrect.
call rejected An X.25 call to the adjacent node failed.
checksum error A PDU's checksum was invalid.
circuit disabled The circuit has been disabled by network management.
configuration fault The adjacency has been configured incorrectly.
datalink failure Exceeded maximum call attempts; configuration fault.
exceeded maximum call attempts The value of the characteristic maximum call attempts has been exceeded.
holding timer expired No Hello traffic has been received during the period of the Hello timer.
maximum broadcast end nodes exceeded There are more adjacent nodes than can be supported on a LAN.
maximum broadcast routers exceeded There are more adjacent nodes than can be supported on a LAN.
neighbor node change The address(es) in the hello has/have changed.
one way connectivity The connectivity between two LAN routers appears to permit traffic in one direction only.
reserve timer expired This may occur temporarily during a change of designated router. Repeated occurrences indicate a configuration or hardware error.
version skew The adjacent node is the wrong version.
wrong node type The adjacent routing node is of the wrong type.

authentication failure

Support: L1,L2,IP
Generated when a PDU is received that contains an Authentication Information field that is incompatible with the PDU type.

Arguments:
adjacent node Node ID of the adjacent node.
authentication level Authentication level of the PDU: area, circuit, domain.
pdu type Type of the PDU.
L1 LSP L2 PSNP
L1 CSNP LAN L1 Hello
L1 PSNP LAN L2 Hello
L2 LSP PtPt Hello
L2 CSNP

circuit change

Support: All
Generated when the status attribute state of the circuit changes from off to on, or vice versa.

Argument:
disable reason The reason that the circuit status changed from on to off. If the disable occurred because of a management circuit disable action, the reason is a management action (1). If the disable occurs for any other reason, it is a protocol action (0).
new circuit state Current state of the circuit.
off Circuit state is now off.
on Circuit state is now on.

corrupted hello pdus received

Support: All
Generated when an ES-IS (end system to intermediate system) or IS-IS (intermediate system to intermediate system) Hello PDU is received that either cannot be parsed or contains an incorrect checksum.

corrupted lsp received

Support: L1,L2
Generated when a corrupted link state packet is received.

Argument:
adjacent node Node IDs of adjacent nodes.

corrupted phaseiv routing packet received

Support: L1,L2
Generated when a corrupted Phase IV routing packet is received.

Argument:
phaseiv id Phase IV ID of the Phase IV routing message that caused the event to be generated.

da adjacency change

Support: All
Generated when the state of a DA adjacency on the circuit changes from up to down or from down to up. For these purposes, the states up and up/dormant are considered up and any other state is considered down. This attribute is supported only if the circuit type is x25 da.

Arguments:
adjacency name Name of the adjacency to which the event refers.
new adjacency state Current state of the adjacency.
down Adjacency state is now down.
up Adjacency state is now up.
reason Reason why the adjacency state changed to down.

exceeded maximum svc adjacencies

Support: End,L2 (DA circuits only)
Generated when there is no free adjacency on which to extablish an SVC for a new destination.

id reachability change

Support: All
Generated when an ID is added to or removed from the endnodeID status of an adjacency on this circuit. For end nodes, this event is generated for point-to-point links only.

Arguments:
adjacency name Name of the adjacency to which the event refers.
adjacent node Node IDs of the adjacent node.
reason Reason why the adjacency state changed to down.

initialization failure

Support: All
Generated when an attempt to initialize with an adjacent node fails, either because of version skew or area mismatch.

Arguments:
adjacent node Node IDs of adjacent nodes.
reason Reason why the event was generated. See possible reasons described under the adjacency state change event.

ip adjacency state change

Support: IP
Generated when the status attribute state of a routing circuit ip adjacency entity belonging to this circuit changes from up (or up/dormant) to some other value, or the reverse.

Arguments:
neighbor IP address IP address of the neighbor.
new IP adjacency state New state of the IP adjacency.
up Either up or up/dormant
down Any other state
reason Reason for the state change.

ip fragmentation failure

Support: IP
Generated when an IP packet that requires fragmentation in order to be transmitted has an IP header that requests "do not fragment".

Arguments:
destination IP address Destination IP address of the IP packet.
source IP address Source IP address of the IP packet.

irrecoverable svc failure

Support: All
Generated when recall count becomes equal to maximum call attempts. This attribute is supported only if the circuit type is x25 static outgoing.
reason Reason why the adjacency state changed to down.

LAN L1 designated router change

Support: L1,L2
Generated when the local node either elects itself or resigns as the LAN level 1 designated router on this circuit.

Argument:
designated router change New state of the designated router.
elected Router state is now elected.
resigned Router state is now resigned.

LAN L2 designated router change

Support: L2
Generated when the local node either elects itself or resigns as the LAN level 2 designated router on this circuit.

Argument:
designated router change New state of the designated router.
elected Router state is now elected.
resigned Router state is now resigned.

LAN phaseiv designated router change

Support: L1,L2
Generated when the local node either elects itself or resigns as the LAN Phase IV designated router on this circuit.

Argument:
designated router change New state of the designated router.
elected Router state is now elected.
resigned Router state is now resigned.

redirect discard

Support: End
Generated when a Redirect packet is discarded because of insufficient cache space.

rejected adjacency

Support: All
Generated when an attempt to create a new adjacency fails because of insufficient resources.

Arguments:
adjacent node Node IDs of adjacent nodes.
reason Reason for the failure. See possible reasons described under the adjacency state change event.

rejected ip adjacency

Support: IP
Generated when an attempt to automatically create an IP adjacency to an IP router fails because of lack of resources.

Arguments:
neighbor IP address IP address of the neighbor.
reason Reason why the attempt failed. See the description of the Reason argument of the IP Adjacency State Change event.

rip error received

Support: L2,IP
Generated when any kind of error is detected in a received RIP packet. This event is generated only if the routing entity's characteristic routing protocols supported includes the value RIP.

Arguments:
neighbor IP address IP address of the neighbor.
RIP reason Type of error that was detected in the RIP packet.
format error
version skew
RIP version RIP version number of the RIP packet. This argument is present only if the RIP reason is version skew.

verification reject

Generated when a verification attempt fails.

21.3.7 Exception Messages

For create:

invalid circuit type

The specified circuit type is invalid.

Argument:
reason Reason why the circuit type is invalid.
1 A dynamically allocated X.25 circuit type is not permitted for a level 1 router.

maximum circuits exceeded

An attempt has been made to create more than the maximum number of circuits allowed.

For enable:

enable mac address failed

The attempt to enable the MAC address failed on a broadcast circuit with a nonzero Phase IV address.

no such data link

Data link specified for this circuit does not exist.

open port failed

A port cannot be opened on the specified data link.

open rip port failed

The UDP port for RIP (port 520) could not be created.

routing not enabled

The Routing module is not in the on state.

subnet address not unique

One of the subnet addresses for this circuit is the same as the subnet address for another circuit.

21.4 routing circuit adjacency

A routing circuit adjacency entity describes an adjacency, which is a neighboring node that is accessible through a particular circuit. The circuit-name refers to the circuit associated with the specified adjacency. The adjacency-name refers to the adjacency managed by this command.

The create and delete commands are allowed only if circuit is csma-cd and type is L1router or L2router. In addition, the delete command is allowed on end systems only for x25 da circuit adjacencies.
create [node node-id] routing circuit circuit-name adjacency adjacency-name {data format string | endnode ids set | LAN address lan-address }
delete [node node-id] routing circuit circuit-name adjacency adjacency-name
show [node node-id] routing circuit circuit-name adjacency adjacency-name [all [attributes] | all identifiers | all status ]

21.4.1 Arguments

data format string

Format of the reachable address. This argument is optional.

endnode ids set

Set of source system IDs. This argument is mandatory.

LAN address lan-address

Data link address from which the adjacency receives end system hellos. This argument is mandatory.

21.4.2 Identifier Attributes

name

Simple name assigned to the adjacency when it is created.

21.4.3 Status Attributes

data link port

Support: All
Name of the data link port used for this X.25 data adjacency. This attribute is supported only if the owning routing circuit entity's characteristic type is set to x25 da.

dte address

Support: All
DTE address of the neighboring node on an X.25 circuit. This status is supported only if the owning circuit entity's characteristic type is x25 da.

endnode ids

Support: All
System IDs of neighboring end nodes. This attribute is supported only if the node is an end node and the owning circuit entity's characteristic type is not x25 da.

endnode nets

Support: All
NETs computed from the system IDs in the endnode ids status and the set of area addresses in the owning routing entity's manual area addresses set. This attribute is supported only if the node is an end node and the owning circuit entity's characteristic type is not x25 da.

holding timer

Support: L1,L2
Holding time for this adjacency, updated from the router-to-router Hello messages. This attribute is supported only if both the node and the adjacency are routers.

ip addresses

Support: IP
IP addresses of the neighbor node. If these are not known, the set is empty.

lan address

Data link address of the neighboring node on a broadcast circuit. This status is supported only if the owning circuit entity's characteristic type is csma-cd.

LAN priority

Support: L1,L2
Priority of the neighbor of this adjacency for becoming the LAN level 1 designated router (if the adjacency is a DECnet-Plus level 1 router) or the LAN level 2 designated router (if the adjacency is a DECnet-Plus level 2 router).

This status is supported only if the owning circuit entity's characteristic type is csma-cd; and the adjacency is a router rather than an end node.

level

Support: L1,L2
The level of the adjacency. This attribute is supported only if both the node and the adjacency are routers.
Level 1 The adjacency is used for level 1 routing.
Level 2 The adjacency is used for level 2 routing.
Level 1 & 2 The adjacency is used for level 1 and level 2 routing.
Level 0 (undefined) The usage is undefined.

neighbor areas

Support: L1,L2
Area addresses of the neighboring node. This attribute is supported only if both the node and the adjacency are routers and the owning circuit entity's characteristic type is not x25 da.

neighbor node id

Support: L1,L2
Node ID of the neighboring node.

neighbor node type

Support: All
Type of the neighboring node. This status is supported only if the owning circuit entity's characteristic type is not x25 da.
DECnet Phase V endnode The node is a DECnet-Plus end node.
DECnet Phase V level 1 router The node is a DECnet Phase V level 1 router.
DECnet Phase V level 2 router The node is a DECnet Phase V level 2 router.
DECnet Phase V router The node is a DECnet Phase V router.
non-dna router The node is not a DNA router.
phaseiv endnode The node is a Phase IV end node.
phaseiv level 1 router The node is a Phase IV level 1 router.
phaseiv level 2 router The node is a Phase IV level 2 router.
phaseiv router The node is a Phase IV router.
unknown The node type is unknown.

neighbor protocols supported

Support: IP
Network protocols supported by the neighboring node (either IP or ISO-8473).

router nets

Support: End
Network Entity Title(s) (NETs) of a neighboring router. This status is supported only if the adjacency is a level 1 or level 2 router, and the owning circuit entity's characteristic type is not x25 da.

state

Support: All
State of the routing circuit adjacency entity. May be one of the following:
failed
initializing
up
up/dormant

type

Type of adjacency.
autoconfigured Created by autoconfiguration.
manual Created manually by a create command.

This attribute indicates whether the adjacency has been manually created, or whether the adjacency was created by means of Hello PDUs. It will always have the value manual when it has been created by the create command; otherwise, it will have the value autoconfigured.

21.4.4 Exception Messages

For create:

invalid lan address

The specified LAN address is invalid.

non broadcast circuit

Manual adjacencies can be treated only on broadcast circuits.

reserved identifier

You have attempted to create a manual adjacency with an identifier that is reserved for automatic adjacencies.

For delete:

deletion not permitted

An attempt has been made to delete an automatic adjacency, or an adjacency on a circuit that is not a dynamically assigned X.25 circuit.

21.5 routing circuit ip address translation

A routing circuit ip address translation entity describes the mapping between the IP address of an IP adjacency on a broadcast circuit and its LAN address. This entity is supported only on systems that support dual routing. All ip address translation entities are created automatically, but can be deleted manually.
delete [node node-id] routing circuit circuit-name ip address translation ip-address
show [node node-id] routing circuit circuit-name ip address translation ip-address [all [attributes] | all identifiers | all status ]

21.5.1 Identifier Attributes

ip address

IP address of the neighbor.

21.5.2 Status Attributes

LAN address

Support: IP
LAN address that corresponds to the IP address of this neighbor.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  NCL_PROFILE_024.HTML
  OSSG Documentation
   2-DEC-1996 12:48:33.95

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal