[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference

Previous | Contents

You can modify this characteristic only when the entity is disabled.

manual L2only mode

Support: L2
Default: False Value: True or false
If true, specifies that this circuit is to be used only for level 2 traffic. If false, the circuit may be used for both level 1 and level 2 traffic. You can modify this characteristic only when the entity is disabled.

manual routers

Support: End
Default: No router IDs Value: Set of LAN addresses
Manually entered IDs of routers. If this set is empty, the circuit will auto-configure the routers. This characteristic is supported only if the circuit's characteristic type is csma-cd. For Digital UNIX, a maximum of five routers can be in the set.

maximum arp retries

Support: IP
Default: 3 Value: 1--10
Maximum number of times an ARP request can be sent for the same IP address. This characteristic is supported only if the circuit's characteristic type is set to csma-cd.

maximum call attempts

Support: All
Default: 10 Value: 0--255
Maximum number of successive X.25 call failures before the circuit is regarded as being halted. A value of zero means that there is no limit to the number of retries.

This attribute is supported only if the characteristic type is set to x25 static outgoing. You can modify this characteristic only when the entity is disabled. Also, you can only increase the characteristic value.

maximum svc adjacencies

Support: All
Default: 1 Value: 1--65535
Number of routing circuit adjacency entities to reserve for switched virtual circuits (SVCs) on this circuit. This is effectively the maximum number of simultaneous calls possible on this circuit. This attribute is supported only if the characteristic type is x25 da.

originating queue limit

Support: L1,L2
Default: 2 Value: 1--50
Maximum number of data PDUs originated by this node that can be on this circuit's transmit queue. This should be set to the minimum number required to keep the data link from idling. You can modify this characteristic to a higher value when the entity is disabled; you can never modify it to a lower value.

recall timer

Support: All
Default: 60 Value: 0--65535
Interval, in seconds, that must elapse between a call failure and a recall. This attribute is supported only if the characteristic type is set to x25 static outgoing, x25 da, hdlc, or ddcmp.

receive passwords

Support: L1,L2,IP
Default: No passwords Value: Set of hex-string
Set of passwords that are valid in received LAN L1 Hellos, LAN L2 Hellos, and PtPt Hellos when simple authentication is in use on this circuit. You cannot use the show command to display the value of this attribute.

receive verifier

Support: All
Default: No verifier Value: Hex string, length 0--38
Value against which a neighbor node's received verifier is to be checked. If no verifier is specified, no verification is performed. This attribute is supported only if the characteristic type is ddcmp, hdlc, x25 static incoming, x25 static outgoing, or x25 permanent. You cannot display this characteristic.

reserve timer

Support: All
Default: 600 Value: 1--65535
Interval, in seconds, during which the SVC remains reserved for the previous DTE address after a call is cleared due to lack of traffic. This attribute is supported only if the characteristic type is x25 da.

reserved adjacency

Support: End
Default: False Value: True or false
If true, specifies that one SVC must be reserved for connection to a router. If false, no SVC needs to be reserved for this purpose. This characteristic is supported only if the circuit's characteristic type is x25 da. You can modify this characteristic only when the entity is disabled.

rip generated default route

Support: L1,L2,IP
Default: False Value: True or false
If true, this specifies that the default route is announced in RIP messages sent on this circuit, with the metric value specified in the RIP generated default route metric characteristic. If false, the default route is not generated.

rip generated default route metric

Support: L1,L2,IP
Default: 1 Value: 0--16
The metric to be used when announcing a generated default route through RIP on this circuit.

rip neighbors

Support: L2,IP
Default: No addresses Value: Set of IP addresses
IP addresses of neighboring systems with which RIP will be exchanged on this circuit.

If the circuit is a point-to-point circuit, this set must contain a single IP address if the rip state characteristic is to be set to send and receive. Also, you must disable the entity before altering this characteristic.

If the rip send type characteristic is set to broadcast, only RIP messages from addresses specified in this set will be received; other messages will be silently discarded.

This characteristic is supported only if the routing protocols supported characteristic of the routing entity includes the RIP routing protocol.

rip poisoned reverse

Support: L2,IP
Default: True Value: True or false
Specifies whether poisoned reverse routes are to be sent in RIP messages on this circuit. If false, poisoned reverse routes are not sent.

This characteristic is supported only if the routing protocols supported characteristic of the routing entity includes the RIP routing protocol.

rip receive default route

Support: L2,IP
Default: True Value: True or false
Specifies whether the default route is accepted from RIP messages on this circuit. If false, the default route from RIP messages on this circuit is discarded.

This characteristic is supported only if the routing protocols supported characteristic of the routing entity includes the RIP routing protocol.

rip send type

Support: L2,IP
Default: Broadcast Value: Broadcast or point-to-point
Specifies how RIP messages are sent on this circuit.
broadcast RIP messages are sent by means of data link broadcast.
point-to-point RIP messages are sent directly to each IP address specified in the rip neighbors characteristic.

This characteristic is supported only if the routing protocols supported characteristic of the routing entity includes the RIP routing protocol and if the circuit's type characteristic is csma-cd.

rip state

Support: L2,IP
Default: Off Value: See description
Specifies how RIP messages are treated on this circuit.
off RIP messages cannot be sent or received on this circuit.
receive RIP messages can be received but not sent on this circuit.
send and receive RIP messages can be sent and received on this circuit.

This characteristic is supported only if the routing protocols supported characteristic of the routing entity includes the RIP routing protocol.

send password

Support: L1,L2,IP
Default: No password Value: Hex-string
Password to be sent in LAN L1 Hellos, LAN L2 Hellos, and PtPt Hellos when simple authentication is used on this circuit. You cannot use the show command to display the value of this attribute.

subnet address

Support: IP
Default: 0.0.0.0 Value: Subnet address
IP address and subnet mask of this interface. You can modify this characteristic only when the entity is disabled.

template

Support: All
Default: No template name Value: Template-id
Name of the template to be used when a port is opened for this data link type. If no template name is specified, no template is used. You can modify this characteristic only when the entity is disabled.

transmit verifier

Support: All
Default: No verifier Value: Hex-string, length 0--38
Value to be transmitted for verifying the identity of this node. If no verifier is specified, no verifier is transmitted. This characteristic is supported only if the characteristic type is ddcmp, hdlc, x25 static outgoing, x25 static incoming, or x25 permanent. You cannot display this characteristic.

type

Support: All
Type of circuit. You cannot modify this characteristic. This characteristic is set by means of an argument to the create command.
csma-cd The circuit is a broadcast circuit.
ddcmp The circuit is a DDCMP circuit.
fddi The circuit is an FDDI large packet circuit.
hdlc The circuit is an HDLC circuit.
x25 da The circuit is a dynamically allocated X.25 circuit.
x25 permanent X.25 permanent virtual circuit.
x25 static incoming Static incoming X.25 circuit.
x25 static outgoing Static outgoing X.25 circuit.

x.25 filters

Default: See description Value: Set of simple names
Specifies the set of X.25 filters to be used when a port is opened to the X.25 module. Typically, there will be two sets: one to specify the selection on the Call User Data field for Phase V, and the other to specify the selection on the subaddress for Phase IV. This attribute is valid only if the characteristic type is x25 static incoming or x25 da.

21.3.3 Counter Attributes

authentication failures

Support: L1,L2,IP
Number of times a PDU has been received on this circuit with an Authentication Information field that is incompatible with the PDU type.

calls failed

Support: All
Number of unsuccessful call attempts on this circuit. This attribute is supported only if the characteristic type is x25 da.

calls placed

Support: All
Number of call attempts (successful and unsuccessful) on this circuit. This attribute is supported only if the characteristic type is x25 da.

changes in adjacency state

Support: All
Number of times the status attribute state of an adjacency belonging to this circuit changes from Up to Down (or Initializing), or the reverse.

changes in ip adjacency state

Support: IP
Number of times the status attribute state of an IP adjacency belonging to this circuit changes from Up to some other state, or the reverse.

changes in rip neighbor state

Support: L2,IP
Number of times the RIP state of IP adjacencies belonging to this circuit have changed. This attribute is supported only if the routing entity's characteristic routing protocols supported includes the routing protocol RIP.

circuit changes

Support: All
Number of times the status attribute state has changed from on to off, or vice versa.

congestion discards

Support: L1,L2
Number of data- and error-report NPDUs that have been discarded, before or after fragmentation, because of congestion. Any other discarding will already have been done by the forwarding process. This number includes all PDUs recognized by the receive process as data PDUs (Phase V data- and error-report PDUs and Phase IV data packets), even though they may subsequently be discarded for some reason.

control pdus received

Support: All
Number of control PDUs that have been received on this circuit. This number includes all Network layer PDUs, with the exception of DECnet-Plus data and error report PDUs and Phase IV data PDUs.

control pdus sent

Support: All
Number of control PDUs that have been sent on this circuit.

corrupted hello pdus received

Support: All
Number of times an ES-IS (end system to intermediate system) or IS-IS (intermediate system to intermediate system) Hello PDU has been received on this circuit that either cannot be parsed or contains an incorrect checksum.

corrupted lsps received

Support: L1,L2
Number of times a corrupted link state packet has been received on this circuit.

creation time

Support: All
Time this entity was created.

da adjacency changes

Support: All
Number of DA adjacency change events that have been generated.

data pdus forwarded

Support: L1,L2
Number of data- and error-report NPDUs that have been forwarded onto this circuit (either from another circuit or from a local port). This number includes all PDUs recognized by the receive process as data PDUs (Phase V data- and error-report PDUs and Phase IV data packets), even though they may subsequently be discarded for some reason.

data pdus fragmented

Support: All
Number of data NPDUs that have been fragmented on this circuit.

data pdus received

Support: All
Number of data- and error-report NPDUs that have been received on this circuit. This number includes all PDUs recognized by the receive process as data PDUs (DECnet-Plus data and error report PDUs and Phase IV data packets), even though they may subsequently be discarded for some reason.

data pdus transmitted

Support: All
Number of data- and error-report NPDUs, after fragmentation, that have been delivered to the port for transmission on this circuit. This number includes all PDUs recognized by the receive process as data PDUs (DECnet-Plus data- and error-report PDUs and Phase IV data packets), even though they may subsequently be discarded for some reason.

exceeded maximum svc adjacencies

Support: End,L2
Number of exceeded maximum svc adjacency events that have been generated. This counter is supported only if the circuit's type is set to x25 da; only for nodes that are end nodes; and if the system supports dual routing (both DECnet and IP routing).

id reachability changes

Support: All
Number of ID reachability change events that have been generated.

initialization failures

Support: All
Number of times that an attempt to initialize an adjacent node over this circuit has failed, either because of version skew or area mismatch.

ip fragmentation failure discards

Support: IP
Number of IP packets discarded because fragmentation was required to transmit them, but the IP header requested "do not fragment."

ip fragments created

Support: IP
Number of IP fragments created for transmission on this circuit.

ip packets forwarded

Support: IP
Number of IP packets forwarded on this circuit before fragmentation. These IP packets may be from another circuit or from a local port. Note that this value includes those IP packets counted in the ip send discards counter.

ip packets fragmented

Support: IP
Number of IP packets that have been fragmented on this circuit.

ip packets received

Support: IP
Number of IP packets received on this circuit. This value includes all types of IP packet (control, data, etc.), and those that may subsequently be discarded for any reason.

ip received discards

Support: IP
Number of IP packets that have been received and then discarded because of congestion.

ip send discards

Support: IP
Number of IP packets for transmission that have been discarded because of congestion.

irrecoverable svc failures

Support: All
Number of times that the number of re-call attempts on this circuit has become equal to the value of the characteristic maximum call attempts. This attribute is supported only if the characteristic type is set to x25 static outgoing.

LAN L1 designated router changes

Support: L1,L2
Number of times the local node has either elected itself or resigned as the LAN level 1 designated router on this circuit. This attribute is supported only if the circuit's characteristic type is set to csma-cd.

LAN L2 designated router changes

Support: L2
Number of times the local node has either elected itself or resigned as the LAN level 2 designated router on this circuit.

LAN phaseiv designated router changes

Support: L1,L2
Number of times the local node has either elected itself or resigned as the LAN Phase IV designated router on this circuit.

redirect discards

Support: End
Number of Redirect PDUs that have been discarded because of insufficient cache memory.

rejected adjacencies

Support: All
Number of times an attempt to create a new adjacency using this circuit has failed because of insufficient resources.

rejected ip adjacencies

Support: L2,IP
Number of times an attempt to automatically create a new IP adjacency to an IP router has failed because of lack of resources.

rip errors received

Support: L2,IP
Number of RIP messages received with any kind of received error on this circuit. This attribute is supported only if the routing entity's characteristic routing protocols supported includes the routing protocol RIP.

segmentation failure discards

Support: L1,L2
Number of data NPDUs that have been discarded because segmentation was required to send them on this circuit but was not permitted in the NPDU header.

verification reject events

Number of verification reject events that have been generated. This attribute is supported only if the characteristic type is set to ddcmp, hdlc, x25 static incoming, x25 static outgoing, or x25 permanent.

21.3.4 Identifier Attributes

name

Simple name assigned to the circuit when it is created.

21.3.5 Status Attributes

data link port

Support: All
Name of the data link port used for this circuit. Not supported on DA circuits.

data link sdu size

Support: All
Maximum size, in octets, of a Data Link SDU for this circuit. This includes the Network layer header, but excludes the Data Link layer header. The value of this status is the lesser of the value of the characteristic manual data link sdu size and any limit imposed by the Data Link layer.

LAN L1 id

Support: L1,L2
LAN ID allocated by the LAN level 1 designated router. This attribute is supported only if the circuit's characteristic type is csma-cd.

LAN L2 id

Support: L2
LAN ID allocated by the LAN level 2 designated router. This attribute is supported only if the circuit's characteristic type is csma-cd.

L1 designated router

Support: L1,L2
ID of the DECnet Phase V level 1 designated router on this circuit. This attribute is supported only if the circuit's characteristic type is csma-cd. If this node does not participate in the router election process, the value returned is 00-00-00-00-00-00.

L2 designated router

Support: L2
ID of the DECnet Phase V level 2 designated router on this circuit. This attribute is supported only if the circuit's characteristic type is csma-cd. If this node does not participate in the router election process, the value returned is 00-00-00-00-00-00.

phaseiv designated router

Support: L1,L2
ID of the Phase IV designated router on this circuit. This attribute is supported only if the circuit's characteristic type is csma-cd. If this node does not participate in the router election process, the value returned is 00-00-00-00-00-00.

point-to-point id

Support: L1,L2
ID allocated to the circuit during its initialization. This attribute is supported only if the circuit's characteristic type is hdlc, ddcmp, or x25 static.

state

State of the routing circuit entity.
Support: All
off The circuit is disabled.
on The circuit is enabled.

uid

Entity's unique identifier, which is generated when the entity is created.

21.3.6 Event Messages

adjacency state change

Support: All
Generated when the status attribute state of a routing circuit adjacency entity belonging to the circuit changes from up to down, or vice versa. For the purposes of this event, the state up/dormant is considered to be the same as up, and the state initializing is considered to be the same as down. For end nodes, this event is generated for point-to-point links only.

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

[HR] 

  NCL_PROFILE_023.HTML
  OSSG Documentation
   2-DEC-1996 12:48:31.06

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal