DECnet-Plus
Network Control Language Reference

Arguments:

discard reason Reason why the PDU was discarded.

destination address unknown The destination address is unknown.

destination address unreachable The destination address is currently unreachable.

duplicate option An optional PDU field occurs twice.

header syntax error There is a format error in the PDU header.

incomplete pdu received The received data did not contain a complete PDU.

incorrect checksum The checksum is incorrect.

lifetime expired during reassembly The PDU's lifetime expired while it was being reassembled.

lifetime expired while data unit in transit The PDU's lifetime expired while it was in transit.

pdu discarded due to congestion No buffers were available to forward the packet.

protocol procedure error Unable to translate a DECnet Phase V format PDU into a Phase IV format PDU.

reason not specified No further information available.

reassembly interference Insufficient memory available to reassemble a PDU.

segmentation required, but not permitted The PDU requires fragmentation, but the originator did not permit this.

unsupported option not specified The PDU contained an unrecognized and unsupported PDU option.

unsupported protocol version The PDU version is not supported.

unsupported recording of route option The sender requested an unsupported form of route recording.

unsupported source routing option The sender requested an unsupported form of source routing.

forwarding address Destination NSAP address.

phaseiv forwarding address Phase IV destination address of the Phase IV data packet.

phaseiv source address Phase IV source address of the Phase IV data packet.

receiving adjacency Name of the adjacency on which the PDU was received. For an end node, only the circuit may be specified.

source address Source NSAP address of the data NPDU.

aged ip packet discard

Support: IP

Generated when an IP packet is discarded because the interval specified in its time to live field has expired.

aged pdu discard

Support: L1,L2

Generated when a data PDU is discarded because its lifetime has expired.

Arguments:

discard reason Reason why the PDU was discarded: See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values can be generated by this event.)

phaseiv pdu header Phase IV header of the Phase IV packet causing this event.

pdu header Contents of the header of the data PDU that was discarded.

attempt to exceed maximum sequence number

Support: L1,L2

Generated when an attempt is made to increase the sequence number of a link state packet beyond the maximum allowed sequence number.

corrupted lsp detected

Support: L1,L2

Generated when a corrupted link state packet is detected in memory.

egp message discard

Support: All

Generated when EGP message is discarded.

ip address unreachable packet discard

Support: IP

Generated when an IP packet is discarded because its destination is unreachable.

Arguments:

forwarding IP address IP address on which the forwarding decision for the IP packet was taken. This is usually the destination IP address.

icmp discard reason Value of the code field of the corresponding ICMP destination unreachable message.

Host unreachable

Network unreachable

Source route failed

LAN address Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

source ip address Source IP address of the IP packet.

ip destination address packet error discard

Support: IP

Generated when an IP packet is discarded because the destination IP address is invalid (that is, it has an invalid format, or it refers to an unsupported network class).

Arguments:

destination ip address Destination IP address in the IP packet.

LAN address Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

source ip address Source IP address of the IP packet.

ip packet discard

Support: IP

Generated when an IP packet is discarded because of version number mismatch or bad checksum.

Arguments:

ip discard reason Reason why the IP packet was discarded. See the ip discard reason argument of the IP Packet Format Error event.

ip header IP header of the PDU that caused the event.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

ip packet format error

Support: IP

Generated when an IP packet is discarded because it contains a format error.

Arguments:

ip discard reason Reason why the IP packet was discarded:

duplicate option

header syntax error

incomplete packet received

incorrect checksum

incorrect header length

incorrect total length

option error

protocol procedure error

reason not specified

received via broadcast

unsupported option not specified

unsupported protocol version

unsupported security option

ip header IP header of the PDU that caused the event.

LAN address Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.

pointer Offset of the octet in the IP header that caused the format error.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

ip protocol unreachable packet discard

Support: IP

Generated when an IP packet is discarded because there was no port on the local system for the protocol type specified in the IP header.

Arguments:

destination protocol Value of the protocol field in the IP packet.

icmp discard reason Value of the code field of the corresponding ICMP destination unreachable message.

Port Unreachable

