|
|
This chapter explains the function and syntax of the Cisco IOS dial services commands from LC through MOD. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Dial Services Command Reference, Release 12.1.
To allow the L2TP Network Server (LNS) to renegotiate the Link Control Protocol (LCP) on dial-in calls, using Layer 2 Tunneling Protocol (L2TP) or Layer 2 Forwarding ( L2F), use the lcp renegotiation command in VPDN group configuration mode. To remove LCP renegotiation, use the no form of this command.
lcp renegotiation {always | on-mismatch}
Syntax Description
always Always renegotiates PPP LCP at the LNS. on-mismatch Renegotiates PPP LCP at the LNS only in the event of an LCP mismatch between the LAC and LNS.
To define the base number of simultaneous connections that can be done in a single customer or Virtual Private Dialup Network (VPDN) profile, use the limit base-size command in customer profile configuration mode or VPDN profile configuration mode. Use the no form of this command to remove the limitation.
limit base-size {number | all}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. |
To define the number of overflow calls granted to one customer or Virtual Private Dialup Network (VPDN) profile, use the limit overflow-size command in customer profile configuration mode or VPDN profile configuration mode. Use the no form of this command to remove the overflow configuration.
limit overflow-size {number | all}Syntax Description
number | Specifies the number of overflow calls. |
all | Allows an unlimited number of overflow calls. |
To identify a specific line for configuration and begin the command in line configuration mode collection mode, use the line command in global configuration mode.
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.
To configure the Cisco MC3810 BRI port to supply line power to the terminal equipment (TE), use the line-power command in interface configuration mode. To disable the line power supply, use the no form of this command.
line-powerSyntax Description
This command has no arguments or keywords.
This command is a preference weighted multiple entries command. Within the same server, the link preference is specified in weighting. Use the no form of this command to disable this function.
link {hostname name | address ip-address} source interface weight number
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.
To configure endpoints for load sharing, use the loadsharing command in VPDN group configuration mode. To remove this function, use the no form of this command.
loadsharing ip ip-address [limit number]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. |
To specify a local host name that the tunnel will use to identify itself, use the local name command in global configuration mode. To remove a local name, use the no form of this command.
local name name
Syntax Description
name Local host name of the tunnel.
To set up a temporary password on a line, use the lock command in EXEC mode.
lockSyntax Description
This command has no arguments or keywords.
To change a login username, use the login command in EXEC mode.
loginSyntax Description
This command has no arguments or keywords.
To enable password checking at login, use the login command in line configuration mode. Use the no form of this command to disable password checking and allow connections without a password.
login [local | tacacs]
Syntax Description
local (Optional) Selects local password checking. Authentication is based on the username specified with the username global configuration command. tacacs (Optional) Selects the TACACS-style user ID and password-checking mechanism.
To define a string of characters that the Cisco IOS software sends to a host after a successful Telnet connection, use the login-string command in global configuration mode. Use the no form of this command to remove the login string.
login-string hostname d message [%secp] [%secw] [%b] [%m] d
Syntax Description n
hostname Specifies the name of the host. d Sets a delimiting character of your choice---a pound sign (#) for example. You cannot use the delimiting character in the busy message. message Specifies the login string. %secp (Optional) Sets a pause in seconds. To insert pauses into the login string, embed a percent sign (%) followed by the number of seconds to pause and the letter "p." %secw (Optional) Prevents users from issuing commands or keystrokes during a pause. %b %m (Optional) Supports TN3270 terminals. Sends only CR and no LINE FEED.
To loop an entire E1 line (including all channel groups defined on the controller) toward the line and back toward the router or access server, use the loopback command in controller configuration mode. Use the no form of this command to remove the loop.
loopbackSyntax Description
This command has no arguments or keywords.
To loop an entire T1 line (including all channel groups defined on the controller) toward the line and the router or access server, use the loopback local command in controller configuration mode. Use the no form of this command to remove the loop.
loopback localSyntax Description
This command has no arguments or keywords.
To loop a channelized T1 or channelized E1 channel group, use the loopback local command in interface configuration mode. Use the no form of this command to remove the loop.
loopback localSyntax Description
This command has no arguments or keywords.
To loop packets from a MIP through the CSU/DSU, over a dedicated T1 link, to the remote CSU at the single destination for this T1 link and back, use the loopback remote command in controller configuration mode. Use the no form of this command to remove the loop.
loopback remoteSyntax Description
This command has no arguments or keywords.
To define a class of shared configuration parameters associated with the dialer map command for outgoing calls from an ISDN interface and for PPP callback, use the map-class dialer command in global configuration mode.
map-class dialer classname
Syntax Description
classname Unique class identifier.
To alter the configuration of an asynchronous interface that is a member of a group, use the member command in interface configuration mode. Use the no form of the command to restore defaults set at the group master interface.
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:
To set the amount of time that the Cisco IOS software waits for the Clear to Send (CTS) signal after raising the data terminal ready (DTR) signal in response to RING, use the modem answer-timeout command in line configuration mode. Use the no form of this command to revert to the default value.
modem answer-timeout seconds
Syntax Description
seconds Specifies the timeout interval in seconds.
To open a directly connected session and enter AT command mode, which is used for sending AT commands to Microcom manageable modems, use the modem at-mode command in EXEC mode.
modem at-mode slot/port
Syntax Description
slot/port Slot and modem port number. Remember to include the forward slash (/) when entering this variable.
To permit a Microcom modem to accept a directly connected session, use the modem at-mode-permit command in line configuration mode. The no form of this command disables permission for modems to accept a direct connection.
modem at-mode-permitSyntax Description
This command has no arguments or keywords.
To configure a line to discover what kind of modem is connected to the router and to configure that modem automatically, use the modem autoconfigure discovery command in line configuration mode. Use the no form of this command to disable this feature.
modem autoconfigure discoverySyntax Description
This command has no arguments or keywords.
To direct a line to attempt to configure the attached modem using the entry for the modem-name argument, use the modem autoconfigure type command in line configuration mode. Use the no form of this command to disable this feature.
modem autoconfigure type modem-name
Syntax Description
modem-name The name of the modem (such as Codex_3260).
To automatically and periodically perform a modem diagnostics test for modems inside the access server or router, use the modem autotest command in global configuration mode. Use the no form of this command to disable or turn off the modem autotest service.
modem autotest {error threshold | minimum modem | time hh:mm [interval]}
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.
To remove an integrated modem from service and indicate it as suspected or proven to be inoperable, use the modem bad command in line configuration mode. Use the no form of this command to restore a modem to service.
modem badSyntax Description
This command has no arguments or keywords.
To configure the size of the history event queue buffer for integrated modems installed in an access server or router, use the modem buffer-size command in global configuration mode.
modem buffer-size number
Syntax Description
number Defined number of modem events that each manageable modem is able to store.
To gracefully disable a modem from dialing or answering calls, use the modem busyout command in line configuration mode. Use the no form of this command to reenable a modem.
modem busyoutSyntax Description
This command has no arguments or keywords.
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 command in line configuration mode. Use the no form of this command to disable this feature.
modem callinSyntax Description
This command has no arguments or keywords.
To configure a line for reverse connections, use the modem callout command in line configuration mode. Use the no form of this command to disable this feature.
modem calloutSyntax Description
This command has no arguments or keywords.
To configure the modem country code for a bank of MICA technologies modems, use the modem country mica command in global configuration mode. Use the no form of this command to remove a country code from service.
modem country mica country
Syntax Description
country Specifies a type of country code. Replace the argument country with one of the supported country names in Table 9.
australia |
austria |
belgium |
china |
cyprus |
czech-republic (Czech/Slovak Republic) |
denmark |
e1-default (Default E1, A Law) |
finland |
france |
germany |
hong-kong |
india |
ireland |
israel |
italy |
japan |
malaysia |
netherlands |
new-zealand |
norway |
poland |
portugal |
russia |
singapore |
south-africa |
spain |
sweden |
switzerland |
t1-default (Defaults T1, u Law) |
taiwan |
thailand |
turkey |
united-kingdom |
usa |
To configure the modem country code for a bank of Microcom modems, use the modem country microcom_hdms command in global configuration mode. Use the no form of this command to remove a country code from service.
modem country microcom_hdms country
Syntax Description
country Specifies a type of country code. Replace the argument country with one of the supported country names in Table 10.
argentina |
australia |
austria |
belgium |
brazil |
canada |
chile |
denmark |
china |
columbia |
czech-republic (Czech/Slovak Republic) |
denmark |
finland |
france |
germany |
greece |
hong-kong |
hungary |
india |
indonesia |
finland |
israel |
italy |
japan |
korea |
malaysia |
mexico |
netherlands |
norway |
peru |
philippines |
poland |
portugal |
saudi-arabia |
singapore |
south-africa |
spain |
sweden |
switzerland |
taiwan |
thailand |
united-kingdom |
usa |
The modem printer command replaces the modem cts-required command. See the description of the modem printer command for more information.
To configure a line to enable a modem attached to the router to accept incoming calls only, use the modem dialin command in line configuration mode. Use the no form of this command to disable this feature.
modem dialinSyntax Description
This command has no arguments or keywords.
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 command in line configuration mode. Use the no form of this command to disable this feature.
modem dtr-activeSyntax Description
This command has no arguments or keywords.
To reset and isolate integrated modems for extensive troubleshooting, use the modem hold-reset command in line configuration mode. Use the no form of this command to restart a modem.
modem hold-resetSyntax Description
This command has no arguments or keywords.
To configure a line for reverse connections where hardware flow control is also required, use the modem host command in line configuration mode. Use the no form of this command to disable the line modem control for reverse connections.
modem hostSyntax Description
This command has no arguments or keywords.
To configure a line for both incoming and outgoing calls, use the modem inout command in line configuration mode. Use the no form of this command to disable the line.
modem inoutSyntax Description
This command has no arguments or keywords.
To configure various modem-service parameters, use the modem min-speed max-speed command in service profile configuration mode. Use the no form of this command to remove modem parameters.
modem min-speed {speed | any} max-speed {speed | any [modulation value]}
Syntax Description no modem min-speed {speed | any} max-speed {speed | any [modulation value]}
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.
To set the maximum number of polling attempts used to retrieve performance statistics from a modem installed in an access server or router, use the modem poll retry command in global configuration mode.
modem poll retry number
Syntax Description
number Maximum number of polling attempts. The configuration range is from 0 to 10 attempts.
To set the time interval between modem polls, which are used to periodically retrieve and report modem statistics, use the modem poll time command in global configuration mode. Use the no form of this command to restore the 12-second default setting.
modem poll time seconds
Syntax Description
seconds Number of seconds between polls. The configuration range is from 2 to 120 seconds.
To configure a line to require a Data Set Ready (DSR) signal, use the modem printer command in line configuration mode. Use the no form of this command to use Clear to Send (CTS) instead of DSR.
modem printerSyntax Description
This command has no arguments or keywords.
To specify the modem recovery mode, use the modem recovery action command in global configuration mode. Use the no form of this command to turn off this feature.
modem recovery action {disable | download | none}
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.
To specify the modem maintenance recovery behavior, use the modem recovery maintenance command in global configuration mode. Use the no form of this command to turn off this behavior.
modem recovery maintenance {action {disable | drop-call | reschedule} | max-download number | schedule {immediate | pending} | time hh:mm | window minutes}
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.
To specify the threshold, which starts the modem recovery process, use the modem recovery threshold command in global configuration mode. Use the no form of this command to disable the threshold value.
modem recovery threshold number
Syntax Description
number Number of consecutive call attempts, which fail to train up, before the modem is deemed faulty. Choose from 1 to 1000.
To set 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, use the modem recovery-time command in global configuration mode. The no form of this command sets a 5-minute response time, which is the default setting.
modem recovery-time minutes
Syntax Description
minutes Maximum amount of time local modems wait for a response.
The modem dialin command replaces the modem ri-is-cd command. See the description of the modem dialin command for more information.
To abruptly shut down an active or idle modem installed in an access server or router, use the modem shutdown command in line configuration mode. Use the no form of this command to take the modem out of a shutdown state and place it back in service.
modem shutdownSyntax Description
This command has no arguments or keywords.
To perform diagnostic testing on each integrated modem during the rebooting process, use the modem startup-test command in global configuration mode. Use the no form of this command to disable startup testing.
modem startup-testSyntax Description
This command has no arguments or keywords.
To poll for modem statistics through a modem's out-of-band feature, use the modem status-poll command in line configuration mode. Use the no form of this command to disable status polling through the out-of-band feature for a specified modem.
modem status-pollSyntax Description
This command has no arguments or keywords.
To change a modem value that was returned from the show modemcap command, use the modemcap edit command in global configuration mode.
modemcap edit modem-name attribute value
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).
To store and compress information about the capability of a specified modem, use the modemcap entry command in global configuration mode. Use the no form of this command to disable this feature.
modemcap entry modem-type
Syntax Description
modem-type Type of supported modem as specified in Table 11.
| Modem Type | Output |
|---|---|
hayes_optima | FD=&F:AA=S0=1:DTR=&D2:CD=&C1:TPL=default. |
codex_3260 | FD=&F:AA=S0=1:CD=&C1:DTR=&D2:HFL=*FL3:SPD=*SC1:BER=*SM3:BCP=*DC1:NER=*SM1:NCP=*DC0:NEC=E0:NRS=Q1:CID=&S1. |
usr_courier | HFL=&H1&R2:SPD=&B1:BER=&M4:BCP=&K1:NER=&M0:NCP=&K0:TPL=default. |
usr_sportster | TPL=usr_courier. |
hayes_optima | HFL=&K3:BER=&Q5:BCP=&Q9:NER=&Q0:NCP=&Q0:TPL=default. |
viva | HFL=&K3:BER=&Q5:BCP=%C1:NER=&Q6:NCP=%C0:TPL=default. |
telebit_t3000 | HFL=S58=2:BER=S180=3:BCP=S190=1:NER=S180=0:NCP=S190=0:TPL=default. |
To create a new modem pool or to specify an existing modem pool, use the modem-pool command in global configuration mode. Use the no form of this command to delete a modem pool from the access server's configuration.
modem-pool name
Syntax Description
name Specifies the name of a modem pool.
Posted: Wed Jul 26 11:48:13 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.