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 IGX node and an access device.

The contents in this chapter are as follows:

•Introduction

•Descriptions of access device procedures

•Descriptions of access device commands

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, 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-2
addcon	Add connection	15-3
cnfadcmtmr	Configure access device congestion management timer	15-6
cnfadcon	Configure access device connection (bandwidth) parameters	15-7
delad	Delete access device	15-10
dspads	Display (all) access devices	15-11
dspcon	Display a connection	15-13
dspcons	Display connections	15-15
resetad	Reset access device	15-18
restartad	Restart access device protocol handshake	15-19

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	Jobs	Log	Node	Lock
1-2	Yes	Yes	IPX, IGX	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       IGX 8420    9.2 Mar. 28 1998 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:

•UVM and FTM/FTC

•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 UVM and FTM/FTC endpoints, and CVM/CDP and FTM/FTC endpoints, the connection type is "voice."

•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.

Full Name

Add a connection

Syntax

The syntax depends on the endpoint cards.

UVM to FTM/FTC:

addcon <slot.line.channel> <node> <slot.port>.<Access Device ID>.<Connection ID>
<Algorithm = a32 | c32 | g729r8 | g729r8v | g729ar8 | g729ar8v>

FTM/FTC to FTM/FTC:

addcon <slot.port>.<Access Device ID>.<Connection ID> <remote node> <slot.port>.<Access Device ID>.<Connection ID>

FTM/FTC to FRM/FRP:

addcon <slot.port>.<Access Device ID>.<Connection ID> <remote node> <slot.port>.<DLCI>

CVM/CDP to FTM/FTC:

addcon <slot.port> <remote node> <slot.port>.<Access Device ID>.<Connection ID>[compression algorithm]

Related Commands

dspads

Attributes


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

Example 1

addcon 4.3.5.31 sw25 4.1.5.31

Description

Add a local connection from 4.3.5.31 to 4.1.5.31. The access device ID is 5, the connection ID is 31.

System Response

sw25           TN    SuperUser       IGX 8410     9.2 May  26 1998 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.5.31 sw25 4.1.5.31 session

Add these connections (y/n)?

Table 15-4 addcon—Parameters
Parameter	Description
slot.port slot.line.channel	Specifies the slot and port number of the trunk to add. (FTM/FRM) Specifies the slot, line, and channel number of the trunk to add. (UVM/CVM)
access device_ID	Specifies the access device ID number. The range for the access device_ID is 1-255.Access devices on the same trunk are assigned in increasing order.
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 •g729r8 •g729r8v •g729ar8 •g729ar8v

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	Jobs	Log	Node	Lock
1	No	Yes	IPX, IGX	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       IGX 8410     9.2 Apr. 1 1998  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 milliseconds. 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 bidirectional. (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 bidirectional 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	Jobs	Log	Node	Lock
1-2	Yes	Yes	IPX, IGX	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       IGX 8410     9.2 Apr. 2 1998  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)
bw_parameters	•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	Jobs	Log	Node	Lock
1-2	No	Yes	IPX, IGX	Yes

Example 1

delad 31.1

Description

Delete the access device at 31.1.

System Response

IPX            TRM   SuperUser       IGX 8430    9.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 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:

•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. Multiple access devices on the same channel are displayed in increasing order.

•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	Jobs	Log	Node	Lock
1-2	Yes	Yes	IPX, IGX	Yes

Example 1

dspads

Description

Display all the access devices in the current node.

System Response

sw25           TN    SuperUser       IGX 8410     9.2 Apr. 1 1998  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 <channel>

Related Commands

addcon, cnfcondsc, cnfcos, cnfpref, dspcons

Attributes


Privilege	Jobs	Log	Node	Lock
1-6	No	No	IPX, IGX	No

Example 1

dspcon 4.1.33

Description

Display connection information for Frame Relay channel 4.1.33.

System Response

sw25           TN    SuperUser      IGX 8410      9.2 May  25 1998 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 rerouting.
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	Jobs	Log	Node	Lock
1-6	No	No	IPX, IGX	No

Example 1

dspcons

Description

Display a summary of all connections.

System Response

sw25           TN    SuperUser       IGX 84208     9.2 May  25 1998 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>.<Access Device ID>

Related Commands

restartad, dspads

Attributes


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

Table 15-12 resetad—Parameters
Parameter	Description
slot.port	Specifies the slot and port number that connects to the access device.
access device_ID	Specifies the access device ID number. The range for the access device_ID is 1-255. Access devices on the same trunk are assigned in increasing order.

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 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>.<Access Device ID>

Related Commands

resetad, dspads

Attributes


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

Table 15-13 restartad-Parameters
Parameter	Description
slot.port	Specifies the slot and port number.
access device_ID	Specifies the access device ID number. The range for the access device_ID is 1-255. Access devices on the same trunk are assigned in increasing order.

Table Of Contents