DECnet-Plus
Network Control Language Reference

21.6 routing circuit ip reachable address

destination subnet-address

Specifies the IP address and subnet mask to which this IP reachable address corresponds. This argument determines the value of the destination characteristic. Note that if the subnet address is for an IP host, this argument also determines the value of the next hop characteristic.

destination

Support: L2,IP

The IP address and subnet mask to which this reachable address refers. This value is derived from the destination argument of the create command. You cannot modify this characteristic.

dte addresses

Support: L2,IP
Default: No DTE addresses	Value: Set of DTE addresses

A set of DTE addresses to which a call may be directed in order to reach an address that matches the subnet address given by the subnet address characteristic. You can modify this characteristic only when the entity is disabled.

This characteristic is supported only if the owning circuit is an X.25 circuit.

metric

Support: L2,IP
Default: 20	Value: 1--maximum link cost

Default metric value for reaching the specified subnet over this circuit. You can modify this characteristic only when the entity is disabled.

metric class

Support: L2,IP
Default: External	Value: External or internal

Class of the default metric, which controls the preference for this route in the decision process.

external	The I/E bit for the default metric in the External Reachability Information option of level 2 link state packets is set to 1. The subnet address specified by this IP reachable address will have the same preference as level 2 external routes.
internal	The I/E bit for the default metric in the External Reachability Information option of level 2 link state packets is set to 0. The subnet address specified by this IP reachable address will have the same preference as level 2 internal routes.

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

next hop

Support: L2,IP
Default: 0.0.0.0	Value: IP-address

IP address of the neighboring node through which the destination is reachable. When you create this entity, this characteristic is set to the value of the IP address component of the destination argument of the create command if the IP reachable address is to an IP host.

This characteristic is not used on circuits of type x25 da. You can modify this characteristic only when the entity is disabled.

name

Simple name assigned to the IP reachable address when it is created.

state

Status of the routing circuit reachable address entity.

off	The IP reachable address is disabled.
on	The IP reachable address is enabled.

For create:

destination not unique

An IP reachable address already exists with the specified destination.

wrong circuit type

If the subnet address if for an IP host, it must be on an x25 da circuit.

For enable:

invalid next hop

The Next Hop IP address has not been changed from the default value.

invalid snpa address

The DTE address has not been changed from the default value and the parent circuit entity (that is the Routing Circuit entity to which this entity is subordinate) has type x25 da.

21.7 routing circuit reachable address

A reachable address of type outbound (default) describes address prefixes in an external domain that are reachable by outbound traffic over this circuit. For end systems, the circuit can be either an X.25 DA circuit or a broadcast circuit. The routing information contained in the reachable address is entered directly into the L2 decision process. When ManualL2Algorithm has the value routing vector, only reachable addresses with address prefixes corresponding to Phase IV areas are fed into the decision process.

On an L2 router, an inbound reachable address describes address prefixes corresponding to Phase IV areas that are reachable through the local node by inbound traffic over this circuit. The routing information contained in the reachable address (area and cost) is entered into a Phase IV routing vector message, which is transmitted periodically over this circuit.

On an end system, the type may be outbound or (for a broadcast circuit only) filter. A reachable address of type outbound behaves in a way similar to that on an L2 router except that the routing information is used to control the operation of the ES cache. A reachable address of type filter (for a broadcast circuit only) specifies the permitted LAN addresses of routers on the LAN that will be used by the reverse path cache algorithm. To switch between outbound and filter types, the reachable address must first be disabled.

For either outbound or filter type, the mapping attribute should be set to manual because the default is X.121.

The circuit-name refers to the circuit associated with the specified reachable address. The address-prefix refers to the reachable address managed by this command.
add [node node-id] routing circuit circuit-name reachable address simple-name {DTE addresses [set] | permitted LAN address [set] }
create [node node-id] routing circuit circuit-name reachable address simple-name address prefix address-prefix
delete [node node-id] routing circuit circuit-name reachable address simple-name
disable [node node-id] routing circuit circuit-name reachable address simple-name
enable [node node-id] routing circuit circuit-name reachable address simple-name
remove [node node-id] routing circuit circuit-name reachable address simple-name {DTE addresses [set] | permitted LAN address [set] }
set [node node-id] routing circuit circuit-name reachable address simple-name {address prefix address-prefix | block size integer | cost integer | data format PhaseIV or PhaseV | DTE addresses [set] | lan address [id] | ISDN address isdn-address | metric type metric-type | mapping string | modem addresses modem-address | modem address prefix modem-address-prefix | modem address suffix modem-address-suffix | permitted lan address lan-address | type string }
show [node node-id] routing circuit circuit-name reachable address simple-name [all [attributes] | all characteristics | all identifiers | all status ]

21.7.1 Arguments

address prefix address-prefix