Protocol Unreachable

LAN address Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the Receiving Entity argument identifies a broadcast circuit entity.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

source ip address Source IP address of the IP packet.

ip source address packet error discard

Support: IP

Generated when an IP packet is discarded because the source IP address is invalid (that is, it has an invalid format, or it refers to an unsupported network class).

Arguments:

destination ip address Destination IP address in the IP packet.

LAN address Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the Receiving Entity argument identifies a broadcast circuit entity.

receiving entity Local name of the circuit entity corresponding to the previous hop for the packet.

source ip address Source IP address of the IP packet.

lsp L1 database overload

Support: L1,L2

Generated when the status attribute L1 state changes from on to waiting, or vice versa.

Arguments:

source id Source ID of the link state packet.

state change Current state.

recovered Router operating normally.

waiting Router has failed to store a link state packet, and is operating in restricted mode.

lsp L2 database overload

Support: L2

Generated when the status attribute L2 state changes from on to waiting, or vice versa.

Arguments:

source id Source ID of the link state packet.

state change Current state.

recovered Router is operating normally.

waiting Router has failed to store a link state packet, and is operating in restricted mode.

manual address dropped from area

Support: L1,L2

Generated when one of the addresses in the manual area addresses set is ignored when computing an area address. The event is generated once for each address that is dropped.

Argument:

area address Area address that caused the maximum number of area addresses to be exceeded.

own lsp purged

Support: L1,L2

Generated when a zero-aged copy of a node's own link state packet is received from some other node. This represents an invalid attempt to purge the local node's link state packet.

pdu format error

Support: All

Generated when a data PDU is discarded because of a format error.

Arguments:

discard reason Reason why the PDU was in error. See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values are generated by this event.)

pdu header Contents of the header of the data PDU that was discarded.

phaseiv pdu header Phase IV header of the Phase IV packet causing this event.

receiving adjacency Name of the adjacency on which the PDU was received. For an end node on a LAN, only the circuit may be specified for Digital UNIX.

phaseiv translation failure

Support: All

Generated when a PDU is discarded because it cannot be translated to Phase IV format.

Arguments:

pdu header Data PDU header causing the event.

receiving adjacency Local entity name of the adjacency upon which the PDU was received. For an end node on a LAN, only the circuit may be specified for Digital UNIX.

sequence number skipped

Support: L1,L2

Generated when the sequence number of a link state packet is incremented by more than 1. This usually occurs when a router is reenabled while its previous link state packets are still stored in the network.

unsupported option

Generated when a data packet is received that contains an unsupported option in its header.

Arguments:

discard reason Reason why the event was generated. See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values are generated by this event.)

pdu header Contents of the header of the data PDU that caused the event.

receiving adjacency Name of the adjacency on which the PDU was received. For an end node on a LAN, only the circuit may be specified.

21.2.7 Exception Messages

For create:

already exists
A routing entity already exists.
invalid router type
The type argument specifies an invalid router type on the create command.
For delete:
wrong state
Routing module cannot be deleted when it is enabled.
has children
Cannot delete while subentities exist.
For ping:
ip not enabled
IP routing is not enabled on this system.

21.3 routing circuit

A routing circuit entity represents a data link to another node. The circuit-name refers the circuit managed by this command.
add [node node-id] routing circuit circuit-name manual routers [set]
create [node node-id] routing circuit circuit-name type circuit-type
delete [node node-id] routing circuit circuit-name
disable [node node-id] routing circuit circuit-name
enable [node node-id] routing circuit circuit-name
remove [node node-id] routing circuit circuit-name manual routers [set]
set [node node-id] routing circuit circuit-name {data link entity local-entity-name | dna neighbor boolean | enable phaseiv address boolean | explicit receive verification boolean | hello timer integer | idle timer integer | inactive area address [set] | initial minimum timer integer | isis hello timer integer | L1 cost integer | L1 router priority integer | L2 cost integer | L2 router priority integer | manual data link sdu size integer | manual L2only mode boolean | manual routers [set] | maximum call attempts integer | maximum svc adjacencies integer | originating queue limit integer | recall timer integer | receive verifier hex-string | reserved adjacency boolean | reserve timer integer | template template-id | transmit verifier hex-string | x.25 filters [set] }
show [node node-id] routing circuit circuit-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

