Table Of Contents

SBC H.323 Commands on Cisco IOS XR Software

adjacency timeout (SBC SBE H.323)

h225 timeout (SBC SBE H.323)

h323 hunting-trigger (SBC SBE H.323)

ras retry (SBC SBE H.323)

ras rrq (SBC H.323)

ras timeout (SBC SBE H.323)

show services sbc sbe h323 hunting-trigger

show services sbc sbe h323 timers

SBC H.323 Commands on Cisco IOS XR Software

---

This module describes the H.323 commands used to configure and monitor the Session Border Controller (SBC).

For detailed information about SBC concepts, configuration tasks, and examples, refer to Cisco IOS XR Session Border Controller Configuration Guide.

adjacency timeout (SBC SBE H.323)

To configure the adjacency retry timeout interval, use the adjacency timeout command in SBE H.323 configuration mode. To return to the default value, use the no form of this command.

adjacency timeout value

no adjacency timeout

Syntax Description

value

Value of the timeout period in milliseconds. The range is from 10000 to 30000. The default value is 30 seconds.

Defaults

The default value is 30 seconds.

Command Modes

SBE H.323 configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure the adjacency retry timeout in SBE H.323 configuration mode:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323 

RP/0/0/CPU0:router(config-sbc-sbe-h323)# adjacency timeout 10000

h225 timeout (SBC SBE H.323)

To configure the H.225 timeout interval for H.323, use the h225 timeout command in SBE H.323 configuration mode. To return to the default value, use the no form of this command.

h225 timeout {setup | proceeding | establishment} value

no h225 timeout {setup | proceeding | establishment}

Syntax Description

setup	Specifies the setup state. Default value for this state is 4 seconds.
proceeding	Specifies the proceeding state. Default value for this state is 10 seconds.
establishment	Specifies the establishment state. Default value for this state is 180 seconds.
value	Timeout period in seconds. For setup and proceeding timeout periods, valid values are from 1 to 30 seconds. For establishment timeout, valid values are from 30 to 300 seconds.

Defaults

No default behavior or values

Command Modes

SBE H.323 configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure an H.225 timeout interval:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323

RP/0/0/CPU0:router(config-sbc-sbe-h323)# h225 timeout setup 30

RP/0/0/CPU0:router(config-sbc-sbe-h323)# h225 timeout proceeding 30

RP/0/0/CPU0:router(config-sbc-sbe-h323)# h225 timeout establishment 30

Related Commands

Command	Description
h225 timeout (SBC SBE adjacency H.323)	Configures the H.225 timeout interval for H.323 adjacency.

h323 hunting-trigger (SBC SBE H.323)

To configure failure return codes to global H.323 hunting triggers, use the h323 hunting-trigger command in SBE configuration mode. To clear all error codes, use the no form of this command.

h323 hunting-trigger {error-codes}

no h323 hunting-trigger

Syntax Description

error-codes

One of the following values is listed: •noBandwidth •unreachableDestination •destinationRejection •noPermission •gatewayResources •badFormatAddress •securityDenied •connectFailed (internally defined) •noRetry value—Specifies that routing should never be retired for this adjacency no matter what failure return code is received.

Defaults

No default behavior or values

Command Modes

SBE configuration

Command History

Release	Modification
Release 3.4.1	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

If you enter the h323 hunting-trigger x command followed by the h323 hunting-trigger y command, the value of x is replaced with the value of y.

To set both x and y to be hunting triggers, you must enter the h323 hunting-trigger x y command.

If you enter the no version of this command with codes x and y, these codes are removed from the configured list.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure H.323 to retry routing if it receives a noBandwidth or securityDenied error:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323 hunting-trigger noBandwidth securityDenied

Related Commands

Command	Description
show services sbc sbe h323 hunting-trigger	Displays the H.323 hunting triggers.

ras retry (SBC SBE H.323)

To configure an H.323 registration, admission, and status (RAS) global retry count for a RAS transaction type, use the ras retry command in SBE H.323 configuration mode. To return to the default value for the specified RAS transaction type, use the no form of this command.

ras retry {arq | brq | drq | grq | rrq | urq} value

no ras retry {arq | brq | drq | grq | rrq | urq}

Syntax Description

arq	Specifies an ARQ transaction. The default value is 2.
brq	Specifies a BRQ transaction. The default value is 2.
drq	Specifies a DRQ transaction. The default value is 2.
grq	Specifies a GRQ transaction. The default value is 2.
rrq	Specifies an RRQ transaction. The default value is 2.
urq	Specifies a URQ transaction. The default value is 1.
value	Value of the retry count. The range is from 0 to 30.

Defaults

The default values vary depending on the transaction type.

Command Modes

SBE H.323 configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure an H.323 RAS global retry count:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras retry arq 5

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras retry rrq 5

ras rrq (SBC H.323)

To configure the global registration request (RRQ), use the ras rrq command in SBE H.323 configuration mode. To return to the default value, use the no form of this command.

ras rrq {keepalive | ttl} value

no ras rrq {keepalive | ttl}

Syntax Description

keepalive	Specifies keepalive messages used to refresh an H.323 adjacency.
ttl	Specifies time to live (TTL) for an RRQ request.
value	Value for the keepalive or ttl keywords in seconds. The valid values for keepalive keyword are from 15 to 150. The valid values for ttl keyword are from 16 to 300. The ttl keyword value must be higher than the keepalive keyword value.

Defaults

keepalive value: 45

ttl value: 60

Command Modes

SBE H.323 configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure registration, admission, and status (RAS) RRQ in SBE H.323 configuration mode:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras rrq ttl 100

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras rrq keepalive 60

ras timeout (SBC SBE H.323)

To configure an H.323 registration, admission, and status (RAS) global timeout interval, use the ras timeout command in SBE H.323 configuration mode. To return to the default value, use the no form of this command.

ras timeout {arq | brq | drq | grq | rrq | urq} value

no ras timeout {arq | brq | drq | grq | rrq | urq}

Syntax Description

arq	Specifies ARQ transaction.
brq	Specifies BRQ transaction.
drq	Specifies DRQ transaction.
grq	Specifies GRQ transaction.
rrq	Specifies RRQ transaction.
urq	Specifies URQ transaction.
value	Timeout value, in seconds. Valid values are from 1 to 45 seconds.

Defaults

The default values vary depending on the transaction type.

Command Modes

SBE H.323 configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read, write

Examples

The following example shows how to configure an H.323 RAS timeout interval in SBE H.323 configuration mode:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# sbc mySbc

RP/0/0/CPU0:router(config-sbc)# sbe

RP/0/0/CPU0:router(config-sbc-sbe)# h323

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras timeout arq 1

RP/0/0/CPU0:router(config-sbc-sbe-h323)# ras timeout lrq 1

show services sbc sbe h323 hunting-trigger

To display the H.323 hunting triggers, use the show services sbc sbe h323 hunting-trigger command in EXEC mode.

show services sbc sbc-name sbe h323 hunting-trigger

Syntax Description

sbc-name

Name of the SBC service.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.4.1	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.
Release 3.6.0	No modification.
Release 3.7.0	Sample output was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read

Examples

The following sample output shows sample data for the media timeout timer for on-hold calls:

RP/0/0/CPU0:router# show services sbc mysbc sbe h323 hunting-trigger

H.323 Hunting Triggers

--------------------

noBandwidth

unreachableDestination

destinationrejection

noPermission

gatewayResources

badFormatAddress

securityDenied

connectFailed

show services sbc sbe h323 timers

To display a list of H.323 timer configurations, use the show services sbc sbe h323 timers command in EXEC mode.

show services sbc sbc-name sbe h323 timers

Syntax Description

sbc-name

Name of the SBC service.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0	No modification.
Release 3.7.0	Sample output was modified and the field descriptions was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

If a configuration is loaded on top of an active configuration, warnings are generated to notify that the configuration cannot be modified. If you must modify the entire configuration by loading a new one, please remove the existing configuration first.

Task ID

Task ID	Operations
sbc	read

Examples

The following sample output shows how to display a list of H.323 timer configurations:

RP/0/0/CPU0:router# show services sbc mySbc sbe h323 timers

H.323 timers

 Global scope

   adjacency retry timeout               30000

   h225 timeout setup                    4000

   h225 timeout proceeding               10000

   h225 timeout establishment            180000

   ras rrq ttl                           60

   ras rrq keepalive                     45000

   ras retry count (arq)                 2

   ras timeout (arq)                     5000

   ras retry count (brq)                 2

   ras timeout (brq)                     3000

   ras retry count (drq)                 2

   ras timeout (drq)                     3000

   ras retry count (grq)                 2

   ras timeout (grq)                     5000

   ras retry count (rrq)                 2

   ras timeout (rrq)                     3000

   ras retry count (urq)                 1

   ras timeout (urq)                     3000

Table 3 describes the significant fields shown in the display.

Table 3 show services sbc sbe h323 timers Field Descriptions 

Field	Description
adjacency timeout	Global configuration of the retry-timeout period for all adjacencies.
h225 timeout setup	Global configuration of the timeout period of the setup state for H.225.
h225 timeout proceeding	Global configuration of the timeout period of the proceeding state for H.225.
h225 timeout establishment	Global configuration of the timeout period of the establishment state for H.225.
ras rrq keepalive	Global configuration of the sending period of the RAS RRQ keepalive message.
ras rrq ttl	Global configuration of the time-to-live field (TTL) in the RAS RRQ message.
ras timeout rrq	Global configuration of the timeout period for waiting for the RRQ response.
RAS Timeout (drq)	Specific to an adjacency configuration of the timeout period for waiting for the DRQ response.
adjacency retry timeout	Configuration of the timeout period for a specific adjacency.
ras retry count (arq)	Global configuration of the number of retries for waiting for the ARQ response.
ras timeout (arq)	Global configuration of the timeout period for waiting for the ARQ response.
ras retry count (brq)	Global configuration of the number of retries for waiting for the BRQ response.
ras timeout (brq)	Global configuration of the timeout period for waiting for the BRQ response.
ras retry count (drq)	Global configuration of the number of retries for waiting for the DRQ response.
ras timeout (drq)	Global configuration of the timeout period for waiting for the DRQ response.
ras retry count (grq)	Global configuration of the number of retries for waiting for the GRQ response.
ras timeout (grq)	Global configuration of the timeout period for waiting for the GRQ response.
ras retry count (rrq)	Global configuration of the number of retries for waiting for the RRQ response.
ras retry count (urq)	Global configuration of the number of retries for waiting for the URQ response.
ras timeout (urq)	Global configuration of the timeout period for waiting for the URQ response.
RAS Timeout arq	Specific to an adjacency configuration of the timeout period for waiting for the ARQ response.