cc/td/doc/product/wanbu/bpx8600/8_5
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Access Device Commands on a Node

Access Device Commands on a Node


This chapter describes the commands that apply specifically to the Cisco access devices (such as the Cisco 3801). The commands in this chapter apply to the trunk between the FTC or FTM card set in an IPX or IGX node and an access device.

The contents in this chapter are as follows:

In addition to commands that are unique to the Cisco access devices, a larger number of commands are common to the Cisco access devices and the FastPAD series of access devices. The descriptions for these common commands appear on-line in the 8.2 FastPAD User's Guide in the section titled "FastPAD Connections."

The commands you enter at the terminal attached to the access device itself are IOS commands. Refer to the documentation for the access device for descriptions of the IOS commands.

Introduction

This chapter describes the commands that apply to an access device. When you use other, common commands such as addcon, dspcon, cnfchutl, and so on, use the following syntax to, for example, specify the access device when adding a connection:

addcon slot.port.connection_ID,

where slot.port.connection_ID is the slot and port number of the FTC or FTM and connection_ID is the connection identifier.

Summary of Commands

Table 15-1 shows the name and starting page for the description of each command.


Table 15-1: Access Device Commands
Command Full Name Page

addad

Add access device

15-4

addcon

Add connection`

15-6

cnfadcmtmr

Configure access device congestion management timer

15-8

cnfadcon

Configure access device connection (bandwidth) parameters

15-10

delad

Delete access device

15-13

dspads

Display (all) access devices

15-15

dspcon

Display a connection

15-17

dspcons

Display connections

15-19

resetad

Reset access device

15-22

restartad

Restart access device protocol handshake

15-23

addad

Adds an access device to a node.

Full Name

Add access device

Syntax

addad <slot.port> <access_device_ID> <DLCI> [ IP address ] [ number of mask bits]

Related Commands

dspads

Attributes

Privilege

1-2

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

addad 12.3 3 990 0

Description

Add an access device at slot 12, port 3. The access device ID is 3. The DLCI is 990.

System Response
duvel TRM SuperUser IPX 16 8.5 Mar. 28 1997 08:19 GMT Access Devices Information Slot.Port Name ID DLCI Type Alarm IP Address 12.1 7 990 UNREACHABLE 12.3 sbrin02 3 990 3800 OK 192.168.6.162/24 Last Command: dspads This Command: addad 12.2 4 990 Enter Cong Mgmt. Timer (0=Disabled or 4-350 in 10ms units): 0 Last Command: addad 12.3 3 990 Next Command:
Table 15-2: addad-Parameters
Parameter Description

slot.port

Specifies the slot and port number of the trunk to add.

access_device_ID

Device ID of the access device. The range for the ID is 0-255.

DLCI

The available range is 16-1007.


Table 15-3: addad-Optional Parameters
Parameter Description

IP address

The IP address of the access device is optional. If you enter an IP address, it overrides the IP address that currently exists on the access device.

number of mask bits

The number of bits in the IP subnet mask.

addcon

Adds a connection between an access device and another endpoint. You add connections between the following endpoints:

Note that, if one end of the connection is a CVM or CDP, you must add the connection at the CVM/CDP.

Three connection types are possible for an access device. After you have specified the local and remote connection identifiers, the interface prompts you for a connection type. The type depends on the endpoint cards, as follows:

Full Name

Add a connection

Syntax

The syntax depends on the endpoint cards.

FTM/FTC to FTM/FTC:

addcon <slot.port.connection_ID> <remote node> <slot.port.connection_ID>

FTM/FTC to FRM/FRP:

addcon <slot.port.connection_ID> <remote node> <slot.port.DLCI>

CVM/CDP to FTM/FTC:

addcon <slot.port> <remote node> <slot.port.connection_ID> [compression algorithm]

Related Commands

dspads

Attributes

Privilege

1-2

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

addcon 4.3.31 sw25 4.1.31

Description

Add a local connection from 4.3.31 to 4.1.31.

System Response
sw25 TN SuperUser IPX 8 8.5 May 26 1997 00:26 GMT From Remote Remote 4.3.31 NodeName Channel State Type Compress Code COS 4.3.31 sw25 4.1.31 Ok session 4.3.32 sw25 4.1.32 Ok fst 4.3.33 sw25 4.1.33 Ok fst This Command: addcon 4.3.31 sw25 4.1.31 session Add these connections (y/n)?
Table 15-4: addcon-Parameters
Parameter Description

slot.port

Specifies the slot and port number of the trunk to add.

connection_ID

Specifies a connection identifier. The range for the connection_ID is 1-252.

DLCI (only for FRP
or FRM endpoints)

The available range is 16-1007.


Table 15-5: addcon-Optional Parameters
Parameter Description

compression
algorithm

The optional compression algorithm can be one of the following:

  • a16

  • a24

  • a32

cnfadcmtmr

Configures the congestion management timer. The timer is applicable only if ForeSight is active.

The configuration management timer specifies how often rate-adjustment messages are passed between the FTC or FTM and the access device. This timer mechanism lets the congestion management provided by ForeSight extend to access devices. If you enter a 0 for the value, the interface card and device do not exchange rate adjustment messages.

Full Name

Configure access device congestion management timer

Syntax

cnfadcmtmr <slot.port> <Cong. Mgmt. Timer>

Related Commands

addad, dspads

Attributes

Privilege

1

Jobs

No

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

cnfadcmtmr 4.3 350

Description

Configure the congestion management timer for port 3 of the card in slot 4 for 350 milliseconds.

System Response
sw25 TN SuperUser IPX 8 8.5 Apr. 1 1997 11:17 GMT FrontCard BackCard Type Rev Type Rev Status 1 NPC BFF Active 2 Empty reserved for NPC 3 CDP BFC E1 AD Active 4 FTC CF15 FPC-V35 AA Active 5 AIT AJF AIT-T3 AE Active 6 NTC EUJ E1 AN Active 7 Empty 8 FTC BHJ FPC-V35 AA Standby This Command: cnfadcmtmr 4.3 Enter Cong Mgmt. Timer (0=Disabld or 40-350 in 10ms units): 350
Table 15-6: cnfadcmtmr-Parameters
Parameter Description

slot.port

Specifies the slot and port number.

Cong. Mgmt. Timer

The setting for the timer. The number you enter is actually a multiplier for the base of 10 milliseconds, so the granularity is automatically 10 milliseconds. The range for the multiplier is 4-350, so the range for the timer is 40-3500 milliseconds.

The default (no user-input) is 100 ms.

To disable the timer, enter a 0.

cnfadcon

Configures bandwidth parameters for the trunk connection between an access device and the FTC or FTM. The parameters for cnfadcon are bi-directional. (Type a slash between the parameter for each direction.) The first parameter is from the node to the access device. The second parameter is from the access device to the node. An asterisk (*) indicates that the value is to remain unchanged for that direction. The only parameter that is not bi-directional is FST (ForeSight enable = "y" or "n").

The command line interface does not prompt for individual bandwidth parameters. Therefore, refer to the cnfadcon options table to see the order in which you type the parameters.

Full Name

Configure access device connection

Syntax

cnfadcon <slot.port> <bw_parameters>

Related Commands

dspcon, cnffrcon, cnfcon

Attributes

Privilege

1-2

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

cnfadcon 4.2 76.8/76.8

Description

Configure the device trunk at port 2 of the card in slot 4 to have MIR (and so on) of 76.8 Kbps.

System Response
sw25 TN SuperUser IPX 8 8.5 Apr. 2 1997 18:44 GMT Conn: 4.2.100 ] sw25 4.3.101 session 76 Kbps Status:OK MIR CIR VC Q Depth PIR Cmax ECN QThresh QIR 76.8/76.8 76.8/76.8 600/600 76.8/76.8 1/1 300/300 76.8/76.8 Priority: H TestRTD: 0 msec FST: n % Util: 100/100 Path: Route information not applicable for local connections sw25 FTC: OK sw25 FTC: OK FPC: OK FPC: OK Access Device: OK Access Device: OK Last Command: cnfadcon 4.2.100 76.8/76.8 Next Command:
Table 15-7: cnfadcon-Parameters
Parameter Description

slot.port

Specifies the slot and port on an FTC/ FTM for an access device connection.

bw_parameters

The bandwidth parameters are as follows:

  • MIR/MIR is defined as fr_MIR_Tx /fr_MIR_Rx, where fr_MIR is the minimum information rate for a connection. The range is 2.4 Kbps-2048 Kbps.

  • CIR/CIR is defined as fr_CIR_Tx and fr_CIR_Rx, where fr_CIR is defined as the committed information rate guaranteed to the user. The CIR range is
    2.4 Kbps-2048 Kbps.

  • VC_Q/VC_Q is defined as fr_vc_q_Tx/fr_vc_q_Rx, where fr_vc_q Tx is the maximum transmit VC queue depth. The VC_Q range is 1-65535 bytes. (An alternative to this parameter is possible, as the description of Bc shows.)

    or

    Bc/Bc is defined as fr_Bc_Tx /fr_Bc_Rx. Bc has meaning for only ForeSight connections. If you have selected Frame Relay Forum standard parameters (through the cnfsysparm command), the Committed Burst (Bc) parameter appears instead of VC_Q. Bc is the amount of data the network can accept over a variable time interval (Tc) for committed delivery on a specific PVC. The range for Bc is 1-65535 bytes. The relationship between Bc and VC_Q is:

    Bc = VC_Q / ((1 - (CIR/port speed))

  • PIR/PIR is defined as fr_PIR_Tx /fr_PIR_Rx, where fr_PIR_Tx is the peak transmit rate for the PVC. The PIR range is 2.4-2048 Kbps. You can also specify the value 0 to cause PIR to default to the port speed. Thus, you can modify PIR, leave it the same, or set it to the port speed. (An alternative specification for this parameter is possible, as the description of Be shows.)

    or

    Be/Be is defined as fr_Be_Tx /fr_Be_Rx. If you have selected Frame Relay Forum standard parameters (through the cnfsysparm command), the PVC uses Excess Burst (Be) instead of PIR. Be is the amount of transmit/receive data above the number of bytes set by Bc if enough bandwidth is available. Specify Be in bytes within the range 1-65535. Delivery of Be-data is not guaranteed. Be has meaning to only ForeSight. The relationship between Be and PIR is:

    Be = Bc * ((PIR/CIR) - 1)

  • Cmax/Cmax is defined as fr_cmax_Tx /fr_cmax_Rx, where cmax is the maximum credits the connection can accrue. The Cmax range is 1-255 packets per second (pps).

  • ECNQ_thresh/ECNQ_thresh are the transmit and receive threshold settings for the explicit congestion notification control queues. The range for ECNQ_thresh is 1-65535 bytes.

  • QIR/QIR is defined as fr_QIR_Tx /fr_QIR_Rx, where fr_QIR is the quiescent information rate for a connection, which is the initial transmit rate after a period of inactivity on the channel. If you do not specify the quiescent receive rate fr_QIR_Rx, the system sets it to the transmit value. The values are specified in Kbps and must be in the range MIR-PIR. In addition, you can specify the value 0 to default to the MIR. QIR has meaning for only ForeSight connections.

  • FST enables or disables (purchased) ForeSight option for a connection. Valid entries are "y" (use ForeSight) or "n" (do not use ForeSight). If the ForeSight status changes, the network reroutes the connection.

delad

Deletes an access device from a node. Before you can delete an access device, you must remove all connections from the device by using the delcon command.

Full Name

Delete access device

Syntax

delad <slot.port>

Related Commands

addad, dspads

Attributes

Privilege

1-2

Jobs

No

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

delad 31.1

Description

Delete the access device at 31.1.

System Response
IPX TRM SuperUser IPX 32 8.5 Date/Time Not Set Access Device Information Slot.Port Name ID DLCI Port_ID Alarm 31.1 ad1 1 17 0 OK 31.2 ad2 2 18 0 OK 31.3 ad3 3 19 0 OK 31.4 ad4 4 20 0 OK This Command: delad 31.1 Delete access device (y/n)?
Table 15-8: delad-Parameters
Parameter Description

slot.port

Specifies the slot and port number.

dspads

Displays all access devices in the node. The dspads command takes no parameters. The displayed information consists of the following:


Note If an access device name and IP address are not relevant, such as when an FTC/FTM port loopback is simulating access devices, blank spaces appear in the "Name," "Type," and "IP Address" fields of the display.
Full Name

Display (all) access devices

Syntax

dspads

Related Commands

addad, delad, cnfadcmtmr

Attributes

Privilege

1-2

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes

Example 1

dspads

Description

Display all the access devices in the current node.

System Response
sw25 TN SuperUser IPX 8 8.5 Apr. 1 1997 13:12 GMT Access Devices Information Slot.Port Name ID DLCI Type Alarm CMT IP Address 4.2 8 990 OK 0 4.3 sbrin01 4 990 3800 OK 91 192.168.6.161/24 Last Command: dspads Next Command:

dspcon

Displays connection information for a connection. The information displayed includes:

A failure that affects the connection flashes on the screen. The possible status messages are:

· OK

Connection OK.

· FAILED

Connection failed.

Full Name

Display connections

Syntax

dspcon <channel>

Related Commands

addcon, cnfcondsc, cnfcos, cnfpref, dspcons

Attributes

Privilege

1-6

Jobs

No

Log

No

Node

IPX, IGX

Lock

No

Example 1

dspcon 4.1.33

Description

Display connection information for frame relay channel 4.1.33.

System Response
sw25 TN SuperUser IPX 8 8.5 May 25 1997 23:07 GMT Conn: 4.1.33 sw25 4.3.33 fst Status:OK MIR CIR VC Q Depth PIR Cmax ECN QThresh QIR 56/56 56/56 65535/65535 512/512 10/10 65535/65535 128/128 Priority: L ForeSightRTD: 40 msec TestRTD: 0 msec FST: y % Util: 100/100 Path: Route information not applicable for local connections sw25 FTC: OK sw25 FTC: OK FPC: OK FPC: OK Access Device: OK Access Device: OK Last Command: dspcon 4.1.33 Next Command:
Table 15-9: dspcon-Parameters
Parameter Description

channel

Specifies the channel in the format slot.port.connection_ID. The range for connection_ID is 1-252. The dspcon command displays information for one connection at a time.

dspcons

Displays a summary of the connections on an IPX or IGX node. Table 15-10 shows the fields displayed in the dspcons screens.


Table 15-10: Information in the dspcons Display
Field Description

Local Channel

The connection's channel at this node.

Remote Node Name

The name of the node at the other end of the connection.

Remote Channel

The connection's channel at the remote node.

State

The state of the connection(s) as follows:

  • OK Routed

  • Down Downed

  • OK Downed Waiting for onhook to occur to allow courtesy down to take
    place for connection(s) that have been courtesy downed using the dncon command.

  • Failed Unrouted, but trying

Type

The type of connection (v = voice, d = data, fr = frame relay, atfr = ATM to frame relay interworking, atfst = ATM to frame relay interworking with ForeSight, -fail = failed connections; data rate in kbps for data)

Route Avoid

The type of lines to avoid when routing (satellite lines, terrestrial lines, lines with zero code suppression).

Compression

The type of compression applied to the connection (PCM, PCM and VAD, ADPCM, VAD and ADPCM for voice connections), (DFM for data connections).

COS

The Class of Service.

Owner

The end of the connection in control of re-routing.

Descriptor

The connection descriptor string (if +d option specified).

Loopback

A connection with a local loopback is indicated by a right parenthesis symbol between the "Local Channel" and "Remote NodeName" columns. A frame relay connection with a port loopback is indicated by a right bracket symbol between the "Local Channel" and "Remote NodeName" columns. A connection with a remote loopback is indicated by a right parenthesis symbol before the channel number in the "Remote Channel" column.

Local/Remote A-bit

A-bit status on the local and remote nodes if -abit option selected. Note that -abit is incompatible with -v, -d, and +d.

Full Name

Display connections

Syntax

dspcons [start_channel] [nodename] [state] [type]
[-g | +d | -v | -d | -f | -abit | -fabit | -atfr | -siw | -fail | -down]]

Related Commands

addcon, cnfchadv, chfchdfm, cnfcondsc

Attributes

Privilege

1-6

Jobs

No

Log

No

Node

IPX, IGX

Lock

No

Example 1

dspcons

Description

Display a summary of all connections.

System Response
sw25 TN SuperUser IPX 8 8.5 May 25 1997 23:29 GMT Local Remote Remote Channel NodeName Channel State Type Compress Code COS 4.1.32 sw25 4.3.32 Ok fst 4.1.33 sw25 4.3.33 Ok fst 4.3.32 sw25 4.1.32 Ok fst 4.3.33 sw25 4.1.33 Ok fst Last Command: dspcons Next Command:
Table 15-11: dspcons-Optional Parameters
Parameter Description

start channel

Specifies the channel to begin the display. The start channel on a CDP or CVM is specified as slot.channel.The start channel on a UVM is slot.line.channel.

node name

Specifies that only connections to this remote node from the local note be displayed. If no "nodename" is designated, connections from the local node to all other nodes are displayed.

connection type

Specifies that only connections of a certain type be displayed. If you do not add at least one argument to specify a particular connection type, all connections appear. When you enter the connection type on the command line, precede it with a hyphen (-). In some cases, you can add more than one connection type (with a space between), but not all compound arguments are compatible, so you may not always see the expected combination of types. The connection types are:

-v displays only voice connections.

-d displays only data connections.

-f displays only frame relay connections.

-abit shows A-bit (nni) status.

-fabit shows connections with failed A-bit (nni) status.

-fail shows only failed connections

-g shows only grouped connections

-siw shows service interworking connections.

-atfr shows only network interworking connections.

+d

Causes the display to show the user-configured descriptor for the connection instead of the compression and ownership fields.

resetad

Directs an access device to reset itself from a node terminal. The reset initiated by resetad is a cold-boot start of the access device. (The restartad command re-initiates the control session between the node and the access device.)

Full Name

Reset access device

Syntax

resetad <slot.port>

Related Commands

restartad, dspads

Attributes

Privilege

1-3

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes


Table 15-12: delad-Parameters
Parameter Description

slot.port

Specifies the slot and port number that connects to the access device.

restartad

Restarts an access device session from a node's command terminal. The restartad command restarts the control session of an access device on an IPX or IGX node. A control session is first established when the following conditions are true:

    1. You add an access device to the node with addad.

    2. The port speed and other parameters on the device and the port match.

Once a control session is established, you can configure and manage the access device by commands you issue at the node. These commands are the access device commands in this chapter and the other, common commands in this manual.

The restartad command does not perform a hard reset of the access device itself. See resetad regarding a hard reset of the access device.

Full Name

Restart access device

Syntax

restartad <slot.port>

Related Commands

resetad, dspads

Attributes

Privilege

1-2

Jobs

Yes

Log

Yes

Node

IPX, IGX

Lock

Yes


Table 15-13: restartad-Parameters
Parameter Description

slot.port

Specifies the slot and port number.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jan 17 21:40:40 PST 2001
All contents are Copyright © 1992--2001 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.