21.3.1 Arguments

type circuit-type
Type of circuit applicable to create only. For infomation on the available circuit types, see the type characteristic attribute description in the Characteristic Attributes section.

21.3.2 Characteristic Attributes

alternative subnet addresses

Support: L1,L2,IP

Default: No addresses Value: Set of subnet-address

A set of alternative IP addresses and subnet masks for this interface. You can modify this characteristic only when the entity is disabled.
arp holding time

Support: IP

Default: 600 Value: 30--65535

Number of seconds to hold on to a routing circuit ip address translation entity. This characteristic is supported only if the circuit's type characteristic is csma-cd.
arp response waiting time

Support: IP

Default: 3 Value: 1--10

Number of seconds to wait for an ARP response when an ARP request has been sent. This characteristic is supported only if the circuit's type characteristic is csma-cd.
authentication type

Support: L1,L2,IP

Default: None Value: None or simple

Type of authentication to be used for LAN L1 Hellos, LAN L2 Hellos, or PtPt Hellos on this circuit.
data link entity

Support: All

Default: No data link name Value: Local-entity-name

Name of the entity within the Data Link module to be created when a port is opened for that data link type. You can modify this characteristic only when the entity is disabled. This attribute is supported for all types of circuits; however, for X.25 circuits set the attribute to x25 access.
directed broadcast

Support: L1,IP

Default: On Value: Off or On

Specifies how an IP packet is to be forwarded on a broadcast link.

off Discard the packet silently.

on Broadcast the packet using data level link broa that either of the following conditions is true:

The packet's subnet address matches the value of the subnet address characteristic.
The packet's subnet address matches one of the values of the alternative subnet addresses characteristic.

This characteristic is supported only if the characteristic type is set to csma-cd.
dna neighbor

Support: L1,L2

Default: True Value: True or false

If true, specifies that the neighbor is expected to be DNA compliant, and so proprietary mechanisms are possible. If false, no router-to-router Hellos or link state packets (LSPs) will be sent over this circuit. This characteristic is supported only if the characteristic type is not x25 da. You can modify this characteristic only when the entity is disabled.
enable phaseiv address

Support: All

Default: True Value: True or false

Specifies whether the physical LAN address is to be set to the Phase IV style LAN address (that is, AA-00-04-00-xx-xx). The LAN address is set only if this attribute is true and the value of the phaseiv address characteristic is not 0.0. If phaseiv address is not 0.0 and there are multiple adaptors to the same LAN, only one circuit may have this attribute set to true. This characteristic is supported only if the characteristic type is set to csma-cd.
explicit receive verification

Support: All

Default: True Value: True or false

Type of password verification performed at circuit initialization. If true, the received verifier is checked against the value of the characteristic receive verifier for this circuit, if any. If false, the received verifier is checked against the set of verifiers specified in the routing permitted neighbor entities. This attribute is supported only if the characteristic type is set to ddcmp, hdlc, x25 static incoming, x25 static outgoing, and x25 permanent.
hello timer

Support: L1,L2

Default: 10 Value: 1--32767

Interval, in seconds, between IS Hello messages.
idle timer

Support: All

Default: 30 Value: 1--65535

Number of seconds of idle time before a call is cleared. This attribute is supported only if the characteristic type is x25 da.
inactive area address

Support: All

Default: No area address Value: Set of area addresses

Area address associated with the use of the inactive subnet of ISO 8473. Maximum area address that may be present is 1. This characterisitic is supported only if the characteristic type is set to csma-cd.
initial minimum timer

Support: All

Default: 55 Value: 1--65535

Period, in seconds, for which an X.25 call remains connected after being established, irrespective of traffic. This should be set small enough that the call is cleared before the start of the next charging interval. This attribute is supported only if the characteristic type is x25 da.
isis hello timer

Support: L1,L2

Default: 3 Value: 1--32767

Interval, in seconds, between LAN level 1 and level 2 router-to-router Hello messages. This value is also used as the interval between IS Hello messages when polling the ES configuration.
L1 cost

Support: L1,L2

Default: 20 Value: 1--63

Cost of this circuit for level 1 traffic.
L1 router priority

Support: L1,L2

Default: 64 Value: 1--127

Priority for becoming LAN level 1 designated router. This attribute is supported only if the circuit's characteristic type is csma-cd.
L2 cost

Support: L2

Default: 20 Value: 1--63

Cost of this circuit for level 2 traffic.
L2 router priority

Support: L2

Default: 64 Value: 1--127

Priority for becoming LAN level 2 designated router. This attribute is supported only if the circuit's characteristic type is csma-cd.
manual data link sdu size

Support: All

Default: 1492 Value: 128--65535

Preferred maximum data link block size, in octets. You can modify this characteristic only when the entity is disabled. If the characteristic type is csma-cd, this characteristic is a read-only attribute whose value is fixed at 1492. If the characteristic type is fddi, this characteristic is a read-only attribute whose value is fixed at 4352.
manual data link sdu size for ip

Support: IP

Default: See description Value: 128--65535

Preferred maximum DSDU size, in octets, for the transmission of IP packets. The DSDU size includes the size of the packet containing the IP header. On point-to-point HDLC links, the DSDU size also includes the 1-octet link encapsulation (that is, the maximum IP packet size is the value of this attribute minus 1). The default value depends on the circuit type, as follows:

CSMA-CD 1500

DDCMP 1500

HDLC 1500

X.25 (all types) 576

Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
  NCL_PROFILE_022.HTML
  OSSG Documentation
   2-DEC-1996 12:48:28.40
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal

discard reason	Reason why the PDU was discarded.
	destination address unknown	The destination address is unknown.
	destination address unreachable	The destination address is currently unreachable.
	duplicate option	An optional PDU field occurs twice.
	header syntax error	There is a format error in the PDU header.
	incomplete pdu received	The received data did not contain a complete PDU.
	incorrect checksum	The checksum is incorrect.
	lifetime expired during reassembly	The PDU's lifetime expired while it was being reassembled.
	lifetime expired while data unit in transit	The PDU's lifetime expired while it was in transit.
	pdu discarded due to congestion	No buffers were available to forward the packet.
	protocol procedure error	Unable to translate a DECnet Phase V format PDU into a Phase IV format PDU.
	reason not specified	No further information available.
	reassembly interference	Insufficient memory available to reassemble a PDU.
	segmentation required, but not permitted	The PDU requires fragmentation, but the originator did not permit this.
	unsupported option not specified	The PDU contained an unrecognized and unsupported PDU option.
	unsupported protocol version	The PDU version is not supported.
	unsupported recording of route option	The sender requested an unsupported form of route recording.
	unsupported source routing option	The sender requested an unsupported form of source routing.
forwarding address	Destination NSAP address.
phaseiv forwarding address	Phase IV destination address of the Phase IV data packet.
phaseiv source address	Phase IV source address of the Phase IV data packet.
receiving adjacency	Name of the adjacency on which the PDU was received. For an end node, only the circuit may be specified.
source address	Source NSAP address of the data NPDU.

discard reason	Reason why the PDU was discarded: See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values can be generated by this event.)
phaseiv pdu header	Phase IV header of the Phase IV packet causing this event.
pdu header	Contents of the header of the data PDU that was discarded.

forwarding IP address	IP address on which the forwarding decision for the IP packet was taken. This is usually the destination IP address.
icmp discard reason	Value of the code field of the corresponding ICMP destination unreachable message.
	Host unreachable
	Network unreachable
	Source route failed
LAN address	Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.
receiving entity	Local name of the circuit entity corresponding to the previous hop for the packet.
source ip address	Source IP address of the IP packet.

destination ip address	Destination IP address in the IP packet.
LAN address	Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.
receiving entity	Local name of the circuit entity corresponding to the previous hop for the packet.
source ip address	Source IP address of the IP packet.

