|
|
This chapter describes the function and displays the syntax for DECnet commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Network Protocols Command Reference, Part 3.
| access-list-number | Integer you choose between 300 and 399 that uniquely identifies the access list. |
| permit | Permits access when there is an address match. |
| deny | Denies access when there is an address match. |
| source | Source address. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All addresses are in decimal. |
| source-mask | Mask to be applied to the address of the source node. All masks are in decimal. |
| destination | (Optional) Destination node's DECnet address in decimal format. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. |
| destination-mask | (Optional) Destination mask. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All masks are in decimal. |
To create an access list that filters connect initiate packets, use this version of the access-list global configuration command. To disable the access list, use the no form of this command.
access-list access-list-number {permit | deny} source source-mask| access-list-number | Integer you choose between 300 and 399 that uniquely identifies the access list. |
| permit | Permits access when there is an address match. |
| deny | Denies access when there is an address match. |
| source | Source address. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All addresses are in decimal. |
| source-mask | Mask to be applied to the address of the source node. All masks are in decimal. |
| destination | (Optional) Destination node's DECnet address in decimal format. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All addresses are in decimal. |
| destination-mask | (Optional) Destination mask. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All masks are in decimal. |
| eq | neq | Use either of these keywords:
· eq--Item matches the packet if all the specified parts of source-object, destination-object, and identification match data in the packet. · neq--Item matches the packet if any of the specified parts do not match the corresponding entry in the packet. |
| source-object | (Optional) Contains the mandatory keyword src and one of the following optional keywords:
· eq | neq | lt | gt--Equal to, not equal to, less than, or greater than. These keywords must be followed by the argument object-number, a numeric DECnet object number. · exp--Stands for expression; followed by a regular expression that matches a string. See the "Regular Expressions" appendix in the Dial Solutions Command Reference for a description of regular expressions. · uic--Stands for user identification code; followed by a numeric user ID (UID) expression.The argument [group, user] is a numeric UID expression. In this case, the bracket symbols are literal; they must be entered. The group and user parts can either be specified in decimal, in octal by prefixing the number with a 0, or in hex by prefixing the number with 0x. The uic expression displays as an octal number. |
| destination-object | (Optional) Contains the mandatory keyword dst and one of the following optional keywords:
· eq | neq | lt | gt--Equal to, not equal to, less than, or greater than. These keywords must be followed by the argument object-number, a numeric DECnet object number. · exp--Stands for expression; followed by a regular expression that matches a string. See the "Regular Expressions" appendix in the Dial Solutions Command Reference for a description of regular expressions. · uic--Stands for user identification code; followed by a numeric user ID (UID) expression. In this case, the bracket symbols are literal; they must be entered. The group and user parts can either be specified in decimal, in octal by prefixing the number with a 0, or in hex by prefixing the number with 0x. The uic expression displays as an octal number. |
| identification | (Optional) Uses any of the following three keywords:
· id--Regular expression; refers to user ID. · password--Regular expression; the password to the account. · account--Regular expression; the account string. |
| any | (Optional) Item matches if any of the specified parts do match the corresponding entries for source-object, destination-object, or identification. |
To create a standard access list, use the standard version of the access-list global configuration command. To delete the entire access list, use the no form of this command.
access-list access-list-number {permit | deny} source source-mask| access-list-number | Integer you choose between 300 and 399 that uniquely identifies the access list. |
| permit | Permits access when there is an address match. |
| deny | Denies access when there is an address match. |
| source | Source address. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All addresses are in decimal. |
| source-mask | Mask to be applied to the address of the source node. Bits are set wherever the corresponding bits in the address should be ignored. All masks are in decimal. |
Use the clear decnet accounting EXEC command to delete all entries in the accounting database when DECnet accounting is enabled.
clear decnet accounting [checkpoint]| checkpoint | (Optional) Clears the checkpoint database. |
To clear DECnet counters that are shown in the output of the show decnet traffic EXEC command, use the clear decnet counters EXEC command.
clear decnet countersTo create a DECnet access group, use the decnet access-group interface configuration command.
decnet access-group access-list-number| access-list-number | Either a standard or extended DECnet access list. A standard DECnet access list applies to source addresses. The value (or values in the case of extended lists) can be in the range 300 to 399. |
To enable DECnet accounting, use the decnet accounting interface configuration command. To disable DECnet accounting, use the no form of this command.
decnet accountingUse the decnet accounting list global configuration command to specify the source and destination address pairs for which DECnet accounting information is kept. DECnet accounting tracks all traffic that traverses the router between the source and destination address pairs specified with this command. To remove the accounting filter, use the no form of this command.
decnet accounting-list src-dec-address dest-dec-address| src-dec-address | DECnet address for the source. The address is in the form area.node, for example, 5.3. |
| dest-dec-address | DECnet address for the destination. The address is in the form area.node, for example, 5.3. |
| all | Disables DECnet accounting for all source and destination address pairs specified previously with the decnet accounting list command. |
To set the maximum number of accounting database entries, use the decnet accounting threshold global configuration command. To restore the default, use the no form of this command.
decnet accounting threshold threshold| threshold | Maximum number of entries (source and destination address pairs) that the Cisco IOS software can accumulate. |
To set the maximum number of transit entries that will be stored in the DECnet accounting database, use the decnet accounting transits global configuration command. To disable this function, use the no form of this command.
decnet accounting transits count| count | Number of transit entries that will be stored in the DECnet accounting database. |
To configure border routers to propagate Phase IV areas through an OSI backbone, use the decnet advertise global configuration command. To disable this feature, use the no form of this command.
decnet advertise decnet-area hops cost| decnet-area | Phase IV area that you want propagated. |
| hops | Hop count to be associated with the route being advertised. Default is 0. |
| cost | Cost to be associated with the route being advertised. Default is 0. |
To set the maximum cost specification value for interarea routing, use the decnet area-max-cost global configuration command.
decnet [network-number] area-max-cost value| network-number | (Optional) Network number from 0 to 3. Specified when using Address Translation Gateway (ATG). If not specified, the default is network 0. |
| value | Maximum cost for a route to a distant area that the Cisco IOS software may consider usable; the software treats as unreachable any route with a cost greater than the value you specify. A valid range for cost is 1 to 1022. This parameter is only valid for area routers. The default is 1022. |
To set the maximum hop count value for interarea routing, use the decnet area-max-hops global configuration command.
decnet [network-number] area-max-hops value| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| value | Maximum number of hops for a usable route to a distant area. The Cisco IOS software treats as unreachable any route with a count greater than the value you specify. A valid range for the hop count is 1 to 30. The default is 30 hops. |
To set the congestion- experienced bit if the output queue has more than the specified number of packets in it, use the decnet congestion-threshold interface configuration command. To remove the parameter setting and set it to 0, use the no form of this command.
decnet congestion-threshold number| number | Number of packets that are allowed in the output queue before the system sets the congestion experience bit. This value is an integer between 0 and 0x7fff. The value zero prevents this bit from being set. Only relatively small integers are reasonable. The default is 1 packet. |
To allow Phase IV routers (running Cisco Release 9.1 or higher) to run in a Phase V network and vice versa, enable conversion with the decnet conversion global configuration command. To disable conversion, use the no form of this command.
decnet conversion nsap-prefix| nsap-prefix | Value used for the IDP field when constructing NSAPs from a Phase IV address. |
To set a cost value for an interface, use the decnet cost interface configuration command. To disable DECnet routing for an interface, use the no form of this command.
decnet cost cost-value| cost-value | Integer from 1 to 63. There is no default cost for an interface, although a suggested cost for FDDI is 1, for Ethernet is 4, and for serial links is greater than 10. |
To provide DECnet encapsulation over Token Ring, use the decnet encapsulation interface configuration command.
decnet encapsulation {pre-dec | dec}| pre-dec | Configures routers for operation on the same Token Ring with routers running software versions prior to Cisco IOS Release 9.1. In this mode, Cisco routers cannot communicate with non-Cisco equipment. Referred to as Cisco-style encapsulation. |
| dec | Provides encapsulation that is compatible with other Digital equipment. All Cisco routers must be running Cisco IOS Release 9.1 or later. |
To change the interval for sending broadcast hello messages, use the decnet hello-timer interface configuration command. To restore the default value, use the no form of this command.
decnet hello-timer seconds| seconds | Interval at which the Cisco IOS software sends hello messages. It can be a decimal number in the range 1 to 8191 seconds. The default is 15 seconds. |
To associate a name-to-DECnet address mapping, use the decnet host global configuration command, which shows up in the output of various commands. To disable name mapping, use the no form of this command.
decnet host name decnet-address| name | A name you choose that uniquely identifies this DECnet address. |
| decnet-address | Source address. DECnet addresses are written in the form area.node. For example, 50.4 is node 4 in area 50. All addresses are in decimal. |
To provide access control to hello messages or routing information received on an interface, use the decnet in-routing-filter interface configuration command. To remove access control, use the no form of this command.
decnet in-routing-filter access-list-number| access-list-number | Standard DECnet access list. This list applies to source addresses. The value can be in the range 300 to 399. |
To establish an address translation for selected nodes, use the decnet map global configuration command.
decnet first-network map virtual-address second-network real-address| first-network | DECnet network numbers in the range 0 to 3. |
| virtual-address | Numeric DECnet address (10.5, for example). |
| second-network | DECnet network number you map to; DECnet numbers range 0 to 3. |
| real-address | Numeric DECnet address (10.5, for example). |
To configure the Cisco IOS software with a maximum number of node addresses, use the decnet max-address global configuration command.
decnet [network-number] max-address value| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| value | A number less than or equal to 1023 that represents the maximum address possible on the network. In general, all routers on the network should use the same value for this argument. The default is 1023. |
To set the largest number of areas that the Cisco IOS software can handle in its routing table, use the decnet max-area global configuration command.
decnet [network-number] max-area area-number| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| area-number | Area number from 1 to 63. Like the decnet max-address global configuration command value, this argument controls the sizes of internal routing tables and of messages sent to other nodes. All routers on the network should use the same maximum address value. The default is 63. |
To set the maximum cost specification for intra-area routing, use the decnet max-cost global configuration command.
decnet [network-number] max-cost cost| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| cost | Cost from 1 to 1022. The default is 1022. |
To set the maximum hop count specification value for intra-area routing, use the decnet max-hops global configuration command.
decnet [network-number] max-hops hop-count| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| hop-count | Hop count from 1 to 30. The Cisco IOS software ignores routes that have a hop count greater than the corresponding value of this parameter. The default is 30 hops. |
To define the maximum number of equal-cost paths to a destination that the Cisco IOS software keeps in its routing table, use the decnet max-paths global configuration command.
decnet [network-number] max-paths value| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| value | Decimal number equal to the maximum number of equal-cost paths the software will save. The valid range is 1 to 31. The default is 1. |
To set the limit on the number of times a packet can pass through a router, use the decnet max-visits global configuration command.
decnet [network-number] max-visits value| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| value | Number of times a packet can pass through a router. It can be a decimal number in the range 1 to 63. If a packet exceeds value, the Cisco IOS software discards the packet. Digital recommends that the value of the max-visits parameter be at least twice that of the max-hops parameter, to allow packets to still reach their destinations when routes are changing. The default is 63 times. |
To specify a mapping between DECnet multicast addresses and Token Ring functional addresses, other than the default mapping, use the decnet multicast-map interface configuration command. To delete the specified information, use the no form of this command.
decnet multicast-map multicast-address-type functional-address| multicast-address-type | Type of multicast address that is used. The following are valid values for the argument:
· iv-all-routers (All Phase-IV routers) · iv-all-endnodes (All Phase-IV end nodes) · iv-prime-all-routers (All Phase IV Prime routers) |
| functional-address | Functional MAC address to which this multicast ID maps; in the form of "c000.xxxx.yyyy." |
To specify the node type, use the decnet node-type global configuration command.
decnet [network-number] node-type {area | routing-iv}| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| area | Router participates in the DECnet routing protocol with other area routers, as described in the Digital documentation, and routes packets from and to routers in other areas. This is sometimes referred to as Level 2 (or interarea) routing. An area router does not just handle interarea routing, it also acts as an intra-area or Level 1 router in its own area. |
| routing-iv | Router acts as an intra-area (standard DECnet Phase IV, Level 1 router) and ignores Level 2 routing packets. In this mode, it routes packets destined for other areas to a designated interarea router, exchanging packets with other end nodes and routers in the same area. |
To provide access control to routing information being sent out on an interface, use the decnet out-routing-filter interface configuration command. To remove access control, use the no form of this command.
decnet out-routing-filter access-list-number| access-list-number | Standard DECnet access list applying to source addresses. The value can be in the range 300 to 399. |
To specify how the Cisco IOS software splits the routable packets between equal-cost paths, use the decnet path-split-mode global configuration command with the appropriate keyword.
decnet path-split-mode {normal | interim}| normal | Normal mode, where equal-cost paths are selected on a round-robin basis. This is the default. |
| interim | Traffic for any particular (higher-layer) session is always routed over the same path. This mode supports older implementations of DECnet (VMS Versions 4.5 and earlier) that do not support out-of-order packet caching. Other sessions may take another path, thus using equal-cost paths that a router may have for a particular destination. |
To enable static route propagation, use the decnet propagate static global configuration command. To disable propagation, use the no form of this command.
decnet propagate staticTo create an interface static route, use this version of the decnet route global configuration command. To remove this route, use the no form of this command.
decnet route decnet-address next-hop-type number [snpa-address] [hops [cost]]| decnet-address | DECnet address. This value is entered into a static routing table and used to match a destination DECnet address. Use a node address value of 0 to specify an area static route. |
| next-hop-type | Interface type. |
| number | Interface number. |
| snpa-address | (Optional) Optional for serial links; required for multiaccess networks. |
| hops | (Optional) Hop count to be associated with the route being advertised. Default is 0. |
| cost | (Optional) Cost to be associated with the route being advertised. Default is 0. |
To enter a specific static route, use this version of the decnet route global configuration command. DECnet addresses that match are forwarded to the next-hop-address. To remove this route, use the no form of this command.
decnet route decnet-address next-hop-address [hops [cost]]| decnet-address | DECnet address. This value is entered into a static routing table and used to match a destination DECnet address. Use a node address value of 0 to specify an area static route. |
| next-hop-address | This value is used to establish the next hop of the route for forwarding packets. |
| hops | (Optional) Hop count to be associated with the route being advertised. Default is 0. |
| cost | (Optional) Cost to be associated with the route being advertised. Default is 0. |
To create an interface default route, use this version of the decnet route default global configuration command. Use the no form of this command to remove this route.
decnet route default next-hop-type number [snpa-address] [hops [cost]]| next-hop-type | Interface type. |
| number | Interface number. |
| snpa-address | (Optional) Optional for serial links; required for multiaccess networks. |
| hops | (Optional) Hop count to be associated with the route being advertised. Default is 0. |
| cost | (Optional) Cost to be associated with the route being advertised. Default is 0. |
To enter a specific default route, use this version of the decnet route default global configuration command. To remove this route, use the no form of this command.
decnet route default next-hop-address [hops [cost]]| next-hop-address | This value is used to establish the next hop of the route for forwarding packets. |
| hops | (Optional) Hop count to be associated with the route being advertised. Default is 0. |
| cost | (Optional) Cost to be associated with the route being advertised. Default is 0. |
To enable fast switching, use the decnet route-cache interface configuration command. To disable fast switching, use the no form of this command.
decnet route-cacheTo elect a designated router to which packets are sent when no destination is specified, use the decnet router-priority interface configuration command.
decnet router-priority value| value | Priority of the router. This can be a number in the range 0 to 127. The larger the number the higher the priority. The default priority is 64. |
To enable DECnet routing, use the decnet routing global configuration command. To disable DECnet routing, use the no form of this command.
decnet [network-number] routing [iv-prime] decnet-address| network-number | (Optional) Network number in the range 0 to 3. Specified when using ATG. If not specified, the default is network 0. |
| iv-prime | (Optional) Enables DECnet Phase IV Prime routing. |
| decnet-address | Address in DECnet format X.Y, where X is the area number and Y is the node number. |
To specify how often the Cisco IOS software sends routing updates that list the hosts that the router can reach, use the decnet routing-timer interface configuration command. Use the no form of this command to disable the routing update timer.
decnet routing-timer seconds| seconds | Time, in seconds, from 1 to 65535. The default is 40 seconds. |
To use split horizon when sending routing updates, use the decnet split-horizon interface configuration command. To disable split horizon, use the no form of this command.
decnet split-horizonTo set the delayed acknowledgment for incoming LAT slave connections, use the lat host-delay global configuration command. To restore the default, use the no form of this command.
lat host-delay number| number | Delay in milliseconds. |
To associate a command with a service, use the lat service autocommand global configuration command. To remove the specified autocommand, use the no form of this command.
lat service service-name autocommand command| service-name | Name of the service. |
| command | Command to be associated with the service. |
To send DECnet echo packets to test the reachability of a remote host over a DECnet network, use the DECnet ping privileged EXEC command.
pingTo send DECnet echo packets to test the reachability of a remote host over a DECnet network, use the ping user EXEC command.
ping decnet {host | address}| decnet | DECnet protocol keyword. |
| host | DECnet host of system to ping. |
| address | DECnet address of system to ping. |
To display the global DECnet parameters, use the show decnet privileged EXEC command.
show decnetTo display the active accounting or checkpointed database, use the show decnet accounting EXEC command.
show decnet accounting [checkpoint]| checkpoint | (Optional) Displays entries in the checkpoint database. |
To display the global DECnet status and configuration for all interfaces, or the status and configuration for a specified interface, use the show decnet interface EXEC command.
show decnet interface [type number]| type | (Optional) Interface type. |
| number | (Optional) Interface number. |
To display the address mapping information used by the DECnet Address Translation Gateway, use the show decnet map EXEC command.
show decnet mapTo display all Phase IV and Phase IV Prime adjacencies and the MAC address associated with each neighbor, use the show decnet neighbors privileged EXEC command.
show decnet neighborsTo display the DECnet routing table, use the show decnet route EXEC command.
show decnet route [decnet-address]| decnet-address | (Optional) DECnet address and, when specified, the first hop route to that address is displayed. |
To display all statically configured DECnet routes, use the show decnet static privileged EXEC command.
show decnet staticTo show the DECnet traffic statistics (including datagrams sent, received, and forwarded), use the show decnet traffic EXEC command.
show decnet traffic
|
|