Access Device Commands on a Node

This chapter describes the commands that apply specifically to the Cisco 3800 series of access devices. 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 (such as the Cisco 3810).

The contents in this chapter are as follows:

Introduction
Descriptions of access device procedures
Descriptions of access device commands

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 17-1 shows the name and starting page for the description of each command.

Table 17-1: Access Device Commands

Mnemonic	Description	Page
addad	Add access device	17-3
addcon	Add connection'	17-5
cnfadcmtmr	Configure access device congestion management timer	17-7
cnfadcon	Configure access device connection (bandwidth) parameters	17-9
delad	Delete access device	17-12
dspads	Display (all) access devices	17-14
dspcon	Display a connection	17-16
dspcons	Display connections	17-18
resetad	Reset access device	17-21
restartad	Restart access device protocol handshake	17-22

addad

Adds an access device to a node.

Full Name

Add access device

Syntax

addad [ 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   StrataCom       IPX 16    8.2 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 17-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 17-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:

FTM/FTC and FTM/FTC
FTM/FTC and FRM/FRP
CVM/CDP and FTM/FTC

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:

For FTM/FTC and FTM/FTC endpoints, the connection type is "session."
For FTM/FTC and FRM/FRP endpoints, you specify the type as a frame relay class.
For CVM/CDP and FTM/FTC endpoints, the connection type is "voice."

Full Name

Add a connection

Syntax

The syntax depends on the endpoint cards.

FTM/FTC to FTM/FTC:

addcon

FTM/FTC to FRM/FRP:

addcon

CVM/CDP to FTM/FTC:

addcon [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    StrataCom       IPX 8     8.2 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 17-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 17-5: addcon-Optional Parameters

Parameter	Description
compression algorithm	The optional compression algorithm can be one of the following: a16 a24 a32l16

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

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    StrataCom       IPX 8     8.2 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 17-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

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    StrataCom       IPX 8     8.2 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 17-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.

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

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   StrataCom       IPX 32    8.2 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 17-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:

The IPX or IGX slot and port that connect to each access device
The name of the access device
The access device ID number of the channel between the interface card and the device
The DLCI of the device
The type of access device (such as a Cisco 3810), as reported by the device
The alarm status (which can be OK, init.., or failed)
The setting for the Congestion Management Timer (in 10-millisecond multiples, 0 if the CMT is disabled)
The IP address of the device and the number of bits in the subnet mask

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    StrataCom       IPX 8     8.2 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:

The channel number at both the local and remote ends of the connection
The node name at both ends of the connection
The type or data rate of the connection
The connection priority (low or high)
The preferred route for the connection (if configured)
The status of the front and back cards and access devices associated with the connection
Any Y-cable conflicts (LDI, CDP for example)
If one endpoint is a CDP or CVM, the compression status (VAD on or off, ADPCM on or off
The bandwidth parameters for the connection
The ForeSight enable status
The percent of utilization
The connection descriptor (if configured)
The circuit round trip delay (RTD) if ForeSight is enabled

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

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    StrataCom       IPX 8     8.2 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 17-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 17-10 shows the fields displayed in the dspcons screens.

Table 17-10: Information in the dspcons Display

Fields	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    StrataCom       IPX 8     8.2 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 17-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

Related Commands

restartad, dspads

Attributes

Privilege	1-3
Jobs	Yes
Log	Yes
Node	IPX, IGX
Lock	Yes

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:

You add an access device to the node with addad.
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

Related Commands

resetad, dspads

Attributes

Privilege	1-2
Jobs	Yes
Log	Yes
Node	IPX, IGX
Lock	Yes

restartad-Parameters

Parameter	Description
slot.port	Specifies the slot and port number.

Table of Contents