Address prefix to which this reachable address corresponds.

address prefix

Support: L2,End
Default: None	Value: Address prefix

Address prefix to which this reachable address refers. You cannot modify this characteristic. This characteristic is set by means of an argument to the create command.

The value of this characteristic derives from an argument to the create command. This characteristic is supported only if the owning circuit has type set to x25 da.

block size

Support: End, type outbound
Default: 0	Value: 0--65536

The data link block size to be used for this prefix for an end system. If the block size is set to the default, the manual block size of the circuit will be used instead. This attribute is supported only if the type characteristic is set to outbound.

cost

Support: L2
Default: 20	Value: 1--63

Cost of reaching this address prefix over this circuit.

data format

Support: L2,End
Default: PhaseV	Value: PhaseIV (1) or PhaseV (0)

The PDU data format to be used when forwarding data (or error report) NPDUs using this reachable address.

This attribute is supported only if the type characteristic is set to outbound. You can modify this characteristic only when the entity is disabled.

dte addresses

Support: End,L2
Default: No DTE addresses={ }	Value: Set of DTE addresses

A set of DTE addresses to which a call may be directed in order to reach an address that matches the address prefix of this reachable address.

This characteristic is supported if the node is a level 2 router, where the owning circuit's characteristic type is one of the X.25 circuit types, and the reachable address's characteristic type is outbound. It is also supported by end nodes operating over an x25 da circuit. You can modify this characteristic only when the entity is disabled.

ISDN address

Support: L1,L2
Default: { }	Value: Set of ISDN Addresses

A full set of E.164 ISDN network addresses to which a call may be directed in order to reach a network number that matches the address prefix of the parent reachable address entity. Associated with each ISDN network address, but not visible to network management, is a variable last failure of type binary absolute time. This attribute is supported only if access type is ISDN DA.

LAN address

Support: L2,End
Default: 00-00-00-00-00-00	Value: ID

A single LAN address to which an NPDU can be directed in order to reach an address that matches the address prefix of the parent reachable address entity. This attribute is supported only if the type characteristic is set to outbound on broadcast circuits only. A valid address is required here.

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

mapping

Support: End,L2
Default: X.121	Value: Manual or X.121

Type of mapping used to determine the SNPA address to which a call should be placed for this address prefix. You can modify this characteristic only when the entity is disabled. If the circuit is a broadcast circuit, this attribute must have the value manual.

manual	The mapping uses the set of addresses in the characteristic dte addresses or the address in the characteristic LAN address.
X.121	The mapping uses the X.121 address extraction algorithm.

This characteristic is supported only if either of the following conditions is satisfied:

• The node is a level 2 router or an end node, and the owning circuit's characteristic type is one of the X.25 circuit types.
• The node is a level 2 router, the owning circuit's characteristic type is csma-cd, and the reachable address's characteristic type is outbound.

metric type

Support: L2
Default: Internal	Value: Internal, external

The metric type of the cost metric for the circuits. If internal, the I/E bit for the metric in the Prefix Neighbors option of L2 LSPs is set to 0, otherwise (external) is set to 1.

modem addresses

Support: L1,L2
Default: { }	Value: Set of modem addresses

A set of full dial sequence that contains the address (PSTN or ISDN) to which a call may be directed in order to reach a network number that matches the address prefix of the parent reachable address entity. Associated with each modem address, but not visible to network management, is a variable last failure of type binary absolute time. This is valid only if mapping is manual and the parent circuit entity's access time is Modem DA.

modem address prefix

Support: L1,L2
Default: L1,L2	Value: Address string

The address that is to be inserted to the beginning of the address extracted from the NSAP address. This is valid only if mapping is not manual and the parent circuit entity's access type is Modem DA. It is used in conjunction with modem access suffix to form the complete dial sequence.

modem address suffix

Support: L1,L2
Default: L1,L2	Value: Address string

The address that is to be inserted to the end of the address extracted from the NSAP address. This is valid only if mapping is not manual and the parent circuit entity's access type is Modem DA. It is used in conjunction with modem access prefix to form the complete dial sequence.

permitted LAN address

Support: End
Default: { }	Value: Set of LAN addresses

The set of LAN addresses corresponding to routers that are permitted to be used for forwarding to this prefix. This attribute is supported only if the type characteristic is set to filter on broadcast circuits only. The default is an empty set, and at least one LAN address is required.

type

Support: L2,End
Default: Outbound	Value: Inbound, outbound, or filter

Type of the reachable address. You can modify this characteristic only when the entity is disabled.

inbound	For L2 only, the address prefix corresponds to a Phase IV area that is reachable through this node and circuit by inbound traffic.
outbound	The address prefix is in an external domain that is reachable over this circuit by outbound traffic. The mapping attribute should be set to manual.
filter	The address prefix defines a set of addresses that should be reached via the set of routers listed in the permitted LAN address characteristic. The mapping attribute should be set to manual.

