Syntax Description

range	Channels in the range 1 to 24. A range of channels is shown with a hyphen (-).
primary	(Optional) Function of channel 24: the primary NFAS D channel.
backup	(Optional) Function of channel 24: the backup NFAS D channel.
none	(Optional) Function of channel 24: B channel.
nfas_interface number	Value in the range 0 to 9 assigned by the service provider to ensure unique identification of a PRI interface. The 0 interface number should be assigned to the primary NFAS D channel.
nfas_group number	Group identifier unique on the router. Multiple NFAS groups can exist on the router.

Defaults

Disabled

Command Modes

Controller configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is used to configure the ISDN NFAS feature on Cisco routers for T1 controllers only.

Examples

The following example configures T1 controller 1/0 for PRI and for the NFAS primary D channel. This primary D channel controls all the B channels in NFAS group 1.

controller t1 1/0
 framing esf
 linecode b8zs
 pri-group timeslots 1-24 nfas_d primary nfas_interface 0 nfas_group 1 

Related Commands

Command	Description
show isdn nfas group	Displays all the members of a specified NFAS group or all NFAS groups.

Syntax Description

port-number

RLM port number. See Table 21 for the default port numbers.

Defaults

3000

Command Modes

RLM configuration

Command History

Release	Modification
11.3(7)	This command was introduced.

Usage Guidelines

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.
link (RLM)	Specifies the link preference.
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

limit number	Specifies the maximum number of simultaneous connections supported by the resource group. Replace the number argument with the session limit you want to assign. Your access server's hardware configuration determines the maximum value of this limit. Applicable to ISDN B-channels or HDLC controllers.
port range	Specifies the range of resource ports to use in the resource group. For the Cisco AS5200 and AS5300, replace the range variable with slot/port slot/port.

Defaults

No range is configured.

Command Modes

Resource group configuration

Command History

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

Usage Guidelines

Use the range resource group configuration command to associate a range of modems or other physical resources with a resource group.

Specify the range for port-based resources by using the resource's physical location. Do not identify non-port-based resource ranges by using a location. Rather, specify the size of the resource group with a single integer limit.

Specify non-contiguous ranges by using multiple range port commands within the same resource group. Do not configure the same ports in more than one resource group and do not overlap multiple port ranges.

For resources that are not pooled and have a 1-to-1 correspondence between DS0s, B channels, and HDLC framers, use the range limit number command. Circuit-switched data calls and V.120 calls use these kinds of resources.

Note Do not put heterogeneous resources in the same group. Do not put MICA modems in the same group as Microcom modems. Do not put modems and HDLC controllers in the same resource group. Do not configure "port" and "limit" parameters in the same resource group.

Examples

The following example shows the range limit set for 48 simultaneous connections being supported by the resource group:

resource-pool group resource hdlc1
 range limit 48
 

The following example shows the ports set for modem 1 ranging from port 0 to port 47:

resource-pool group modem1
 range port 1/0 1/47

Syntax Description

name	Assigns a name to a group of physical resources inside the access server. This name can have up to 23 characters.
digital	Accepts digital calls. Specifies circuit-switched data calls that terminate on a HDLC framers (unlike asynchronous analog modem call that use start and stop bits).
speech	Accepts speech calls. Specifies normal voice calls, such as calls started by analog modems and standard telephones.
v110	Accepts V.110 calls.
v120	Accepts V.120 calls. By specifying this keyword, the access server begins counting the number of v120 software encapsulations occurring in the system.
service name	(Optional) Configures a service profile. This option is not supported for digital or V.120 calls.

Defaults

No resources are assigned to the customer profile by default.

Command Modes

Customer profile configuration

Command History

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

Usage Guidelines

Use the resource customer profile configuration command to assign resources and supported call-types to a customer profile. This command specifies a group of physical resources to be used in answering an incoming call of a particular type for a particular customer profile. For example, calls started by analog modems are reciprocated with the speech keyword.

Examples

The following example shows a physical resource group called "modem1". Forty-eight integrated modems are then assigned to modem1, which is linked to the customer profile called "customer1_isp":

resource group resource modem1
 range port 1/0 1/47
 exit

resource-pool profile customer customer1_isp

resource modem1 speech

Related Commands

Command	Description
resource-pool profile customer	Creates a customer profile.

Syntax Description

enable	Enables resource pool management.
disable	Disables resource pool management.

Defaults

Resource management is disabled.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool global configuration command to enable and disable the resource pool management feature.

Examples

The following example shows how to enable RPM:

resource-pool enable

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled. The default of the resource-pool enable command is to not enable these new accounting records.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool aaa accounting ppp global configuration command to include enhanced start/stop resource manager records to AAA accounting. The resource-pool aaa accounting ppp command adds new resource pool management fields to the AAA accounting start/stop records. The new attributes in the start records are also in the stop records---in addition to those new attributes added exclusively for the stop records.

If you have configured your regular AAA accounting, this command directs additional information from the resource manager into your accounting records.

Note If you configure only this command and do not configure AAA accounting, nothing happens. The default functionality for the resource-pool enable command does not include this functionality.

The following new fields are added to the start and stop records:

Table 22: Start and Stop Resource Manager Records

New Start Record Fields	New Stop Record Fields
Call-type Customer-profile-name Customer-profile-active-sessions MLP-session-ID (multilink users) Resource-group-name Overflow-flag VPDN-tunnel-ID (VPDN users) VPDN-homegateway (VPDN users) VPDN-domain-name (VPDN users) VPDN-group-active-session (VPDN users)	ModemSpeed-receive ModemSpeed-transmit MLP-session-ID (multilink users)

Caution  This list of newly supported start and stop fields is not exhaustive. Cisco reserves the right to enhance this list of records at any time. Use the show accounting command to see the contents of each active session.

Note Cisco recommends that you thoroughly understand how these new start/stop records affect your current accounting structure before you enter this command.

Examples

The following example shows the new AAA accounting start/stop records inserted into an existing AAA accounting infrastructure:

resource-pool aaa accounting ppp

Related Commands

Command	Description
show accounting	Allows display of the active accountable events on the network and helps collect information in the event of a data loss on the accounting server.

Syntax Description

local	Specifies local authorization.
group name	Specifies an authorization method that is not local; for example, using an external authorization, authentication, and accounting (AAA) server group. The Resource Pool Management Server(s) (RPMS) is defined in a AAA server group.

Defaults

Defaults to local.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool aaa protocol global configuration command to specify which protocol to use for resource management. The AAA server group is most useful when you want to have multiple RPMSs configured as a fall-back mechanism.

Examples

The following example shows how to specify local authorization protocol:

resource-pool aaa protocol local

Syntax Description

profile	Call treatment when profile authorization fails.
busy	Answers the call; then, sends a busy signal when profile authorization or resource allocation fails.
no-answer	Does not answer the call when profile authorization fails.
resource	Call treatment when resource allocation fails.
channel-not-available	Send "channel not available" code when resource allocation fails.

Defaults

No answer for a customer profile; CNA for a resource.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool call treatment global configuration command to set up the signal sent back to the telco switch in response to incoming calls.

Examples

resource-pool call treatment profile ?
  busy       Send busy code when profile authorization fails
  no-answer  Don't answer when profile authorization fails

Syntax Description

resource name

Assigns a name to a group of physical resources inside the access server. This name can have up to 23 characters.

Defaults

No resource groups are set up.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool group resource global configuration command to create a resource group for resource management. When calls come into the access server, they are allocated physical resources as specified within resource groups and customer profiles.

See the range command for more information.

If some physical resources are not included in any resource groups, then these remaining resources are not used and are considered to be part of the default resource group. These resources can be used in certain cases to answer calls before profile allocation occurs, but the resources are not used other than in the connection phase.

Note For standalone network access server environments, configure resource groups before using them in customer profiles. For external RPMS environments, configure resource groups on the network access server before defining them on external RPMS servers.

When enabling RPM for SS7 signalling, like resources in the network access server (NAS) must be in a single group:

• All modems must be in one group.

• All HDLC controllers must be in a different group.

• All V.110 ASICs must be put into another group.

• All V.120 resources must be in a separate group.

All resource group types must have the same number of resources and that number must equal the number of interface channels available from the public network switch. This grouping scheme prevents the signal "Channel Not Available" (CNA) from being sent to the signaling point. For SS7 signaling, Microcom and MICA technologies modems must be in the same group. If SS7 signaling is not used, Cisco recommends assigning Microcom and MICA modems to separate groups to avoid introducing errors in RPM statistics.

Examples

The following example shows the configuration options within a resource group:

resource-pool group resource modem1
?
Resource Group Configuration Commands:
  default  Set a command to its defaults
  exit     Exit from resource-manager configuration mode
  help     Description of the interactive help system
  no       Negate a command or set its defaults
  range    Configure range for resource
 
range ?
  limit  Configure the maximum limit
  port   Configure the resource ports
 
range limit ?
  <1-192>  Maximum number of connections allowed
 
range port ?
  <0-246>  First Modem TTY Number
  x/y      Slot/Port for Internal Modems

Syntax Description

name	Name of the customer profile. This name can have up to 23 characters.

Defaults

No customer profiles are set up.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool profile customer global configuration command to create a customer profile.

Examples

The following example shows the creation of a customer profile called isp-abc. By entering the ? command, you can see the options you can set within the customer profile:

resource-pool profile customer isp-abc
?
Customer Profile Configuration Commands:
  dnis      Assign dnis group with this profile
  default   Set a command to its defaults
  exit      Exit from resource-manager configuration mode
  help      Description of the interactive help system
  limit     Configure limits for the profile
  no        Negate a command or set its defaults
  resource  Assign resource and supported call-type
  vpdn      Assign VPDN group/profile with this profile

Related Commands

Command	Description
resource-pool group resource	Creates a resource group for resource management.
limit base-size	Defines the base number of simultaneous connections that can be done in a single customer or VPDN profile.
limit overflow-size	Defines the number of overflow calls granted to one customer or VPDN profile.
dnis group	Includes a group of DNIS numbers in a customer profile.
resource	Assigns resources and supported call types to a customer profile.

Syntax Description

name	Name of the call discriminator profile. This name can have up to 23 characters.

Defaults

No discrimination of calls.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool profile discriminator global configuration command to create a call discrimination profile.

Examples

The following example shows how to create a discrimination profile called user1:

resource-pool profile discriminator user1

Related Commands

Command	Description
dnis group	Includes a group of DNIS numbers in a customer profile.
call-type	Rejects particular types of calls.

Syntax Description

name	Name of the service profile. This name can have up to 23 characters.

Defaults

No service profiles are set up.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool profile service global configuration command to set up the service profile configuration.

Examples

The following example shows the creation of a service profile called user1:

resource-pool profile service user1

Syntax Description

name	Name of the VPDN profile.

Defaults

No VPDN profiles are set up.

Command Modes

Global configuration

Command History

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

Usage Guidelines

Use the resource-pool profile vpdn global configuration command to set up VPDN session counting for one or more VPDN groups and to limit sessions that can be authorized for VPDN groups.

Examples

The following example shows the creation of a VPDN session counter at the VPDN group named lg-hmgate:

resource-pool profile vpdn lg-hmgate

Related Commands

Command	Description
limit base-size	Defines the base number of simultaneous connections that can be done in a single customer or VPDN profile.
limit overflow-size	Defines the number of overflow calls granted to one customer or VPDN profile.

Syntax Description

connection	(Optional) The name or number of the connection; the default is the most recent connection.
/set parameter:value	(Optional) Sets the X.3 connection options and PAD parameters for the Cisco IOS software. Refer to Table 23 for PAD parameters. Refer to the chapter "Configuring the Cisco PAD Facility to Make X.25 Connections" of the Cisco IOS Dial Services Configuration Guide: Terminal Services for a list of these connection options.

