Cisco IOS Dial Services Commands: PRI Through SGBP

This chapter explains the function and syntax of the Cisco IOS dial services commands from PRI through SGBP. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Dial Services Command Reference, Release 12.1.

pri-group timeslots nfas_d

To configure Non-Facility Associated Signalling (NFAS) and specify the channels to be controlled by the primary NFAS D channel, use the pri-group timeslots nfas_d command in controller configuration mode.

pri-group timeslots range nfas_d [primary | backup | none] nfas_interface number
nfas_group number

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.

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.

protocol (VPDN)

To specify the Layer 2 Tunneling Protocol (L2TP) that the Virtual Private Dialup Network (VPDN) subgroup will use, use the protocol subgroup command. To remove the protocol-specific configurations from a VPDN subgroup, use the no form of this command.

protocol {l2f | l2tp | any}

no protocol

Syntax Description

l2f

Enables the VPDN subgroup to establish Layer 2 Forwarding (L2F) tunnels.

l2tp

Enables the VPDN subgroup to establish L2TP tunnels.

any

Enables the VPDN subgroup to establish either L2F or L2TP tunnels.

l2f	Enables the VPDN subgroup to establish Layer 2 Forwarding (L2F) tunnels.
l2tp	Enables the VPDN subgroup to establish L2TP tunnels.
any	Enables the VPDN subgroup to establish either L2F or L2TP tunnels.

protocol rlm port

To configure the RLM port number, use the protocol rlm port command in RLM configuration mode. The port number for the basic RLM connection can be reconfigured for the entire RLM group. Use the no form of this command to disable this function.

protocol rlm port port-number

no protocol rlm port port-number

Syntax Description

port-number

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

port-number	RLM port number. See Table 12 for the default port numbers.

Table 12: Default RLM Port Number

Protocol Port Number

RLM

3000

ISDN

Port[RLM]+1

Protocol	Port Number
RLM	3000
ISDN	Port[RLM]+1

range

To associate a range of modems or other physical resources with a resource group, use the range command in resource group configuration mode. To remove a range of modems or other physical resources, use the no form of this command.

range {limit number | port range}

no range {limit number | port range}

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.

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.

request dialout

To enable an L2TP network server (LNS) to request Virtual Private Dialup Network (VPDN) dialout calls by using Layer 2 Tunnel Protocol (L2TP), use the request dialout command in VPDN group configuration mode. To disable L2TP dialout, use the no form of this command.

request dialout

no request dialout

Syntax Description

This command has no arguments or keywords.

resource

To assign resources and supported call-types to a customer profile, use the resource command in customer profile configuration mode. Use the no form of this command to disable this function.

resource name {digital | speech | v110 | v120} [service name]

no resource name {digital | speech | v110 | v120} [service name]

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.

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.

resource-pool

To enable or disable resource pool management, use the resource-pool command in global configuration mode.

resource-pool {enable | disable}

Syntax Description

enable

Enables resource pool management.

disable

Disables resource pool management.

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

resource-pool aaa accounting ppp

To include enhanced start/stop resource manager records to authorization, authentication, and accounting (AAA) accounting, use the resource-pool aaa accounting ppp command in global configuration mode. Use the no form of this command to disable this feature.

resource-pool aaa accounting ppp

no resource-pool aaa accounting ppp

Syntax Description

This command has no arguments or keywords.

resource-pool aaa protocol

To specify which protocol to use for resource management, use the resource-pool aaa protocol command in global configuration mode. Use the no form of this command to disable this feature and go to local.

resource-pool aaa protocol {local | group name}

no resource-pool aaa protocol

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.

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.

resource-pool call treatment

To set up the signal sent back to the telco switch in response to incoming calls, use the resource-pool call treatment command in global configuration mode. Use the no form of this command to disable this function.

resource-pool call treatment {profile {busy | no-answer} | resource {busy | channel-not-available}}

no resource-pool call treatment {profile {busy | no-answer} | resource {busy | channel-not-available}}

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.

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.

resource-pool group resource

To create a resource group for resource management, use the resource-pool group resource command in global configuration mode. Use the no form of this command to remove a resource group from the running configuration.

resource-pool group resource name

no resource-pool group resource name

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.

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

resource-pool profile customer

To create a customer profile, use the resource-pool profile customer command in global configuration mode. Use the no form of this command to delete a customer profile from the running configuration.

resource-pool profile customer name

no resource-pool profile customer name

Syntax Description

name

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

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

resource-pool profile discriminator

To create a call discrimination profile, use the resource-pool profile discriminator command in global configuration mode. Use the no form of this command to remove a profile from the running configuration.

resource-pool profile discriminator name

no resource-pool profile discriminator name

Syntax Description

name

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

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

resource-pool profile service

To set up the service profile configuration, use the resource-pool profile service command in global configuration mode. Use the no form of this command to disable this function.

resource-pool profile service name

no resource-pool profile service name

