-
Cisco IOS Dial Technologies Command Reference, Release 12.2
-
Using Cisco IOS Software
-
Commands A through CAS
-
Commands CHA through CPP
-
Commands D
-
Commands EN through IP
-
Commands IS through L2
-
Commands LCP through MOD
-
Commands MU through PPP
-
Commands PRI through SHE
-
Commands SHOW A through SHOW DI
-
Commands SHOW DS through SHOW LI
-
Commands SHOW M through SHOW N
-
Commands SHOW P through SHOW R
-
Commands SHOW S through SHOW V
-
Commands SHU through X
-
Index
-
Table Of Contents
virtual-profile virtual-template
vpdn authorize directed-request
vty-async ipx ppp-client loopback
shutdown (port)
To disable a port, use the shutdown command in port configuration mode. To change the administrative state of a port from out-of-service to in service, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
Port is enabled.
Command Modes
Port configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(3)T
This command was implemented on the Cisco AS5800.
Usage Guidelines
The shutdown command disables a port.
Note
The shutdown command is similar to the modem shutdown MICA modem command.
Examples
The following example disables ports 1 to 18 then re-enables them:
port 1/1 1/18shutdownno shutdownexitRelated Commands
shutdown (spe)
To take a Service Processing Element (SPE) out of service, use the shutdown command in SPE configuration mode. To change the administrative state of this SPE from down to up, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
SPE is enabled.
Command Modes
SPE configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(3)T
This command was implemented on the Cisco AS5800.
Examples
The following example disables SPE ports 1 to 18 then re-enables them:
spe 1/1 1/18shutdownno shutdownRelated Commands
signaling-class cas
To define a signalling class with a template formed by directives guiding the Call Service Module (CSM) to process the digit sequence, use the signaling-class cas command in global configuration mode. To remove the signalling class assignment, use the no form of this command.
signaling-class cas name
no signaling-class cas name
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Usage Guidelines
The signalling class is referred by the name argument.
Examples
The following example enables the signaling-class cas command:
signaling-class cas testprofile incoming S<*a<*d<*ncontroller T1 1/0/1cas-custom 1class testRelated Commands
Activates the signaling-class cas command.
Defines a template formed by directives guiding the CSM to process the digit sequence for a signaling class.
snapshot client
To configure a client router for snapshot routing, use the snapshot client command in interface configuration mode. To disable a client router, use the no form of this command.
snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]
no snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]
Syntax Description
Defaults
Snapshot routing is disabled.
The active-time and quiet-time arguments have no default values.
Command Modes
Interface configuration
Command History
Usage Guidelines
The value of the active-time argument must be the same for the client and server routers.
To specify that the remote server routers be called by this client router during each active period, use the dialer map snapshot command.
Examples
The following example configures a client router for snapshot routing:
interface dialer 1snapshot client 5 600 suppress-statechange-updates dialerRelated Commands
snapshot server
To configure a server router for snapshot routing, use the snapshot server command in interface configuration mode. To disable a server router, use the no form of this command.
snapshot server active-time [dialer]
no snapshot server active-time [dialer]
Syntax Description
Defaults
Snapshot routing is disabled.
The active-time argument has no default value.
Command Modes
Interface configuration
Command History
Usage Guidelines
The value of the active-time argument must be the same for the client and server routers.
Examples
The following example configures a server router for snapshot routing:
interface dialer 1snapshot server 5Related Commands
Displays snapshot routing parameters associated with an interface.
Configures a client router for snapshot routing.
source template
To attach a configured customer profile template to a particular customer profile, use the source template command in customer profile configuration mode.
source template name
Syntax Description
Defaults
No templates are sourced or attached to a customer profile.
Command Modes
Customer profile configuration
Command History
Usage Guidelines
All PPP and peer-default commands are allowed for a particular customer profile template under this grouping.
Examples
The following example shows the creation and configuration of a customer profile template named acme-direct and its subsequent assignment to the customer profile acme1:
template acme-directmultilink {max-fragments num | max-links num | min-links num}peer match aaa-poolspeer default ip address pool acme-numbersppp ipcp dns 10.1.1.1 10.2.2.2ppp multilinkexitresource-pool profile customer acme1source template acme-directRelated Commands
Accesses the template configuration mode for configuring a particular customer profile template.
source-ip (VPDN)
To specify an IP address that is different from the physical IP address used to open a virtual private dialup network (VPDN) tunnel for the tunnels associated with a VPDN group, use the source-ip command in VPDN group configuration mode. To remove the alternate IP address, use the no form of this command.
source-ip ip-address
no source-ip
Syntax Description
Command Default
No alternate IP address is specified.
Command Modes
VPDN group configuration
Command History
Usage Guidelines
Use the source-ip command in VPDN group configuration mode to configure an alternate IP address to be used for only those tunnels associated with that VPDN group. Each VPDN group on a router can be configured with a unique source-ip command.
Use the vpdn source-ip command to specify a single alternate IP address to be used for all tunnels on the device. A single source IP address can be configured globally per device.
The VPDN group-level configuration will override the global configuration.
Examples
The following example configures a network access server (NAS) to accept Layer 2 Tunnel Protocol (L2TP) dial-out calls using the alternate IP address 172.23.33.7, which is different from the physical IP address used to open the L2TP tunnel:
vpdn-group 3accept-dialoutprotocol l2tpdialer 2terminate-from hostname router21source-ip 172.23.33.7Related Commands
spe
To enter Service Processing Element (SPE) configuration mode and set the range of SPEs, use the spe command in global configuration mode.
Cisco AS5400 with NextPort DFC
spe {slot | slot/spe}
Cisco AS5800 with Universal Port Card
spe {shelf/slot | shelf/slot/spe}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
The spe global configuration command enables the SPE configuration mode. Configure your SPE by specifying a slot and an SPE associated with the slot; or, you can configure a range of SPEs by specifying the first and last SPE in the range.
When the access server is booted, the spe global configuration command specifies the location from which the firmware image is downloaded to the SPE. If the spe configuration command is used to download the firmware from Flash memory and subsequently the no version of the exact command is entered, then the spe command downloads the embedded firmware.
Note
Caution
Examples
The following example shows the spe command being used from global configuration mode to access the SPE configuration mode for the range of SPEs from 1/2 to 1/4 on the Cisco AS5400:
Router(config)# spe 1/2 1/4The following example specifies the range for use of the shutdown command:
Router(config)# spe 1/1 1/18Router(config-spe)# shutdownRouter(config-spe)# no shutdownRouter(config-spe)#Related Commands
spe call-record modem
To generate a modem call record at the end of each call, use the spe call-record modem command in global configuration mode. To cancel the request to generate the reports, use the no form of the command.
spe call-record modem {max-userid number | quiet}
no spe call-record modem {max-userid number | quiet}
Syntax Description
max-userid number
Maximum length of User ID for the modem call record report in number of bytes. The range is 0 to 100.
quiet
Disables logging to console and terminal, but not to syslog.
Defaults
SPE call record is enabled.
Command Modes
Global configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(3)T
This command was implemented on the Cisco AS5800.
Usage Guidelines
The spe modem-call-record command generates a modem call record at the end of each call.
Note
Examples
The following example displays SPE call record:
Router# configure terminalRouter(config)# spe call-record modem max-userid 50Router(config)# endRouter#00:18:30: %SYS-5-CONFIG_I: Configured from console by consoleRouter# write memoryBuilding configuration...[OK]The following is an example of traces generated when a call terminates. The logs from the show port modem log command do not change as a result of using the spe call-record modem command.
...%LINK-3-UPDOWN: Interface Async5/105, changed state to down%MODEMCALLRECORD-6-PM_TERSE_CALL_RECORD: DS0 slot/contr/chan=4/2/15,shelf/slot/port=5/37, call_id=EE, userid=touraco-e1-4, ip=79.188.24.1,calling=(n/a), called=35160, std=V.34+, prot=LAP-M, comp=V.42bis,init-rx/tx b-rate=33600/33600, finl-rx/tx b-rate=33600/33600, rbs=0,d-pad=None, retr=1, sq=5, snr=10495, rx/tx chars=286/266, bad=0, rx/txec=16/6, bad=0, time=96, finl-state=Steady Retrain,disc(radius)=(n/a)/(n/a), disc(modem)=1F00 <unknown>/Requested byhost/non-specific host disconnect%MODEMCALLRECORD-6-PM_TERSE_CALL_RECORD: DS0 slot/contr/chan=4/1/24,shelf/slot/port=5/38, call_id=FD, userid=touraco-e1-4, ip=79.205.24.1,calling=(n/a), called=35170, std=V.34+, prot=LAP-M, comp=V.42bis,init-rx/tx b-rate=33600/33600, finl-rx/tx b-rate=33600/33600, rbs=0,d-pad=None, retr=1, sq=5, snr=10495, rx/tx chars=289/267, bad=0, rx/txec=17/7, bad=0, time=93, finl-state=Steady Retrain,disc(radius)=(n/a)/(n/a), disc(modem)=1F00 <unknown>/Requested byhost/non-specific host disconnect%MODEMCALLRECORD-6-PM_TERSE_CALL_RECORD: DS0 slot/contr/chan=4/3/15,shelf/slot/port=5/2, call_id=FF, userid=touraco-e1-4, ip=79.200.24.1,calling=(n/a), called=35170, std=V.34+, prot=LAP-M, comp=V.42bis,init-rx/tx b-rate=33600/33600, finl-rx/tx b-rate=33600/33600, rbs=0,d-pad=None, retr=1, sq=5, snr=10495, rx/tx chars=287/270, bad=0, rx/txec=17/7, bad=0, time=92, finl-state=Steady Retrain,disc(radius)=(n/a)/(n/a), disc(modem)=1F00 <unknown>/Requested byhost/non-specific host disconnect%MODEMCALLRECORD-6-PM_TERSE_CALL_RECORD: DS0 slot/contr/chan=4/3/10,shelf/slot/port=5...spe country
To specify the country while setting the Universal Port DFC parameters (including country code and encoding), use the spe country command in global configuration mode. To set the country code to the default value, use the no form of this command.
spe country country-name
no spe country country-name
Syntax Description
country-name
Name of the country; see Table 127 for a list of supported country name keywords.
Defaults
Disabled
Command Modes
Global configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(3)T
This command was implemented on the Cisco AS5800.
Usage Guidelines
The spe country command is similar to the modem country command. On the Cisco access server, DS0 companding law selection is configured for the entire system rather than on individual voice ports. Set spe country to the appropriate country. A list of all supported countries is displayed in Table 127.
If T1s are configured, the default is t1-default; if E1s are configured, the default is e1-default.
The Cisco access server must be in an Idle state (no calls are active) to execute the spe country command. All sessions on all modules in all slots must be Idle.
Examples
The following example configures the setting of the country code to the default for E1:
spe country e1-defaultThe following example configures the setting of the country code to the default for T1:
spe country t1-defaultRelated Commands
spe download maintenance
To perform download maintenance on Service Processing Elements (SPEs) that are marked for recovery, use the spe download maintenance command in global configuration mode. To unmark the ports, use the no form of the command.
spe download maintenance {time hh:mm | stop-time hh:mm | max-spes num-of-spes| window time-period | expired-window {drop-call | reschedule}}
no spe download maintenance {time hh:mm | stop-time hh:mm | max-spes num-of-spes| window time-period | expired-window {drop-call | reschedule}}
Syntax Description
Defaults
Enabled
Command Modes
Global configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(3)T
This command was implemented on the Cisco AS5800.
Usage Guidelines
The SPE download maintenance activity takes place when SPEs are marked for recovery. The settings are enabled by default. When you want to change the default settings to a desired setting, use the spe download maintenance command parameters to perform SPE download maintenance activity with the specific changes.
Enter the time hh:mm keyword to set a time to start the SPE download maintenance activity. Then enter the stop-time hh:mm keyword to set a time to stop the download maintenance. Next enter the max-spes num-of-spes keyword to set the number of SPEs for the download maintenance. Then enter the window time-period keyword to set a time period to perform the download maintenance. Finally, enter the expired-window keyword to set actions in the event the SPE download maintenance is not completed in the set window time-period.
The download maintenance activity starts at the set start time and steps through all the SPEs that need recovery and the SPEs that need a firmware upgrade and starts maintenance on the maximum number of set SPEs for maintenance. The system waits for the window delay time for all the ports on the SPE to become inactive before moving the SPE to the Idle state. Immediately after the SPE moves to Idle state, the system starts to download firmware. If the ports are still in use by the end of window delay time, depending upon the expired-window setting, connections on the SPE ports are shutdown and the firmware is downloaded by choosing the drop-call option, or the firmware download is rescheduled to the next download maintenance time by choosing the reschedule option. This process continues until the number of SPEs under maintenance is below max-spes, or until stop-time (if set), or until all SPEs marked for recovery or upgrade have had their firmware reloaded.
Examples
The following example displays the SPE download maintenance with the different keyword parameters:
spe download maintenance time 03:00spe download maintenance stop-time 04:00spe download maintenance max-spes 50spe download maintenance window 30spe download maintenance expired-window rescheduleRelated Commands
spe log-size
To set the size of the port event log, use the spe log-size command in global configuration mode. To restore the default size, use the no version of this command.
spe log-size number
no spe log-size
Syntax Description
number
The number of recorded events. Valid values for the number argument range from 0 to 100. The default value is 50 events.
Command Default
The port event log records 50 events.
Command Modes
Global configuration
Command History
Examples
The following example sets the size of the event log to 70 events:
Router(config)# spe log-size 70Related Commands
show port digital log
Displays the digital data event log with the oldest event first.
show port modem log
Displays the modem port history event log or modem test log.
spe recovery
To set a service processing element (SPE) port for recovery, use the spe recovery command in global configuration mode. To disable SPE recovery or to restore the default port-threshold value, use the no form of this command.
spe recovery {port-action {disable | recover} | port-threshold number-failures}
no spe recovery {port-action | port-threshold}
Syntax Description
Defaults
There is no default port-action value. SPE recovery is disabled.
The default port-threshold value is 30 failed attempts.Command Modes
Global configuration
Command History
12.1(1)XD
This command was introduced on the Cisco AS5400.
12.1(2.3)T1
This command was implemented on the Cisco AS5800.
Usage Guidelines
Failure of an SPE port to connect after repeated tries indicates that a problem exists in the SPE or firmware. An SPE port in this state is recovered by downloading firmware.
When an SPE port fails to connect consecutively for a number of times, as specified by the port-threshold number-failures keyword and argument, the SPE is moved to a state based on the port-action configuration.
If the spe recovery port-action recover command has been configured, when the port-threshold number-failures value is exceeded, the port is temporarily marked as disabled ("d" state) to avoid further incoming calls, and it is then marked for recovery ("r" state). Any SPE that has a port marked for recovery will download firmware when the SPE is idle (when none of the ports on the SPE have active calls).
If the spe recovery port-action disable command has been configured, when the port-threshold number-failures value is exceeded, the port is marked as bad ("BAD" state). An SPE with a port that is marked as bad must be explicitly cleared in order for that port to be used again.
If no port-action is configured, the port will be marked as not in use ("_" state). An SPE with a port marked as not in use will remain unusable until it is explicitly cleared, and the SPE will not accept incoming calls on any of the ports.
SPE recovery can be disabled by issuing the no spe recovery port-action command. If SPE recovery is disabled, the SPE will behave as if no port-action has been configured.
Note
Examples
The following example configures the SPE to recover ports that exceed the call failure threshold:
Router(config)# spe recovery port-action recoverThe following example sets a value of 50 for the number of consecutive failed attempts on the port before the port-action keyword is applied:
Router(config)# spe recovery port-threshold 50Related Commands
start-character
To set the flow control start character, use the start-character command in line configuration mode. To remove the character, use the no form of this command.
start-character ascii-number
no start-character
Syntax Description
Defaults
Decimal 17
Command Modes
Line configuration
Command History
Usage Guidelines
This command defines the character that signals the start of data transmission when software flow control is in effect. Refer to the "ASCII Character Set" appendix in the Cisco IOS Configuration Fundamentals Command Reference for a list of ASCII characters.
Examples
The following example changes the start character to Ctrl-B, which is decimal 2:
line 2start-character 2Related Commands
start-chat
To specify that a chat script start on a specified line at any point, use the start-chat command in privileged EXEC mode. To stop the chat script, use the no form of this command.
start-chat regexp [line-number [dialer-string]]
no start-chat
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command provides modem dialing commands for a chat script that you want to apply immediately to a line. If you do not specify a line, the script runs on the current line. If the specified line is already in use, the script is not activated and an error message appears.
The argument regexp is used to specify the name of the modem script that is to be executed. The first script that matches the argument in this command and the dialer map command will be used. For more information about regular expressions, refer to the "Regular Expressions" appendix in this publication.
This command functions only on physical terminal (TTY) lines. It does not function on virtual terminal lines.
Examples
The following example forces a dialout on line 8 using the script telebit:
start-chat telebit line 8Related Commands
stop-character
To set the flow control stop character, use the stop-character command in line configuration mode. To remove the character, use the no form of this command.
stop-character ascii-number
no stop-character
Syntax Description
Defaults
Decimal 19
Command Modes
Line configuration
Command History
Usage Guidelines
This command defines the character that signals the end of data transmission when software flow control is in effect. Refer to the "ASCII Character Set" appendix in the Cisco IOS Configuration Fundamentals Command Reference for a list of ASCII characters.
Examples
The following example changes the stop character to Ctrl-E, which is decimal 5:
line 3stop-character 5Related Commands
Sets the method of data flow control between the terminal or other serial device and the router.
Sets the flow control start character.
Sets the flow control stop character.
syscon address
To specify the system controller for a managed shelf, use the syscon address command in global configuration mode. To stop the management of the shelf by the system controller, use the no form of this command.
syscon address ip-address password
no syscon address
Syntax Description
<
