Table Of Contents
ISO CLNS Commands
area-password
clear clns cache
clear clns es-neighbors
clear clns is-neighbors
clear clns neighbors
clear clns route
clns access-group
clns adjacency-filter
clns checksum
clns cluster-alias
clns configuration-time
clns congestion-threshold
clns dec-compatible
clns enable
clns erpdu-interval
clns esct-time
clns es-neighbor
clns filter-expr
clns filter-set
clns holding-time
clns host
clns is-neighbor
clns mtu
clns net (global configuration command)
clns net (interface configuration command)
clns packet-lifetime
clns rdpdu-interval
clns route (interface static route)
clns route (to enter a static route)
clns route default
clns route discard
clns route-cache
clns router isis
clns router iso-igrp
clns routing
clns security pass-through
clns send-erpdu
clns send-rdpdu
clns split-horizon
clns template-alias
clns want-erpdu
distance
domain-password
ignore-lsp-errors
ip domain-lookup nsap
isis adjacency-filter
isis circuit-type
isis csnp-interval
isis hello-interval
isis hello-multiplier
isis metric
isis password
isis priority
isis retransmit-interval
iso-igrp adjacency-filter
is-type
log-adjacency-changes
lsp-mtu
match clns address
match clns next-hop
match clns route-source
match interface
match metric
match route-type
metric weights
net
ping (privileged)
ping (user)
redistribute
route-map
router isis
router iso-igrp
set level
set metric
set metric-type
set tag
show clns
show clns cache
show clns es-neighbors
show clns filter-expr
show clns filter-set
show clns interface
show clns is-neighbors
show clns neighbors
show clns protocol
show clns route
show clns traffic
show isis database
show isis routes
show isis spf-log
show route-map
timers basic
trace (privileged)
trace (user)
which-route
ISO CLNS Commands
The International Organization for Standardization (ISO) Connectionless Network Service (CLNS) protocol is a standard for the network layer of the Open System Interconnection (OSI) model.
Use the commands in this chapter to configure and monitor ISO CLNS networks. For ISO CLNS protocol configuration information and examples, refer to the "Configuring ISO CLNS" chapter of the Router Products Configuration Guide.
area-password
Use the area-password router configuration command to configure the area authentication password. The no area-password command disables the password.
area-password password
no area-password [password]
Syntax Description
password
|
Password you assign.
|
Default
No area authentication password is defined.
Command Mode
Router configuration
Usage Guidelines
This password is inserted in Level 1 (station router level) link state PDUs (LSPs), complete sequence number PDUs (CSNPs), and partial sequence number PDUs (PSNP).
Example
The following example assigns an area authentication password:
Related Command
domain-password
clear clns cache
Use the clear clns cache EXEC command to clear and reinitialize the CLNS routing cache.
clear clns cache
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Example
The following example clears the CLNS routing cache:
Related Command
show clns cache
clear clns es-neighbors
Use the clear clns es-neighbors EXEC command to remove ES neighbor information from the adjacency database.
clear clns es-neighbors
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Example
The following example removes the ES neighbor information from the adjacency database:
Related Commands
clear clns neighbors
show clns es-neighbors
clear clns is-neighbors
Use the clear clns is-neighbors EXEC command to remove IS neighbor information from the adjacency database.
clear clns is-neighbors
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Example
The following example removes the IS neighbor information from the adjacency database:
Related Commands
clear clns neighbors
show clns is-neighbors
clear clns neighbors
Use the clear clns neighbors EXEC command to remove CLNS neighbor information from the adjacency database.
clear clns neighbors
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Example
The following example removes the CLNS neighbor information from the adjacency database:
Related Commands
clear clns es-neighbors
clear clns is-neighbors
show clns neighbors
clear clns route
Use the clear clns route EXEC command to remove all of the dynamically derived CLNS routing information.
clear clns route
Syntax Description
This command has no arguments or keywords.
Command Mode
EXEC
Example
The following example removes all of the dynamically derived CLNS routing information:
Related Command
show clns route
clns access-group
Use the clns access-group interface configuration command to filter transit CLNS traffic going either into or out of the router or both on a per-interface basis. Use the no form of this command to disable filtering of transit CLNS packets.
clns access-group name [in | out]
no clns access-group name [in | out]
Syntax Description
name
|
Name of the filter set or expression to apply.
|
in
|
(Optional) Filter should be applied to CLNS packets entering the router.
|
out
|
(Optional) Filter should be applied to CLNS packets leaving the router. If you do not specify an in or out keyword, out is assumed.
|
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command has no effect on any CLNS packets sourced by the router. It applies only to packets forwarded by the router. Fast switching is still supported with access groups in place, but its performance will be impacted based on the complexity of the filters.
Filter sets and expressions are described in this manual in the descriptions for the clns filter-expr, clns filter-set, and clns template-alias global configuration commands.
Example
The following example shows how to enable forwarding of frames received on Ethernet 0 that had a source address of anything other than 38.840F, and a destination address that started with 47.0005 or 47.0023, but nothing else:
clns filter-set US-OR-NORDUNET permit 47.0005...
clns filter-set US-OR-NORDUNET permit 47.0023...
clns filter-set NO-ANSI deny 38.840F...
clns filter-set NO-ANSI permit default
clns filter-expr STRANGE source NO-ANSI and destination US-OR-NORDUNET
clns access-group STRANGE in
Related Commands
clns filter-expr
clns filter-set
clns template-alias
clns adjacency-filter
Use the clns adjacency-filter interface configuration command to filter the establishment of CLNS end system (ES) and intermediate system (IS) adjacencies. Use the no form of this command to disable this filtering.
clns adjacency-filter {es | is} name
no clns adjacency-filter {es | is} name
Syntax Description
es
|
End system adjacencies are to be filtered.
|
is
|
Intermediate system adjacencies are to be filtered.
|
name
|
Name of the filter set or expression to apply.
|
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
Filtering is performed on full NSAP addresses. If filtering should only be performed on system IDs or any other substring of the full NSAP address, the wildcard-matching capabilities of filter sets should be used to ignore the insignificant portions of the NSAP addresses.
Filter sets and expressions are described in this manual in the descriptions for the clns filter-expr, clns filter-set, and clns template-alias global configuration commands.
Example
The following example builds a filter that accepts end system adjacencies with only two systems, based only on their system IDs:
clns filter-set ourfriends ...0000.0c00.1234.**
clns filter-set ourfriends ...0000.0c00.125a.**
clns adjacency-filter es ourfriends
Related Commands
clns filter-expr
clns filter-set
clns template-alias
clns checksum
Use the clns checksum interface configuration command to enable checksum generation when ISO CLNS routing software sources a CLNS packet. Use the no form of this command to disable checksum generation.
clns checksum
no clns checksum
Syntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
This command has no effect on routing packets (ES-IS, ISO-IGRP, and IS-IS) sourced by the system. It applies to pings and trace route packets.
Example
The following example shows how to enable checksum generation:
clns cluster-alias
Use the clns cluster-alias interface configuration command to allow multiple systems to advertise the same system ID as other systems in end-system hello messages. The no form of this command disables cluster aliasing.
clns cluster-alias
no clns cluster-alias
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This feature caches multiple ES adjacencies with the same network service access point (NSAP) but different subnetwork point of attachment (SNPA) addresses. When a packet is destined to the common NSAP address, the router load-splits the packets among the different SNPA addresses. A router that supports this capability forwards traffic to each system.
If DECnet Phase V cluster aliases are disabled on an interface, end-system hello packet information is used to replace any existing adjacency information for the NSAP. Otherwise, an additional adjacency (with a different SNPA) is created for the same NSAP.
Example
The following example shows how cluster aliasing is enabled on specified interfaces:
clns nsap 47.0004.004d.0001.0000.0c00.1111.00
clns configuration-time
Use the clns configuration-time global configuration command to specify the rate at which ES hellos (ESHs) and IS hellos (ISHs) are sent. You can restore the default value by specifying the no form of this command.
clns configuration-time seconds
no clns configuration-time
Syntax Description
seconds
|
Rate in seconds at which ESH and ISH packets are sent.
|
Default
60 seconds
Command Mode
Global configuration
Example
The following example specifies that ESHs and ISHs are to be sent every 100 seconds:
clns configuration-time 100
Related Commands
clns esct-time
clns holding-time
clns congestion-threshold
Use the clns congestion-threshold interface configuration command to set the congestion experienced bit if the output queue has more than the specified number of packets in it. A number value of zero or the no form of this command prevents this bit from being set. Use the no form of this command to remove the parameter setting and set it to 0.
clns congestion-threshold number
no clns congestion-threshold
number
|
Number of packets that are allowed in the output queue before the system sets the congestion-experienced bit. The value zero (0) prevents this bit from being set.
|
Syntax Description
Default
4 packets
Command Mode
Interface configuration
Usage Guidelines
If a router configured for CLNS experiences congestion, it sets the congestion experienced bit. The congestion threshold is a per-interface parameter set by this interface configuration command. An error PDU is sent to the sending router and the packet is dropped if the number of packets exceeds the threshold.
Example
The following example sets the congestion threshold to 10:
clns congestion-threshold 10
clns dec-compatible
Use the clns dec-compatible interface configuration command to allow ISHs sent and received to ignore the N-selector byte. Use the no form of this command to disable this feature.
clns dec-compatible
no clns dec-compatible
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Interface configuration
Example
The following example enables DEC-compatible mode:
clns enable
Use the clns enable interface configuration command if you do not intend to perform any static or dynamic routing on an interface, but intend to pass ISO CLNS packet traffic to end systems. Use the no form of this command to disable ISO CLNS on a particular interface.
clns enable
no clns enable
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Interface configuration
Example
The following example enables ISO CLNS on Ethernet interface 0:
clns erpdu-interval
Use the clns erpdu-interval interface configuration command to determine the minimum interval time, in milliseconds, between error PDUs (ERPDUs). A milliseconds value of zero or the no form of this command turns off the interval and effectively sets no limit between ERPDUs.
clns erpdu-interval milliseconds
no clns erpdu-interval milliseconds
Syntax Description
milliseconds
|
Minimum interval time (in milliseconds) between ERPDUs.
|
Default
10 milliseconds
Command Mode
Interface configuration
Usage Guidelines
This command does not send ERPDUs more frequently than one per interface per 10 milliseconds. It is wise not to send an ERPDU frequently if bandwidth is precious, such as over slow serial lines.
Example
The following example sets the ERPDU interval to 30 milliseconds:
Related Command
clns send-erpdu
clns esct-time
Use the clns esct-time interface configuration command to supply an ES Configuration Timer (ESCT) option in a transmitted IS hello packet that tells the end system how often it should transmit ES hello packet protocol data units (PDUs). Use the no form of this command to restore the default value and disable this feature.
clns esct-time seconds
no clns esct-time seconds
Syntax Description
seconds
|
Time, in seconds, between ESH PDUs. Range is from 0 through 65535.
|
Default
0 seconds (disabled)
Command Mode
Interface configuration
Example
The following example sets the ES configuration time to 10 seconds:
Related Commands
clns configuration-time
clns holding-time
clns es-neighbor
Use the clns es-neighbor interface configuration command to list all end systems that will be used when you manually specify the NSAP-to-SNPA mapping. The SNPAs are the MAC addresses. Use the no form of this command to delete the ES neighbor.
clns es-neighbor nsap snpa
no clns es-neighbor nsap
Syntax Description
nsap
|
Specific NSAP to map to a specific MAC address.
|
snpa
|
Data link (MAC) address.
|
Default
No end systems are listed.
Command Mode
Interface configuration
Usage Guidelines
If you have configured either the clns router iso-igrp or clns router isis interface configuration commands for a particular interface, the ES-IS routing software automatically turns ES-IS on for that interface.
It is only necessary to use static mapping for those end systems that do not support ES-IS. The router will continue to discover dynamically those end systems that do support ES-IS.
Example
The following example defines an ES neighbor on Ethernet interface 0:
clns es-neighbor 47.0004.004D.0055.0000.0C00.A45B.00 0000.0C00.A45B
In this case, the end systems with the following NSAP (or NET) are configured with an Ethernet MAC address of 0000.0C00.A45B:
47.0004.004D.0055.0000.0C00.A45B.00
Related Commands
clns host
clns is-neighbor
clns filter-expr
Use one or more clns filter-expr global configuration commands to combine CLNS filter sets and CLNS address templates into complex logical NSAP pattern-matching expressions. The no form of this command deletes the expression. There are many forms of this command.
clns filter-expr ename term
clns filter-expr ename not term
clns filter-expr ename term or term
clns filter-expr ename term and term
clns filter-expr ename term xor term
no clns filter-expr ename
Syntax Description
ename
|
Alphanumeric name to apply to this filter expression.
|
term
|
Filter expression term. A term can be any of the following:
ename—Another, previously defined, filter expression.
sname (or destination sname)—A previously defined filter set name, with the filter set applied to the destination NSAP address.
source sname—A previously defined filter set name, with the filter set applied to the source NSAP address.
|
Default
No filter expression is defined.
Command Mode
Global configuration
Usage Guidelines
Filter expressions can reference previously defined filter expressions, so you can build arbitrarily complex expressions.
The first form listed defines a simple filter expression that is pattern matched only if the pattern given by term is matched.
The second form defines a filter expression that is pattern matched only if the pattern given by term is not matched.
The third form defines a filter expression that is pattern matched if either of the patterns given by the two terms are matched.
The fourth form defines a filter expression that is pattern matched only if both of the patterns given by the two terms are matched.
The fifth form defines a filter expression that is pattern matched only if one of the patterns, but not both, given by the two terms are matched.
The sixth and final form of the command deletes the definition of an existing filter expression.
Use this command to define complex filter expressions. See the description of the clns filter-set global configuration command to learn how to define filter sets.
Example
The following example shows how to define a filter expression that matches addresses with a source address of anything besides 39.840F, and a destination address that started with 47.0005 or 47.0023, but nothing else:
clns filter-set US-OR-NORDUNET permit 47.0005...
clns filter-set US-OR-NORDUNET permit 47.0023
clns filter-set NO-ANSI deny 38.840F...
clns filter-set NO-ANSI permit default
clns filter-expr STRANGE source NO-ANSI and destination US-OR-NORDUNET
Related Commands
clns filter-set
clns template-alias
show clns filter-expr
clns filter-set
Use one or more clns filter-set global configuration commands to build a list of CLNS address templates with associated permit and deny conditions for use in CLNS filter expressions. CLNS filter expressions are used in the creation and use of CLNS access lists. The no form of this command deletes the entire filter set.
clns filter-set sname [permit | deny] template
no clns filter-set sname
Syntax Description
sname
|
Alphanumeric name to apply to this filter set.
|
permit | deny
|
(Optional) Addresses matching the pattern specified by template are to be permitted or denied. If neither permit nor deny is specified, permit is assumed.
|
template
|
Address template, template alias name, or the keyword default. Address templates and alias names are described under the description of the clns template-alias global configuration command. The default keyword denotes a zero-length prefix and matches any address.
|
Default
No address templates are defined.
Command Mode
Global configuration
Usage Guidelines
Use this command to define a list of pattern matches and permit/deny conditions for use in CLNS filter expressions. Filter expressions are used in the creation and use of CLNS access lists. See the description of the clns filter-expr global configuration command to learn how to define filter expressions and the clns template-alias global configuration command to learn how to define address templates and address template aliases.
Each address that must be matched against a filter set is first compared against all of the entries in the filter set, in order, for an exact match with the address. If the exact match search fails to find a match, then the entries in the filter set containing wildcard matches are scanned for a match, again, in order. The first template that matches is used. If an address does not match any of the filter set entries, an implicit "deny" is returned as the permit/deny action of the filter set.
Examples
The following example returns a permit action if an address starts with either 47.0005 or 47.0023. It returns an implicit deny action on any other address.
clns filter-set US-OR-NORDUNET permit 47.0005...
clns filter-set US-OR-NORDUNET permit 47.0023...
The following example returns a deny action if an address starts with 39.840F, but returns a permit action for any other address:
clns filter-set NO-ANSI deny 38.840F...
clns filter-set NO-ANSI permit default
Related Commands
clns filter-expr
clns template-alias
show clns filter-set
clns holding-time
Use the clns holding-time global configuration command to allow the sender of an ESH or ISH to specify the length of time you consider the information in the hello packets to be valid. You can restore the default value (300 seconds or 5 minutes) by using the no form of this command.
clns holding-time seconds
no clns holding-time
Syntax Description
seconds
|
Length of time in seconds during which the information in the hello packets is considered valid.
|
Default
300 seconds (5 minutes)
Command Mode
Global configuration
Usage Guidelines
Setting this value too high puts extra traffic on a line and adds time to process hellos. However, you want to avoid setting it too low if your topology changes more often than the router sends updates.
Example
The following example sets the holding time at 150 seconds:
Related Commands
clns configuration-time
clns esct-time
clns host
Use the clns host global configuration command to define a name-to-NSAP mapping that can then be used with commands requiring NSAPs.
clns host name nsap
Syntax Description
name
|
Desired name for the NSAP. The first character can be either a letter or a number, but if you use a number, the operations you can perform are limited.
|
nsap
|
NSAP that the name maps to.
|
Default
No mapping is defined.
Command Mode
Global configuration
Usage Guidelines
The assigned NSAP name is displayed, where applicable, in show and debug EXEC commands. There are some effects and requirements associated with using names to represent NETs and NSAPs, however. Although using names as proxies for addresses is allowed with CLNS commands, they are never written out to NVRAM.
The first character can be either a letter or a number, but if you use a number, the operations you can perform (such as ping) are limited.
The clns host command is generated after all other CLNS commands when the configuration file is parsed. As a result, the NVRAM version of the configuration cannot be edited to specifically change the address defined in the original clns host command. You must specifically change any commands that refer to the original address. This affects all commands that accept names.
The commands that are affected by these requirements include the following:
•
net (router configuration command)
•
clns is-neighbor (interface configuration command)
•
clns es-neighbor (interface configuration command)
•
clns route (global configuration command)
Example
The following example defines names to NSAPs:
clns host cisco1 39.0001.0000.0c00.1111.00
clns host cisco2 39.0002.0000.0c00.1111.00
Related Commands
clns es-neighbor
clns is-neighbor
clns is-neighbor
Use the clns is-neighbor interface configuration command to list all intermediate systems that will be used when you manually specify the NSAP-to-SNPA mapping. The SNPAs are the MAC addresses. Use the no form of this command to delete the specified IS neighbor.
clns is-neighbor nsap snpa
no clns is-neighbor nsap
Syntax Description
nsap
|
NSAP of a specific intermediate system to enter as neighbor to a specific MAC address.
|
snpa
|
Data link (MAC) address.
|
Default
No intermediate systems are listed.
Command Mode
Interface configuration
Usage Guidelines
It is sometimes preferable for a router to have a neighbor entry statically configured rather than learned through ES-IS, ISO-IGRP, or IS-IS. This interface configuration command enters an IS neighbor.
Example
The following example defines an IS neighbor on Ethernet interface 0:
clns is-neighbor 47.0004.004D.0055.0000.0C00.A45B.00 0000.0C00.A45B
Related Commands
clns es-neighbor
clns host
clns mtu
Use the clns mtu interface configuration command to set the MTU packet size for the interface. The no form of this command restores the default and maximum packet size.
clns mtu size
no clns mtu
Syntax Description
size
|
Maximum packet size in bytes. The minimum value is 512; the default and maximum packet size depends on the interface type.
|
Default
Depends on interface type
Command Mode
Interface configuration
Usage Guidelines
All interfaces have a default maximum packet size. You can set the maximum transmission unit (MTU) size of the packets sent on the interface using this interface configuration command.
All devices on a physical medium must have the same protocol MTU in order to operate.
The CTR card does not support the switching of frames larger than 4472 bytes. Interoperability problems can occur if CTR cards are intermixed with other Token Ring cards on the same network. These problems can be minimized by lowering the CLNS maximum packet sizes (MTUs) to be the same on all devices on the network, using the clns mtu command.
Note
Changing the MTU value with the mtu interface configuration command can affect the CLNS MTU value. If the CLNS MTU is at its maximum given the interface MTU, then the CLNS MTU will change with the interface MTU. However, the reverse is not true: changing the CLNS MTU value has no effect on the value for the mtu interface configuration command.
Example
The following example sets the MTU packet size to 1000 bytes:
Related Command
A dagger (†) indicates that the command is documented in another chapter.
mtu †
clns net (global configuration command)
Use the clns net global configuration command to assign a static address for a router. If a router is configured to support ISO CLNS but is not configured to dynamically route CLNS packets using ISO-IGRP or IS-IS, use this command to assign an address to the router. The no form of this command removes any previously configured NET or NSAP address.
clns net {net-address | name}
no clns net {net-address | name}
Syntax Description
net-address
|
Network Entity Title (NET). Refer to the "Usage Guidelines" section.
|
name
|
CLNS host name to be associated with this interface.
|
Default
No static address is assigned.
Command Mode
Global configuration
Usage Guidelines
A CLNS packet sent to any of the defined NSAPs or NETs will be received by the router. The router chooses the NET to use when it sends a packet with the following algorithm:
•
If no dynamic routing protocol is running, use the NET defined for the outgoing interface if it exists; otherwise, use the NET defined for the router.
•
If ISO-IGRP is running, use the NET of the routing process that is running on this interface.
•
If IS-IS is running, use the NET of the IS-IS routing process that is running on this interface.
Example
The following example assigns a static address:
clns net 49.0001.aa00.0400.9105.00
clns net (interface configuration command)
Use the clns net command interface configuration command to assign an NSAP address or name to a router interface. If a router is configured to support ISO CLNS, but is not configured to dynamically route CLNS packets using an ISO-IGRP or IS-IS, use this command to assign an address to the router. The no form of this command removes any previously configured NSAP address.
clns net {nsap-address | name}
no clns net {nsap-address | name}
Syntax Description
nsap-address
|
Specific NSAP address.
|
name
|
Name to be associated with this interface.
|
Default
No address or name is assigned.
Command Mode
Interface configuration
Usage Guidelines
This command is useful if you are doing static routing and need to control the source NET used by the router on each interface.
Examples
The following example assigns an NSAP address to a router interface:
clns net 49.0001.0000.0c00.1111.00
The following example assigns a name to a router interface:
clns packet-lifetime
Use the clns packet-lifetime global configuration command to specify the initial lifetime for locally generated packets. The no form of this command removes the parameter's settings.
clns packet-lifetime seconds
no clns packet-lifetime
Syntax Description
seconds
|
Packet lifetime in seconds.
|
Default
32 seconds
Command Mode
Global configuration
Example
The following example sets a packet lifetime of 120 seconds:
Related Command
clns want-erpdu
clns rdpdu-interval
Use the clns rdpdu-interval interface configuration command to determine the minimum interval time, in milliseconds, between redirect PDUs (RDPDUs). A milliseconds value of zero or the no form of this command turns off the interval rate and effectively sets no limit between RDPDUs.
clns rdpdu-interval milliseconds
no clns rdpdu-interval milliseconds
Syntax Description
milliseconds
|
Minimum interval time (in milliseconds) between RDPDUs.
|
Default
100 milliseconds
Command Mode
Interface configuration
Usage Guidelines
An RDPDU is rate-limited and is not sent more frequently than one per interface per 100 milliseconds. There is no need to change the default. This setting will work fine for most networks.
Example
The following example sets an interval of 50 milliseconds:
Related Command
clns send-rdpdu
clns route (interface static route)
Use this form of the clns route global configuration command to create an interface static route. The no form of this command removes this route.
clns route nsap-prefix type number [snpa-address]
no clns route nsap-prefix
Syntax Description
nsap-prefix
|
Network service access point prefix. This value is entered into a static routing table and used to match the beginning of a destination NSAP. The longest NSAP-prefix entry that matches is used.
|
type
|
Interface type.
|
number
|
Interface number.
|
snpa-address
|
(Optional) Specific SNPA address. Optional for serial links; required for multiaccess networks.
|
Default
No interface static routes are created.
Command Mode
Global configuration
Usage Guidelines
If you do not specify an SNPA address when you have a multiaccess network, you will receive an error message indicating a bad SNPA.
Examples
The following example shows how to create a static route for an Ethernet interface:
clns route 39.0002 ethernet 3 aa00.0400.1111
The following example shows how to create a static route for a serial interface:
clns route 39.0002 serial 0
Related Commands
clns route (to enter a static route)
clns route default
clns route discard
clns route (to enter a static route)
Use this form of the clns route global configuration command to enter a specific static route. NSAPs that start with nsap-prefix are forwarded to next-hop-net or the name of the next hop. The no form of this command removes this route.
clns route nsap-prefix {next-hop-net | name}
no clns route nsap-prefix
Syntax Description
nsap-prefix
|
Network service access point prefix. This value is entered into a static routing table and used to match the beginning of a destination NSAP. The longest NSAP-prefix entry that matches is used.
|
next-hop-net
|
Next-hop Network Entity Title. This value is used to establish the next hop of the route for forwarding packets.
|
name
|
Name of the next hop node. This value can be used instead of the next-hop NET to establish the next hop of the route for forwarding packets.
|
Default
No static route is entered.
Command Mode
Global configuration
Example
The following example forwards all packets toward the specified route:
clns route 39.840F 47.0005.80FF.FF00.0123.4567.89AB.00
Related Commands
clns route (to enter a static route)
clns route default
clns route discard
clns route default
Use the clns route global configuration command to configure a default zero-length prefix rather than type an NSAP prefix. The no form of this command removes this route.
clns route default nsap-prefix type number
no clns route default
Syntax Description
nsap-prefix
|
Network service access point prefix that is a default zero-length prefix.
|
type
|
Interface type. Specify the interface type immediately followed by the interface number; there is no space between the two.
|
number
|
Interface unit number.
|
Default
No default prefix is configured.
Command Mode
Global configuration
Example
The following example configures a default zero-length prefix:
clns route default 39.840F ethernet0
Related Commands
clns route (interface static route)
clns route (to enter a static route)
clns route discard
clns route discard
Use the clns route discard global configuration command to explicitly tell a router to discard packets with NSAP addresses that match the specified nsap-prefix. The no form of this command removes this route.
clns route nsap-prefix discard
no clns route nsap-prefix
Syntax Description
nsap-prefix
|
Network service access point prefix. This value is entered into a static routing table and used to match the beginning of a destination NSAP. The longest NSAP-prefix entry that matches is used.
|
Default
No NSAP addresses are identified.
Command Mode
Global configuration
Usage Guidelines
The decnet advertise command and the clns route discard command work together when DECnet Phase IV/V conversion is enabled. Any packet with the specified CLNS NSAP prefix causes CLNS to behave as if no route was found. Because DECnet Phase IV/V conversion is enabled, the route is then looked up in the Phase IV routing table. The router that is advertising the DECnet Phase IV route converts the packet to OSI and sends it to the router that is advertising the CLNS discard static route. Once it gets there, the packet is converted back to Phase IV.
Example
The following example discards packets with a destination NSAP address that matches the prefix 47.0005:
clns route 47.0005 discard
Related Commands
clns route (interface static route)
clns route (to enter a static route)
clns route default
clns route-cache
Use the clns route-cache interface configuration command to allow fast switching through the cache. To disable fast switching, use the no form of this command.
clns route-cache
no clns route-cache
Syntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
The cache still exists and is used after the no clns route-cache command is used; the software just does not do fast switching through the cache.
Example
The following example shows how to allow fast switching through the cache:
clns router isis
Use the clns router isis interface configuration command to enable IS-IS routing for OSI on a specified interface. The no clns router isis command with the appropriate area tag disables IS-IS on the interface. Use the no form of this command with the appropriate area tag to disable IS-IS routing for the system.
clns router isis [tag]
no clns router isis [tag]
Syntax Description
tag
|
(Optional) Meaningful name for a routing process. If not specified, a null tag is assumed. It must be unique among all CLNS router processes for a given router. Use the same text for the argument tag as specified in the router isis global configuration command.
|
Default
IS-IS routing is not specified for any interface.
Command Mode
Interface configuration
Usage Guidelines
Creating a name for a routing process means that you use names when configuring routing. You can specify only one IS-IS process per router.
Example
The following example enables IS-IS routing for OSI on Ethernet interface 0:
net 39.0001.0000.0c00.1111.00
Related Command
router isis
clns router iso-igrp
Use the clns router iso-igrp interface configuration command to specify ISO-IGRP routing on a specified interface. The no form of this command with the appropriate area tag disables ISO-IGRP on the interface. Use the no form of the global configuration command command with the appropriate tag to disable ISO-IGRP routing for the system.
clns router iso-igrp tag [level 2]
no clns router iso-igrp tag
Syntax Description
tag
|
Meaningful name for routing process. It must be unique among all CLNS router processes for a given router. This tag should be the same as defined for the routing process in the router iso-igrp global configuration command.
|
level 2
|
(Optional) Allows the interface to advertise Level 2 information.
|
Default
ISO-IGRP routing is not specified on any interface.
Command Mode
Interface configuration
Global configuration
Usage Guidelines
If you want this interface to advertise Level 2 information only, use the level 2 keyword. This option reduces the amount of router-to-router traffic by telling the router to send out only Level 2 routing updates on certain interfaces. Level 1 information is not passed on the interfaces for which the Level 2 option is set.
Example
In the following example, the interface advertises Level 2 information only on serial interface 0:
router iso-igrp marketing
net 49.0001.0000.0c00.1111.00
clns router iso-igrp marketing level 2
Related Command
router iso-igrp
clns routing
Use the clns routing global configuration command to enable routing of CLNS packets. Use the no form of this command to disable CLNS routing.
clns routing
no clns routing
Syntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Global configuration
Example
The following example enables routing of CLNS packets:
Related Command
clns security pass-through
clns security pass-through
Use the clns security pass-through global configuration command to allow the router to pass packets that have security options set. Use the no form of this command to disable this function.
clns security pass-through
no clns security pass-through
Syntax Description
This command has no arguments or keywords.
Default
The router discards any packets it sees as set with security options.
Command Mode
Global configuration
Example
The following example allows the router to pass packets that have security options set:
clns security pass-through
Related Command
clns routing
clns send-erpdu
Use the clns send-erpdu interface configuration command to allow CLNS to send an error PDU when the routing software detects an error in a data PDU. To disable this function, use the no form of this command.
clns send-erpdu
no clns send-erpdu
Syntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
When a CLNS packet comes in, the routing software looks in the routing table for the next hop. If it does not find the next hop, the packet is discarded and an error protocol data unit (ERPDU) can be sent.
Example
The following example shows how to allow CLNS to send an error PDU when it detects an error in a data PDU:
Related Command
clns erpdu-interval
clns send-rdpdu
Use the clns send-rdpdu interface configuration command to allow CLNS to send redirect PDUs (RDPDUs) when a better route for a given host is known. To disable this function, use the no form of this command.
clns send-rdpdu
no clns send-rdpdu
Syntax Description
This command has no arguments or keywords.
Default
Enabled
Command Mode
Interface configuration
Usage Guidelines
If a packet is sent out the same interface it came in on, an RDPDU can also be sent to the sender of the packet.
Example
The following example shows how to allow CLNS to send redirect PDUs:
Related Command
clns rdpdu-interval
clns split-horizon
Use the clns split-horizon interface configuration command to implement split horizon for ISO-IGRP updates. The no form of this command disables this feature.
clns split-horizon
no clns split-horizon
Syntax Description
This command has no arguments or keywords.
Default
For all LAN interfaces—enabled
For WAN interfaces on X.25, Frame Relay, or SMDS networks—disabled
Command Mode
Interface configuration
Usage Guidelines
Normally, routers that are connected to broadcast-type OSI networks and that use distance vector routing protocols employ the split-horizon mechanism to prevent routing loops. Split horizon blocks information about routes from being advertised by a router out any interface from which that information originated. This behavior usually optimizes communications among multiple routers, particularly when links are broken. However, with nonbroadcast networks, such as Frame Relay and SMDS, situations can arise for which this behavior is less than ideal. For all interfaces except those for which either Frame Relay or SMDS encapsulation is enabled, the default condition for this command is for split horizon to be enabled.
If your configuration includes either the encapsulation frame-relay or encapsulation smds interface configuration commands, the default is for split horizon to be disabled. Split horizon is not disabled by default for interfaces using any of the X.25 encapsulations.
For networks that include links over X.25 PSNs, the neighbor interface configuration command can be used to defeat the split horizon feature. You can as an alternative explicitly specify the no clns split-horizon command in your configuration. However, if you do so, you must similarly disable split horizon for all routers in any relevant multicast groups on that network.
Split horizon for ISO-IGRP defaults to off for X.25, SMDS, and Frame Relay. Thereby, destinations are advertised out the interface for which the router has a destination.
In general, changing the state of the default for this interface configuration command is not recommended, unless you are certain that your application requires making a change in order to properly advertise routes. Remember that if split horizon is disabled on a serial interface (and that interface is attached to a packet-switched network), you must disable split horizon for all routers in any relevant multicast groups on that network.
Example
In the following example, split horizon is disabled on a serial link connected to an X.25 network:
clns template-alias
Use one or more clns template-alias global configuration commands to build a list of alphanumeric aliases of CLNS address templates for use in the definition of CLNS filter sets. The no form of this command deletes the alias.
clns template-alias name template
no clns template-alias name
Syntax Description
name
|
Alphanumeric name to apply as an alias for the template.
|
template
|
Address template, as defined in the "Usage Guidelines" section.
|
Default
No alias list is defined.
Command Mode
Global configuration
Usage Guidelines
Address templates are "pattern forms" that match one or more CLNS addresses. They can be simple single CLNS addresses, which match just themselves, or contain wildcards, prefixes, and suffixes, allowing a single template to match many addresses.
The simplest address template matches just a single address, as shown in this example:
47.0005.1234.5678.9abc.def0.00
Wildcard digits, which can match any value, are indicated with asterisks (*). The following template matches the above address and any other 12-byte long address that starts with 47.0005.1234.5678:
47.0005.1234.5678.****.****.**
Because OSI addresses are variable in length, it is often useful to build templates that match addresses that share a common prefix. The following template matches any address of any length that begins with the prefix 47.0005.1234.5678:
In other instances, matching a suffix of the address is also important, such as when matching system IDs. The following template matches any address that ends with the suffix 0000.0c01.2345.00:
In other cases, you might want to match addresses on a single-bit granularity, rather than half-byte (four-bit, or nibble) granularity. This pattern matching is supported by allowing the hex digits that represent four bits to be replaced by groups of four binary bits, represented by 0s and 1s. These four binary digits are enclosed within parentheses.