ip discard reason	Reason why the IP packet was discarded. See the ip discard reason argument of the IP Packet Format Error event.
ip header	IP header of the PDU that caused the event.
receiving entity	Local name of the circuit entity corresponding to the previous hop for the packet.

ip discard reason	Reason why the IP packet was discarded:
	duplicate option
	header syntax error
	incomplete packet received
	incorrect checksum
	incorrect header length
	incorrect total length
	option error
	protocol procedure error
	reason not specified
	received via broadcast
	unsupported option not specified
	unsupported protocol version
	unsupported security option
ip header	IP header of the PDU that caused the event.
LAN address	Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the receiving entity argument identifies a broadcast circuit entity.
pointer	Offset of the octet in the IP header that caused the format error.
receiving entity	Local name of the circuit entity corresponding to the previous hop for the packet.

destination protocol	Value of the protocol field in the IP packet.
icmp discard reason	Value of the code field of the corresponding ICMP destination unreachable message.
	Port Unreachable
	Protocol Unreachable
LAN address	Data link address of the broadcast circuit that is the previous hop for the packet. This argument is present only if the Receiving Entity argument identifies a broadcast circuit entity.
receiving entity	Local name of the circuit entity corresponding to the previous hop for the packet.
source ip address	Source IP address of the IP packet.

source id	Source ID of the link state packet.
state change	Current state.
	recovered	Router operating normally.
	waiting	Router has failed to store a link state packet, and is operating in restricted mode.

discard reason	Reason why the PDU was in error. See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values are generated by this event.)
pdu header	Contents of the header of the data PDU that was discarded.
phaseiv pdu header	Phase IV header of the Phase IV packet causing this event.
receiving adjacency	Name of the adjacency on which the PDU was received. For an end node on a LAN, only the circuit may be specified for Digital UNIX.

pdu header	Data PDU header causing the event.
receiving adjacency	Local entity name of the adjacency upon which the PDU was received. For an end node on a LAN, only the circuit may be specified for Digital UNIX.

discard reason	Reason why the event was generated. See possible reasons described under the discard reason argument of the address unreachable pdu discard event. (Not all of these argument values are generated by this event.)
pdu header	Contents of the header of the data PDU that caused the event.
receiving adjacency	Name of the adjacency on which the PDU was received. For an end node on a LAN, only the circuit may be specified.

Support: L1,L2,IP
Default: No addresses	Value: Set of subnet-address

Support: L1,L2,IP
Default: None	Value: None or simple

Support: All
Default: No data link name	Value: Local-entity-name

off	Discard the packet silently.
on	Broadcast the packet using data level link broa that either of the following conditions is true: The packet's subnet address matches the value of the subnet address characteristic. The packet's subnet address matches one of the values of the alternative subnet addresses characteristic.

Support: All
Default: No area address	Value: Set of area addresses

Support: IP
Default: See description	Value: 128--65535

DECnet-PlusNetwork Control Language Reference

aged ip packet discard

aged pdu discard

attempt to exceed maximum sequence number

corrupted lsp detected

egp message discard

ip address unreachable packet discard

ip destination address packet error discard

ip packet discard

ip packet format error

ip protocol unreachable packet discard

ip source address packet error discard

lsp L1 database overload

lsp L2 database overload

manual address dropped from area

own lsp purged

pdu format error

phaseiv translation failure

sequence number skipped

unsupported option

21.2.7 Exception Messages

already exists

invalid router type

wrong state

has children

ip not enabled

21.3 routing circuit

21.3.1 Arguments

type circuit-type

21.3.2 Characteristic Attributes

alternative subnet addresses

arp holding time

arp response waiting time

authentication type

data link entity

directed broadcast

dna neighbor

enable phaseiv address

explicit receive verification

hello timer

idle timer

inactive area address

initial minimum timer

isis hello timer

L1 cost

L1 router priority

L2 cost

L2 router priority

manual data link sdu size

manual data link sdu size for ip

DECnet-Plus
Network Control Language Reference