name

Simple name assigned to the reachable address when it is created.

state

State of the routing circuit reachable address entity.

off	The reachable address is disabled.
on	The reachable address is enabled.

For create:

address prefix not unique

A reachable address already exists with the specified address prefix.

invalid address prefix

Specified address prefix has more than two digits, and does not correspond to a valid AFI.

non DA circuit

A reachable address on an end node can only be created on a DA circuit.

For enable:

invalid address

The DTE address or LAN address has not been changed from the default value.

21.8 routing destination area

Destination areas exist only on nodes that are level 2 routers. The address-prefix is the destination area managed by this command.
show [node node-id] routing destination area address-prefix [all [attributes] | all identifiers | all status ]

21.8.1 Identifier Attributes

name

Address prefix associated with this destination area.

cost

Support: L2

Cost of the least cost path(s) to this destination area.

output adjacencies

Support: L2

Set of routing circuit and routing circuit adjacency (or routing circuit reachable address) entity names that represent the forwarding decisions for this destination area.

21.9 routing destination cache

• Circuit name --- The name of the circuit over which data was received.
• Data link address --- The data link address of the system that passed the data to the local system. This may be the address of the actual source of the data, or it could the address of a router.
• Remaining Time--- The amount of time (in seconds) this data will be considered valid. If it is not updated by the end of that time (by the arrival of more data, for example), it will be deleted.
• Reachability --- There are three values possible:
  • Reverse --- Data has arrived from the indicated data link address, with no further indication of the source's location.
  • Indirect --- One or more routers (IS) have sent redirect packets to indicate that the specified data link address is the best path to use.
  • Direct --- The remote system has been shown to be directly connected or on the same LAN segment.
• Data format --- Indicates if PhaseIV or ISO CLNP packets are being used for communications with the remote system.
• Block size --- Shows what sized packets are being used, which for LAN circuits would be either Ethernet or FDDI frame sizes.

name

Address prefix associated with this destination area.

information

The set of records containing cache information relating to this address.

21.10 routing destination node

name

System ID associated with this destination node.

cost

Support: L1,L2

Cost of the least cost path(s) to this destination node.

nets

Support: L1,L2

Set of NETs computed from the system ID that is the entity's name and the area addresses in the routing entity's manual area addresses set.

output adjacencies

Support: L1,L2

Set of routing circuit and routing circuit adjacency entity names representing the forwarding decisions for this destination node.

21.11 routing egp group

autonomous system number

Support: L2,IP
Default: 0	Value: 0--65535

The autonomous system number common to members of this group. You can modify this characteristic only when the entity is disabled. This attribute is supported only if the node is a level 2 router, and if the system supports dual routing (both DECnet and IP routing).

external routes

Support: L2,IP
Default: Receive	Value: Set of send,receive

If the set includes receive, external gateway routes are accepted from neighbors in the group; if the set does not include receive, external gateway routes are discarded. If the set includes send, external gateway routes will be sent to neighbors in this group; if the set does not include send, external gateway routes are not sent. You can modify this characteristic only when the entity is disabled.

maximum active neighbors

Support: L2,IP
Default: 1	Value: 0--255

The maximum number of neighbor systems in the group that this system will attempt to acquire and maintain in the Up state at any given time. You can modify this characteristic only when the entity is disabled.

receive metric class

Support: L2,IP
Default: External	Value: Internal or external

The class to be associated with routes received from EGP neighbors in this group (unless overridden by a routing receive route entity). You can modify this characteristic only when the entity is disabled.

send local metric

Support: L2,IP
Default: 1	Value: 0--255

The metric value to be used when announcing routes derived from local information (unless overridden by a routing send route entity). You can modify this characteristic only when the entity is disabled.

send metric classes

Support: L2,IP
Default: Internal	Value: Set of external,internal

Routes received through routing protocols other than EGP with metric classes in this set are candidates for announcement in EGP messages sent to neighbors in this group, subject to route propagation policy. Routes with metric classes not specified in this set will not be announced. You can modify this characteristic only when the entity is disabled.

send replacement metric

Support: L2,IP
Default: 1	Value: 0--255

Specifies the metric value to be used when announcing routes derived from non-EGP routing protocols (unless overridden by a routing send route entity). You can modify this characteristic only when the entity is disabled.

name

Simple name assigned to the EGP group when it is created.

state

State of the routing egp group entity.

off	The entity is disabled.
on	The entity is enabled.

For enable:

invalid autonomous system number

The autonomous system number characteristic has not been changed from its default value.

open port failed

The routing EGP port could not be opened.

  NCL_PROFILE_025.HTML
  OSSG Documentation
   2-DEC-1996 12:48:36.62

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal