Syntax Description

number	Sets the maximum number of simultaneous connections or sessions that can be used in a specified customer or VPDN profile.
all	Accepts all calls. Use this command if you don't want to limit or apply overflow session counting to a customer or VPDN profile.

Defaults

No limits are set for a customer profile. The base size is set to all.

Command Modes

Customer profile configuration/VPDN profile configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the limit base-size customer or VPDN profile configuration command to define the base number of simultaneous connections in a single customer or VPDN profile. The session limit applies to all the physical resource groups and pools configured in a single customer profile. If you want to define the number of overflow calls granted to a customer profile by using the limit overflow-size command , do not set the limit base-size command to "all." Instead, specify a number for the limit base-size command.

Examples

The following example shows the limits of the total number of simultaneous connections to a base size of 48:

resource-pool profile customer customer1_isp
limit base-size 48

Related Commands

Command	Description
resource-pool profile customer	Creates a customer profile.
limit overflow-size	Defines the number of overflow calls granted to one customer or VPDN profile.

Syntax Description

number	Specifies the number of overflow calls.
all	Allows an unlimited number of overflow calls.

Defaults

The overflow size is set to 0.

Command Modes

Customer profile configuration/VPDN profile configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the limit overflow-size customer or VPDN profile configuration command to define the number of overflow calls granted to one customer or VPDN profile. The overflow is not applied if the limit base-size command is set to "all."

Examples

The following example shows 20 overflow calls granted to the customer profile called customer1_isp:

resource-pool profile customer customer1_isp
limit overflow-size 20

Related Commands

Command	Description
resource-pool profile customer	Creates a customer profile.
limit base-size	Defines the base number of simultaneous connections that can be done in a single customer or VPDN profile.

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.

Defaults

There is no default line.

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

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.

line tty 7
 

You also can use 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:

line 5
 

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.

1. Console 0 (con 0)

2. Standard asynchronous line (TTY)

3. Auxiliary port (aux)

4. Virtual terminal line (VTY)

5. Printer

line con 0
 

The console relative line number must be 0.

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

Command	Description
show line	Displays the parameters of a terminal line.
show users	Displays information about the active lines on the router.

Syntax Description

This command has no arguments or keywords.

Defaults

The BRI port does not supply line power.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)XG	This command was introduced.

Usage Guidelines

This command is supported only on the Cisco MC3810, and only if an installed BRI voice module (BVM) is equipped to supply line power (phantom power).

This command is used only on a BRI port operating in NT mode. A BRI port operating in TE mode is automatically disabled as a source of line power, and the line-power command is rejected.

When you use the line-power command, the line power provision is activated on a BRI port if the port is equipped with the hardware to supply line power. When you enter the no line-power command, the line power provision is deactivated on a BRI port.

Note If the BRI port is operating in NT mode, the line-power command will be accepted, but will have no effect if a BVM is not equipped to supply line power.

Examples

The following example configures a BRI port to supply power to an attached TE device (only if the BVM is equipped to supply line power):

interface bri 1
line-power

Syntax Description

hostname name	If hostname is used, RLM will look up the DNS server periodically for the hostname configured until lookup is successful or the configuration is removed.
address ip-address	IP address of the link.
source interface	We recommend you use the loopback interface as the source, so that it is independent of the hardware condition. Also, the source interface should be different in every link to avoid falling back to the same routing path. If you intend to use the same routing path for the failover, a single link is sufficient to implement it.
weight number	The higher the weighting number, the higher priority it gets to become the active link. If all entries have the same weighting, all links will be treated equally. There is no preference among servers according to the assumption that only one server will accept the connection requests at any given time. Otherwise, the preference will extend across all servers.

Defaults

Disabled

Command Modes

RLM configuration

Command History

Release	Modification
11.3(7)	This command was introduced.

Related Commands

Command	Description
clear rlm group	Clears all RLM group time stamps to zero.
clear interface	Resets the hardware logic on an interface.
interface	Defines the IP addresses of the server, configures an interface type, and enters interface configuration mode.
protocol rlm port	Reconfigures the port number for the basic RLM connection for the whole rlm-group.
retry keepalive	Allows consecutive keepalive failures a certain amount of time before the link is declared down.
server (RLM)	Defines the IP addresses of the server.
show rlm group statistics	Displays the network latency of the RLM group.
show rlm group status	Displays the status of the RLM group.
show rlm group timer	Displays the current RLM group timer values.
shutdown (RLM)	Shuts down all of the links under the RLM group.
timer	Overwrites the default setting of timeout values.

Syntax Description

ip ip-address	IP address of the HGW/LNS at the other end of the tunnel. This is the IP endpoint at the end of the tunnel, which is a HGW/LNS router.
limit number	(Optional) Limits sessions per load share. The limit has a range from 0 to 32,767 sessions. The default is no limit set.

Defaults

This function is not used when not configured.

Command Modes

VPDN group configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the loadsharing VPDN group configuration command to configure endpoints for loadsharing.

Examples

In the following example, one VPDN group called customer1-vpdng is created. L2TP IP traffic load is shared between two HGW/LNSs. The IP addresses for the HGW/LNS's WAN ports are 172.21.9.67 and 172.21.9.68. The characteristics for 172.21.9.67 are defined by using the request dialin command. The characteristics for 172.21.9.68 are defined by using the loadsharing command.

A backup home-gateway router is specified at 172.21.9.69 by using the backup command. This router serves as a backup device for two load-sharing HGW/LNS:

!
vpdn-group customer1-vpdng
 request dialin l2tp ip 172.21.9.67 domain cisco.com
 loadsharing ip 172.21.9.68 limit 100
 backup ip 172.21.9.69 priority 5
 domain cisco2.com
!

Related Commands

Command	Description
request dialin	Configures a VPDN group to request L2F or L2TP tunnels to a home gateway and creates a request-dialin VPDN subgroup.

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced in a release prior to Cisco IOS Release 10.0.

Usage Guidelines

You can prevent access to your session while keeping your connection open by setting up a temporary password. To lock access to the terminal, follow this procedure:

When you issue this command, the system prompts you for a password.

Step 2 Enter a password, which can be any arbitrary string.

The screen clears and displays the message "Locked."

Step 3 To regain access to your sessions, reenter the password.

The Cisco IOS software honors session timeouts on a locked lines. You must clear the line to remove this feature. The system administrator must set the line up to allow use of the temporary locking feature by using the lockable line configuration command.

Examples

The following command locks access to the terminal line to which the user is connected. Only this user can access the session:

router(config-line)# lockable
router(config-line)# Ctrl-z
router# copy system:running-config nvram:startup-config
Building configuration...
 
OK
router# lock 
Password: 
Again:
                       Locked
 
Password:
router#

Related Commands

Command	Description
lockable	Enables the lock EXEC command.
login (EXEC)	Enables or changes a login username.

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

When you enter this command, the Cisco IOS software prompts you for a username and password. Enter the new username and the original password. If the username does not match, but the password does, the Cisco IOS software updates the session to the new username with which the login command attempt was made.

If no username and password prompts appear when you enter this command, the network administrator did not specify that a username and password be required at login time. If both the username and password are entered correctly, the session becomes associated with the specified username.

When you access a system using TACACS security with this command, enter your login name and specify a TACACS server using the following syntax when the "Username:" prompt appears:

The TACACS server must be one of those defined in a Cisco IOS software configuration file. For more information, refer to the sections about specifying a TACACS host in the Cisco IOS Security Configuration Guide, or refer to the tacacs-server host command in the Cisco IOS Security Command Reference Publication.

If you do not specify a host, the Cisco IOS software tries each of the TACACS servers in the list until it receives a response.

If you do specify a host that does not respond, no other TACACS server is queried. The Cisco IOS software will deny access or function according to the action specified by the tacacs-server last-resort command, if one is configured.

If you specified a TACACS server host with the user @tacacs-server command, the TACACS server specified will be used for all subsequent authentication or notification queries, with the possible exception of SLIP address queries.

Examples

The following example shows how login usernames and passwords can be changed. In this example, a user currently logged on under the username user1 attempts to change that login name to user2. After entering the login command, the user enters the new username, but enters an incorrect password. Because the password does not match the original password, the system rejects the attempt to change the username.

router> login
Username: user2
Password:
% Access denied
Still logged in as "user1"
 

Next, the user attempts the login change again, with the user name user2, but enters the correct (original) password. This time the password matches the current login information, the login username is changed to user2, and the user is allowed access to the EXEC at the user-level.

router> login
Username: user2
Password:
router>

Related Commands

Command	Description
line-power	Sets up a temporary password on a line.
lockable	Enables the lock EXEC command.

Examples

In the following example, the value %5p causes a 5-second pause:

login-string office #ATDT 555-1234
%5p hello
#

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command is useful for testing the DCE Channel Service Unit/Data Service Unit (CSU/DSU) itself.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Examples

The following example configures the loopback test on the E1 line:

controller e1 0
 loopback 

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command is useful for testing the DCE Channel Service Unit/Data Service Unit (CSU/DSU) itself.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Examples

The following example configures the loopback test on the T1 line:

controller t1 0
 loopback local

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command is useful for looping a single channel group in a channelized environment without disrupting the other channel groups.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Examples

The following example configures the loopback test on the T1 line:

interface serial 1/0:22
 loopback local

Related Commands

Command	Description
show interfaces loopback	Displays information about the loopback interface.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command applies only when the device supports the remote function. It is used for testing the data communication channels.

For MIP cards, this controller configuration command applies if only one destination exists at the remote end of the cloud, the entire T1 line is dedicated to it, and the device at the remote end is a CSU (not a CSU/DSU). This is an uncommon case; MIPs are not usually used in this way.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Examples

The following example configures a remote loopback test:

interface serial 0
 loopback remote

Related Commands

Command	Description
show interfaces loopback	Displays information about the loopback interface.

Syntax Description

classname

Unique class identifier.

Defaults

Disabled; no class name is provided.

Command Modes

Global configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is used on the PPP callback server, not on the callback client.

This command is used to define classes of calls for PPP callback for DDR, for ISDN Advice of Charge, and for Network Specific Facilities (NSF) call-by-call dialing plans.

Examples

The following example configures the PPP callback server on an ISDN BRI interface on a router in Atlanta. The callback server requires an enable timeout and a map class to be defined.

interface BRI0
 ip address 7.1.1.7 255.255.255.0
 encapsulation ppp
 dialer callback-secure
 dialer enable-timeout 2
 dialer map ip 7.1.1.8 name atlanta class dial1 81012345678901
 dialer-group 1
 ppp callback accept
 ppp authentication chap
!
map-class dialer dial1
 dialer callback-server username
 

The following example configures the ISDN switch type to Primary-4ESS and configures ISDN PRI on T1 controller 1/0, and sets the D channel for dialer map classes that reference the NSF dialing plans. Finally, the map-class dialer command uses a dialing plan keyword and the dialer outgoing command refers to the same plan.

isdn switch-type primary-4ess
!
!
controller T1 1/0
 framing esf
 linecode b8zs
 pri-group timeslots 1-24
