Cisco IOS Release 12.0 Dial Solutions Command Reference
Modem Support & Async Device Commands

Table Of Contents

Modem Support and Asynchronous Commands

async-bootp

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

Related Commands

async default ip address

async default routing

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Command

async dynamic address

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

async dynamic routing

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

autocommand

Syntax Description

Default

Command Mode

Usage Guidelines

Example

autohangup

Syntax Description

Default

Command Mode

Usage Guidelines

Example

clear line

Syntax Description

Command Mode

Usage Guidelines

Example

exec

Syntax Description

Default

Command Mode

Usage Guidelines

Example

exec-timeout

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

flowcontrol

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

group-range

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

Related Commands

hold-queue

Syntax Description

Default

Command Mode

Usage Guidelines

Example

ip access-group

Syntax Description

Default

Command Mode

Usage Guidelines

Example

ip mtu

Syntax Description

Default

Command Mode

Usage Guidelines

Example

line

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

Related Commands

member

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

Related Commands

modem call-record

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem callin

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem callout

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem cts-required

modem dialin

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem dtr-active

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem host

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem inout

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

modem printer

Syntax Description

Default

Command Mode

Usage Guidelines

Example

modem ri-is-cd

netbios nbf

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

physical-layer

Syntax Description

Default

Command Mode

Usage Guidelines

Example

:rotary

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

script activation

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

script connection

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

script reset

Syntax Description

Default

Command Mode

Usage Guidelines

Examples

Related Commands

script startup

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

show async bootp

Syntax Description

Command Mode

Usage Guidelines

Sample Display

show async status

Syntax Description

Command Mode

Usage Guidelines

Sample Display

show line

Syntax Description

Command Mode

Usage Guidelines

Sample Display

show modemcap

Syntax Description

Default

Command Mode

Usage Guidelines

Sample Display

Related Commands

show nbf cache

Syntax Description

Command Mode

Usage Guidelines

Sample Display

Related Commands

show nbf sessions

Syntax Description

Command Mode

Usage Guidelines

Sample Display

Related Commands

show users

Syntax Description

Command Mode

Usage Guidelines

Sample Displays

Related Commands

start-character

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands

start-chat

Syntax Description

Command Mode

Usage Guidelines

Example

Related Commands

stop-character

Syntax Description

Default

Command Mode

Usage Guidelines

Example

Related Commands


Modem Support and Asynchronous Commands


The configuration commands described in this chapter are used to configure modems and modem lines on access servers and routers.


Note   Some commands previously documented in this chapter have been replaced by new commands. Although these commands continue to perform their normal functions in the current release, support for these commands will cease in future releases.


For line configuration information and examples, refer to the "Configuring Modem Support and other Asynchronous Features" chapter in the Dial Solutions Configuration Guide.

async-bootp

To support the extended BOOTP request specified in RFC 1084, and to specify information that will be sent in response to BOOTP requests, use the async-bootp global configuration command. To clear the list, use the no form of this command.

async-bootp tag [:hostname] data
no async-bootp tag [:hostname] data

Syntax Description

tag

Item being requested; expressed as filename, integer, or IP dotted decimal address. See Table 3 for possible values.

:hostname

(Optional) This entry applies only to the specified host. The argument can be either an IP address or a logical host name.

data

List of IP addresses entered in dotted decimal notation or as logical host names, a number, or a quoted string.


Table 1 Supported Extended BOOTP Requests 

Keyword and Argument Pair
Use

bootfile

Server boot file from which to download the boot program. Use the optional :hostname and data arguments to specify the host or hosts.

subnet-mask mask

Dotted decimal address specifying the network and local subnetwork mask (as defined by RFC 950).

time-offset offset

A signed 32-bit integer specifying the time offset of the local subnetwork in seconds from Coordinated Universal Time.

gateway address

Dotted decimal address specifying the IP addresses of gateways for this subnetwork. A preferred gateway should be listed first.

time-server address

Dotted decimal address specifying the IP address of time servers (as defined by RFC 868).

ien116-server address

Dotted decimal address specifying the IP address of name servers (as defined by IEN 116).

nbns-server address

Dotted decimal address specifying the IP address of Windows NT servers.

dns-server address

Dotted decimal address specifying the IP address of Domain Name Servers (as defined by RFC 1034).

log-server address

Dotted decimal address specifying the IP address of an MIT-LCS UDP log server.

quote-server address

Dotted decimal address specifying the IP address of Quote of the Day servers (as defined in RFC 865).

lpr-server address

Dotted decimal address specifying the IP address of Berkeley UNIX Version 4 BSD servers.

impress-server address

Dotted decimal address specifying the IP address of Impress network image servers.

rlp-server address

Dotted decimal address specifying the IP address of Resource Location Protocol (RLP) servers (as defined in RFC 887).

hostname name

Name of the client (which might or might not be domain qualified, depending upon the site).

bootfile-size value

Two-octet value specifying the number of 512 octet (byte) blocks in the default boot file.


Default

If no extended BOOTP commands are entered, the software generates a gateway and subnet mask appropriate for the local network.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Each of the tag keyword-argument pairs is a field that can be filled in and sent in response to BOOTP requests from clients.

BOOTP supports the extended BOOTP requests specified in RFC 1084 and works for both SLIP and PPP encapsulation.

Use the show async bootp EXEC command to list the configured parameters. BOOTP works for both SLIP and PPP.

Examples

The following example specifies different boot files: one for a PC and one for a Macintosh. With this configuration, a BOOTP request from the host on 192.168.31.1 results in a reply listing the boot filename as pcboot. A BOOTP request from the host named mac results in a reply listing the boot filename as macboot.

async-bootp bootfile :192.168.31.1 "pcboot"
async-bootp bootfile :mac "macboot"

The following example specifies a subnet mask of 255.255.0.0:

async-bootp subnet-mask 255.255.0.0

The following example specifies a negative time offset of the local subnetwork of -3600 seconds:

async-bootp time-offset -3600

The following example specifies the IP address of a time server:

async-bootp time-server 192.168.31.1

Related Commands

You can use the master indexes or search online to find documentation of related commands.

service old-slip-prompts

async default ip address

The peer default ip address command replaces the async default ip address command.

Refer to the description of the peer default ip address command in the "Media Independent PPP and Multilink PPP Commands" chapter of this book for more information.

async default routing

To enable the router to pass routing updates to other routers over the AUX port configured as an asynchronous interface, use the async default routing interface configuration command. To disable dynamic addressing, use the no form of this command.

async default routing
no async default routing

Syntax Description

This command has no keywords or arguments.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Use the async default routing command to define the default behavior for router-to-router communication over connections to the AUX port configured as an asynchronous interface. This command is commonly used to enable two routers to communicate over an async dial backup link.

To require a remote user to manually configure routing over connections to the AUX port configured as an asynchronous interface, use the async dynamic routing command.

Example

The following example enables routing over asynchronous interface 0:

interface async 0
async default routing

Related Command

async dynamic routing

async dynamic address

To specify dynamic asynchronous addressing, use the async dynamic address interface configuration command. To disable dynamic addressing, use the no form of this command.

async dynamic address
no async dynamic address

Syntax Description

This command has no arguments or keywords.

Default

Dynamic addressing is disabled.

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

You can control whether addressing is dynamic (the user specifies the address at the EXEC level when making the connection), or whether default addressing is used (the address is forced by the system). If you specify dynamic addressing, the router must be in interactive mode and the user will enter the address at the EXEC level.

It is common to configure an asynchronous interface to have a default address and to allow dynamic addressing. With this configuration, the choice between the default address or a dynamic addressing is made by the user when they enter the slip or ppp EXEC command. If the user enters an address, it is used, and if the user enters the default keyword, the default address is used.

Example

The following example shows dynamic addressing assigned to async interface 6.

interface ethernet 0
 ip address 10.0.0.1 255.0.0.0
interface async 6
 async dynamic address

Related Commands

You can use the master indexes or search online to find documentation of related commands.

peer default ip address

async dynamic routing

