Cisco VR-561 User Manual

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

This chapter presents the commands to configure and maintain Cisco IOS voice, video, and fax applications. The commands are presented in alphabetical order beginning with R. Some commands required for configuring voice, video, and fax may be found in other Cisco IOS command references. Use the command reference master index or search online to find these commands.

For detailed information on how to configure these applications and features, refer to the Cisco IOS Voice, Video, and Fax Configuration Guide.

Cisco IOS Voice, Video, Fax Command Reference

VR-561

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

register e164

To configure a gateway to register or deregister (remove the registration for) a fully qualified plain old telephone service (POTS) dial -peer E.164 address wi th a ga tek eep er, use the r egi ster e164 co mmand in dial-peer configuration mode. To deregister an E.164 address, use the no form of this command.

Syntax Description This command has no keywords or arguments.

Defaults No E.164 addresses are registered until you enter this command.

Command Modes Dial-peer configuration

Command History

Release Modification

12.0(5)T This command was introduced on the Cisco AS5300 universal access server.

Usage Guidelines Use this command to register the E.164 address of an analog telephone line attached to a Foreign

Exchange Station (FXS) port on a router. The gateway automatically registers fully qualified E164 addresses. Use the no register e164 command to deregister an address. Use the register e164 command to register a deregistered address.

Before you automatically or manually regi ster an E.164 address with a gatek eeper , you must create a dial peer (using the dial-peer command), assign an FXS port to the peer (using the port command), and assign an E.164 address (using the destination-pattern command). The E.164 address must be a fully qualified address. For example, +5551212, 5551212, and 4085551212 are fully qualified addresses;

408555.... is not a fully qualified address. E.164 addresses are registered only for active

interfaces—those that are not shut down. If an FXS port or its interf ace is shut down, the corresponding E.164 address is deregistered.

Tips You can use the show gateway command to fin d out if the g ateway is connected to a gatekeeper and

if a fully qualified E.164 address is assigned to the gateway. Use the zone-prefix command at the

gatekeeper to define prefix patterns, such as 408555...., that apply to one or more gateways.

Examples The following command sequence places the g ate way in d ial-peer conf iguration mo de, assigns an E.164

address to the interface, and registers that address with the gatekeeper:

dial-peer voice 111 pots

port 1/0/0 destination-pattern 5551212 register e164

Cisco IOS Voice, Video, Fax Command Reference

VR-562

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

The following commands deregister an address with the gatekeeper:

dial-peer voice 111 pots no register e164

The following example sho ws that you must ha ve a connecti on to a gatekeeper and def ine a unique E.164 address before you can register an address:

dial-peer voice 222 pots port 1/0/0

destination 919555....

ERROR-register-e164:Dial-peer destination-pattern is not a full E.164 number

no gateway dial-peer voice 111 pots register e164

ERROR-register-e164:No gatekeeper

Related Commands Command Description

destination-pattern Specifies either the prefix, the full E.164 telephone number, or an ISDN

directory number (depending on the dial plan) to be used for a dial peer.

dial-peer Enters dial-peer configuration mode, defines the type of dial peer, and

defines the tag number associated with a dial peer.

port Enables an interface on a PA-4R-DTR to operate as a concentrator port. show gateway Displays the current gateway status. zone prefix Configures the gatekeeper with knowledge of its own prefix and the prefix

of any remote zone.

Cisco IOS Voice, Video, Fax Command Reference

VR-563

registered-caller ring

To configure the Nariwake service registered caller ring cadence, use the registered-caller ring command in dial-peer configuration mode.

registered-caller ring cadence

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Syntax Description

cadence A value of 0, 1, or 2. The default ring cadence for registered callers is 1

and for unregistered callers is 0. The on and off periods of ring 0 (normal ringing signals) and ring 1 (ringing signals for the Nariwake service ) are defined in the NTT user manual.

Defaults The default Nariwake service registered caller ring cadence is ring 1.

Command Modes Dial-peer configuration

Command History

Release Modification

12.1.(2)XF The command registered-caller ring was introduced on the Cisco 800

series routers.

Usage Guidelines If your ISDN line is provisioned for the I Number or dial-in services, you must also conf igure a dial peer

by using the destination-pattern not-provided command. Either port 1 or port 2 can be configured under this dial peer. The router then forwards the incoming call to voice port 1. (See the “Examples” section below.

If more than one dial peer is configured with the destination-pattern not-provided command, the router uses the first configured dial peer for the incoming calls. To display the Nariwake ring cadence setting, use the show run command.

Examples The following example sets the ring cadence for registered callers to 2.

pots country jp dial-peer voice 1 pots

registered-caller ring 2

Cisco IOS Voice, Video, Fax Command Reference

VR-564

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

req-qos

To specify the desired quality of service to be used in reaching a specified dial peer, use the req-qos command in dial-peer configuration mode. To restore the default value for this command, use the no form of this command.

req-qos {best-effort | controlled-load | guaranteed-delay} no req-qos

req-qos

Syntax Description

Defaults best-effort

Command Modes Dial-peer configuration

Command History

Usage Guidelines This command is applicable only to VoIP dial peers.

best-effort Indicates that Resource Reservation Protocol (RSVP) make s no bandwidth

reservation.

controlled-load Indicates that RSVP guarantees a single level of preferential service,

presumed to correlate to a delay boundary. The controlled load service uses admission (or capacity) control to assure that preferential service is received even when the bandwidth is overloaded.

guaranteed-delay Indicates that RSVP reserves bandwidth and guarantees a minimum bit rate

and preferential queueing if the bandwidth reserved is not exceeded.

Release Modification

11.3(1)T This command was introduced on the Cisco 3600 series routers.

Use the req-qos command to request a specif ic quality of service to be used in reaching a dial peer. Like acc-qos, when you issue this command, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses Resource Reservation Protocol (RSVP) to request quality of service guarantees from the network.

Examples The following example configures guaranteed-delay as the desired (requested) quality of service to a

dial peer:

dial-peer voice 10 voip

req-qos guaranteed-delay

Related Commands

Command Description

acc-qos Defines the acceptable QoS for any inbound and outbound call on a VoIP dial

peer.

Cisco IOS Voice, Video, Fax Command Reference

VR-565

reset

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

To reset a set of digital signal processors (DSPs), use the reset command in global configuration mode.

reset number

Syntax Description

Defaults No default behavior or values.

Command Modes Global configuration

Command History

Examples The following example displays the reset command configuration for DSP 1:

number Specifies the number of DSPs to be reset. The number of DSPs ranges

from 0 to 30.

12.0(5)XE This command was introduced on the Cisco 7200 series routers.

12.0(7)T This command was integrated into the Cisco IOS Release 12.0(7)T.

reset 1 01:24:54:%DSPRM-5-UPDOWN: DSP 1 in slot 1, changed state to up

VR-566

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

resource threshold

To c onfigure a gateway to report H.323 resour ce availability to the its gatekeeper, use the resource threshold command in gateway configuration mode. To d isable gateway resource-level reporting, use the no form of this command.

resou rc e t h re s h o l d [all] [high percentage-value] [low percentage-value] no resource threshold

resource threshold

Syntax Description

Defaults Reports low resources when 90 percent of resources are in use, and reports resource availability when

Command Modes Gateway configuration

all (Optional) Applies the high- and low- parameter settings to all monitored

H.323 resources. This is the default condition.

high percentage-value (Optional) A resource utilization level that triggers a Resource Availability

Indicator (RAI) message indicating that H.323 resource use is high. Enter a number between 1 and 100 that represents the high-resource utilization percentage. A value of 100 specifies high-resource usage when any H.323 resource is unavailable. The default is 90 percent.

low percentage-value (Optional) Resource utilization lev el that triggers an RAI message indicating

that H.323 resource usage has dropped below the high-usage level. Enter a number between 1 and 100 that represents the acceptable resource utilization percentage. After the gateway sends a high-utilization message, it waits to send the resource recovery message until the resource use drops below the value defined by the low parameter. The default is 90 percent.

resource use drops below 90 percent.

Command History

Usage Guidelines The resou rc e t h re s h o l d command defines the resource load levels that trigger Resource Availability

Note The DS0 resources that are monitored for H.32 3 calls are l imited to the ones that are associated with

Release Modification

12.0(5)T This command was introduced on the Cisco AS5300 universal access serv er.

Indicator (RAI) messages. To view the monitored resources, enter the show gateway command. The monitored H.323 resources include digital signal processor (DSP) channels and DS0s. Use the show

call resource voice stats command to see the total amount of resources available for H.323 calls.

a voice POTS dial peer.

See the dial-peer configuration commands for details on ho w to associate a dial peer with a PRI or CAS group.

Cisco IOS Voice, Video, Fax Command Reference

VR-567

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

resource threshold

When any monitored H.323 resources exceed the threshold level defined by the high parameter, the gateway sends an RAI message to the gatekeeper with the AlmostOutOfResources field flagged. This message reports high resource usage.

When all gateway H.323 resources drop below the level defined by the low parameter, the gateway sends the RAI message to the gatekeeper with the AlmostOutOfResources field cleared.

When a gatekeeper can choose between multiple gateways for call completion, the gatekeeper uses internal priority settings and gateway resource statistics to determine which gateway to use. When all other factors are equal, a gateway that has available resources will be chosen over a gateway that has reported limited resources.

Examples The following command defines the H.323 resource limits for a gateway:

resource threshold high 70 low 60

Related Commands Command Description

show call resource voice

Displays resource statistics for an H.323 gateway.

stats show call resource voice

threshold

Displays the threshold configuration settings and status for an H.323 gateway.

show gateway Displays the current gateway status.

VR-568

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

response-timeout

To configure the maximum time to wait for a response from a server, use the response-timeout command in settlement configuration mode. To restore the default value of this command, use the no form of this command.

response-timeout nu mber no response-timeout number

response-timeout

Syntax Description

Defaults The default response timeout is one (1) second.

Command Modes Settlement configuration

Command History

Usage Guidelines If no response is received within the response-timeout time limit, the current connection ends, and the

Examples The following example illustrates a response-timeout set to 1 second.

number Response waiting time in seconds.

Release Modification

12.0(4)XH1 This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and the Cisco AS5300 universal access server.

12.1(1)T This command was integrated into Cisco IOS Release 12.1(1)T.

router attempts to contact the next service point.

settlement 0

response-timeout 1

Related Commands

Command Description

connection-timeout Configures the time for which a connection is maintained after completion

of a communication exchange.

customer-id Identifies a carrier or ISP with a settlement provider. device-id Specifies a gateway associated with a settlement provider. encryption Sets the encryption method to be negotiated with the provider. max-connection Sets the maximum number of simultaneous connections to be used for

communication with a settlement provider.

retry-delay Sets the time between attempts to connect with the settlement provider. retry-limit Sets the maximum number of attempts to connect to the provider.

Cisco IOS Voice, Video, Fax Command Reference

VR-569

response-timeout

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Command Description

session-timeout Sets the interva l for closing the connec tion when there is no input or output

traffic.

settlement Enters settlement mode and specifies the attributes specific to a settlement

provider.

show settlement Displays the configuration for all settlement server transactions. shutdown/no

Deactivates the settlement provider/activates the settlement provider.

shutdown type Configures an SAA-RTR operation type. url Specifies the Internet service provider address.

VR-570

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

retry-delay

T o set the time between attempts to connect with the settlement pro v ider, use the retry-delay command in settlement configuration mode. To restore the default value, use the no form of this command.

retry-delay number no retry-delay

retry-delay

Syntax Description

Defaults The default retry delay is two seconds.

Command Modes Settlement configuration

Command History

Usage Guidelines After exhausting all service points for the provider, the router is delayed for the specified length of time

Examples The following example sets a retry value of 15 seconds:

number Length of time (in seconds) between attempts to connect with th e settlement

provider. The valid range for retry delay is from 1 to 600 seconds.

Release Modification

12.0(4)XH1 This command w as introduced on the Cisco 2600 and 3600 series routers and the Cisco AS5300 universal access server.

12.1(1)T This command was integrated into Cisco IOS Release 12.1(1)T.

before resuming connection attempts.

settlement 0

relay-delay 15

Related Commands

Command Description

connection-timeout Configures the time for which a connection is maintained after completion

of a communication exchange.

communication with a settlement provider.

response-timeout Configures the maximum time to wait for a response from a server. retry-limit Sets the maximum number of attempts to connect to the provider.

Cisco IOS Voice, Video, Fax Command Reference

VR-571

retry-delay

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Command Description

session-timeout Sets the interva l for closing the connec tion when there is no input or output

traffic.

settlement Enters settlement configuration mode and specifies the attributes specific to

a settlement provider.

show settlement Displays the configuration for all settlement server transactions. shutdown/no

Deactivates the settlement provider/activates the settlement provider.

shutdown type Configures an SAA-RTR operation type.

VR-572

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

retry-limit

To set the maximum number of attempts to connect to the provider, use the retry-limit command in settlement configuration mode. To restore the default value, use the no form of this command.

retry-limit number no retry-limit number

retry-limit

Syntax Description

Defaults The default retry limit is one (1) retry.

Command Modes Settlement configuration

Command History

Usage Guidelines If no connection is established after the configured retries, the router ceases connection attempts. The

Examples The following example sets the number of retries to 1:

number Maximum number of connection attempts in addition to the first attempt.

Release Modification

12.0(4)XH1 This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on the Cisco AS5300 universal access server.

12.1(1)T This command was integrated into Cisco IOS Release 12.1(1)T.

retry limit number does not count the initial connection attempt. A retry limit of one (default) results in a total of two connection attempts to every service point.

settlement 0

retry-limit 1

Related Commands

Command Description

connection-timeout Configures the time for which a connection is maintained after a

communication exchange is complete.

communication with a settlement provider.

response-timeout Configures the maximum time to wait for a response from a server. retry-delay Sets the time between attempts to connect with the settlement provider.

Cisco IOS Voice, Video, Fax Command Reference

VR-573

retry-limit

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Command Description

session-timeout Sets the length of interval for closing the connection when there is no input

or output traffic.

settlement Enters settlement mode and specifies the attributes specific to a settlement

provider.

show settlement Displays the configuration for all settlement server transactions. shutdown Brings up the settlement provider. type Configures an SAA-RTR operation type.

VR-574

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

retry (SIP user-agent)

To configure the number of retry attempts for Session Initiation Protocol (SIP) messages, use th e retry command in SIP user-agent configuration mode. To reset this command to the default value, use the no form of this command.

retry {invite number | response numbe r | bye number | cancel number} no retry {invite number | response number | bye number | cancel number}

retry (SIP user-agent)

Syntax Description

Defaults invite: 6

Command Modes SIP user-agent configuration

Command History

Usage Guidelines To reset this command to the default value, you can also use the default command.

invite number Number of INVITE retries: 1 through 10 are valid inputs; default = 6. response number Number of RESPONSE retries: 1 through 10 are valid inputs; default = 6. bye number Number of BYE retries: 1 through 10 are valid inputs; default = 10. cancel number Number of CANCEL retries: 1 through 10 are valid inputs; default = 10.

response: 6 bye: 10 cancel: 10

Release Modification

12.1(1)T This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on the Cisco AS5300 universal access server.

Examples In the following example, the number of invite retries has been set to 5.

sip-ua

retry invite 5

Related Commands

Command Description

sip-ua Enables the sip-ua configuration commands, with which you configure the

user agent.

Cisco IOS Voice, Video, Fax Command Reference

VR-575

ring

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

To set up a distinctive ring for your connected telephones, fax machines, or modems, use the ring command in interface configuration mode. To disable the specified distinctive ring, use the no form of this command.

ring cadence-number no ring cadence-number

Syntax Description

Defaults The default is 0.

Command Modes Interface configuration

Command History

Usage Guidelines This command applies to Cisco 800 series routers.

cadence-number Number from 0 through 2:

• Type 0 is a primary ringing caden ce—default ringing cadence

for the country your router is in.

• Type 1 is a distinctive ring—0.8 seconds on, 0.4 seconds off,

0.8 seconds on, 0.4 seconds off.

• Type 2 is a distinctive ring—0.4 seconds on, 0.2 seconds off,

0.4 seconds on, 0.2 seconds off, 0.8 seconds on, 4 seconds off.

Release Modification

12.0(3)T This command was introduced on the Cisco 800 series router.

You can specify this command when creating a dial peer. This command will not work if it is not specified within the context of a dial peer. For information on creating a dial peer, refer to the Cisco 800 Series Routers Software Configuration Guide.

Examples The following example specifies the type 1 distinctive ring:

ring 1

Cisco IOS Voice, Video, Fax Command Reference

VR-576

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Related Commands Command Description

destination-pattern Specifies either the prefix, the full E.164 telephone number, or an

ISDN directory number (depending on the dial plan) to be used for a dial peer.

dial-peer voice Enters dial-peer configuration mode, defines the type of dial peer, and

defines the tag number associated with a dial peer.

no call-waiting Disables call waiting. port (dial-peer) Enables an interface on a PA-4R-DTR port adapter to operate as a

concentrator port.

pots distinctive-ring-guard-time

Specifies a delay in which a telephone port can be rung after a previous call is disconnected (for Cisco 800 series routers).

ring Sets up a distinctive ring for telephones, fax machin es, or mod ems

connected to a Cisco 800 series router.

show dial-p eer voic e Displays configuration information and call statistics for dial peers.

ring

Cisco IOS Voice, Video, Fax Command Reference

VR-577

ring cadence

To specify the ring cadence for a Foreign Exchange Station (FXS) voice port, use the ring cadence command in voice-port configuration mode. To restore the default value, use the no form of this command.

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

ring cadence {pattern-number | define pulse interval} no ring cadence

Syntax Description

pattern-number Predefined ring cadence patterns. Each pattern specifies a ring-pulse

time and a ring-interval time.

• pattern01—2 seconds on, 4 seconds off

• pattern02—1 second on, 4 seconds off

• pattern03—1.5 seconds on, 3.5 seconds off

• pattern04—1 second on, 2 seconds off

• pattern05—1 second on, 5 seconds off

• pattern06—1 second on, 3 seconds off

• pattern07—0.8 second on, 3.2 seconds off

• pattern08—1.5 seconds on, 3 se conds off

• pattern09—1.2 seconds on, 3.7 seconds off

• pattern09—1.2 seconds on, 4.7 seconds off

• pattern11—0.4 second on, 0.2 second off, 0.4 second on, 2 seconds

off

• pattern12—0.4 second on, 0.2 second off, 0.4 second on, 2.6

seconds off

define User-definable ring cadence pattern. Each number pair specifies one

ring-pulse time and one ring-interval time. You must enter numbers in pairs, and you can enter from 1 to 6 pairs. The second number in the last pair that you enter specifies the interval between rin gs.

pulse A number (1 or 2 digits) specifying ring pulse (on) time in hundreds of

milliseconds. The range is from 1 to 50, for pulses of 100 ms to 5000 ms.

For example: 1 = 100 ms; 10 = 1 s, 40 = 4 s.

interval A number (1 or 2 digits) specifying ring interval (off) time in hundreds

of milliseconds. The range is from 1 to 50, for pulses of 100 to 5000 ms.

For example: 1 = 100 ms; 10 = 1 s, 40 = 4 s.

Defaults Ring cadence defaults to the pattern you specify with the cptone command.

Cisco IOS Voice, Video, Fax Command Reference

VR-578

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Command Modes Voice-port configuration

ring cadence

Command History

Release Modification

11.3(1)MA This command was introduced on the Cisco MC3810 multiservice concentrator.

12.0(7)XK This command was first supported on the Cisco 2600 and 3600 series routers, and the patternXX keyword was introduced.

12.1(2)T This command was integrated into the 12.1(2)T release.

Usage Guidelines The patternXX keyword provides preset ring cadence patterns for use on any platform. The define

keyword allows you to create a custom ring cadence. On the Cisco 2600 and 3600 series routers, only one or two pairs of digits can be entered under the define keyword.

Examples The following example configures the ring cadence for 1 second on and 4 seconds off on voice port 1/1

on a Cisco MC3810 multiservice concentrator:

voice-port 1/1

ring cadence pattern02

The following example configures the ring cadence for 1 second on, 1 second off, 1 second on, and 5 seconds off on voice port 1/2 on a Cisco MC3810 multiservice concentrator:

voice-port 1/2

ring cadence define 10 10 10 50

Related Commands

The following example conf igures the ring cad ence for 1 second on an d 2 seconds off o n voice port 1/ 0/0 on a Cisco 2600 or 3600 series router:

voice-port 1/0/0

ring cadence pattern04

Command Description

ring frequency Specifies the ring frequency for a specified FXS voice port. cptone Specifies the default tone, ring, and cadence settings according to country.

Cisco IOS Voice, Video, Fax Command Reference

VR-579

ring frequency

To specify the ring frequency for a specified Foreign Exchange Station (FXS) voice port, use the ring frequency command in voice-port configuration mode. To restore the default value, use the no form of

this command.

ring frequency number no ring frequency number

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Syntax Description

number Ring frequency (hertz) used in the FXS interface. Valid entrie s on the

Cisco 3600 series are 25 and 50. Valid entries on the Cisco MC3810 multiservice concentrator are 20 and 30.

Defaults 25 Hz on the Cisco 3600 series routers and 20 Hz on the Cisco MC3810 multiservice concentrators.

Command Modes Voice-port configuration

Command History

Release Modification

11.3(1)T This command was introduced on the Cisco MC3810 multiservice concentrator.

Usage Guidelines Use the ring frequency command to select a specific ring frequency for an FXS voice port. Use the no

form of this command to reset the default value. The ri ng frequency you select must match the connected equipment. If set incorrectly, the attached phone might not ring or might buzz. In addition, the ring frequency is usually country-dependent. You should tak e into account the approp riate ring frequency for your area before configuring this command.

This command does not affect ringback, which is the ringing a user hears when placing a remote call.

Examples The following example configures the ring frequency on the Cisco 3600 series for 25 Hz:

voice-port 1/0/0

ring frequency 25

The following example configures the ring frequency on the Cisco MC3810 multiservice concentrator for 20 Hz:

voice-port 1/1

ring frequency 20

Cisco IOS Voice, Video, Fax Command Reference

VR-580

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Related Commands Command Description

ring cadence Specifies the ring cadence for an FXS voice port on the Cisco MC3810

multiservice concentrator.

ring number Specifies the number of rings for a specified FXO voice port.

ring frequency

Cisco IOS Voice, Video, Fax Command Reference

VR-581

ring number

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

To specify the number of rings for a specified Foreign Exchange Office (FXO) voice port, use the ring number comman d in voice-port conf iguration mode . T o restore the default v alue, use the no form of this

command.

ring number number no ring number number

Syntax Description

number Number of rings detected before answering the call. Valid entries are

numbers from 1 to 10. The default is 1.

Defaults One ring

Command Modes Voice-port configuration

Command History

Release Modification

11.3(1)T This command was introduced on the Cisco 3600 series router.

Usage Guidelines Use the ring number command to set the maximum number of rings to be detected before answering a

call over an FXO voice port. Use the no form of this command to reset the default value, which is one ring.

Normally , this command should be set to the def ault so that incoming calls are answered quickly. If you have other equipment available on the line to answer incoming calls, you might want to set the value higher to giv e the equipment sufficient time to respond. In that case, the FXO interface would answer if the equipment online did not answer the incoming call in the configured number of rings.

This command is not applicable to Foreign Exchange Station (FXS) or E&M interfaces because they do not receive ringing on incoming calls.

Examples The following example on the Cisco 3600 series sets five rings as the maximum number of rings to be

detected before closing a connection over this voice port:

voice-port 1/0/0

ring number 5

The following exampl e on the Cisco MC3810 multiservice concentrator sets five rings as the maximum number of rings to be detected before closing a connection over this voice port:

voice-port 1/1

ring number 5

Cisco IOS Voice, Video, Fax Command Reference

VR-582

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Related Commands Command Description

ring frequency Specifies the ring frequency for a specified FXS voice port.

ring number

Cisco IOS Voice, Video, Fax Command Reference

VR-583

roaming (dial-peer)

T o enable the roaming capability for t he dial peer, use the roaming command in dial-peer configuration mode. To disable the roaming capability, use the no form of this command.

roaming no roaming

Syntax Description This command has no arguments or keywords.

Defaults No roaming

Command Modes Dial-peer configuration

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Command History

Usage Guidelines Enable the roaming capability of a dial peer if that dial peer can terminate roaming calls. If a dial peer

Examples The following example enables the roaming capability for the dial peer:

Related Commands

Release Modification

12.1(1)T This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on the Cisco AS5300 universal access server‘.

is dedicated to local calls only, disable the roaming capability. The roaming dial peer must work with a roaming service pro vider. If the dial peer allows a roaming user

to go through, and the service provider is not roaming-enabled, the call fails.

dial-peer voice 10 voip roaming

Command Description

roaming (settlement) Enables the roaming capability for a settlement provider. settle-call Limits the dial peer to using only the specific clearinghouse identified

by the specified provider-number.

settlement roam-pattern Configures a pattern to match against when determining roaming.

VR-584

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

roaming (settlement)

To enable the roaming capability for a settlement provider, use the roaming command in settlement configuration mode. To disable the roaming capability, use the no form of this command.

roaming no roaming

Syntax Description This command has no arguments or keywords.

Defaults No roaming

Command Modes Settlement configuration

roaming (settlement)

Command History

Usage Guidelines Enable roaming capability of a settlement provider if that provider can authenticate a roaming user and

Examples The following example enables the roaming capability for the settlement provider:

Related Commands

Release Modification

12.1(1)T This command was introduced on the Cisco 2600 series and Cisco 3600 series routers and on the Cisco AS5300 universal access server.

route roaming calls. A roaming call is successful only if both the settlement provider and the outbound dial peer for that call

are roaming-enabled.

settlement 0 roaming

Command Description

roaming (dial-peer mode) Enables the roaming capability for the dial peer. settle-call Limits the dial peer to using only the specific clearinghouse identified

by the specified provider-number.

settlement roam-pattern Configures a pattern to match against when determining roaming.

Cisco IOS Voice, Video, Fax Command Reference

VR-585

rtsp client session history duration

To specify how long to keep Real Time Streaming Protocol (RTSP) session history records in memory, use the rtsp client session history duration command in global configuration mode. To set the value to the default, use the no form of this command.

rtsp client session history duration number no rtsp client session history duration number

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

Syntax Description

Defaults 10 minutes

Command Modes Global configuration

Command History

Examples The following example sets the RTSP session history to 500 minutes:

Related Commands

number Specifies how long, in minutes, to keep the record.

Release Modification

12.1(3)T This command was introduced on the Cisco AS5300 universal access server.

rtsp client session history duration 500

Command Description

call application voice load Allows reload of an aplication that was loaded via the MGCP

scripting package.

rtsp client session history records

show call application voice Displays all TCL or MGCP scripts that are loaded. show rtsp client session Displays cumulative information about the RTSP session records.

Specifies the number of RTSP client session history records kept during the session.

VR-586

Cisco IOS Voice, Video, Fax Command Reference

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

rtsp client session history records

T o configure the number of records to keep in the R TSP client session history , use the rtsp client session history records command in global conf iguration mode. To set the value to the default , use the no for m

of this command.

rtsp client session history records number no rtsp client session history records number

rtsp client session history records

Syntax Description

Defaults 50 records

Command Modes Global configuration

Command History

Examples The following example sets the RTSP client history to 500 records:

Related Commands

number Specifies the number of records to retain in a session history. Values

range from 1 to 100000.

Release Modification

12.1(3)T This command was introduced on the Cisco AS5300 universal access server.

rtsp client session history records 500

Command Description

call application voice load Allows reload of an aplication that was loaded via the MGCP

scripting package.

rtsp client session history duration

show call application voice Displays all TCL or MGCP scripts that are loaded.

Specifies the how long the RTSP is kept during the session.

Cisco IOS Voice, Video, Fax Command Reference

VR-587

rule

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

To apply a translation rule to a calling party number or a called party number for both incoming and outgoing calls, use the rule command in translation-rule configuration mode. T o remove the translation rule, use the no form of this command.

rule name-tag input-matched-pattern substituted-pattern [match-type substituted-type] no rule name-tag input-matched-pattern substituted-pattern [match-type substituted-type]

Syntax Description

Note In the syntax description above, the square brackets indicate optional values. When using this

name-tag The tag number by which the rule set will be referenced. This is an

arbitrarily chosen number. Range is from 1 through 2147483647.

input-matched-pattern The input string of digits for which pattern matching is performed. substituted-pattern The replacement digit string that results after pattern matching is

performed. Regular expressions are used to carry out this process.

match-type (Optional) The choices for this field are international, national,

subscriber, abbreviated, unknown, and any, as defined by the

International Telecommunication Union Telecommunication Standardization Sector (ITU-T) Q.931 specification. If y o u en t e r t h e

match-type value, then you must also enter the substituted-type valu e .

substituted-type (Optional) The choices for this field are international, national,

subscriber, abbreviated and unknown, as defined by the ITU Q.931 specification.

command, do not include these square brackets as part of the syntax. They are not valid parameters in the rule command. The square brackets can only be used in actual syntax for such commands as the destination-pattern and incoming called-number commands, where the syntax specifically allows this delimiter.

Defaults No default behavior or values.

Command Modes Translation-rule configuration

Command History

Cisco IOS Voice, Video, Fax Command Reference

VR-588

Release Modification

12.0(7)XR1 This command was introduced for Voice over IP on the Cisco AS5300

12.0(7)XKs This command was first supported for Voice over IP on the following

universal access server.

platforms: Cisco 2600 and 3600 series routers and Cisco MC3810 multiservice concentrators.

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

rule

Release Modification

12.1(1)T This command was first supported on the T train for Voice over IP on the

following platforms: Cisco 1750 routers, Cisco 2600 and 3600 series routers, Cisco AS5300 universal access servers, Cisco 7200 series routers, and Cisco 7500 series routers.

12.1(2)T This command was first supported for Voice over IP on the

Cisco MC3810 multiservice concentrator.

Usage Guidelines When configuring your dial peers, you are provided with an option called the translation rule. This

option applies a translation rule to a calling party number (Automatic Number Identification [ANI]) or a called party number (Dial Number Information Servi ce [DNI S]) fo r both incoming and out goi ng call s within Cisco H.323 voice-enabled gatewa ys. Also, the rule allows translation of the type of number.

Examples The following example applies a translation rule. If a called number starts with 5552205 or 52205, then

translation rule 21 will use the rule command to forward the number to 14085552205 instead.

translation-rule 21

rule 1 555.% 1408555 subscriber international rule 2 7.% 1408555 abbreviated international

Related Commands

In the next example, if a called number is either 14085552 205 or 014085552205, then after the execution of the translation rule 345, the forwarding digits will be 52205. If the match type is configured and the type is not “unknown,” then the dial peer matching will be required to match input string numbering type.

translation-rule 345

rule 1 .%555.% 7 any abbreviated

Command Description

numbering-type Specifies number type for the VoIP or POTS dial peer. test translation-rule Tests the execution of the translation rules on a sp ecific name tag. translate Applies a translation rule to a calling party number or a called party number

for incoming calls

translate-outgoing Applies a translation rule to a calling party number or a called party number

for outgoing calls

translation-rule Creates a translation name and enters translation-rule configuration mode. voip-incoming

Captures calls that originate from H.323-compatible clients.

translation-rule

Cisco IOS Voice, Video, Fax Command Reference

VR-589

security

Cisco IOS Voice, Video, and Fax Commands: R Through Sh

To enable authentication and authorization on a gatekeeper, use the security command in gatekeeper configuration mode. To disable security, use the no form of this command.

security {any | h323-id | e164} {password default password | password separator character} no security {any | h323-id | e164} {password default password | password separator character }

Syntax Description

any Uses the first alias of an incoming registration, admission, and status

(RAS) protocol registration, regardless of its type, as the means of identifying the user to RADIUS/TACAC S+.

h323-id Uses the first H.323 ID type alias as the means of identifying the user

to RADIUS/TACACS+.

e164 Uses the first E.164 address type alias as the means of identifying the

user to RADIUS/TACACS+.

password default password Specifies the default password that the gatekeeper associates with

endpoints when authenticating them with an authentication server . The password must be identical to the password on the authentication server.

password separator

character

Specifies the character that endpoints use to separate the H.323-ID from the piggybacked password in the registration. Specifying this character allows each endpoint to supply a user-specific password. The separator character and password will be stripped from the string before it is treated as an H.323-ID alias to be registered.

Note that passwords may only be piggybacked in the H.323-ID, no t the E.164 address, because the E.164 address allows a limited set of mostly numeric characters. If the endpoint does not wish to register an H.323-ID, it can still supply an H.323-ID consisting of just the separator character and password. This H.323-ID consisting of just th e separator character and password will be understood to be a passwor d mechanism and no H.323-ID will be registered.

Defaults No default

Command Modes Gatekeeper configuration

Command History

Usage Guidelines Use the security command to enable identi fication of registered aliase s by RADIUS/TACACS+. If the

Cisco IOS Voice, Video, Fax Command Reference

VR-590

Release Modification

11.3(2)NA This command was introduced on the Cisco 2600 series and Cisco 3600 series routers.

alias does not exist in RADIUS/TACACS+, the endpoint will not be allowed to register.

+ 280 hidden pages