!
interface Serial1/0:23
 description This is the DMS D-channel 415-390-9503
 ip address 6.1.1.3 255.255.255.0
 encapsulation ppp
 no keepalive
 dialer map ip 6.1.1.1 name tommyjohn class sdnplan 14085770715
 dialer map ip 6.1.1.2 name angus class megaplan 14085773775
 dialer map ip 6.1.1.4 name angus class accuplan 14085773778
 dialer-group 1
 ppp authentication chap
!
map-class dialer sdnplan
 dialer outgoing sdn
!
map-class dialer megaplan
 dialer voice-call
 dialer outgoing mega
!
map-class dialer accuplan
 dialer outgoing accu
 

The following partial example configures BRI 0 to function as the callback server on the shared network. The callback server requires an enable timeout and a map class to be defined.

interface BRI0
 ip address 7.1.1.7 255.255.255.0
 encapsulation ppp
 dialer callback-secure
 dialer enable-timeout 2
 dialer map ip 7.1.1.8 name atlanta class dial1 81012345678901
 dialer-group 1
 ppp callback accept
 ppp authentication chap
!
map-class dialer dial1
 dialer callback-server username
 

The following example configures a map class called "hawaii" and sets an ISDN speed of 56 kbps for the class.

map-class dialer hawaii
 isdn speed 56

Related Commands

Command	Description
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
dialer string (legacy DDR)	Specifies the destination string (telephone number) to be called for interfaces calling a single site.
show controllers e1	Displays information about the E1 links supported by the NPM (Cisco 4000) or MIP (Cisco 7500 series).

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

Defaults

No individual configurations are set for member interfaces.

Command Modes

Interface configuration

Command History

Release	Modification
11.1	This command was introduced.

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.) Use the no form of this command to restore the defaults set at the group master interface.

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

Command	Description
group-range	Creates a list of member asynchronous interfaces (associated with a group interface).
interface group-async	Creates a group interface that will serve as master, to which asynchronous interfaces can be associated as members.

Syntax Description

seconds

Specifies the timeout interval in seconds.

Defaults

15 seconds

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

This command is useful for modems that take a long time to synchronize to the appropriate line speed.

For more information, see the chapter "Configuring Modems and Chat Scripts" in the Cisco IOS Dial Services Configuration Guide: Terminal Services.

Examples

The following example sets the timeout interval to 20 seconds for the modem connected to lines 3 through 13:

line 3 13
 modem answer-timeout 20

Related Commands

Command	Description
modem callin	Supports dial-in modems that use the DTR signal to control the off-hook status of the modem.
modem inout	Configures a line for both incoming and outgoing calls.

Syntax Description

slot/port

Slot and modem port number. Remember to include the forward slash (/) when entering this variable.

Defaults

Disabled

Command Modes

EXEC

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Manageable modems return "OK" if the AT command you send is successfully enabled. Press Ctrl-C after sending an AT command to close the directly connected session.

Note This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example opens a directly connected session on modem 1/1, enters AT command mode on modem 1/1, and transmits the AT command ATH through the out-of-band feature of modem 1/1:

router# modem at-mode 1/1
You are now entering AT command mode on modem (slot 1 / port 1).
Please type CTRL-C to exit AT command mode.
at%v
 
MNP Class 10 V.34/V.FC Modem Rev 1.0/85
 
OK
at\s
 
IDLE           000:00:00
LAST DIAL      
 
NET ADDR:      FFFFFFFFFFFF
MODEM HW: SA 2W United States
4 RTS 5 CTS 6 DSR - CD 20 DTR - RI 
MODULATION     IDLE
MODEM BPS      28800  AT%G0   
MODEM FLOW     OFF    AT\G0
MODEM MODE     AUT    AT\N3
V.23 OPR.      OFF    AT%F0
AUTO ANS.      ON     ATS0=1
SERIAL BPS     115200 AT%U0   
BPS ADJUST     OFF    AT\J0
SPT BPS ADJ.   0      AT\W0
ANSWER MESSGS  ON     ATQ0   
SERIAL FLOW    BHW    AT\Q3
PASS XON/XOFF  OFF    AT\X0
PARITY         8N     AT

Related Commands

Command	Description
clear modem	Resets the hardware for one or more manageable modems on access servers and routers.

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

After you enter this command, enter the modem at-mode command to enable a directly connected session on the modem. From AT command mode, you can enter AT commands directly from your terminal session.

For a complete list of supported AT commands, refer to the AT command documentation that came with your access server or router.

The no modem at-mode-permit command disables a modem from accepting a direct connection, which is useful for ensuring modem security.

Note This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example permits the modem connected to TTY line 1 to accept a directly connected session:

line 1
 modem at-mode-permit

Related Commands

Command	Description
clear modem	Resets the hardware for one or more manageable modems on access servers and routers.
modem at-mode	Opens a directly connected session and enters AT command mode, which is used for sending AT commands to Microcom manageable modems.

Syntax Description

This command has no arguments or keywords.

Defaults

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

The modem is identified each time the line is reset. If a modem cannot be detected, the line continues retrying for 10 seconds. When the modem type is determined, this information remains stored until the modem is recycled or disconnected. Discovery mode is much slower than configuring a line directly.

Each time the modem is reset (every time a chat reset script is executed), a string of commands is sent to the modem, the first one being "return to factory-defaults."

Examples

The following example discovers whatever kind of modem is attached to the router or access server:

modem autoconfigure discovery 

Related Commands

Command	Description
modem autoconfigure type	Directs a line to attempt to configure the attached modem using the entry for modem-name.