To enable manually configured routing on an asynchronous interface, use the async dynamic routing interface configuration command. Use the no form of this command to disable routing protocols; static routing is still used.

async dynamic routing
no async dynamic routing

Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

The async dynamic routing command is commonly used to manually bring up PPP from an EXEC session.

Example

The following example shows how to enable manually configured routing on asynchronous interface 1. The ip tcp header-compression passive command enables Van Jacobson TCP header compression and prevents transmission of compressed packets until a compressed packet arrives from the asynchronous link.

interface async 1
async dynamic routing 
async dynamic address
async default ip address 1.1.1.2 
ip tcp header-compression passive

A remote user who establishes a PPP or SLIP connection to this asynchronous interface can enable routing by using the /routing switch or the ppp/routing command.

However, if you want to establish routing by default on connections to an asynchronous interface, use the async default routing command when you configure the interface.

Related Commands

async default routing
async dynamic address
ip tcp header-compression

autocommand

To configure the Cisco IOS software to automatically execute a command when a user connects to a particular line, use the autocommand line configuration command. Use the no form of this command to disable the automatic execution.

autocommand command
no autocommand command

Syntax Description

command

Any appropriate EXEC command, including the host name and any switches that occur with the EXEC command.


Default

No commands are configured to automatically execute.

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

This command enables you to automatically execute an EXEC command when a user connects to a line.

Example

The following example forces an automatic connection to a host named host21 (which could be an IP address):

line vty 4 
 autocommand connect host21 

autohangup

To configure automatic line disconnect, use the autohangup line configuration command. This command causes the EXEC to issue the exit command when the last connection closes. Use the no form of this command to disable automatic line disconnect.

autohangup
no autohangup

Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

This command is useful for UNIX UUCP applications that automatically disconnect lines because UUCP scripts cannot issue the exit command to hang up the telephone.

Example

The following example enables automatic line disconnect on lines 5 through 10:

line 5 10
 autohangup

clear line

To return a terminal line to idle state, use the clear line EXEC command.

clear line line-number

Syntax Description

line-number

Absolute line number.


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Use this command to log out of a specific session running on another line. If the line uses a modem, the modem will be disconnected.

Example

The following example resets line 3 to idle state:

clear line 3

exec

To allow an EXEC process on a line, use the exec line configuration command. Use the no form of this command to turn off the EXEC process for the specified line.

exec
no exec

Syntax Description

This command has no arguments or keywords.

Default

The EXEC processes start is activated automatically on all lines.

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

When you want to allow an outgoing connection only for a line, use the no exec command. When a user tries to Telnet to a line with the no exec command configured, the user will get no response when pressing the Return key at the login screen.

Example

The following example turns off the EXEC on line 7. You might want to do this on the auxiliary port if the attached device (for example, the control port of a rack of modems) sends unsolicited data. If this happens, an EXEC process starts, which makes the line unavailable.

line 7 
 no exec

exec-timeout

To set the interval that the EXEC command interpreter waits until user input is detected, use the exec-timeout line configuration command. Use the no form of this command to remove the timeout definition.

exec-timeout minutes [seconds]
no exec-timeout

Syntax Description

minutes

Integer that specifies the number of minutes.

seconds

(Optional) Additional time intervals in seconds. An interval of zero specifies no timeouts.


Default

10 minutes

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

If no input is detected, the EXEC facility resumes the current connection, or if no connections exist, it returns the terminal to the idle state and disconnects the incoming session. It is the same as entering exec-timeout 0.

Examples

The following example sets a time interval of 2 minutes, 30 seconds:

line console 
 exec-timeout 2 30

The following example sets a time interval of 10 seconds:

line console 
 exec-timeout 0 10

flowcontrol

To set the method of data flow control between the terminal or other serial device and the router, use the flowcontrol line configuration command. Use the no form of this command to disable flow control.

flowcontrol {none | software [lock] [in | out] | hardware [in | out]}
no flowcontrol {none | software [in | out] | hardware [in | out]}

Syntax Description

none

Turns off flow control.

software

Sets software flow control. An optional keyword specifies the direction: in causes the Cisco IOS software to listen to flow control from the attached device, and out causes the software to send flow control information to the attached device. If you do not specify a direction, both are assumed.

lock

(Optional) Used to make it impossible to turn off flow control from the remote host when the connected device needs software flow control. This option applies to connections using the Telnet or rlogin protocols.

hardware

Sets hardware flow control. An optional keyword specifies the direction: in causes the software to listen to flow control from the attached device, and out causes the software to send flow control information to the attached device. If you do not specify a direction, both are assumed. For more information about hardware flow control, see the hardware manual that was shipped with your router.


Default

No flow control

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

When software flow control is set, the default stop and start characters are Ctrl-S and Ctrl-Q (XOFF and XON). You can change them with the stop-character and start-character commands.

If a remote Telnet device requires software flow control, the remote system should not be able to turn it off. Using the lock option makes it possible to refuse "dangerous" Telnet negotiations if they are inappropriate.

Example

The following example sets hardware flow control on line 7:

line 7
 flowcontrol hardware

Related Commands

You can use the master indexes or search online to find documentation of related commands.

start-character
stop-character
terminal flowcontrol

group-range

To create a list of member asynchronous interfaces (associated with a group interface), use the group-range interface configuration command. Use the no form of the command to remove an interface from the member list.

group-range low-end-of-range high-end-of-range
no group-range interface

Syntax Description

low-end-of-range

Beginning interface number to be made a member of the group interface.

high-end-of-range

Ending interface number to be made a member of the group interface.


Default

No interfaces are designated as members of a group.

Command Mode

Interface configuration

Usage Guidelines

Using the group-range command, you create a group of asynchronous interfaces that are associated with a group asynchronous interface on the same device. This group interface is configured by using the interface group-async command. This one-to-many structure allows you to configure all associated member interfaces by entering one command on the group interface, rather than entering this command on each interface. You can customize the configuration on a specific interface by using the member command.

Examples

The following example defines interfaces 2, 3, 4, 5, 6, and 7 as members of asynchronous group interface 0:

interface group-async 0
 group range 2 7 

Related Commands

You can use the master indexes or search online to find documentation of related commands.

interface group-async
member

hold-queue

To limit the size of the IP output queue, use the hold-queue interface configuration command. To return the output queue to the default size, use the no form of this command.

hold-queue packets
no hold-queue

Syntax Description

packets

Maximum number of packets. The range of values is 0 to 65535.


Default

10 packets (default for asynchronous interfaces only)

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0. The no hold-queue command first appeared in Cisco IOS Release 11.1.

The default of 10 packets allows the Cisco IOS software to queue a number of back-to-back routing updates. This is the default for asynchronous interfaces only; other media types have different defaults.

The hold queue stores packets received from the network that are waiting to be sent to the client. It is recommended that the queue size not exceed ten packets on asynchronous interfaces. For most other interfaces, queue length should not exceed 100.

Example

The following example changes the packet queue length of a line to five packets:

interface async 2
 async default ip address 172.31.7.5
 hold-queue 5

ip access-group

To configure an access list to be used for packets transmitted to and from the asynchronous host, use the ip access-group interface configuration command. To disable control over packets transmitted to or from an asynchronous host, use the no form of this command.

ip access-group access-list-number {in | out}
no ip access-group access-list-number

Syntax Description

access-list-number

Assigned IP access list number.

in

Defines access control on packets transmitted from the asynchronous host.

out

Defines access control on packets being sent to the asynchronous host.


Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

With this command in effect, the IP destination address of each packet is run through the access list for acceptability and dropped or passed.

Example

The following example assumes that users are restricted to certain servers designated as SLIP or PPP servers, but that normal terminal users can access anything on the local network:

! access list for normal connections
access-list 1 permit 172.16.0.0 0.0.255.255
!
! access list for SLIP packets.
access-list 2 permit 172.16.42.55
access-list 2 permit 172.16.111.1
access-list 2 permit 172.16.55.99
!
! Specify the access list
interface async 6
 async dynamic address
 ip access-group 1 out
 ip access-group 2 in

ip mtu

To specify the size of the largest Internet packet, use the ip mtu interface configuration command. To return to the default MTU size of 1500 bytes, use the no form of this command.

ip mtu bytes
no ip mtu

Syntax Description

bytes

Maximum number of bytes. The range of values is 64 to 1000000.


Default

1500 bytes

Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

Example

The following example sets the packet MTU size to 200 bytes:

interface async 5
 async default ip address 172.31.7.5
 ip mtu 200

line

To identify a specific line for configuration and start the line configuration command collection mode, use the line global configuration command.

line [aux | console | tty | vty] line-number [ending-line-number]

Syntax Description

aux

(Optional) Auxiliary EIA/TIA-232 DTE port. Must be addressed as relative line 0. The auxiliary port can be used for modem support and asynchronous connections.

console

(Optional) Console terminal line. The console port is DCE.

tty

(Optional) Standard asynchronous line.

vty

(Optional) Virtual terminal for remote console access.

line-number

The relative number of the terminal line (or the first line in a contiguous group) that you want to configure when the line type is specified. Numbering begins with zero.

ending-line-number

(Optional) The relative number of the last line in a contiguous group that you want to configure. If you omit the keyword, then line-number and ending-line-number are absolute rather than relative line numbers.


Default

There is no default line.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

You can address a single line or a consecutive range of lines with the line command. A line number is necessary, though, and you will receive an error message if you forget to include it.

Entering the line command with the optional line type (AUX, CON, TTY, or VTY) designates the line number as a relative line number. For example, to configure line parameters for line 7 (a TTY line), you could enter the following:

Router(config)# line tty 7

You also can enter the line command without specifying a line type. In this case, the line number is treated as an absolute line number. For example, to configure line parameters for line 5, which can be of any type, you could enter the following:

Router(config)# line 5

Absolute line numbers increment consecutively and can be difficult to manage on large systems. Relative line numbers are a shorthand notation used in configuration. Internally, the Cisco IOS software uses absolute line numbers. You cannot use relative line numbers everywhere, but you can use absolute line numbers everywhere.

The absolute line number of the auxiliary port is 1. The relative line number of the auxiliary port is 0. See the modem line configuration command to set up modem support on the auxiliary port.

The software keeps a table of absolute and relative line numbers that you can display with the EXEC command show users all. A sample display follows:

Router> show users all
  Line      User     Host(s)               Idle   Location 
   0 con 0                                        chaff console 
   1 tty 1                                        Engineering printer 
   2 tty 2 
   3 tty 3           DREGGS                1:07   Katy x1111 
   4 tty 4                                        Console E3-D 
   5 tty 5                                        Mkt. demo area 
   6 tty 6 
   7 tty 7           DREGGS                  14   Marie x1112 
  10 tty 10
 .  .  .
 135 tty 135 
 136 tty 136 
 137 tty 137                                      rp4-printer 
 140 tty 140                                      Braille printer 
 141 aux 0 
 142 vty 0   Denise    idle                       DENISE-MAC.CISCO.COM 
 143 vty 1   Michael   idle                     0 DREGGS.CISCO.COM 
 144 vty 2 
 145 vty 3 
 146 vty 4 
 147 vty 5

The absolute line numbers are listed at the far left, followed by the line type, and then the relative line number. Relative line numbers always begin numbering at zero and define the type of line. Addressing the second virtual terminal line as line VTY 1, for example, is easier than remembering it as line 143—its absolute line number.

The line types are ranked as follows in the line table:

1 Console 0 (con 0)

2 Standard asynchronous line (TTY)

3 Auxiliary port (aux)

4 Virtual terminal line (VTY)

5 Printer

The terminal from which you locally configure the router is attached to the console port. To configure line parameters for the console port, enter the following:

Router(config)# line con 0

The console relative line number must be 0.

Virtual terminal lines are used to allow remote access to the router. A virtual terminal line is not associated with either the auxiliary or console port. The router has five virtual terminal lines by default. However, you can create additional virtual terminal lines as described in the section "Create Additional Virtual Terminal Lines" in the "Configuring Protocol Translation and Virtual Asynchronous Devices" chapter of the Dial Solutions Configuration Guide.

Configuring the console port or virtual terminal lines allows you to perform such tasks as setting communication parameters, specifying autobaud connections, and configuring terminal operating parameters for the terminal you are using.

Examples

The following example starts configuration for virtual terminal lines 0 to 4:

line vty 0 4

In the following example, the user creates and configures the maximum 100 virtual terminal lines with the no login command:

line vty 0 99
 no login

In the following example, the user eliminates virtual terminal line number 5 and all higher-numbered virtual terminal lines. Only virtual terminal lines 0 to 4 will remain.

no line vty 5

In the following example, the user configures console line 0, auxiliary line 0, and virtual terminal lines 0 to 4:

line vty 0 4
 login
line con 0
 password baskerville
line aux 0
 password Mypassword
 no exec
 access-class 1 in
 speed 19200
line vty 0
 exec-timeout 0 0
 password Mypassword
line vty 1
 exec-timeout 0 0
 password Mypassword
line vty 2
 exec-timeout 0 0
 password Mypassword
line vty 3
 password Mypassword
line vty 4
 password Mypassword

Related Commands

You can use the master indexes or search online to find documentation of related commands.

show line
show users
all

member

To alter the configuration of an asynchronous interface that is a member of a group, use the member interface configuration command. Use the no form of the command to restore defaults set at the group master interface.

member number interface-command
no member number interface-command

Syntax Description

number

Number of the asynchronous interface to be altered.

interface-command

One or more of the following commands entered for this specific interface:

peer default ip address

description


Default

No individual configurations are set for member interfaces.

Command Mode

Interface configuration

Usage Guidelines

You can customize a member interface by using the member command. (Interfaces are designated as members of a group by using the interface group-async and group-range commands.) To restore the defaults set at the group master interface, use the no form of this command.

Examples

The following example defines interface 3 with a description of line 3, which is attached to a Hayes Optima modem:

interface group-async 0 
 member 3 description line #3 Hayes Optima

Related Commands

You can use the master indexes or search online to find documentation of related commands.

group-range
interface group-async

modem call-record

To activate the logging of a summary of modem events upon the termination of a call, use the modem call-record command in global configuration mode. Use the no form of this command to deactivate modem event logging of calls.

modem call-record terse
no modem call-record

Syntax Description

terse

Specifies that only significant data is logged to the Modem Call Record (MCR).


Default

Logging of modem events is off.

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3(6) AA.

The modem management subsytem provides event logs for each modem at each major event during usage of the modems. The volume of event logs being generated make the monitoring of modem calls for debugging purposes difficult. MCR log, activated using the modem call-record command, will log a summary of a modem call to syslog upon termination of the call. If a call fails to establish a connection, the call will be summarized in a Modem Call Failed Record.

The MCR is written to the syslog and can be displayed using the terminal monitor or show logging command, or by examining files on a syslog server.

The modem call-record command is supported on routers with integrated MICA technologies and Microcom modems.

The information provided in the MCR log and the Modem Call Failed Record log varies depending on the type of modem being used. The following table describes the significant fields in the display for MICA and Microcom modems.

Table 2 modem call-record Field Descriptions 

Field
Description

Interface slot

Interface slot of device assigned for call.

Interface controller unit

Interface controller unit of device assigned for call.

Interface channel

Interface channel of device assigned for call.

Modem type

Modem type used for call.

Modem slot/port

Physical location for modem handling the call.

Call id

Unique Call Identifier assigned to the modem call by the call switching module.

Userid

User ID of caller.

IP address

IP address assigned for caller.

Calling number

Modem calling number.

Called number

Modem called number.

Connected standard

Standard used for connection. Possible values are Bell103, Bell212, K56Flex 1.1, V.17, V.21, V.22, V.22bis, V.23, V.27, V.29, V.32, V.32bis, V.32terbo. V.34, V.34+, and V.90.

Connect protocol

Protocol user for connection. Possible values are ARA1.0, ARA2.0, ASYNC Mode, FAX Mode, LAP-M, MNP, SS7/COT, and SYNC Mode.

Compression

Compression method used for connection. Possible values are MNP5 data, none, V.42bis both, V.42bis RX, and V.42bis TX.

Initial RX bit rate

Actual bit rate from the remote Digital Signal Processor (DSP) to the local DSP at connect.

Initial TX bit rate

Actual bit rate from the local DSP to the remote DSP at connect.

Final RX bit rate

Actual bit rate from the remote DSP to the local DSP at disconnect.

Final TX bit rate

Actual bit rate from the local DSP to the remote DSP at disconnect.

RBS pattern1

Actual Robbed Bit Signaling (RBS) pattern observed by the modem. The six LSBs of the returned value indicate the periodic RBS pattern where a one denotes a pulse code modulation sample with a robbed-bit. (Only reported for K56Flex).

Digital pad1

Amount of digital padding (attenuation) in downlink, in decibles. (Only reported for V.90 and K56Flex.)

Total retrains1

Count of total retrains and speed shifts.

Signal quality value1

This value ranges from 0 to 7, where 0 is the worst. The units are arbitrary, approximating abs(log10(SNR)).

SNR

Signal-to-noise ratio, ranging from 0 to 70 in dB steps.

Characters received

Count of total characters received for SYNC/ASYNC connection.

Characters transmitted

Count of total characters sent for SYNC/ASYNC connection.

Characters received BAD1

Total number of parity errored characters received (for ASYNC connections).

Error correction frames received OK

Count of error-free Error Correction frames received. Incorrect or duplicate frames are not included.

Error correction frames transmitted

Count of unique Error Correction frames sent. Re-sent frames are not included.

Error correction frames received BAD/ABORTED1

Total error correction retransmissions requested by this modem during the course of the link.

Call timer

Duration of call, in seconds.

Final state

State of modem call before it terminated.

Disconnect reason

Reason for call being disconnected. Each modem type handles parameter differently.

1 These fields are displayed only for MICA modems.


Example

The following example shows the activation of MCR logging:

modem call-record terse 

The following is the MCR of a successful call on a MICA modem:

*Aug 15 01:34:08.775: %CALLRECORD-3-MICA_TERSE_CALL_REC:
DS0 slot/contr/channel=1/0/22 modem=mica slot/port=1/2 call_id=0x3
userid=jdoe ip=124.34.45.120
calling=#4085551212 called=#4085552222
std=V.34+ prot=LAP-M comp=None
init-rx/tx b-rate=31200/33600 finl-rx/tx b-rate=33600/33600
rbs=0 d-pad=None retr=2 sq=2 snr=28
rx/tx chars=1067/0 bad=0 rx/tx ec=0/0 bad=0
time=139 finl-state=Steady
disc=0xA220
Type (=5 ):  Rx (line to host) data flushing, not OK
Class (=2 ):  EC condition, locally detected
Reason (=32):  received DISC frame -- normal LAPM termination

The following is the MCR of a failed call on a MICA modem:

*Aug 15 16:47:54.527: %CALLRECORD-3-MICA_TERSE_CALL_FAILED_REC:
DS0 slot/contr/channel=1/0/22 modem=mica slot/port=1/2 call_id=0x9
calling=4085551212# called=#4085552222
time=2 finl-state=Link
disc=0x7F06
Type (=3 ):  Condition occurred during call setup
Class (=31):  Requested by host
Reason (=6 ):  network indicated disconnect

The following is the MCR of a successful call on a Microcom modem:

01:17:30: %CALLRECORD-3-MCOM_TERSE_CALL_REC: 
DS0 slot/contr/channel=0/0/22 modem=microcom_server slot/port=0/2 call_id=0x3
userid=sque ip=124.34.46.111
calling=#4085551111 called=#4085552222
std=V34 prot=Normal comp=None
Init-RX/TX b-rate=33600/31200 Finl-RX/TX b-rate=33600/33600
SNR=47
RX/TX chars=0/0 RX/TX EC=0/0
time=73 Disc(local)=0x9 DTR Drop Disc(remote)=0x0 Unknown

The following is the MCR of a failed call on a Microcom modem:

Microcom Terse Modem Call Failed Record Log:
19:28:55: %CALLRECORD-3-MCOM_TERSE_CALL_FAILED_REC:
DS0 slot/contr/channel=0/0/0 modem=microcom_server slot/port=0/2 call_id=0xA003
calling=4085551111# called=#4085552222
time=0 finl-state=Dialing/Answering
disc(local)=0x9 DTR Drop disc(remote)=0x0 Unknown

Related Commands

You can use the master indexes or search online to find documentation of related commands.

show logging
terminal monitor

modem callin

To support dial-in modems that use the data terminal ready (DTR) signal to control the off-hook status of the modem, use the modem callin line configuration command. Use the no form of this command to disable this feature.

modem callin
no modem callin

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

In response to RING, the router raises the DTR signal, which indicates to the modem that it should answer the call. At the end of the session, the Cisco IOS software lowers DTR, which disconnects the modem. This command is useful for older modems that do not support auto answer.

This command uses CTS, whereas newer modem commands in the Cisco IOS software use DSR.

Only use the modem callin command on the ASM terminal server, where hardware flow control is not possible. If you have a more recent device (such as a Cisco 2509 through 2512, Cisco 2520 through 2523, a Cisco AS5100, Cisco 3600 series, or Cisco AS5200), use the modem dialin command instead.

Example

The following example configures lines 10 through 16 for dial-in modems that can run at speeds from 300 to 19,200 bps:

line 10 16 
 modem callin 
 autobaud

Related Commands

You can use the master indexes or search online to find documentation of related commands.

modem answer-timeout
modem inout

modem callout

To configure a line for reverse connections, use the modem callout line configuration command. Use the no form of this command to disable this feature.

modem callout
no modem callout

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

This command supports ports connected to computers that would normally be connected to modems. It causes the access server to act somewhat like a modem.

This command uses CTS and should be used only on access servers that do not support hardware flow control. If you have an access server that is newer than the ASM terminal server (such as a Cisco 2509 through 2512, Cisco 2520 through 2523, a Cisco AS5100, Cisco 3600 series, or a Cisco AS5200), use the modem host command instead. The modem callout command uses CTS, whereas the modem host command uses DSR/DCD. If CTS is used for modem control instead of DSR/DCD, it prevents CTS from being used by hardware flow control.

Example

The following example configures lines 17 through 32 in reverse connection mode to a large terminal switch. By using Telnet to connect to a TCP port on this host, the user gets the next free line in the rotary group.

line 17 32 
 rotary 1 
 modem callout

Related Commands

You can use the master indexes or search online to find documentation of related commands.

modem inout
:rotary

modem cts-required

The modem printer command replaces the modem cts-required command. Refer to the description of the modem printer command for more information.

modem dialin

To configure a line to enable a modem attached to the router to accept incoming calls only, use the modem dialin line configuration command. Use the no form of this command to disable this feature.

modem dialin
no modem dialin

Syntax Description

This command has no arguments or keywords.

Default

Do not permit incoming calls to the modem.

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.1.

This command supports modems that can automatically handle telephone line activity, such as answering the telephone after a certain number of rings.

Example

The following example configures a line for a high-speed modem:

line 5 
 modem dialin 

Related Commands

You can use the master indexes or search online to find documentation of related commands.

dialer
modem inout
parity

modem dtr-active

To configure a line to leave data terminal ready (DTR) signals low, unless the line has an active incoming connection or an EXEC process, use the modem dtr-active line configuration command. Use the no form of this command to disable this feature.

modem dtr-active
no modem dtr-active

Syntax Description

This command has no arguments or keywords.

Default

No modem control

Command Mode

Line configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0.

This command does not use the Carrier Detect (CD) signal.

This command can be useful if the line is connected to an external device (for example, a time-sharing system) that must know whether a line is in active use. The modem dtr-active command is similar to the no modem line configuration command.

Example

The following example configures a line for low DTR:

line 5 
 modem dtr-active

Related Commands

You can use the master indexes or search online to find documentati