Syntax Description

name

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

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

resource-pool profile vpdn

To set up for Virtual Private Dialup Network (VPDN) session counting for one or more VPDN groups and to limit sessions that can be authorized for VPDN groups, use the resource-pool profile vpdn command in global configuration mode. Use the no form of this command to disable this function.

resource-pool profile vpdn name

no resource-pool profile vpdn name

Syntax Description

name

Name of the VPDN profile.

name	Name of the VPDN profile.

resume (setting X.3 PAD parameters)

To set X.3 parameters, use the resume command in EXEC mode.

resume [connection] [/set parameter:value]

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 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.

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 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.

resume (switching sessions)

To switch to another open Telnet, rlogin, local-area transport (LAT), or packet assembler/disassembler (PAD) session, use the resume command in EXEC mode.

resume [connection] [keyword] [/set parameter:value]

Syntax Description

connection

(Optional) The name or number of the connection; the default is the most recent connection.

keyword

(Optional) One of the options listed in Table 13.

/set parameter:value

(Optional) Sets PAD parameters for the Cisco IOS software.

connection	(Optional) The name or number of the connection; the default is the most recent connection.
keyword	(Optional) One of the options listed in Table 13.
/set parameter:value	(Optional) Sets PAD parameters for the Cisco IOS software.

Table 13: Telnet and Rlogin resume Command Options

Option Description

/debug

Displays parameter changes and messages. In the Cisco IOS software, this option displays informational messages whenever the remote host changes an X.3 parameter, or sends an X.29 control packet.

/echo

Performs local echo.

/line

Enables line-mode editing.

/nodebug

Cancels printing of parameter changes and messages.

/noecho

Disables local echo.

/noline¹

Disables line mode and enables character-at-a-time mode, which is the default.

/nostream

Disables stream processing.

/set parameter:value

Sets X.3 connection options. 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.

/stream

Enables stream processing.

¹/noline is the default keyword.

Option	Description
/debug	Displays parameter changes and messages. In the Cisco IOS software, this option displays informational messages whenever the remote host changes an X.3 parameter, or sends an X.29 control packet.
/echo	Performs local echo.
/line	Enables line-mode editing.
/nodebug	Cancels printing of parameter changes and messages.
/noecho	Disables local echo.
/noline¹	Disables line mode and enables character-at-a-time mode, which is the default.
/nostream	Disables stream processing.
/set parameter:value	Sets X.3 connection options. 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.
/stream	Enables stream processing.

retry keepalive

Redundant Link Manager (RLM) allows keepalive failures in consecutive certain amounts of time configured using the command line interface (CLI) before it declares the link is down. Use the no form of this command to disable this function.

retry keepalive number-of-times

no retry keepalive number-of-times

Syntax Description

number-of-times

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

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

rlogin

To log in to a UNIX host using rlogin, use the rlogin command in EXEC mode:

rlogin host [-l username] [/user username] [debug]

Syntax Description

host

Specifies the host name or IP address.

-l username

(Optional) The BSD UNIX syntax which 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 which specifies a remote user name in the initial exchange with the remote host. The rlogin protocol will not present you with the login prompt.

debug

(Optional) Enables debugging output from the rlogin protocol.

host	Specifies the host name or IP address.
-l username	(Optional) The BSD UNIX syntax which 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 which specifies a remote user name in the initial exchange with the remote host. The rlogin protocol will not present you with the `login` prompt.
debug	(Optional) Enables debugging output from the rlogin protocol.

rlogin trusted-localuser-source

To choose an authentication method for determining the local username to send to the remote rlogin server, use the rlogin trusted-localuser-source command in global configuration mode. Use the no form of this command to restore the default rlogin behavior.

rlogin trusted-localuser-source [local | radius | tacacs]

no rlogin trusted-localuser-source [local | radius | tacacs]

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.

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.

rlogin trusted-remoteuser-source local

To determine the remote username to send to the remote rlogin server, use the rlogin trusted-remoteuser-source local command in global configuration mode. Use the no form of this command to restore the default rlogin behavior, which is to prompt the user for the remote username.

rlogin trusted-remoteuser-source local

no rlogin trusted-remoteuser-source local

Syntax Description

This command has no arguments or keywords.

rotary

To define a group of lines consisting of one of more lines, use the rotary command in line configuration mode. Use the no form of this command to remove a line or group of lines from a rotary group.

rotary group

no rotary

Syntax Description

group

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

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

rotary-group

To assign a request-dialout Virtual Private Dialup Network (VPDN) subgroup to a dialer rotary group, use the rotary-group command in request-dialout configuration mode. To remove the request-dialout VPDN subgroup from the dialer rotary group, use the no form of this command.

rotary-group group-number

no rotary-group [group-number]

Syntax Description

group-number

The dialer rotary group that this VPDN group belongs to.

group-number	The dialer rotary group that this VPDN group belongs to.

rxspeed

To set the terminal receive speed (how fast the terminal receives information from the modem), use the rxspeed command in line configuration mode.

rxspeed bps

Syntax Description

bps

Baud rate in bits per second (bps).

bps	Baud rate in bits per second (bps).

script activation

To specify that a chat script start on a physical terminal line any time the line is activated, use the script activation command in line configuration mode. Use the no form of this command to disable this feature.

script activation regexp

no script activation

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 will be used.

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

script arap-callback

To specify that a chat script start on a line any time an AppleTalk Remote Access (ARA) client requests a callback, use the script arap-callback command in line configuration mode. Use the no form of this command to disable this feature.

script arap-callback regexp

no script arap-callback

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.

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.

script callback

To specify that a chat script start on a line any time a client requests a callback, use the script callback command in line configuration mode. Use the no form of this command to disable this feature.

script callback regexp

no script callback

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.

script connection

To specify that a chat script will start on a physical terminal line any time a remote network connection is made to a line, use the script connection command in line configuration mode. Use the no form of this command to disable this feature.

script connection regexp

no script connection

Syntax Description

regexp

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

script dialer

To specify a default modem chat script, use the script dialer command in line configuration mode. Use the no form of this command to disable this feature.

script dialer regexp

no script dialer

Syntax Description

regexp

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

script reset

To specify that a chat script will start on a physical terminal line any time the specified line is reset, use the script reset command in line configuration mode. Use the no form of this command to disable this feature.

script reset regexp

no script reset

Syntax Description

regexp

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

script startup

To specify that a chat script will start on a physical terminal line any time the router is powered up, use the script startup command in line configuration mode. Use the no form of this command to disable this feature.

script startup regexp

no script startup

Syntax Description

regexp

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

server (RLM)

To define IP addresses of the server, use the server command in RLM configuration mode. Each server can have multiple entries of IP addresses or aliases. Use the no form of this command to disable this function.

server name-tag

no server name-tag

Syntax Description

name-tag

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

service exec-callback

To enable the Cisco IOS software to call back clients who request a callback from the EXEC level, use the service exec-callback command in global configuration mode.

service exec-callback

Syntax Description

This command has no arguments or keywords.

service old-slip-prompts

To provide backward compatibility for client software scripts expecting Serial Line Internet Protocol (SLIP) and PPP dialogs to be formatted with Cisco IOS software Release 9.1 or earlier, use the service old-slip-prompts command in global configuration mode. Use the no form of this command to disable this function.

service old-slip-prompts

no service old-slip-prompts

Syntax Description

This command has no arguments or keywords.

service pt-vty-logging

To log the X.121 calling address, Call User Data (CUD), and the IP address assigned to a vty asynchronous connection, use the service pt-vty-logging command in global configuration mode. Use the no form of this command to disable this function.

service pt-vty-logging

no service pt-vty-logging

Syntax Description

This command has no arguments or keywords.

session-limit

To set the maximum number of terminal sessions per line, use the session-limit command in line configuration mode. Use the no form of this command to remove any specified session limit.

session-limit session-number

no session-limit

Syntax Description

session-number

Specifies the maximum number of sessions.

session-timeout

To set the interval for closing the connection when there is no input or output traffic, use the session-timeout command in line configuration mode. Use the no form of this command to remove the timeout definition.

session-timeout minutes [output]

no session-timeout

Syntax Description

minutes

Specifies the timeout interval in minutes.

output

(Optional) Specifies that when traffic is sent to an asynchronous line from the router (within the specified interval), the connection is retained.

sgbp dial-bids

To allow the stack group to bid for dialout connection, use the sgbp dial-bids command in global configuration mode. To disable this function, use the no form of this command.

sgbp dial-bids

no sgbp dial-bids

Syntax Description

This command has no arguments or keywords.

sgbp group

To define a named stack group and make this router a member of that stack group, use the sgbp group command in global configuration mode.

sgbp group name

Syntax Description

name

Name of the stack group the system belongs to.

sgbp member

To specify the host name and IP address of a router or access server that is a peer member of a stack group, use the sgbp member command in global configuration mode.

sgbp member peer-name [peer-ip-address]

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.

sgbp ppp-forward

To enable forwarding of PPP calls---in addition to Multilink PPP (MLP) calls---to the winner of the Stack Group Bidding Protocol (SGBP) bid, use the sgbp ppp-forward command in global configuration mode.

sgbp ppp-forward

Syntax Description

This command has no arguments or keywords.

sgbp seed-bid

To set the bidding level that a stack group member can bid with for a bundle, use the sgbp seed-bid command in global configuration mode.

sgbp seed-bid {default | offload | forward-only | bid}

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.

minutes	Specifies the timeout interval in minutes.
output	(Optional) Specifies that when traffic is sent to an asynchronous line from the router (within the specified interval), the connection is retained.

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.

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.

Table of Contents

Cisco IOS Dial Services Commands: PRI Through SGBP