Syntax Description

modem-name

The name of the modem (such as Codex_3260).

Defaults

No default behavior or values.

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

The modem is reconfigured each time the line goes down.

Examples

The following example automatically configures the attached modem using the codex_3260 modemcap entry:

modem autoconfigure type Codex_3260

Related Commands

Command	Description
modem autoconfigure discovery	Configures a line to discover which kind of modem is connected to the router and to configure that modem automatically.

Syntax Description

error threshold	Maximum modem error threshold. When the system detects this many errors with the modems, the modem diagnostics test is automatically triggered. Specify a threshold count between 3 and 50.
minimum modem	Minimum number of modems that will remain untested and available to accept calls during each test cycle. You can specify between 5 and 48 modems. The default is 6 modems.
time hh:mm	Time you want the modem autotest to begin. You must use the military time convention and a required colon (:) between the hours and minutes variables for this feature. For example, 1:30 a.m. is issued as 01:30.
interval	(Optional) Long-range time variable used to set the modem autotest more than one day in advance. The range of hours is between 1 hour and 168 hours. For example if you want to run the test once per week, issue 168. There are 168 hours in one week.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.3	This command was introduced.

Examples

The following example shows how to set the modem autotest to run once per week at 3:00 a.m. Additionally, the autotest will activate if the system detects a modem error count higher than 40 errors.

router# show clock
*15:00:01.031 EST Aug 25 1997
 

Step 2 Enter global configuration mode and set the time you want the modem autotest to activate. In this example, the access server is configured to run the modem autotest each ongoing Tuesday at 3:00 a.m:

router# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
router(config)# modem autotest time 03:00 168
 

Step 3 Configure the autotest to activate if the system detects a high modem error count. In this example, the autotest activates if the system detects a modem error count higher than 40 errors. For the list of modem errors that are monitored by the modem autotest command, see the show modem call-stats command.

router(config)# modem autotest error 40
router(config)# exit
router#
%SYS-5-CONFIG_I: Configured from console by console
router#
 

Step 4 Display the results of the modem autotest once the test has run through a test cycle by issuing the show modem test EXEC command:

router# show modem test
 Date Time         Modem  Test               Reason             State Result
 5/15 07:25:17 AM  1/0    Back-To-Back       TIME INTERVAL      Idle  FAIL
 5/15 07:25:17 AM  1/1    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/2    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/3    Back-To-Back       TIME INTERVAL      Idle  FAIL
 5/15 07:25:17 AM  1/4    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/5    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/6    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/7    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/8    Back-To-Back       TIME INTERVAL      Idle  PASS
 5/15 07:25:17 AM  1/9    Back-To-Back       TIME INTERVAL      Idle  PASS
...
 

Alternatively, you can view which modems were marked bad by the modem autotest by issuing the show modem EXEC command. Bad modems are marked by the letter B. In this example, modems 1/0 and 1/3 are marked bad (identified with a B), which takes them out of commission and unable to participate in dial services:

router# show modem
 
                  Inc calls     Out calls    Busied    Failed   No      Succ
  Mdm   Usage    Succ   Fail   Succ   Fail     Out      Dial    Answer  Pct.
B 1/0     0%       0      0      0      0       1        0       0      0%
  1/1     0%       0      0      0      0       3        0       0      0%
  1/2     0%       0      0      0      0       1        0       0      0%
B 1/3     0%       0      0      0      0       1        0       0      0%
  1/4     0%       0      0      0      0       1        0       0      0%
  1/5     0%       0      0      0      0       1        0       0      0%
  1/6     0%       0      0      0      0       1        0       0      0%
  1/7     0%       0      0      0      0       1        0       0      0%
  1/8     0%       0      0      0      0       1        0       0      0%
  1/9     0%       0      0      0      0       1        0       0      0%
...
  1/20    0%       0      0      0      0       0        0       0      0%
  1/21    0%       0      0      0      0       0        0       0      0%
  1/22    0%       0      0      0      0       0        0       0      0%
 

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

If you mark a modem as inoperable, it appears as Bad---without the asterisk (*)---in the Status column of the show modem command output. A modem marked inoperable by the modem startup-test command appears as Bad* in the show modem command output. Use the no modem bad command to unmark a modem as Bad* or Bad and restore it for dialup connection services.

Note Only idle modems can be marked bad by the modem bad command. If you want to mark a modem bad that is actively supporting a call, first issued the modem shutdown command then issue the modem bad command.

Examples

The first part of the following example shows a successful connection between modem 2/1 and modem 2/0, which verifies normal operating conditions between these two modems. However, when modem 2/1 is tested against modem 2/3, the back-to-back modem test fails. Therefore, modem 2/3 is suspected or proven to be inoperable. Modem 2/3 is removed from dial-up services through the use of the modem bad command on line 28.

router# test modem back-to-back 2/1 2/0
Repetitions (of 10-byte packets) [1]: 10
router#
%MODEM-5-B2BCONNECT: Modems (2/1) and (2/0) connected in back-to-back test: CONN
ECT9600/REL-MNP
%MODEM-5-B2BMODEMS: Modems (2/0) and (2/1) completed back-to-back test: success/
packets = 20/20
router# test modem back-to-back 2/1 2/3
Repetitions (of 10-byte packets) [1]: 10
router#
%MODEM-5-BADMODEMS: Modems (2/3) and (2/1) failed back-to-back test: NOCARRIER
router# configure terminal
router(config)# line 28
router(config-line)# modem bad
router(config-line)# end

Related Commands

Command	Description
modem startup-test	Performs diagnostic testing on each integrated modem during the rebooting process.
show modem	Displays a high-level performance report for all the modems or a single modem.
terminate-from	Diagnoses an integrated modem that may not be functioning properly.

Syntax Description

number

Defined number of modem events that each manageable modem is able to store.

Defaults

100 modem events

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

A large buffer size uses significant amounts of processing memory. If the processing memory is running low, reduce the modem buffer size.

To view modem events, use the show modem log command.

Note This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example enables each modem in the access server to store 150 modem events:

modem buffer-size 150

Related Commands

Command	Description
show modem log	Displays the modem history event status performed on a manageable modem or group of modems.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The disabling action is not executed until the active modem returns to an idle state. No active connections are interrupted when you enter this command.

If a busyout-threshold is set, this command will be delayed until the DS0 lines to the exchange are taken out of service.

For T3 cards the message, No Controller configured, might appear for unconfigured T1 links in the T3.

Examples

The following example disables the modem associated with line 1/0/5 from dialing and answering calls. You do not specify a slot/port number with this command:

line 1/0/5
 modem busyout
 

The following example busyouts a range of modems:

line 1/0/5 1/0/72
 modem busyout
 

The following example disables the modem associated with line 1 from dialing and answering calls. You do not specify a slot or port number with this command:

line 1
 modem busyout

Related Commands

Command	Description
busyout	Informs the central-office switch that a channel is out-of-service.
ds0 busyout	Places one or more DS0s (digital signal level 0s) out of service.
modem shutdown	Abruptly shuts down an active or idle modem installed in an access server or router.

Syntax Description

threshold-number

The number of modems that are free when the router should enforce the stipulation that the number of free DS0 lines is less than or equal to the number of modems.

Command Modes

Global configuration

Command History

Release	Modification
11.3(2)AA	This command was introduced.

Usage Guidelines

The modem busyout-threshold command functionality is also often termed autobusyout. This command applies to all DS0 lines coming into the router and counts all free modems in all pools.

The modem busyout-threshold command periodically checks to see if the number of free modems is less that the user specified threshold and if it is it ensures the number of free DS0 channels is less than or equal to the number of modems.

This command should only be used where excess calls to one router are forwarded by the exchange to an additional router on the same exchange group number.

Since the modem busyout-threshold command checks only periodically, the threshold should be greater than the number of calls the user expects to receive in 1 minute plus a safety margin. For example, if the user receives an average of 10 calls per minute, then a threshold of 20 would be advised. Very small thresholds should be avoided since they do not allow sufficient time for the exchange to respond to out-of-service notifications from the router, and callers may receive busy signals when free modems are all used.

Caution The number of DS0 lines in normal operating conditions should be approximately equal to the number of modems (for example, within 30). If it is not, this will cause a lot of messaging traffic to the exchange and may cause active calls to be dropped. This is not a concern for short periods, that is, when modem cards are replaced.

On T3 controllers, any contained T1 controllers that are not in use should be undeclared to remove them from the autobusyout list.

Examples

The following example shows how you might configure the modem busyout-threshold command:

configure terminal
# modem busyout-threshold 30
# exit

Related Commands

Command	Description
busyout	Informs the central-office switch that a channel is out-of-service.
ds0 busyout	Places one or more DS0s (digital signal level 0s) out of service.
modem busyout	Disables a modem from dialing or answering calls whereby the disabling action is not executed until the active modem returns to an idle state.
modem shutdown	Abruptly shuts down an active or idle modem installed in an access server or router.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

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.

Examples

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

line 10 16
 modem callin
 autobaud

Related Commands

Command	Description
modem answer-timeout	Sets the amount of time that the Cisco IOS software waits for the CTS signal after raising the DTR signal in response to RING.
modem inout	Configures a line for both incoming and outgoing calls.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

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.

Examples

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

Command	Description
modem inout	Configures a line for both incoming and outgoing calls.
show async-bootp	Displays the extended BOOTP request parameters that have been configured for asynchronous interfaces.

Examples

The following example shows the different duplex configuration options you can configure on a Cisco AS5300:

router(config)# modem country mica ?
  australia       Australia
  austria         Austria
  belgium         Belgium
  china           China
  cyprus          Cyprus
  czech-republic  Czech/Slovak Republic
  denmark         Denmark
  e1-default      Defaults E1 (A Law)
  finland         Finland
  france          France
  germany         Germany
  hong-kong       Hong Kong
  india           India
  ireland         Ireland
  israel          Israel
  italy           Italy
  japan           Japan
  malaysia        Malaysia
  netherlands     Netherlands
  new-zealand     New Zealand
  norway          Norway
  poland          Poland
  portugal        Portugal
  russia          Russia
  singapore       Singapore
  south-africa    South Africa
  spain           Spain
  sweden          Sweden
  switzerland     Switzerland
  t1-default      Defaults T1 (u Law)
  taiwan          Taiwan
  thailand        Thailand
  turkey          Turkey
  united-kingdom  United Kingdom
  usa             USA

Related Commands

Command	Description
modem country microcom_hdms	Configures the modem country code for a bank of Microcom modems.

Syntax Description

country

Specifies a type of country code. Replace the argument country with one of the supported country names in Table 18.

Defaults

No country code enabled.

Command Modes

Global configuration

Usage Guidelines

Command History

Release	Modification
11.2P	This command was introduced.
12.0	The europe keyword was added.

Examples

The following example shows the different duplex configuration options you can configure on a Cisco AS5300:

router(config)# modem country microcom_hdms ?
  argentina       Argentina
  australia       Australia
  austria         Austria
  belgium         Belgium
  chile           Chile
  china           China
  columbia        Columbia
  czech-republic  Czech/Slovak Republic
  denmark         Denmark
  europe          Europe
  finland         Finland
  france          France
  germany         Germany
  greece          Greece
  hong-kong       Hong Kong
  india           India
  indonesia       Indonesia
  ireland         Ireland
  israel          Israel
  italy           Italy
  japan           Japan
  korea           Korea
  malaysia        Malaysia
  mexico          Mexico
  netherlands     Netherlands
  new-zealand     New Zealand
  norway          Norway
  peru            Peru
  philippines     Philippines
  poland          Poland
  portugal        Portugal
  saudi-arabia    Saudi Arabia
  singapore       Singapore
  south-africa    South Africa
  spain           Spain
  sweden          Sweden
  switzerland     Switzerland
  taiwan          Taiwan
  thailand        Thailand
  united-kingdom  United Kingdom
  usa             USA

Related Commands

Command	Description
modem country mica	Configures the modem country code for a bank of MICA modems.

Syntax Description

This command has no arguments or keywords.

Defaults

Do not permit incoming calls to the modem.

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

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

Examples

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

line 5
 modem dialin 

Related Commands

Command	Description
modem inout	Configures a line for both incoming and outgoing calls.
parity	Defines generation of a parity bit.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

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.

Examples

The following example configures a line for low DTR:

line 5
 modem dtr-active

Related Commands

Command	Description
modem cts-required	The modem printer command replaces this command.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is also used to reset a modem that is frozen in a suspended state. Disable the suspended modem with the modem hold-reset command, and then restart initialization with the no modem hold-reset command.

The modem hold-reset command for the V.110 port module resets the processor on board the module only if the command is executed on all 12 ports. If the modem hold-reset command is issued on only a portion of the V.110 ports, the processor will not reset.

Examples

The following example disables the suspended modem using tty line 4 and resets the modem's initialization:

line 4
 modem hold-reset
 no modem hold-reset
 

The following examples resets a 12-port V.110 port module. You must specify the entire tty line range for the entire bank of ports.

line 1 12
 modem hold-reset
 no modem hold-reset
 exit

Related Commands

Command	Description
modem autotest	Automatically and periodically performs a modem diagnostics test for modems inside the access server or router.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

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

The modem host command is identical in operation to the modem callout command except that DSR/DCD is used for modem control instead of CTS. This frees CTS for use by hardware flow control.

Examples

The following example configures a line to send a DSR/CD active signal to the modem for data switches and hosts:

line 5
 modem host 

Related Commands

Command	Description
modem callout	Configures a line for reverse connections.
modem printer	Configures a line to require a DSR signal instead of CTS.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

This command uses DSR and RING signals for carrier detection.

The Cisco IOS software does not support any dialing protocols; therefore, the host system software or the user must provide any special dialing commands when using the modem for outgoing calls.

Examples

The following example configures a line for both incoming and outgoing calls:

line 5
 modem inout

Related Commands

Command	Description
parity	Defines generation of a parity bit.

Syntax Description

min-speed	Configures the minimum modem speed for all the modems used by this service profile.
speed	Specifies the minimum and maximum bps rate for the modems, which can be between 300 and 56,000 bps. Must be in V.90 increments.
any	Specifies any minimum or maximum speed.
max-speed	Configures the maximum modem speed for all the modems used by this service profile. Must be in V.90 increments.
modulation value	(Optional) Specifies the maximum negotiated speed. Replace the value argument with one of the following choices: any, k56flex, v22bis, v34, or v90.

Defaults

No modem service parameters are defined by default. Any default services provided by the modems will be available.

Command Modes

Service profile configuration

Command History

Release	Modification
12.0(4)XI	This command was introduced.

Usage Guidelines

Use the modem min-speed max-speed service profile configuration command to configure various modem-service parameters:

Examples

The following example shows the modem service parameters for the service profile named user1sample configured for a minimum speed of any, a maximum speed of any, and a modulation of k56flex.

resource-pool profile service user1sample
  modem min-speed any max-speed any modulation k56flex

Syntax Description

number

Maximum number of polling attempts. The configuration range is from 0 to 10 attempts.

Defaults

Three polling attempts

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Higher settings cause the software to keep polling one modem for status and to avoid polling other modems, which decreases the amount of statistics that are gathered.

Note This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example configures the server to attempt to retrieve statistics from a local modem up to five times before discontinuing the polling effort:

modem poll retry 5

Related Commands

Command	Description
clear modem	Resets the hardware for one or more manageable modems on access servers and routers.
modem poll time	Sets the time interval between modem polls, which are used to periodically retrieve and report modem statistics.
modem status-poll	Polls for modem statistics through the out-of-band feature of a modem.

Syntax Description

seconds

Number of seconds between polls. The configuration range is from 2 to 120 seconds.

Defaults

12 seconds

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example sets the time interval between polls to 10 seconds:

modem poll time 10

Related Commands

Command	Description
modem min-speed max-speed	Sets the maximum number of polling attempts used to retrieve performance statistics from a modem installed in an access server or router.
modem status-poll	Polls for modem statistics through the out-of-band feature of a modem.

Syntax Description

This command has no arguments or keywords.

Defaults

No modem control

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command uses Ring/Data Carrier Detect/Data Set Ready as the modem control signals instead of CTS. This leaves CTS free for use in hardware flow control. You can configure hardware flow control concurrently with the modem printer command.

While the modem dialin command supports modems concurrently with hardware flow control, the other auxiliary modem control options for printers, such as modem cts-required, use CTS instead of DSR/CD, as the Carrier Detect (CD) signal.

Examples

The following example configures a line to send a DSR signal to the modem:

line 5
 modem printer

Syntax Description

disable	Mark the modem bad.
download	Recover by firmware download. Sets the modem into a recovery pending state, thus, stopping the modem from accepting new calls.
none	Do not try to recover. Ignore the recovery threshold and just keep going.

Defaults

The default setting is modem recovery action download.

Command Modes

Global configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

MICA portware is downloaded on a modular basis and not on a modem basis. Thus, reloading MICA portware requires all 6 modems (or 12) in a module to be re-loaded.

After a modem has been deemed faulty, the configured action will take place on the modem. The following choices are possible: disable, download, and none.

Examples

The following example shows the available options for this command:

modem recovery action ?
  disable   Mark the modem bad
  download  Recover by firmware download
  none      Do not try to recover

Related Commands

Command	Description
modem recovery maintenance	Specifies the scheduled modem maintenance recovery behavior.
modem recovery threshold	Specifies the threshold, which starts the modem recovery process.
modem recovery-time	Sets the maximum amount of time the call-switching module waits for a local modem to respond to a request before it is considered locked in a suspended state.

Syntax Description

action	Mode of recovery. The default is set to reschedule.
disable	Mark the modem bad. Mark the originally faulty modem as bad and return all other modems back into service.
drop-call	Force firmware download by dropping holding calls. This forces the recovery by dropping any active calls remaining on modems within the module.
reschedule	Reschedule firmware download to next maintenance time. Leave the originally faulty modem as needing recovery and return all other modems back into service. Recovery will be attempted again on the following day. The default is set to reschedule.
max-download number	Maximum simultaneous recovery downloads. You must choose one number from 1 to 30. A range of values is not supported.
schedule	Scheduling method for modem recovery. Determines if the system should attempt module recovery as soon as a problem is found or wait for the maintenance window.
immediate	Immediately attempt module recovery.
pending	Delay recovery until maintenance time.
time hh:mm	Time of day for scheduled modem recovery. This is the actual time of day when the modem recovery maintenance process wakes up and starts recovering MICA technologies modems. The default time is 3:00 AM.
window minutes	Amount of time for normal recovery to take place. This is the delay timer in minutes, which is from 0 to 360.

Defaults

The default mode of recovery (action) is set to reschedule.

The default schedule is set to pending.

The default time for scheduled modem recovery is 3:00 AM.

Command Modes

Global configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

MICA portware is downloaded on a modular basis and not on a modem basis. Thus, reloading MICA portware requires all 6 modems (or 12) in a module to be re-loaded.

Every 24 hours, the modem recovery maintenance process will wake up and attempt to recover any modems which are in the pending recovery state.

When a MICA module attempts to reload its portware, it must avoid taking down any modem connections that may exist. As such, the recovery process sets all modems currently not in use to recovery pending state. If any modems on the module are active, the recovery process waits for the calls to terminate normally. To avoid capacity problems from attempting recovery for an excessively long time period, a maintenance window is configured to require the modem recovery to take place within a specific timeframe. Otherwise, a given action is performed on that module when the window expires. The default window is 60 minutes. This behavior is set using the modem recovery maintenance window minutes command.

When the modem recovery maintenance window expires, one of the following actions is performed on the modem module awaiting recovery: disable, reschedule, or drop-call. These options are associated with the modem recovery action command.

When the modem recovery maintenance process starts, it attempts to recover all modems in the recovery pending state. This can potentially be all modules on a given system. Thus, to avoid taking down all modems on a given system, only a maximum of simultaneous module recoveries can take place. The default is dynamically calculated to be 20% of the modules on a given system. This configuration allows that value to be overridden. These options are associated with the modem recovery maintenance max-download number command.

Examples

The following example shows the available options for this command:

modem recovery maintenance ?
  action        Mode of recovery
  max-download  Maximum simultaneous recovery downloads
  schedule      Scheduling method for modem recovery
  time          Time of day for scheduled modem recovery
  window        Amount of time for normal recovery to take place
 
modem recovery maintenance action ?
  disable     Mark the modem bad
  drop-call   Force firmware download by dropping holding calls
  reschedule  Reschedule firmware download to next maintenance time
 
modem recovery maintenance max-download ?
  <1-30>  Number of MICA modules which can be simultaneously recovered
 
modem recovery maintenance schedule ?
  immediate  Attempt recovery immediately
  pending    Delay recovery until maintenance time

Related Commands

Command	Description
modem recovery action	Specifies the modem recovery mode when a modem has been identified as faulty.
modem recovery threshold	Specifies the threshold, which starts the modem recovery process.
modem recovery-time	Sets the maximum amount of time the call-switching module waits for a local modem to respond to a request before it is considered locked in a suspended state.

Syntax Description

number

Number of consecutive call attempts, which fail to train up, before the modem is deemed faulty. Choose from 1 to 1000.

Defaults

30 call attempts are enabled by default.

Command Modes

Global configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

MICA technologies portware is downloaded on a modular basis and not on a modem basis. Thus, reloading MICA portware requires all 6 modems (or 12) in a module to be reloaded.

Examples

The following example shows the variable number for this command:

modem recovery threshold ?
  <1-10000>  Number of failures after which modem recovery is started
 

Related Commands

Command	Description
modem recovery action	Specifies the modem recovery mode when a modem has been identified as faulty.
modem recovery maintenance	Specifies the scheduled modem maintenance recovery behavior.
modem recovery-time	Sets the maximum amount of time the call-switching module waits for a local modem to respond to a request before it is considered locked in a suspended state.

Syntax Description

minutes