2:1, 3:2, 4:1, 7:4, 16:127, 17:21, 18:19
 

All other parameters default to zero, but can be changed using the /set switch option with either the resume command or the x3 command.

2:0, 4:1, 7:21, 15:0

Command Modes

EXEC

Command History

Release	Modification
9.1	This command was introduced.

Usage Guidelines

Step 2 Issue the where command, to list the open sessions. All open sessions associated with the current terminal line are displayed.

Step 3 Enter the resume command, followed by the parameter, a colon, and then the value to be set.

Examples

You can have several concurrent sessions open and switch back and forth between them. The number of sessions that can be open is defined by the session-limit command.

You can switch between sessions by escaping one session and resuming a previously opened session, as follows:

Step 2 Enter the where command, to list the open sessions. All open sessions associated with the current terminal line are displayed.

Step 3 Enter the resume command and the session number to make the connection.

You also can resume the previous session by pressing the Return key.

The Ctrl^x, where, and resume commands are available with all supported connection protocols.

Examples

The following example shows how to escape out of a connection and to resume connection 2:

Swift% ^^X 
router> resume 2 
 

You can omit the command name and simply enter the connection number to resume that connection. The following example illustrates how to resume connection 3:

router> 3 
 

Related Commands

Command	Description
show tn3270 ascii-hexval	Displays ASCII-hexadecimal character mappings.
where	Lists open sessions associated with the current terminal line.

Syntax Description

number-of-times

Number of keepalive failures allowed before the link is declared down, from 1 to 100.

Defaults

3

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.
link (RLM)	Specifies the link preference.
protocol rlm port	Reconfigures the port number for the basic RLM connection for the whole rlm-group.
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

host	Specifies the host name or IP address.
-l username	(Optional) The Berkeley Standard Distribution (BSD) UNIX syntax that specifies a user name for the remote login. If you do not use this option, the remote user name is your local user name.
/user username	(Optional) The EXEC command syntax that specifies a remote user name in the initial exchange with the remote host. The rlogin protocol will not present you with the login prompt.
/quiet	(Optional) Prevents onscreen display of all messages from the Cisco IOS software.
debug	(Optional) Enables debugging output from the rlogin protocol.

Command Modes

EXEC

Command History

Release	Modification
10.0	This command was introduced.
12.1	The /quiet keyword was added.

Usage Guidelines

You can have several concurrent rlogin connections open and switch back and forth between them. To open a new connection, first suspend the current connection by pressing the escape sequence (Ctrl-Shift-6 then x [Ctrl^x] by default) to return to the EXEC prompt. Then open a new connection. A user cannot automatically log in to a UNIX system from the router, but must provide a user ID and a password for each connection.

If your preferred transport is set to rlogin, you can use the connect command in place of the rlogin command. Refer to the chapter "Configuring Terminal Operating Characteristics for Dial-In Sessions" in the Cisco IOS Dial Services Configuration Guide: Terminal Services for more information about configuring a preferred transport type. When your preferred transport is set to none or to another protocol, you must use the rlogin command to connect to a host.

To terminate an active rlogin session, enter one of the commands from the following list at the UNIX prompt of the device to which you are connecting:

Examples

The following example illustrates how the user Joe Smith ("jsmith") can use the rlogin ? help command and the debug command mode to establish and troubleshoot a remote connection to the host Alviso:

4500> rlogin ?
  WORD  IP address or hostname of a remote system
4500> rlogin Alviso ?
  -l     Specify remote username
  /quiet Suppress login/logout messages
  /user  Specify remote username
  debug  Enable rlogin debugging output
  <cr>
4500> rlogin Alviso -l ?
  WORD  Remote user name
4500> rlogin Alviso -l jsmith?
 debug Enable rlogin debugging output
  <cr>
4500> rlogin Alviso -l jsmith debug 
 

The following example illustrates debug return on the host named zipper by the user named staff:

yak# rlogin zipper.cisco.com -l staff debug
Trying zipper.cisco.com (171.69.63.31)... Open
RLOGIN: local username is: ciscoTS
RLOGIN: remote username is: staff
Password: 
Last login: Wed Jun 24 06:15:36 from itech-view3.cisc
1 zipper> uptime
  1:40pm  up 42 day(s), 20:53,  80 users,  load average: 1.44, 2.67, 3.39
2 zipper> logout
[Connection to zipper.cisco.com closed by foreign host]
yak#
 

The following example makes an rlogin connection to a host at address 108.33.21.2 for a user named supervisor and enables the message mode for debugging:

router> rlogin 108.33.21.2 -l supervisor debug
 

The following example makes an rlogin connection to a host named headquarters for the user named admin:

router> rlogin headquarters -l admin
 

The following example suppresses all onscreen messages from the Cisco IOS software during login and logout:

router> rlogin host2 /quiet

Related Commands

Command	Description
connect	Logs in to a host that supports Telnet, rlogin, or LAT.
telnet	Logs in to a host that supports Telnet.

Syntax Description

local	(Optional) Use local username from any authentication method.
radius	(Optional) Use local username from RADIUS authentication.
tacacs	(Optional) Use local username from TACACS authentication.

Defaults

The user must enter their rlogin username and password when connecting to the rlogin server.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

Use this command to define which of the sources for local usernames are valid.

The rlogin protocol passes three types of information: the remote username, the local username, and the local hostname of the router. The rlogin trusted-localuser-source command allows you to configure one of three behaviors for making connections to the rlogin server, as follows:

• The user must enter their login username and password to connect (default).

• The user's IOS-authenticated username can be passed to the rlogin server so the user need only enter their password to connect.

• The user can be automatically connected to the rlogin server without having to provide a username or password. This configuration is made by using both the rlogin trusted-localuser-source and rlogin trusted-remoteuser-source local commands where both the IOS-authenticated username and the rlogin server username are the same.

Examples

The following example uses the local username from RADIUS authentication:

router# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
router(config)# rlogin trusted-localuser-source ?
  local   Use local username from any authentication method
  radius  Use local username from radius authentication
  tacacs  Use local username from tacacs authentication
router(config)# rlogin trusted-localuser-source radius 

Related Commands

Command	Description
ip alias	Assigns an IP address to the service provided on a TCP port.
retry keepalive	Logs in to a UNIX host using rlogin.
rlogin trusted-remoteuser-source local	Determines the remote username to send to the remote rlogin server.
template	Temporarily defines the list of services to which you or another user can connect.

Syntax Description

This command has no arguments or keywords.

Defaults

The user must enter their rlogin username and password when connecting to the rlogin server.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

The current username is used only if the rlogin host /user username command is not enabled. If the current username is not known, rlogin falls back to providing the "login:" prompt to discover a remote username.

Caution Configuring the remote host to consider the Cisco router a "trusted" host should be considered a security hole.

Examples

After you issue the rlogin trusted-remoteuser-source local command, you will not be prompted for a username. The first response you see is the password prompt from the remote system. For example, when this command is not enabled, you must enter your username twice (once at initial system login and once for the rlogin command).

User Access Verification
 
Username: gmcmilla
Password: xxxxx
 
router> rlogin puli
Trying puli.cisco.com (170.69.3.154)... Open
login: gmcmilla
Password: xxxxx
 
 

After you issue the rlogin trusted-remoteuser-source local command, you no longer have to specify the username after the rlogin command. The username is automatically copied from the router's user ID.

enable
Password: xxxxx
router# configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
router(config)# rlogin ?
  trusted-localuser-source   Allowed authentication types for local username
  trusted-remoteuser-source  Method used to get remote username
router(config)# rlogin trusted-remoteuser-source local 
router(config)# ^Z
router# rlogin puli
Trying puli.cisco.com (170.69.3.154)... Open
Password: xxxxx
 

The following example uses the /user root option as an override.

router# rlogin puli /user root
Trying puli.cisco.com (170.69.3.154)... Open
Password: xxxxx
login: 

Related Commands

Command	Description
ip alias	Assigns an IP address to the service provided on a TCP port.
retry keepalive	Logs in to a UNIX host using rlogin.
rlogin trusted-localuser-source	Chooses an authentication method for determining the local username to send to the remote rlogin server.
template	Temporarily defines the list of services to which you or another user can connect.

Syntax Description

group

Integer from 1 to 100 that you choose to identify the rotary group.

Defaults

No group of lines is defined.

Command Modes

Line configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Typically, rotary groups are used on devices with multiple modem connections to allow connections to the next free line in a hunt group.

Connections to a rotary group can take advantage of the following features:

For example, if Telnet protocols are required, the remote host connects to the TCP port numbered 3000 (decimal) plus the rotary group number. If the rotary group identifier is 13, the corresponding TCP port is 3013.

If a raw TCP stream is required, the port is 5000 (decimal) plus the rotary group number. If rotary group 5 includes a raw TCP (printer) line, the user connects to port 5005 and is connected to one of the raw printers in the group.

If Telnet binary mode is required, the port is 7000 (decimal) plus the rotary group number.

Examples

The following example establishes a rotary group consisting of virtual terminal lines 2 through 4 and defines a password on those lines. By using Telnet to connect to TCP port 3001, the user gets the next free line in the rotary group. The user does not have to remember the range of line numbers associated with the password.

line vty 2 4
 rotary 1
 password letmein
login

Related Commands

Command	Description
modem bad	Removes an integrated modem from service and indicates it as suspected or proven to be inoperable.
modem callout	Configures a line for reverse connections.
session-timeout	Sets the interval for closing the connection when there is no input or output traffic.

Examples

The following example specifies that the chat script with a name that includes "telebit" will be activated whenever line 4 is activated:

line 4
 script activation telebit 

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
script activation	Specifies that a chat script start on a physical terminal line when the line is activated.
script connection	Specifies that a chat script start on a physical terminal line when a remote network connection is made to a line.
script dialer	Specifies a default modem chat script.
script reset	Specifies that a chat script start on a physical terminal line when the specified line is reset.
script startup	Specifies that a chat script start on a physical terminal line when the router is powered up.
start-chat	Specifies that a chat script start on a specified line at any point.

Syntax Description

regexp

Regular expression that specifies the set of modem scripts that might be executed. The first script name that matches the regexp argument is used.

Defaults

Not assigned to terminal lines

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command specifies that if an originating ARA client requests callback, the device will be disconnected and the chat script defined by the regexp argument will be executed to call back the client. The first available line specified for callback, and for which a chat script has been applied, will be used for the callback.

Examples

The following example specifies that a chat script with a name that includes usr4 will be activated whenever a client requests a callback on line 4:

line 4
 script arap-callback usr4

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
script activation	Specifies that a chat script start on a physical terminal line when the line is activated.
script callback	Specifies that a chat script start on a line when a client requests a callback.
script connection	Specifies that a chat script start on a physical terminal line when a remote network connection is made to a line.
script dialer	Specifies a default modem chat script.
script reset	Specifies that a chat script start on a physical terminal line when the specified line is reset.
script startup	Specifies that a chat script start on a physical terminal line when the router is powered up.
start-chat	Specifies that a chat script start on a specified line at any point.

Syntax Description

regexp

Regular expression that specifies the set of modem scripts that might be executed. The first script name that matches the regexp argument is used.

Defaults

Not assigned to terminal lines

Command Modes

Line configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command specifies that if an originating client requests callback, the device will be disconnected and the chat script defined by the regexp argument will be executed to call back the client. The first available line specified for callback, and for which a chat script has been applied, will be used for the callback.

Create a chat script using the chat script command.

Examples

The following example specifies that the chat script with a name that includes supra4 will be activated whenever a client requests a callback on line 4:

line 4
 script callback supra4

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
script activation	Specifies that a chat script start on a physical terminal line when the line is activated.
script connection	Specifies that a chat script start on a physical terminal line when a remote network connection is made to a line.
script dialer	Specifies a default modem chat script.
script reset	Specifies that a chat script start on a physical terminal line when the specified line is reset.
script startup	Specifies that a chat script start on a physical terminal line when the router is powered up.
start-chat	Specifies that a chat script start on a specified line at any point.

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
script activation	Specifies that a chat script start on a physical terminal line when the line is activated.
script dialer	Specifies a default modem chat script.
script reset	Specifies that a chat script start on a physical terminal line when the specified line is reset.
script startup	Specifies that a chat script start on a physical terminal line when the router is powered up.
start-chat	Specifies that a chat script start on a specified line at any point.

Syntax Description

regexp

Specifies the set of modem scripts that might be executed. The first script that matches the regexp argument will be used.

Defaults

No chat script is defined.

Command Modes

Line configuration

Command History

Release	Modification
10.3	This command was introduced.

Usage Guidelines

• codex-.*

• telebit-.*

• usr-.*

• xyz-.*

In the dialer map command, you can specify the modulation but leave the type of modem unspecified, as in .*-v32bis.

Examples

The following example shows line chat scripts being specified for lines connected to Telebit and US Robotics modems:

! Some lines have telebit modems
line 1 6
script dialer telebit.*
!
! Some lines have US robotics modems
line 7 12
script dialer usr.*

Related Commands

Command	Description
chat-script	Places calls over a modem and logs in to remote systems.
dialer map	Configures a serial interface or ISDN interface to call one or multiple sites or to receive calls from multiple sites.
script activation	Specifies that a chat script start on a physical terminal line when the line is activated.
script connection	Specifies that a chat script start on a physical terminal line when a remote network connection is made to a line.
script reset	Specifies that a chat script start on a physical terminal line when the specified line is reset.
script startup	Specifies that a chat script start on a physical terminal line when the router is powered up.
start-chat	Specifies that a chat script start on a specified line at any point.

Syntax Description

name-tag

The logic name to identify the server configuration so that multiple entries of server configuration can be entered.

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.
link (RLM)	Specifies the link preference.
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.
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

This command has no arguments or keywords.

Defaults

Callback is not enabled.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced.

Usage Guidelines

This command enables the Cisco IOS software to return a call to a device that dials in, connects to the EXEC, and requests callback.

Examples

The following example enables EXEC level callback:

service exec-callback

Related Commands

Command	Description
arap callback	Enables an ARA client to request a callback from an ARA client.
script arap-callback	Specifies that a chat script start on a line when an ARA client requests a callback.
debug callback	Displays callback events when the router is using a modem and a chat script to call back on a terminal line.
debug confmodem	Displays information associated with the discovery and configuration of the modem attached to the router.
ppp callback (PPP client)	Enables a dialer interface that is not a DTR interface to function either as a callback client that requests callback or as a callback server that accepts callback requests.
username	Establishes a username-based authentication system, such as PPP CHAP and PAP.

Syntax Description

This command has no arguments or keywords.

Defaults

The prompts and information transmitted by SLIP and PPP are formatted with the current release of Cisco IOS software.

Command Modes

Global configuration

Command History

Release	Modification
11.1	This command was introduced to provide backward compatibility for client software scripts expecting SLIP and PPP dialogs to be formatted with Cisco IOS software Release 9.1 or earlier.

Examples

The following example shows the output of a SLIP command after the service old-slip-prompts command is enabled:

configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
service old-slip-prompts
exit
slip
IP address or hostname: 2.2.2.2
Entering SLIP mode.
Your IP address is 2.2.2.2. MTU is 1500 bytes

Syntax Description

This command has no arguments or keywords.

Defaults

This feature is disabled.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command permits you to log the X.121 calling address, Call User Data (CUD), and the IP address assigned to a vty asynchronous connection and direct this information to the console, an internal buffer, or a UNIX syslog server, depending on the logging configuration command you use. This authentication information can be used to associate an incoming PAD vty-asynchronous connection with an IP address.

Note By default, the Cisco IOS software displays all messages to the console terminal.

Examples

The following example enables you to log the X.121 calling address, Call User Data (CUD), and the IP address assigned to a vty asynchronous connection and save this information to a syslog server:

service pt-vty-logging
 

The following is sample output resulting from the service pt-vty-logging command:

01:24:31: PAD18: call from 00011890 on LCI 10 PID 1 0 0 0 CUD "xyz"
 

Related Commands

Command	Description
logging	Logs messages to a syslog server host.
logging buffered	Logs messages to an internal buffer.

Syntax Description

This command has no arguments or keywords.

Defaults

The stack group bid function is disabled by default.

Command Modes

Global configuration

Command History

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

Examples

The following example shows how to configure a stack group for large-scale dialout:

sgbp group forever
sgbp member NAS2 172.21.17.17
sgbp dial-bids

Related Commands

Command	Description
dialer congestion-threshold	Specifies congestion threshold in connected links.
dialer reserved-links	Reserves links for dialin and dialout.
sgbp group	Defines a named stack group and makes this router a member of that stack group.
sgbp member	Specifies the host name and IP address of a router or access server that is a peer member of a stack group.

Syntax Description

name	Name of the stack group the system belongs to.

Defaults

Disabled. No stack group name is provided.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Examples

The following example makes this system a member of the stack group named stackq:

sgbp group stackq

Related Commands

Command	Description
sgbp member	Specifies the host name and IP address of a router or access server that is a peer member of a stack group.
sgbp seed-bid	Sets the bidding level that a stack group member can be used to bid for a bundle.

Syntax Description

peer-name	Host name of the peer member.
peer-ip-address	(Optional) IP address of the peer member. If the domain name system (DNS) can perform a lookup on the peer-name value, the IP address is not required. Otherwise, it must be specified.

Defaults

Disabled. When enabled, names and IP addresses of peer routers or access servers in the stack group are not provided.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Examples

sgbp group rockstar
sgbp member jimi 10.69.5.2
sgbp member janis 172.16.6.3
sgbp member jerry 192.165.15.4

Related Commands

Command	Description
sgbp dial-bids	Defines a named stack group and makes this router a member of that stack group.
sgbp seed-bid	Sets the bidding level that a stack group member can be used to bid for a bundle.

Syntax Description

This command has no arguments or keywords.

Defaults

This command is disabled by default.

Command Modes

Global configuration

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

When this command is enabled, both PPP and multilink PPP calls are projected to the winner of the SGBP bid. By default, only Multilink PPP calls are forwarded.

Examples

The following partial example enables forwarding of PPP calls, as well as MLP calls, to the winner of the SGBP bidding:

sgbp ppp-forward

Related Commands

Command	Description
sgbp member	Specifies the host name and IP address of a router or access server that is a peer member of a stack group.
sgbp seed-bid	Sets the bidding level that a stack group member can be used to bid for a bundle.

Syntax Description

default	If set across all members of a stack group, indicates that the member which receives the first call for a certain user always wins the bid and hosts the master bundle interface. All subsequent calls to the same user received by another stack group member will project to this stackgroup member. This is the default.
offload	Indicates that this router is a relatively higher powered stack group member, is to function as an offload server, and host the master bundle interface.
forward-only	Indicates that this router or access server is to forward calls to another system and never wins the bid to host a master interface. This router or access server should hang up---instead of answering a call---if all the offload servers are down.
bid	Bid level, an integer in the range 0 through 9999.

Defaults

The default keyword; no bid-level integer value is set.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

If you have assorted or exactly the same platforms and for some reason want to designate one or more as offload servers, you can manually set the bid value to be significantly higher than the rest. For example, you might use the sgbp seed-bid 9999 command. To determine the initial bid value associated with your particular platform, use the show sgbp command. This method allows you to manually designate the bid values when you have assorted platforms and want to designate one or more platforms as offload servers; for example, one Cisco 4700 (given the highest seed-bid), two Cisco 4000s and one Cisco 7000.

Related Commands

Command	Description
sgbp dial-bids	Defines a named stack group and makes this router a member of that stack group.
sgbp member	Specifies the host name and IP address of a router or access server that is a peer member of a stack group.
show sgbp queries	Displays the current SGBP seed bid value.