Maximum amount of time local modems wait for a response.

Defaults

5 minutes

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Note This command does not apply to basic modems that do not have out-of-band ports.

After the call-switching module resets a suspended modem, it recovers to a default call switching module state.

Examples

The following example configures the call-switching module to wait for 8 minutes:

modem recovery-time 8

Related Commands

Command	Description
modem recovery action	Specifies the modem recovery mode when a modem has been identified as faulty.
modem recovery maintenance	Specifies the scheduled modem maintenance recovery behavior.
modem recovery threshold	Specifies the threshold, which starts the modem recovery process.

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Enable the no modem shutdown command to restore to service a modem that has been shut down.

Examples

The following example abruptly shuts down the modem associated with line 1/0/6. All active calls on the modem are dropped immediately.

line 1/0/6
 modem shutdown
 

The following example abruptly shuts down a range of modems:

line 1/0/5 1/0/72
 modem shutdown
 

 line 2
  modem shutdown

Related Commands

Command	Description
modem busyout	Disables a modem from dialing or answering calls whereby the disabling action is not executed until the active modem returns to an idle state.

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The results of the modem startup test output are displayed in the Status column of the show modem command. Modems that pass the diagnostic test are marked as Idle, Busy, Downloading, and Reset. Modems that fail the diagnostic test are marked as Bad*. These modems cannot be used for call connections. Depending on how many modems are installed, this diagnostic test may take from 5 to 15 minutes to complete.

Perform additional testing on an inoperative modem by executing the test modem back-to-back command. The no modem startup-test command disables startup testing.

Examples

The following example performs a startup test on the integrated Cisco AS5200 modems:

configure terminal
 modem startup-test
 

Display the results of the modem startup test after you restart the system by enabling the show modem command.

Related Commands

Command	Description
modem autotest	Automatically and periodically performs a modem diagnostics test for modems inside the access server or router.
show modem at-mode	Displays a list of the manageable Microcom modems that have open AT sessions and a list of users logged in to those sessions.
terminate-from	Diagnoses an integrated modem that may not be functioning properly.

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Line configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command applies only to manageable modems that have out-of-band ports.

Note This command does not apply to basic modems, which do not have out-of-band ports.

Examples

The following example enables modem status polling through TTY line 1:

 line 1
  modem status-poll

Related Commands

Command	Description
modem min-speed max-speed	Sets the maximum number of polling attempts used to retrieve performance statistics from a modem installed in an access server or router.
modem poll time	Sets the time interval between modem polls, which are used to periodically retrieve and report modem statistics.

Syntax Description

modem-name	Name of the modem whose values are being edited.
attribute	Modem capability, or attribute, as defined by the show modemcap command.
value	The AT command equivalent (such as &F).

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

Modemcaps are printed within the configuration file. You can edit them using this command.

Configure one attribute of one modem at a time. See the modem-capability values defined by the show modemcap command.

Examples

The following example adds the factory default entry, &F, to the configuration file. This entry, and others like it, are stored in a database that is referenced by the configuration file.

modemcap edit Codex_3250 factory-default &F 

Related Commands

Command	Description
modemcap entry	Stores and compresses information about the capability of a specified modem.
show modemcap	Displays the values set for the current modem and lists the modems for which the router has entries.

Syntax Description

modem-type

Type of supported modem as specified in Table 19.

Defaults

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command displays the capability of the specified modem.

Modemcaps are printed within the configuration file and are intended to be edited using the modemcap edit command. The modemcap entry command does not display values that are not set in the modem.

Related Commands

Command	Description
modem hold-reset	Resets and isolates integrated modems for extensive troubleshooting.
show modemcap	Displays the values set for the current modem and lists the modems for which the router has entries.

Syntax Description

name	Specifies the name of a modem pool.

Defaults

All modems are configured to be part of one system default modem pool (displayed as System-def-Mpool by the show modem-pool command.). For example, if you have 120 MICA technologies modems loaded in your access server, then 120 modems are in the default modem pool.

Command Modes

Global configuration

Command History

Release	Modification
11.2P	This command was introduced.

Usage Guidelines

Modem pools enable you to physically partition or virtually partition your access server for dial-in and dial-out access.

Physical partitioning is makes one access server appear as if it is multiple access servers loaded with different types of modem services (for example, v.34 modems, fax capable modems, and point-of-sale (POS) modems). Each service is part of one modem pool and assigned a unique DNIS number.

Virtual partitioning is creates one large modem pool on the access server, but enables different customers to dial-in and share the modem resources. Each customer is assigned its own DNIS number. Each customer is given overflow protection, which guarantees a certain number of simultaneous connections.

Note MICA and Microcom modems support incoming analog calls over ISDN PRI. However, only MICA modems support modem pooling for CT1 and CE1 configurations with channel associated signaling.

Examples

The following example creates a modem pool called v90service. After the modem-pool v90service command is issued, modem pool configuration mode is accessed. The access server's prompt changes from as5300(config)# to as5300(config-modem-pool)#.

modem-pool v90service
 

The next example assigns modem TTY line numbers 30 to 50 to a modem pool. The DNIS number is set to 2000. The customers dialing the number 2000 are guaranteed access to 21 modems. The 22nd client to dial in is refused connectivity because the maximum number of allowable connections is exceeded.

pool-range 30-50
called-number 2000 max-conn 21
exit

Related Commands

Command	Description
called-number	Assigns a called party number to a pool of modems.
clear modempool-counters	Clears active or running counters associated with one or more modem pools.
pool-member	Assigns a range of modems to a modem pool.
show modem-pool	Displays the configuration and connection status for one or more modem pools.