Cisco IOS 音声コマンドリファレンス - A ～ C - cable detect through call application stats [Cisco Unified Border Element]

cable-detect

アナログ Foreign Exchange Office (FXO) voice-portでケーブルポーリングを有効にするには、voice-port設定モードで cable-detect コマンドを使用します。ケーブルポーリングを無効にするには、このコマンドの no 形式を使用します。

cable-detect

no cable-detect

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

アナログ FXO voice-portでのケーブルポーリングは無効になっています。

コマンドモード

Voice-port configuration (config-voiceport)

コマンド履歴


リリース	変更
15.1(1)T	このコマンドが導入されました。
15.2(4)M	このコマンドは変更されました。ケーブルポーリングは、アナログの Foreign Exchange Office End Ground Start (FXOGS)、Foreign Exchange Office End Loop Start (FXOLS)、Foreign Exchange Station End Ground Start (FXSGS)、および Foreign Exchange Station End Loop Start (FXSLS) voice-portに拡張されました。

使用上のガイドライン

デジタル信号プロセッサ (DSP) がアナログ FXSLS ポートと FXOLS ポート間にケーブルが接続されていないことを検出した場合、FXOLS voice-portはビジーアウト状態になります。 no cable-detect コマンドを設定し、ケーブルが接続されていないためにアナログ FXOLS voice-portがビジーアウト状態になっている場合、Cisco ソフトウェアはケーブル接続のポーリングを停止します。アナログ FXOLS voice-portは、 shutdown および no shutdown コマンドを使用してアナログ FXOLS voice-portをアイドル状態に切り替えるまで、ビジーアウト状態のままになります。 cable-detect コマンドは、ループスタートと Central Automatic Message Accounting (CAMA) シグナリングをサポートします。

FXOLS とは異なり、アナログ FXOGS、FXSLS、および FXSGS voice-portの場合、ケーブルステータスが接続から切断に、または切断から接続に変わっても、voice-portの状態は変化しません。新しいケーブルステータスを示す syslog メッセージのみが出力されます。アナログ音声インターフェイスがケーブルポーリングをサポートしていない場合、このコマンドはvoice-portの下に表示されません。 cable-detect

アナログ FXOGS の場合、 cable-detect コマンドはすべての FXO 音声インターフェイスカードで設定できます。

このコマンドは、次のアナログ FXOLS 音声インターフェイスカード (VIC) で設定できます。

[VIC2-2FXS]
VIC2-4FXS
EM-HDA-6FXO
EM-HDA-3FXS-4FXO
EM-HDA-4FXO

アナログ FXSLS および FXSGS の場合、このコマンドは次の FXS 音声インターフェイスカードで設定できます。

VIC3-2FXS/DID
VIC3-4FXS/DID
VIC3-2FXS-E/DID
EM3-HDA-8FXS/DID
SM-D-72FXS
SM-D-48FXS-E
Cisco 8xx プラットフォーム上のオンボードアナログ FXS
Cisco VG20x および VG2435 プラットフォーム上のオンボードアナログ FXS

例

次の例は、FXOLS voice-portでケーブルポーリングを有効にする方法を示しています。


Device> enable
Device# configure terminal
Device(config)# voice-port 1/2/3
Device(config-voiceport)# cable-detect

コマンド	description
shutdown	特定の音声インターフェイスカードのvoice-portの状態をオフラインに変更します。

cable-detect-poll-timer

アナログvoice-port上のバックグラウンドポーリングプロセスのケーブルポーリングタイマー値を設定するには、音声サービス設定モードで cable-detect-poll-timer コマンドを使用します。ポーリングタイマーを無効にするには、このコマンドの no 形式を使用します。

cable-detect-poll-timer timer-value

no cable-detect-poll-timer

構文の説明


`タイマー値`	ケーブルポーリングタイマーの値 (分)。値の範囲は 0 ～ 1440 です。

コマンドデフォルト

アナログvoice-port上のケーブルポーリングは無効になっています。

コマンドモード

Voice service configuration (conf-voi-serv)

コマンド履歴


リリース	変更
15.2(4)M	このコマンドが導入されました。

使用上のガイドライン

cable-detect-poll-timer コマンドを使用して、アナログ Foreign Exchange Office End Ground Start（FXOGS）、Foreign Exchange Office End Loop Start（FXOLS）、Foreign Exchange Station End Ground Start（FXSGS）、および Foreign Exchange Station End Loop Start（FXSLS）voice-portのケーブルポーリングタイマー値を設定します。

例

次の例は、FXOLS voice-portでケーブルポーリングを有効にする方法を示しています。


Device> enable
Device# configure terminal
Device(config)# voice service pots
Device(conf-voi-serv)# cable-detect-poll-timer 100

コマンド	description
cable-detect	アナログ FXOGS、FXOLS、FXSGS、および FXSLS voice-portでのケーブルポーリングを有効にします。

cac_off

接続アドミッション制御（CAC）を無効にするには、インターフェイス ATM VC 設定モードで cac_off コマンドを使用します。 CAC を有効にするには、このコマンドの no 形式を使用します。

cac_off

no cac_off

構文の説明

このコマンドにはキーワードも引数もありません。

コマンドデフォルト

通話許可制御が有効になっています。

コマンドモード

インターフェース-ATM-VC 設定

コマンド履歴


リリース	変更
12.3(4)XD	このコマンドが導入されました。
12.3(7)T	このコマンドが Cisco IOS Release 12.3(7)T に統合されました。

使用上のガイドライン

接続許可制御 (CAC) は、接続のセットアップ中に各 ATM スイッチによって実行される一連のアクションであり、要求されたサービス品質 (QoS) が確立された接続の QoS 保証に違反するかどうかを判定します。 CAC は音声通話用の帯域幅を予約しますが、ロスレス圧縮codec (LLCC) の使用時に必要な帯域幅は動的であり、通常は CAC によって一般的に予約される帯域幅よりも小さくなります。 CAC を無効にすると、LLCC の使用時に帯域幅をより有効に活用できるようになります。

例

次の例では、PVC 上のコールアドミッション制御を無効にします。


interface ATM0/IMA1.1 point-to-point
 pvc test1 15/135
  cac_off

cache (neighbor BE)

ネイバーから受信した記述子をキャッシュするようにローカル境界要素 (BE) を設定するには、ネイバー BE 設定モードで cache コマンドを使用します。キャッシュを無効にするには、このコマンドの no 形式を使用します。

cache

no cache

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

キャッシュが有効になっていません

コマンドモード

ネイバー BE 設定 (config-annexg-neigh)

コマンド履歴


リリース	変更
12.2(2)XA	このコマンドが導入されました。
12.2(4)T	このコマンドが Cisco IOS Release 12.2(4)T に統合されました。このリリースには、Cisco AS5300 ユニバーサルアクセスサーバー、Cisco AS5350、Cisco AS5400 のサポートは含まれていません。
12.2(2)XB1	このコマンドが Cisco AS5850 に導入されました。
12.2(11)T	このコマンドが Cisco IOS Release 12.2(11)T に統合されました。

使用上のガイドライン

このコマンドを使用して、ローカル BE がネイバーから受信した記述子をキャッシュするように設定します。キャッシュが有効な場合、指定された間隔で近隣は記述子について照会されます。

例

次の例は、境界要素がその隣接要素からの記述子をキャッシュできるように有効になっていることを示しています。


Router(config-annexg-neigh)# id neighbor-id
Router(config-annexg-neigh)# cache

コマンド	description
id	近隣のブリッジエンティティのローカル ID を設定します。
port	Annex G メッセージの交換に使用される近隣のポート番号を設定します。
query-interval	ローカル BE が隣接 BE を照会する間隔を設定します。

cache reload time (global application configuration mode)

定期的にキャッシュからスクリプトをリロードするようにルータを設定するには、グローバルアプリケーション設定モードで cachereloadtime コマンドを使用します。値をデフォルトに設定するには、このコマンドの no 形式を使用します。

cache reload time bg-minutes

no cache reload time

構文の説明


`bg` -`分`	バックグラウンドプロセスが起動されるまでの分数。このバックグラウンドプロセスは、スクリプトが最後に使用されてからの経過時間と、スクリプトが最新かどうかを確認します。スクリプトが最後の「アンロード時間」内に使用されなかった場合は、スクリプトをアンロードして終了します。アンロード時間は設定できません。スクリプトが使用されている場合、バックグラウンドプロセスは URL からスクリプトを読み込みます。スクリプトを比較し、一致しない場合は、新しい呼び出しに新しいスクリプトの使用を開始します。

コマンドデフォルト

30 分

コマンドモード

グローバルアプリケーション設定

コマンド履歴


リリース	変更
12.3(14)T	callapplicationcachereloadtime コマンドはグローバルアプリケーション設定モードに移動され、cachereloadtime に変更されました。

例

次の例は、バックグラウンドプロセスが起動されるまでの 15 分を指定するように設定された cachereloadtime コマンドを示しています。

アプリケーションとサービスを設定するには、アプリケーション設定モードに入ります。


application

グローバルアプリケーション設定モードに入ります。


global

キャッシュの再読み込み時間を設定します。


cache reload time 15

コマンド	description
callapplicationcachereloadtime	定期的にキャッシュから MGCP スクリプトをリロードするようにルータを設定します。
showcallapplicationvoice	ロードされているすべての Tcl または MGCP スクリプトを表示します。

cadence

コールプログレストーンのトーンオンとトーンオフの継続時間を定義するには、コールプログレスデュアルトーン設定モードで cadence コマンドを使用します。既定のケイデンスに戻すには、このコマンドの no 形式を使用します。

{cadence cycle-1-on-time サイクル 1 のオフ時間 [cycle-2-on-time cycle-2-off-time] [cycle-3-on-time サイクル 3 のオフタイム] [cycle-4-on-time サイクル 4 オフタイム] | continuous}

no cadence

構文の説明


`cycle-1-on-time`	リズムパターンの最初のサイクルのトーンオン期間（ミリ秒 (ms)）。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`サイクル 1 のオフ時間`	リズムパターンの最初のサイクルのトーンオフ期間（ミリ秒単位）。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`cycle-2-on-time`	(オプション) リズムパターンの 2 番目のサイクルのトーンオン期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`サイクル 2 のオフ時間`	(オプション) リズムパターンの 2 番目のサイクルのトーンオフ期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`cycle-3-on-time`	(オプション) リズムパターンの 3 番目のサイクルのトーンオン期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`サイクル 3 のオフ時間`	(オプション) リズムパターンの 3 番目のサイクルのトーンオフ期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`cycle-4-on-time`	(オプション) リズムパターンの 4 番目のサイクルのトーンオン期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
`サイクル 4 のオフ時間`	(オプション) リズムパターンの 4 番目のサイクルのトーンオフ期間 (ミリ秒単位)。範囲は 0 ～ 1000 です。デフォルトは 0 です。
continuous	連続した通話進行トーンが検出されました。

コマンドデフォルト

連続

コマンドモード

通話進行デュアルトーン設定

コマンド履歴


リリース	変更
12.1(5)XM	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、および Cisco MC3810 で導入されました。
12.2(2)T	このコマンドは Cisco 1750 に実装され、Cisco IOS リリース 12.2(2)T に統合されました。

使用上のガイドライン

このコマンドは、カスタムコールプログレストーンのクラスのケイデンスを指定します。

voice-portで検出する各ケイデンスを定義する必要があります。検出する追加のケイデンスごとにコマンドを再入力します。

このコマンドがトーン検出に影響を与えるには、カスタムコールプログレストーンのクラスをvoice-portに関連付ける必要があります。

例

次の例では、「country-x」という名前の custom-cptone 音声クラスのビジートーンのリズムを定義します。この例では、500 ミリ秒のトーンオンと 500 ミリ秒のトーンオフを定義します。


voice class custom-cptone country-x
 dualtone busy
 cadence 500 500

次の例では、「country-x」という名前の custom-cptone 音声クラスのビジートーンのデフォルトの周波数とリズム値の検出を設定します。デフォルトの周波数は 300 Hz のトーンで、デフォルトのリズムは連続的です。


voice class custom-cptone country-x
 dualtone busy
 no cadence
 no frequency

コマンド	description
supervisorycustom-cptone	カスタム通話進行トーンのクラスをvoice-portに関連付けます。
voiceclasscustom-cptone	カスタム通話進行トーンを定義するための音声クラスを作成します。
voiceclassdualtone-detect-params	voiceclasscustom-cptone コマンドによって定義されたカスタム通話進行トーンの境界と制限を変更します。

cadence-list

検出するトーンケイデンスパターンを指定するには、音声クラス設定モードで cadence-list コマンドを使用します。ケイデンスパターンを削除するには、このコマンドの no 形式を使用します。

cadence-list ケイデンス ID cycle-1-on-time サイクル 1 のオフ時間 [cycle-2-on-time cycle-2-off-time] [cycle-3-on-time サイクル 3 のオフタイム] [cycle-4-on-time サイクル 4 オフタイム]

no cadence-list ケイデンス ID

構文の説明


`ケイデンス ID`	このケイデンスリストを識別するためのタグ。値の範囲は 1 ～ 10 です。
`cycle-1-on-time`	リズムパターンの最初のサイクルのトーンの持続時間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`サイクル 1 のオフ時間`	リズムパターンの最初のサイクルの無音期間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`cycle-2-on-time`	(オプション) リズムパターンの 2 番目のサイクルのトーンの持続時間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`サイクル 2 のオフ時間`	(オプション) リズムパターンの 2 番目のサイクルの無音期間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`cycle-3-on-time`	(オプション) リズムパターンの 3 番目のサイクルのトーンの持続時間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`サイクル 3 のオフ時間`	(オプション) リズムパターンの 3 番目のサイクルの無音期間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`cycle-4-on-time`	(オプション) リズムパターンの 4 番目のサイクルのトーンの持続時間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。
`サイクル 4 のオフ時間`	(オプション) リズムパターンの 4 番目のサイクルの無音期間。範囲は 0 ～ 1000 (0 ミリ秒～ 100 秒) です。デフォルトは 0 です。

コマンドデフォルト

ケイデンスパターンが設定されていません。

コマンドモード

音声クラスの設定 (config-voice-class)

コマンド履歴


リリース	変更
12.1(3)T	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、Cisco MC3810 で導入されました。

使用上のガイドライン

ケイデンスリストを使用すると、ルータは PBX または公衆交換電話網（PSTN）からの複雑なトーンパターンを一致させることができます。設定されたケイデンスリストと一致する場合、トーンが検出されます。最大 10 個のケイデンスリストを作成できるため、ルータでは最大 10 個の異なるトーンパターンを検出できます。検出するトーンがオン/オフサイクル 1 つだけで設定される場合は、次の 2 つの方法のいずれかで設定できます。

cycle-1-on-time と cycle-1-off-time変数 のみを使用してケイデンスリストを作成します。
cadence-max-off-time および cadence-min-on-time コマンドを使用します。

また、 cadence-max-off-time コマンドと cadence-min-on-time コマンドの時間を、 cadence-list コマンドで指定されたオン時間とオフ時間と一致するように設定する必要があります。 cadence-max-off-time の時間は、ケイデンスリスト内の最長のオフタイム以上である必要があります。また、 cadence-min-on-time の時間は、ケイデンスリスト内の最短のオンタイム以下である必要があります。

例

次の例は、音声クラス 100 に対して、オン/オフサイクルが 3 つあるケイデンスリスト 1 と、オン/オフサイクルが 2 つあるケイデンスリスト 2 の設定を示しています。


voice class dualtone 100
 cadence-list 1 100 100 300 300 100 200
 cadence-list 2 100 200 100 400

コマンド	description
cadence-max-off-time	トーンの検出の最大オフ期間を指定します。
cadence-min-on-time	トーンの検出の最小オン期間を指定します。
voiceclassdualtone	FXO トーン検出パラメータの音声クラスを作成します。

cadence-max-off-time

トーンがオフになってもリズムの一部として検出される最大時間を指定するには、音声クラス設定モードで cadence-max-off-time コマンドを使用します。デフォルトに戻すには、このコマンドの no 形式を使用します。

cadence-max-off-time 時刻

no cadence-max-off-time

構文の説明


`時間`	検出できるトーンの最大オフ時間（10 ミリ秒単位）。範囲は 0 ～ 5000 (0 ミリ秒～ 50 秒) です。デフォルトは 0 です。

コマンドデフォルト

0（オフ時間なし）

コマンドモード

音声クラスの設定 (config-voice-class)

コマンド履歴


リリース	変更
12.1(3)T	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、および Cisco MC3810 で導入されました。

使用上のガイドライン

検出するトーンのオフ時間よりも大きい時間値を指定し、リズムトーンの検出を有効にするには 0 より大きい時間値を使用します。デフォルト (0) では、ルータは連続トーンのみを検出します。

例

次の例は、音声クラス 100 の最大オフ期間を 20 秒に設定する例を示しています。


voice class dualtone 100
 cadence-max-off-time 2000

コマンド	description
cadence-min-on-time	トーンの検出の最小オン期間を指定します。
cadence-variation	トーンの検出に許可されるリズムの変化時間を指定します。
voiceclassdualtone	FXO トーン検出パラメータの音声クラスを作成します。

cadence-min-on-time

トーンがオンになってリズムの一部として検出される最小時間を指定するには、音声クラス設定モードで cadence-min-on-time コマンドを使用します。デフォルトに戻すには、このコマンドの no 形式を使用します。

cadence-min-on-time 時刻

no cadence-min-on-time

構文の説明


`時間`	検出できるトーンの最小オン時間（10 ミリ秒単位）。範囲は 0 ～ 100 (0 ミリ秒～ 1 秒) です。デフォルトは 0 です。

コマンドデフォルト

0（オン時間の最小値なし）

コマンドモード

音声クラスの設定 (config-voice-class)

コマンド履歴


リリース	変更
12.1(3)T	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、および Cisco MC3810 で導入されました。

使用上のガイドライン

検出するトーンのオン時間よりも短い時間値を指定します。デフォルト (0) では、任意の長さのトーンが検出されます。

例

次の例は、音声クラス 100 に対して 30 ミリ秒 (10 ミリ秒の時間間隔が 3 つ) の最小オン期間を設定する方法を示しています。


voice class dualtone 100
 cadence-min-on-time 3

コマンド	description
cadence-max-off-time	トーンの検出の最大オフ期間を指定します。
cadence-variation	トーンの検出に許可されるリズムの変化時間を指定します。
voiceclassdualtone	FXO トーン検出パラメータの音声クラスを作成します。

cadence-variation

トーンの検出に許可されるリズム変化時間を指定するには、音声クラス設定モードで cadence-variation コマンドを使用します。デフォルトのケイデンス変動時間を復元するには、このコマンドの no 形式を使用します。

cadence-variation 時刻

no cadence-variation

構文の説明


`時間`	トーンの開始が指定された開始時間から変化しても検出可能な最大時間 (10 ミリ秒単位)。範囲は 0 ～ 200 (0 ミリ秒～ 2 秒) です。デフォルトは 10 です。

コマンドデフォルト

10 ミリ秒

コマンドモード

音声クラスの設定 (config-voice-class)

コマンド履歴


リリース	変更
12.1(3)T	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、および Cisco MC3810 で導入されました。
12.1(5)XM	このコマンドは、Cisco 2600 シリーズ、Cisco 3600 シリーズ、および Cisco MC3810 に実装されました。
12.2(2)T	このコマンドは Cisco IOS リリース 12.2(2)T に統合され、Cisco 1750 ルータに実装されました。

使用上のガイドライン

検出するトーンのリズムの変化よりも大きい時間値を指定します。デフォルトの 0 では、設定されたリズムに一致するトーンだけが検出されます。

このコマンドは、音声クラス内の 1 つのパラメータの検出制限を作成します。検出制限は任意のvoice-portに適用できます。

例

次の例では、音声クラス 100 に対して 30 ミリ秒のリズム変化時間を指定します。


voice class dualtone 100
 cadence-variation 3

次の例では、音声クラス 70 で許容される最大リズム変化として 80 ミリ秒 (10 ミリ秒の時間間隔が 8 つ) を指定します。


voice class dualtone-detect-params 70
 cadence-variation 8

コマンド	description
cadence-max-off-time	トーンの検出の最大オフ期間を指定します。
cadence-min-on-time	トーンの検出の最小オン期間を指定します。
supervisoryanswerdualtone	voice-portでの応答監視を有効にします。
supervisorydualtone-detect-params	voiceclassdualtone-detect-params コマンドで定義された境界および検出許容パラメータをvoice-portに割り当てます。

call accounting-template

特定の場所にあるアカウンティングテンプレートを選択するには、グローバル設定モードまたはアプリケーション設定モードで callaccounting-template コマンドを使用します。特定のアカウンティングテンプレートを選択解除するには、このコマンドの no 形式を使用します。

call accounting-template acctTempName url

no call accounting-template acctTempName url

構文の説明


`acctTempName`	テンプレート名。
`URL`	テンプレートの場所。

コマンドデフォルト

デフォルトの動作や値はない

コマンドモード

グローバル設定（config）アプリケーション設定

コマンド履歴


リリース	変更
12.2(11)T	このコマンドが次のプラットフォームに導入されました: Cisco 3660、Cisco AS5300、Cisco AS5350、Cisco AS5400、Cisco AS5800、および Cisco AS5850。
12.3(14)T	このコマンドは、 callapplicationvoiceaccounting-template コマンドを置き換えるためにアプリケーション設定モードに追加されました。

使用上のガイドライン

通話詳細レコードの場合、テンプレート名には .cdr 拡張子が必要です。アカウンティングのニーズに基づいてコールレコードを選択し、選択したコールレコードを生成するために適切なベンダー固有属性 (VSA) を定義するアカウンティングテンプレートの場所を指定するには、グローバル設定モードで callaccounting-template コマンドを使用します。

acctTempName 引数は、RADIUS サーバーに送信する特定のアカウンティングテンプレートファイルを指します。このテンプレートファイルは、アカウンティングのニーズに基づいて通話記録を制御するために選択した特定の VSA のみを定義します。

例

以下の例は、特定の TFTP アドレスから選択されたアカウンティングテンプレート cdr1 を示しています。


call accounting-template temp-ivr tftp://kyer/sample/cdr/cdr1.cdr

コマンド	description
callapplicationvoiceaccounting-template	VoIP AAA 非ブロッキング API を使用して T.37 FAX アカウンティングを設定します。
showcallaccounting-templatevoice	特定の場所にあるアカウンティングテンプレートを選択します。

call accounting-template voice

特定の場所のアカウンティングテンプレートを選択するには、グローバル設定モードで callaccounting-templatevoice コマンドを使用します。特定のアカウンティングテンプレートを削除するには、このコマンドの no 形式を使用します。

call accounting-template voice acctTempName url

no call accounting-template voice acctTempName url

構文の説明


`acctTempName`	テンプレート名。
`URL`	テンプレートの場所。

コマンドデフォルト

デフォルトの動作や値はない

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.2(11)T	このコマンドが次のプラットフォームに導入されました: Cisco 3660、Cisco AS5300、Cisco AS5350、Cisco AS5400、Cisco AS5800、および Cisco AS5850。
12.3(14)T	アプリケーション設定モードでは、 callaccounting-templatevoice コマンドは、 callaccounting-template コマンドに置き換えられます。詳細については、 callaccounting-template コマンドを参照してください。

使用上のガイドライン

テンプレート名には .cdr 拡張子が必要です。

アカウンティングのニーズに基づいてコールレコードを選択し、選択したコールレコードを生成するために適切なベンダー固有属性 (VSA) を定義するアカウンティングテンプレートの場所を指定するには、グローバル設定モードで callaccounting-templatevoice コマンドを使用します。

acctTempName 引数は、RADIUS サーバーに送信する特定のアカウンティングテンプレートファイルを指します。このテンプレートファイルは、アカウンティングのニーズに基づいて通話記録を制御するために選択した特定の VSA のみを定義します。

例

以下の例は、特定の TFTP アドレスから選択されたアカウンティングテンプレート cdr1 を示しています。


call accounting-template voice temp-ivr tftp://kyer/sample/cdr/cdr1.cdr

コマンド	description
callaccounting-templatevoicereload	会計テンプレートを再読み込みします。
showcallaccounting-templatevoice	特定の場所にあるアカウンティングテンプレートを選択します。

call accounting-template voice reload

アカウンティングテンプレートをリロードするには、特権 EXEC モードで callaccounting-templatevoicereload コマンドを使用します。

call accounting-template voice reload acctTempName

構文の説明


reload	テンプレートが保存されているアドレス (たとえば、TFTP アドレス) からアカウンティングテンプレートをリロードします。
`acctTempName`	アカウンティングテンプレートの名前。

コマンドモード

特権 EXEC（#）

コマンド履歴


リリース	変更
12.2(11)T	このコマンドが次のプラットフォームに導入されました: Cisco 3660、Cisco AS5300、Cisco AS5350、Cisco AS5400、Cisco AS5800、および Cisco AS5850。

使用上のガイドライン

callaccounting-templatevoicereload コマンドを使用して、 callaccounting-templatevoice コマンドで定義された URL からテンプレートをリロードします。起動後、TFTP サーバーからテンプレートファイルの読み込みに失敗した場合、システムは 5 分間隔でファイルを自動的に再読み込みしようとします。

例

以下の例は、アカウンティングテンプレート cdr2 をリロードする方法を示しています。


call accounting-template voice reload cdr2

コマンド	description
callaccounting-templatevoice	特定の場所にあるアカウンティングテンプレートを選択します
gw-accountingaaa	URL で定義された場所にあるテンプレートファイルを定義して読み込みます。
showcallaccounting-templatevoice	会計テンプレートに含まれる VSA を表示します。

call-agent

メディアゲートウェイコントロールプロトコル（MGCP）プロファイルのコールエージェントを定義するには、MGCP プロファイル設定モードで call-agent コマンドを使用します。デフォルト値に戻すには、このコマンドの no 形式を使用します。

call-agent {DNS 名 | ip-address} [port] [service-type タイプ] [version プロトコルバージョン]

no call-agent

構文の説明


`DNS 名`	コールエージェントの完全修飾ドメイン名 (ホスト部分を含む)。たとえば、「ca123.example.net」などです。
`ip-address`	コールエージェントの IP アドレス。
`ポート`	(オプション) ゲートウェイがコールエージェントにメッセージを送信するユーザーデータグラムプロトコル (UDP) ポート番号。範囲は 1025 から 65535 です。 MGCP 1.0、ネットワークベースコールシグナリング (NCS) 1.0、および Trunking Gateway Control Protocol (TGCP) 1.0 の場合、デフォルトのコールエージェント UDP ポートは 2727 です。 MGCP 0.1 および Simple Gateway Control Protocol (SGCP) の場合、デフォルトのコールエージェント UDP ポートは 2427 です。
service-type `タイプ`	(オプション) `type` 引数のプロトコルサービスタイプの有効値は、mgcp 、ncs 、sgcp 、および tgcp です。デフォルトのサービスタイプは mgcp です。
version `プロトコルバージョン`	(オプション) プロトコルのバージョン番号。有効値は次のとおりです。サービスタイプ MGCP--0.1 、 1.0 サービスタイプ NCS--1.0 サービスタイプ SGCP--1.1 、 1.5 サービスタイプ TGCP--1.0 デフォルトのサービスタイプとバージョンは mgcp と 0.1 です。

コマンドデフォルト

MGCP 1.0、ネットワークベースコールシグナリング (NCS) 1.0、および Trunking Gateway Control Protocol (TGCP) 1.0 の場合、デフォルトのコールエージェント UDP ポートは 2727 です。 MGCP 0.1 および Simple Gateway Control Protocol (SGCP) の場合、デフォルトのコールエージェント UDP ポートは 2427 です。デフォルトのサービスタイプとバージョンは MGCP 0.1 です。

コマンドモード

MGCP プロファイル設定 (config-mgcp-profile)

コマンド履歴


リリース	変更
12.2(2)XA	このコマンドが導入されました。
12.2(4)T	このコマンドが Cisco IOS Release 12.2(4)T に統合されました。
12.2(11)T	このコマンドが Cisco AS5300 および Cisco AS5850 に実装されました。

使用上のガイドライン

このコマンドは、MGCP プロファイルの値を設定するときに使用されます。

MGCP プロファイルのコールエージェント設定（このコマンドを使用）とグローバルコールエージェント設定（ mgcpcall-agent コマンドを使用）は相互に排他的です。エンドポイントで最初に設定される設定は、同じエンドポイントでの他の設定をブロックします。

call-agent コマンドで IP アドレスではなくドメインネームシステム (DNS) 名でコールエージェントを識別すると、DNS 名に複数の IP アドレスを関連付けることができるため、コールエージェントの冗長性が実現されます。コールエージェントが DNS 名で識別され、ゲートウェイからのメッセージがコールエージェントに到達できない場合、 max1lookup および max2lookup コマンドを使用すると、DNS ルックアップテーブルから別の IP アドレスにあるバックアップコールエージェントを検索できます。

port 引数は、コールエージェントのポート番号 (ゲートウェイがコールエージェントにメッセージを送信する UDP ポート) を設定します。逆に、ゲートウェイポート番号 (ゲートウェイがコールエージェントからメッセージを受信する UDP ポート) は、 mgcp コマンドでポート番号を指定して設定します。

サービスタイプ mgcp は、mgcpsgcprestartnotify コマンドが有効になっている場合、ゲートウェイから送信される再起動進行中（RSIP）エラーメッセージをサポートします。サービスタイプは sgcp RSIP メッセージを無視します。

例

次の例では、「tgcp_trunk」という名前の MGCP プロファイルのコールエージェントを定義します。


Router(config)# mgcp profile tgcp_trunk
Router(config-mgcp-profile)# call-agent 10.13.93.3 2500 service-type tgcp version 1.0

コマンド	description
max1lookup	疑いしきい値に達したときに、MGCP コールエージェントアドレスの DNS ルックアップを有効にします。
max2lookup	切断しきい値に達したときに、MGCP コールエージェントアドレスの DNS ルックアップを有効にします。
mgcp	開始し、MGCP デーモンにリソースを割り当てます。
mgcpcall-agent	コールエージェント (メディアゲートウェイコントローラ) のアドレスを設定します。
mgcpprofile	1 つまたは複数のエンドポイントに関連付けられた名前付き MGCP プロファイルを作成および設定するか、またはデフォルトのプロファイルを設定するための MGCP プロファイルモードを開始します。

call application alternate

（注）

Cisco IOS リリース 12.3(14)T では、グローバルアプリケーション設定モードで、 callapplicationalternate コマンドが service コマンドに置き換えられました。詳細については、 service コマンドを参照してください。

ダイヤルピアに設定されているアプリケーションに障害が発生した場合に使用する代替アプリケーションを指定するには、グローバル設定モードで callapplicationalternate コマンドを使用します。デフォルトの動作に戻すには、このコマンドの no 形式を使用します。

call application alternate [アプリケーション名]

no call application alternate

構文の説明


`アプリケーション名`	(オプション) ダイヤルピア内のアプリケーションに障害が発生した場合に使用する特定の音声アプリケーションの名前。特定のアプリケーション名が入力されていない場合、ゲートウェイはデフォルトのアプリケーションを使用します。

コマンドデフォルト

ダイヤルピアのアプリケーションに障害が発生した場合、通話は拒否されます。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.2(11)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、グローバルアプリケーション設定モードでは service コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドが設定されていない場合、通話に一致するダイヤルピアが有効な音声アプリケーションを指定していないと、通話は拒否されます。

Cisco IOS リリース 12.2(11)T より前のリリースでは、ダイヤルピアにアプリケーションが設定されていない場合、または設定されたアプリケーションに障害が発生した場合、デフォルトのアプリケーション（DEFAULT）が自動的にトリガーされていました。 callapplicationalternate コマンドが設定されていない限り、デフォルトのアプリケーションは自動的に実行されなくなります。

DEFAULT というアプリケーションは、ダイヤルトーンを出力し、数字を収集し、ダイヤルした番号に電話をかけるシンプルなアプリケーションです。このアプリケーションは Cisco IOS ソフトウェアに含まれているため、ダウンロードしたり、 callapplicationvoice コマンドを使用して設定したりする必要はありません。

callapplicationalternate コマンドは、ダイヤルピアに設定されているアプリケーションに障害が発生した場合に、デフォルトの音声アプリケーションが実行されることを指定します。特定のアプリケーションの名前を入力すると、ダイヤルピアに設定されているアプリケーションに障害が発生した場合に、そのアプリケーションがトリガーされます。代替アプリケーションも失敗した場合、通話は拒否されます。

アプリケーション名を入力する場合は、まず callapplicationvoice コマンドを使用してそのアプリケーションをゲートウェイ上で設定する必要があります。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application alternate 
	Warning: This command has been deprecated. Please use the following:
		service

次の例では、DEFAULT アプリケーションを代替として設定します。


call application alternate

次の例では、アプリケーションセッションを代替として設定します。


call application alternate session

コマンド	description
application	ダイヤルピアで音声アプリケーションを有効にします。
callapplicationvoice	音声アプリケーションの名前を定義し、このアプリケーションにロードする Tcl または VoiceXML ドキュメントの場所を指定します。
service	ダイヤルピア上の特定のスタンドアロンアプリケーションをロードして設定します。
showcallapplicationvoice	音声アプリケーションに関する情報を表示します。

call application cache reload time

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定グローバルモードで、 callapplicationcachereloadtime コマンドが cachereloadtime コマンドに置き換えられました。詳細については、 cachereloadtime コマンドを参照してください。

ルータが定期的にキャッシュからメディアゲートウェイコントロールプロトコル (MGCP) スクリプトをリロードするように設定するには、グローバル設定モードで callapplicationcachereloadtime コマンドを使用します。値をデフォルトに設定するには、このコマンドの no 形式を使用します。

call application cache reload time bg-minutes

no call application cache reload time

構文の説明


`bg-minutes`	バックグラウンドプロセスが起動されるまでの分数を指定します。このバックグラウンドプロセスは、スクリプトが最後に使用されてからの経過時間と、スクリプトが最新かどうかを確認します。スクリプトが最後の「アンロード時間」内に使用されなかった場合は、スクリプトをアンロードして終了します。アンロード時間は設定できません。スクリプトが使用されている場合、バックグラウンドプロセスは URL からスクリプトを読み込みます。スクリプトを比較し、一致しない場合は、新しい呼び出しに新しいスクリプトの使用を開始します。

コマンドデフォルト

30 分

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.1(3)T	このコマンドが Cisco AS5300 に導入されました。
12.3(14)T	このコマンドは、アプリケーション設定グローバルモードでは cachereloadtime コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application cache reload 20
	Warning: This command has been deprecated. Please use the following:
		cache reload time

次の例は、バックグラウンドプロセスが起動されるまでの 30 分を指定するように設定された callapplicationcachereloadtime コマンドを示しています。


call application cache reload time 30

コマンド	description
cachereloadtime	定期的にキャッシュからスクリプトをリロードするようにルータを設定します。
callapplicationvoiceload	MGCP スクリプトパッケージ経由でロードされたアプリケーションのリロードを許可します。
showcallapplicationvoice	ロードされているすべての Tcl または MGCP スクリプトを表示します。

call application dump event-log

アプリケーションインスタンスのイベントログバッファを外部ファイルにフラッシュするには、特権 EXEC モードで callapplicationdumpevent-log コマンドを使用します。

call application dump event-log

構文の説明

このコマンドには引数もキーワードもありません。

コマンドモード

特権 EXEC（#）

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。

使用上のガイドライン

このコマンドは、グローバル設定モードで callapplicationevent-logdumpftp コマンドを使用して場所が定義されている外部ファイルに、イベントログバッファを直ちに書き込みます。

（注）

callapplicationdumpevent-log コマンドと callapplicationevent-logdumpftp コマンドは 2 つの異なるコマンドです。

例

次の例では、アプリケーションイベントログバッファーをフラッシュします。


Router# call application dump event-log

コマンド	description
callapplicationevent-log	音声アプリケーションインスタンスのイベントログを有効にします。
callapplicationevent-logdumpftp	ゲートウェイがアプリケーションイベントログバッファの内容を外部ファイルに書き込めるようにします。
callapplicationevent-logmax-buffer-size	各アプリケーションインスタンスのイベントログバッファの最大サイズを設定します。
showcallapplicationsession-level	音声アプリケーションインスタンスのイベントログと統計を表示します。

call application event-log

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationevent-log コマンドが event-log コマンドに置き換えられました。詳細については、 event-log コマンドを参照してください。

すべての音声アプリケーションインスタンスのイベントログを有効にするには、グローバル設定モードで callapplicationevent-log コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application event-log

no call application event-log

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

音声アプリケーションのイベントログが無効になっています。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは event-log コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、すべての音声アプリケーションインスタンスのイベントログをグローバルに有効にします。特定のアプリケーションのイベントログを有効または無効にするには、 callapplicationvoiceevent-log コマンドを使用します。

（注）

イベントログが本番トラフィックのシステムリソースに悪影響を及ぼさないようにするために、ゲートウェイはスロットリングメカニズムを使用します。プロセッサメモリの空きが 20% を下回ると、ゲートウェイは自動的にすべてのイベントログを無効にします。メモリの空きが 30% を超えるとイベントログが再開されます。スロットリングが行われている間は、イベントログが有効になっていても、ゲートウェイは新しいイベントログをキャプチャしません。空きメモリを監視し、障害の切り分けに必要な場合にのみイベントログを有効にしてください。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application event-log
        Warning: This command has been deprecated. Please use the following:
             event-log

次の例では、すべてのアプリケーションインスタンスのイベントログを有効にします。


call application event-log

call application event-log dump ftp

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationevent-logdumpftp コマンドが event-logdumpftp コマンドに置き換えられました。詳細については、 event-logdumpftp コマンドを参照してください。

ゲートウェイがアプリケーションイベントログバッファの内容を外部ファイルに書き込めるようにするには、グローバル設定モードで callapplicationevent-logdumpftp コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application event-log dump ftp server [:ポート]/ファイル username ユーザー名（username） password [ [暗号化タイプ] ]パスワード

no call application event-log dump ftp

構文の説明


`サーバー`	ファイルが保存されている FTP サーバーの名前または IP アドレス。
: `ポート`	(オプション) サーバー上の特定のポート番号。
/ `ファイル`	ファイルの名前とパス。
`ユーザー名`	ファイルにアクセスするにはユーザー名が必要です。
`暗号化タイプ`	(オプション) パスワードの暗号化に使用される Cisco 独自のアルゴリズム。値は 0 または 7 です。暗号化を無効にするには 0 を入力し、暗号化を有効にするには 7 を入力します。7 を指定する場合は、暗号化されたパスワード（Cisco ルータによってすでに暗号化されているパスワード）を入力する必要があります。
`パスワード`	ファイルにアクセスするにはパスワードが必要です。

コマンドデフォルト

デフォルトの動作や値はない

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは event-logdumpftp コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドにより、アクティブなアプリケーションインスタンスが終了した後、またはイベントログバッファがいっぱいになったときに、ゲートウェイがイベントログバッファを指定されたファイルに自動的に書き込むことができるようになります。デフォルトのバッファサイズは 4 KB です。バッファのサイズを変更するには、 callapplicationevent-logmax-buffer-size コマンドを使用します。イベントログバッファを手動でフラッシュするには、特権 EXEC モードで callapplicationdumpevent-log コマンドを使用します。

（注）

callapplicationdumpevent-log コマンドと callapplicationevent-logdumpftp コマンドは 2 つの異なるコマンドです。

ゲートウェイがイベントログを FTP に書き込めるようにすると、次のような場合など、一部のシナリオでゲートウェイのメモリリソースに悪影響を与える可能性があります。

ゲートウェイは大量のプロセッサリソースを消費しており、FTP にはログに記録されたバッファを FTP サーバーにフラッシュするのに十分なプロセッサリソースがありません。
指定された FTP サーバーは、FTP 転送を迅速に実行するのに十分な性能がありません。
ゲートウェイと FTP サーバー間のリンクの帯域幅が十分ではありません
ゲートウェイは大量の短時間の通話や失敗した通話を受信しています

FTP ダンプは必要な場合にのみ有効化してください。システムパフォーマンスに悪影響を与える可能性がある場合には有効化しないでください。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application event-log dump ftp
	Warning: This command has been deprecated. Please use the following:
		event-log dump ftp

次の例では、ゲートウェイが ftp-server というサーバー上の app_elogs.log という外部ファイルにアプリケーションイベントログを書き込むことができるようにします。


call application event-log dump ftp ftp-server/:elogs/app-elogs.log username myname password 0 mypass

次の例では、アプリケーションイベントログが、IP アドレス 10.10.10.101 を持つサーバー上の app_elogs.log という名前の外部ファイルに書き込まれるように指定します。


call application event-log dump ftp 10.10.10.101/:elogs/app-elogs.log username myname password 0 mypass

call application event-log error-only

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationevent-logerror-only コマンドが event-logerror-only コマンドに置き換えられました。詳細については、 event-logerror-only コマンドを参照してください。

アプリケーションインスタンスのエラーイベントのみにイベントログの記録を制限するには、グローバル設定モードで callapplicationevent-logerror-only コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application event-log error-only

no call application event-log error-only

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

すべてのアプリケーションイベントがログに記録されます。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは event-logerror-only コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、新しいイベントログをエラーイベントのみに制限します。ログ記録を有効にするわけではありません。このコマンドは、すべての音声アプリケーションのイベントログを有効にする callapplicationevent-log コマンド、または特定のアプリケーションのイベントログを有効にする callapplicationvoiceevent-log コマンドのいずれかと一緒に使用する必要があります。このコマンドが発行される前に記録されたイベントは影響を受けません。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application event-log error-only
	Warning: This command has been deprecated. Please use the following:
		event-log error-only

次の例では、エラーイベントのみのイベントログを有効にします。


call application event-log
call application event-log error-only

call application event-log max-buffer-size

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationevent-logmax-buffer-size コマンドが event-logmax-buffer-size コマンドに置き換えられました。詳細については、 event-logmax-buffer-size コマンドを参照してください。

各アプリケーションインスタンスのイベントログバッファの最大サイズを設定するには、グローバル設定モードで callapplicationevent-logmax-buffer-size コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application event-log max-buffer-size キロバイト

no call application event-log max-buffer-size

構文の説明


`キロバイト`	最大バッファサイズ (キロバイト)。値の範囲は 1 ～ 50 です。デフォルトは 4 です。

コマンドデフォルト

4 キロバイト

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは event-logmax-buffer-size コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

イベントログバッファがこのコマンドで設定された制限に達すると、ゲートウェイは同じサイズの 2 番目のバッファを割り当てます。 showcallapplicationsession-level コマンドを使用すると、両方のバッファの内容が表示されます。最初のイベントログバッファがいっぱいになると、 callapplicationevent-logdumpftp コマンドが使用されている場合、ゲートウェイはその内容を自動的に外部の FTP の場所に付加します。

イベントログには最大 2 つのバッファーが割り当てられます。両方のバッファがいっぱいになった場合、最初のバッファは削除され、別のバッファが新しいイベント用に割り当てられます (バッファがラップアラウンドします)。 callapplicationevent-logdumpftp コマンドが設定されていて、最初のバッファがダンプされる前に 2 番目のバッファがいっぱいになると、イベントメッセージはドロップされ、バッファに記録されません。

最大バッファサイズを、一般的なアプリケーションセッションに必要なサイズよりも大きく設定しないでください。アクティブセッションが終了すると、バッファーによって使用されるメモリの量が履歴テーブルに割り当てられ、 callapplicationhistorysessionretain-timer コマンドで設定された時間だけ維持されます。また、致命的なエラーのほとんどはイベントログの最後に記録されることにも留意してください。

メモリリソースを節約するには、 callapplicationevent-logdumpftp コマンドを使用してイベントログバッファーを FTP に書き込みます。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application event-log max-buffer-size
	Warning: This command has been deprecated. Please use the following:
		event-log max-buffer-size

次の例では、アプリケーションイベントログバッファーを 8 キロバイトに設定します。


call application event-log
call application event-log max-buffer-size 8

call application global

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モードでは、 callapplicationglobal コマンドが global コマンドに置き換えられました。詳細については、 global コマンドを参照してください。

着信ダイヤルピアに明示的なアプリケーションが設定されていない着信コールに使用するアプリケーションを設定するには、グローバル設定モードで callapplicationglobal コマンドを使用します。アプリケーションを削除するには、このコマンドのno 形式を使用します。

call application global アプリケーション名

no call application global アプリケーション名

構文の説明


`アプリケーション名`	アプリケーションの名前を定義する文字列。

コマンドデフォルト

デフォルトのアプリケーションは、 default すべてのダイヤルピア用です。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.2(15)ZJ	このコマンドが導入されました。
12.3(4)T	このコマンドが Cisco IOS Release 12.3(4)T に統合されました。
12.3(14)T	このコマンドは、アプリケーション設定モードでは global コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

ダイヤルピアで定義されたアプリケーションは、 callapplicationglobal コマンドで設定されたグローバルアプリケーションよりも常に優先されます。このコマンドで設定されたアプリケーションは、ダイヤルピアにアプリケーションが設定されていない場合にのみ実行されます。

このコマンドで設定するアプリケーションは、デフォルトのセッションアプリケーション以外のアプリケーションでもかまいませんが、このコマンドを使用する前に、Cisco IOS ソフトウェアに含まれているか、 callapplicationvoice コマンドを使用してゲートウェイにロードされている必要があります。アプリケーションが Cisco IOS ソフトウェアに存在しないか、ゲートウェイにロードされていない場合、このコマンドは効果がありません。

（注）

Cisco IOS Release 12.3(4)T 以降のリリースで、アプリケーション名のデフォルトは、Open Settlement Protocol（OSP）、通話転送、および着信通知をサポートするアプリケーションを指します。 Cisco IOS Release 12.2(13)T 以前のリリースのデフォルトセッションアプリケーションは default.old.c に名前が変更されましたが、 application コマンドを使用して特定のダイヤルピアに対して設定することも、 callapplicationglobal コマンドを使用してすべての着信ダイヤルピアに対してグローバルに設定することもできます。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application global
	Warning: This command has been deprecated. Please use the following:
		global

次の例では、clid_authen_collect アプリケーションは、特定のアプリケーションが設定されていないすべての着信ダイヤルピアのグローバルアプリケーションとして設定されます。


call application global clid_authen_collect

call application history session event-log save-exception-only

（注）

Cisco IOS Release 12.3(14)T から、アプリケーション設定モニターモードで callapplicationhistorysessionevent-logsave-exception-only コマンドは historysessionevent-logsave-exception-only コマンドに置き換えられました。詳細については、 historysessionevent-logsave-exception-only コマンドを参照してください。

少なくとも 1 つのエラーがあるアプリケーションセッションのイベントログのみを履歴に保存するには、グローバル設定モードで callapplicationhistorysessionevent-logsave-exception-only コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application history session event-log save-exception-only

no call application history session event-log save-exception-only

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

セッションのすべてのイベントログは履歴に保存されます。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは historysessionevent-logsave-exception-only コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

インスタンスが終了すると、アプリケーションイベントログはアクティブから履歴に移動します。このコマンドを使用すると、音声ゲートウェイは、1 つ以上のエラーが発生したインスタンスのイベントログのみを保存します。エラーが含まれていない通常のインスタンスのイベントログは履歴に保存されません。

（注）

このコマンドは、 callapplicationdumpevent-log コマンドを使用して FTP サーバーに保存されたレコードには影響しません。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application history session event-log save-exception-only
	Warning: This command has been deprecated. Please use the following:
		history session event-log save-exception-only

次の例では、インスタンスにエラーがあった場合にのみ、イベントログを履歴に保存します。


call application history session event-log save-exception-only

call application history session max-records

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationhistorysessionmax-records コマンドが historysessionmax-records コマンドに置き換えられました。詳細については、 historysessionmax-records コマンドを参照してください。

履歴に保存されるアプリケーションインスタンスレコードの最大数を設定するには、グローバル設定モードで callapplicationhistorysessionmax-records コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application history session max-records number

no call application history session max-records

構文の説明


`number`	履歴に保存するレコードの最大数。値の範囲は 0 ～ 2000 です。デフォルトは 360 です。

コマンドデフォルト

360

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは historysessionmax-records コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、 showcallapplicationhistorysession-level コマンドを使用するときに表示されるレコードの数に影響します。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application history session max-records
	Warning: This command has been deprecated. Please use the following:
		history session max-records

次の例では、最大レコード制限を 500 に設定します。


call application history session max-records 500

call application history session retain-timer

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationhistorysessionretain-timer コマンドが historysessionretain-timer コマンドに置き換えられました。詳細については、 historysessionretain-timer コマンドを参照してください。

アプリケーションインスタンスレコードが履歴に保存される最大分数を設定するには、グローバル設定モードで callapplicationhistorysessionretain-timer コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application history session retain-timer 分

いいえ call application history session retain-timer

構文の説明


`分`	履歴レコードが保存される最大時間（分）。範囲は 0 ～ 4294,967,295 です。デフォルトは 15 です。

コマンドデフォルト

15

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは historysessionretain-timer コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、 showcallapplicationhistorysession-level コマンドを使用するときに表示されるレコードの数に影響します。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application history session retain-timer
	Warning: This command has been deprecated. Please use the following:
		history session retain-timer

次の例では、履歴レコードを保存する最大時間を 1 時間に設定します。


call application history session retain-timer 60

call application interface dump event-log

アプリケーションインターフェイスのイベントログバッファを外部ファイルにフラッシュするには、特権 EXEC モードで callapplicationinterfacedumpevent-log コマンドを使用します。

call application interface dump event-log

構文の説明

このコマンドには引数もキーワードもありません。

コマンドモード

特権 EXEC（#）

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。

使用上のガイドライン

このコマンドは、グローバル設定モードの callapplicationinterfaceevent-logdumpftp コマンドで定義された場所にある外部ファイルに、イベントログバッファを直ちに書き込みます。

（注）

callapplicationinterfacedumpevent-log コマンドと callapplicationinterfaceevent-logdumpftp コマンドは 2 つの異なるコマンドです。

例

次の例では、イベントログバッファを int_elogs という名前の外部ファイルに書き込みます。


Router(config)# call application interface event-log dump ftp ftp-server/int_elogs.log username myname password 0 mypass
Router(config)# exit
Router# call application interface dump event-log

call application interface event-log

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationinterfaceevent-log コマンドが interfaceevent-log コマンドに置き換えられました。詳細については、 interfaceevent-log コマンドを参照してください。

音声アプリケーションにサービスを提供するインターフェイスのイベントログを有効にするには、グローバル設定モードで callapplicationinterfaceevent-log コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface event-log [ {aaa | asr | flash | http | ram | rtsp | smtp | tftp | tts} [server server] [disable]]

no call application interface event-log [ {aaa | asr | flash | http | ram | rtsp | smtp | tftp | tts} [server server] [disable]]

構文の説明


aaa	認証、許可、アカウンティング (AAA) インターフェイスタイプ。
asr	自動音声認識 (ASR) インターフェースタイプ。
flash	Cisco ゲートウェイのフラッシュメモリ。
http	ハイパーテキスト転送プロトコル (HTTP) インターフェイスタイプ。
ram	Cisco ゲートウェイのメモリ。
rtsp	リアルタイムストリーミングプロトコル (RTSP) インターフェイスタイプ。
smtp	Simple Mail Transfer Protocol（SMTP）インターフェイスタイプ。
tftp	簡易ファイル転送プロトコル (TFTP) インターフェイスタイプ。
tts	テキスト読み上げ (TTS) インターフェースタイプ。
server `サーバー`	(オプション) サーバー名または IP アドレス。
disable	(オプション) 指定されたインターフェイスタイプまたはサーバーのイベントログを無効にします。

コマンドデフォルト

アプリケーションインターフェイスのイベントログが無効になっています。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは interfaceevent-log コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、特定のインターフェイスタイプまたはサーバーを選択しない限り、すべてのインターフェイスタイプおよびサーバーに対してイベントログをグローバルに有効にします。インターフェイスタイプを指定すると、特定のインターフェイスタイプに対するグローバルコマンドよりも優先されます。個々のサーバーの指定は、インターフェースタイプよりも優先されます。

（注）

イベントログが本番トラフィックのシステムリソースに悪影響を及ぼさないようにするために、ゲートウェイはスロットリングメカニズムを使用します。プロセッサメモリの空きが 20% を下回ると、ゲートウェイは自動的にすべてのイベントログを無効にします。メモリの空きが 30% を超えるとイベントログが再開されます。スロットリングが行われている間は、イベントログが有効になっていても、ゲートウェイは新しいイベントログをキャプチャしません。空きメモリを監視し、障害の切り分けに必要な場合にのみイベントログを有効にしてください。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface event-log
	Warning: This command has been deprecated. Please use the following:
		interface event-log

次の例では、すべてのインターフェースのイベントログを有効にします。


call application interface event-log

次の例では、HTTP インターフェースに対してのみイベントログを有効にします。


call application interface event-log http

次の例では、HTTP を除くすべてのインターフェースのイベントログを有効にします。


call application interface event-log
call application interface event-log http disable

次の例では、IP アドレスが 10.10.1.1 のサーバーを除くすべての HTTP サーバーのイベントログを有効にします。


call application interface event-log http
call application interface event-log http server http://10.10.1.1 disable

call application interface event-log dump ftp

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationinterfaceevent-logdumpftp コマンドが interfaceevent-logdumpftp コマンドに置き換えられました。詳細については、 interfaceevent-logdumpftp コマンドを参照してください。

ゲートウェイがインターフェイスイベントログバッファの内容を外部ファイルに書き込めるようにするには、グローバル設定モードで callapplicationinterfaceevent-logdumpftp コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface event-log dump ftp server [:ポート]/ファイル username ユーザー名（username） password [ [暗号化タイプ] ]パスワード

no call application interface event-log dump ftp

構文の説明


`サーバー`	ファイルが保存されている FTP サーバーの名前または IP アドレス。
: `ポート`	(オプション) サーバー上の特定のポート番号。
/ `ファイル`	ファイルの名前とパス。
username `ユーザー名`	ファイルにアクセスするにはユーザー名が必要です。
`暗号化タイプ`	(オプション) パスワードの暗号化に使用される Cisco 独自のアルゴリズム。値は 0 または 7 です。暗号化を無効にするには 0 を入力し、暗号化を有効にするには 7 を入力します。7 を指定する場合は、暗号化されたパスワード（Cisco ルータによってすでに暗号化されているパスワード）を入力する必要があります。
password `パスワード`	ファイルにアクセスするにはパスワードが必要です。

コマンドデフォルト

インターフェイスイベントログバッファーは外部ファイルに書き込まれません。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニターモードにおいて interfaceevent-logdumpftp コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドにより、バッファがいっぱいになったときにゲートウェイがインターフェイスイベントログバッファを指定されたファイルに自動的に書き込むことができるようになります。デフォルトのバッファサイズは 4 KB です。バッファのサイズを変更するには、 callapplicationinterfaceevent-logmax-buffer-size コマンドを使用します。イベントログバッファを手動でフラッシュするには、特権 EXEC モードで callapplicationinterfacedumpevent-log コマンドを使用します。

（注）

callapplicationinterfacedumpevent-log コマンドと callapplicationinterfaceevent-logdumpftp コマンドは 2 つの異なるコマンドです。

ゲートウェイがイベントログを FTP に書き込めるようにすると、次のようなシナリオでゲートウェイのメモリリソースに悪影響が及ぶ可能性があります。
- ゲートウェイは大量のプロセッサリソースを消費しており、FTP にはログに記録されたバッファを FTP サーバーにフラッシュするのに十分なプロセッサリソースがありません。
- 指定された FTP サーバーは、FTP 転送を迅速に実行するのに十分な性能がありません。
- ゲートウェイと FTP サーバー間のリンクの帯域幅が十分ではありません
- ゲートウェイは大量の短時間の通話や失敗した通話を受信しています

FTP ダンプは必要な場合にのみ有効化してください。システムパフォーマンスに悪影響を与える可能性がある場合には有効化しないでください。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface event-log dump ftp 
	Warning: This command has been deprecated. Please use the following:
		interface event-log dump ftp

次の例では、インターフェイスイベントログが ftp-server というサーバー上の int_elogs.log という外部ファイルに書き込まれるように指定します。


call application interface event-log dump ftp ftp-server/elogs/int_elogs.log username myname password 0 mypass

次の例では、アプリケーションイベントログが、IP アドレス 10.10.10.101 を持つサーバー上の int_elogs.log という名前の外部ファイルに書き込まれるように指定します。


call application interface event-log dump ftp 10.10.10.101/elogs/int_elogs.log username myname password 0 mypass

call application interface event-log error-only

（注）

Cisco IOS リリース 12.3(14)T では、 callapplicationinterfaceevent-logerror-only コマンドはinterfaceevent-logerroronly commandin アプリケーション設定モニタモードに置き換えられました。詳細については、 interfaceevent-logerroronly コマンドを参照してください。

イベントログをアプリケーションインターフェイスのエラーイベントのみに制限するには、グローバル設定モードで callapplicationinterfaceevent-logerror-only コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface event-log error-only

no call application interface event-log error-only

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

すべてのイベントが記録されます。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは interfaceevent-logerroronly コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、ログに記録されるイベントの重大度レベルを制限しますが、ログ記録を有効にするものではありません。このコマンドは、すべてのアプリケーションインターフェイスのイベントログを有効にする callapplicationinterfaceevent-log コマンドと一緒に使用する必要があります。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface event-log error-only
        Warning: This command has been deprecated. Please use the following:
             interface event-log error only

次の例では、エラーイベントのみのイベントログを有効にします。


call application interface event-log error-only

call application interface event-log max-buffer-size

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、callapplicationinterfaceevent-logmax-buffer-size コマンドが interfaceevent-logmax-buffer-size コマンドに置き換えられました。詳細については、 interfaceevent-logmax-buffer-size コマンドを参照してください。

各アプリケーションインターフェイスのイベントログバッファの最大サイズを設定するには、グローバル設定モードで callapplicationinterfaceevent-logmax-buffer-size コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface event-log max-buffer-size キロバイト

no call application interface event-log max-buffer-size

構文の説明


`キロバイト`	最大バッファサイズ (キロバイト)。値の範囲は 1 ～ 10 です。デフォルトは 4 です。

コマンドデフォルト

4 キロバイト

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは interfaceevent-logmax-buffer-size コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

イベントログバッファがこのコマンドで設定された制限に達すると、ゲートウェイは同じサイズの 2 番目のバッファを割り当てます。 showcallapplicationinterface コマンドを使用すると、両方のバッファの内容が表示されます。最初のイベントログバッファがいっぱいになると、 callapplicationinterfaceevent-logdumpftp コマンドが使用されている場合、ゲートウェイはその内容を自動的に外部の FTP 場所に追加します。

イベントログには最大 2 つのバッファーが割り当てられます。両方のバッファがいっぱいになった場合、最初のバッファは削除され、別のバッファが新しいイベント用に割り当てられます (バッファがラップアラウンドします)。 callapplicationinterfaceevent-logdumpftp コマンドが設定されていて、最初のバッファがダンプされる前に 2 番目のバッファがいっぱいになると、イベントメッセージはドロップされ、バッファに記録されません。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface event-log max-buffer-size
	Warning: This command has been deprecated. Please use the following:
			interface event-log max-buffer-size

次の例では、最大バッファサイズを 8 キロバイトに設定しています:


call application interface event-log max-buffer-size 8

call application interface max-server-records

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationinterfacemax-server-records コマンドがinterfacemax-server-records コマンドに置き換えられました。詳細については、 interfacemax-server-records コマンドを参照してください。

保存されるアプリケーションインターフェイスレコードの最大数を設定するには、グローバル設定モードで callapplicationinterfacemax-server-records コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface max-server-records number

no call application interface max-server-records

構文の説明


`number`	保存するレコードの最大数。値の範囲は 1 ～ 100 です。デフォルトは 10 です。

コマンドデフォルト

10

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは interfacemax-server-records コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

最近アクセスしたサーバーからの指定された数のレコードのみが保持されます。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface max-server-records
        Warning: This command has been deprecated. Please use the following:
             interface max-server-records

次の例では、保存されるレコードの最大数を 50 に設定します。


call application interface max-server-records 50

call application interface stats

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationinterfacestats コマンドが interfacestats コマンドに置き換えられました。詳細については、 interfacestats コマンドを参照してください。

アプリケーションインターフェイスの統計収集を有効にするには、グローバル設定モードで callapplicationinterfacestats コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application interface stats

no call application interface stats

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

統計収集は無効です。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは interfacestats コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドによって有効になったインターフェース統計を表示するには、 showcallapplicationinterface コマンドを使用します。インターフェイスカウンタをゼロにリセットするには、 clearcallapplicationinterface コマンドを使用します。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application interface stats
 
	Warning: This command has been deprecated. Please use the following:
		interface stats

次の例では、アプリケーションインターフェイスの統計収集を有効にします。


call application interface stats

call application session start (global)

（注）

Cisco IOS Release 12.3(14)T から、アプリケーション設定モードで callapplicationsessionstart （グローバル）コマンドは sessionstart コマンドに置き換えられました。詳細については、 sessionstart コマンドを参照してください。

Tcl IVR 2.0 アプリケーションの新しいインスタンス (セッション) を開始するには、グローバル設定モードで callapplicationsessionstart コマンドを使用します。セッションを停止して設定を削除するには、このコマンドの no 形式を使用します。

call application session start instance-name アプリケーション名

no call application session start instance-name

構文の説明


`instance-name`	このアプリケーションインスタンスを一意に識別する英数字のラベル。
`アプリケーション名`	Tcl アプリケーションの名前。これは、 callapplicationvoice コマンドで割り当てられたアプリケーションの名前です。

コマンドデフォルト

このコマンドにデフォルトの動作や値はありません。

コマンドモード

グローバル設定 (config)

コマンド履歴


リリース	変更
12.3(4)T	このコマンドが導入されました。
12.3(14)T	アプリケーション設定モードでは、 callapplicationsessionstart (グローバル設定) コマンドが sessionstart コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

このコマンドは、Tcl IVR 2.0 アプリケーションの新しいセッションまたはインスタンスを開始します。 Cisco IOS ソフトウェアはアクティブなコールレッグがないと VoiceXML アプリケーションを開始できないため、VoiceXML アプリケーションのセッションを開始できません。

callapplicationvoice コマンドを使用して Tcl アプリケーションがゲートウェイにロードされた後にのみ、アプリケーションインスタンスを開始できます。

このコマンドを使用すると、ゲートウェイが再起動するとセッションが再起動します。

nocallapplicationsessionstart コマンドは Tcl セッションを停止し、ゲートウェイから設定を削除します。 callapplicationsessionstop コマンドを使用すると、設定を削除せずにアプリケーションセッションを停止できます。

VoiceXML セッションは Cisco IOS コマンドでは開始できないため、 nocallapplicationsessionstart コマンドで VoiceXML セッションを停止することはできません。

アプリケーションセッションの実行が停止した場合、ゲートウェイが再起動しない限り、アプリケーションセッションは再開されません。 Tcl スクリプトは、たとえば「call close」コマンドを実行して意図的に実行を停止したり、スクリプトエラーのために失敗したりする場合があります。

異なるインスタンス名を使用して、同じアプリケーションの複数のインスタンスを起動できます。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application session start
	Warning: This command has been deprecated. Please use the following:
		session start

次の例では、demo という名前のアプリケーションに対して my_instance という名前のセッションを開始します。


call application session start my_instance demo

次の例では、demo という名前のアプリケーションの別のセッションを開始します。


call application session start my_instance2 demo

call application session start (privileged EXEC)

Tcl IVR 2.0 アプリケーションの新しいインスタンス (セッション) を開始するには、特権 EXEC モードで callapplicationsessionstart コマンドを使用します。

call application session start instance-name [アプリケーション名]

構文の説明

instance-name

このアプリケーションインスタンスを一意に識別する英数字のラベル。

アプリケーション名

(オプション) Tcl アプリケーションの名前。これは、 callapplicationvoice コマンドで割り当てられたアプリケーションの名前です。

（注）

アプリケーションインスタンスが以前に開始および停止されている場合、この引数はオプションです。

コマンドデフォルト

None

コマンドモード

特権 EXEC（#）

コマンド履歴


リリース	変更
12.3(4)T	このコマンドが導入されました。

使用上のガイドライン

このコマンドは、Tcl IVR 2.0 アプリケーションの新しいセッションまたはインスタンスを開始します。 Cisco IOS ソフトウェアはアクティブなコールレッグがないと VoiceXML アプリケーションを開始できないため、VoiceXML アプリケーションのセッションを開始できません。

callapplicationvoice コマンドを使用して Tcl アプリケーションがゲートウェイにロードされた後にのみ、アプリケーションインスタンスを開始できます。

このコマンドを使用すると、ゲートウェイが再起動してもセッションは再開されません。ゲートウェイが再起動した場合にセッションを自動的に再開するには、グローバル設定モードで callapplicationsessionstart コマンドを使用します。

アプリケーションセッションの実行を開始したら停止するには、callapplicationsessionstop コマンドを使用します。

アプリケーションセッションの実行が停止した場合、ゲートウェイが再起動し、グローバル設定モードで callapplicationsessionstart コマンドが使用されない限り、アプリケーションセッションは再開されません。 Tcl スクリプトは、たとえば「call close」コマンドを実行して意図的に実行を停止したり、スクリプトエラーが原因で失敗したりする場合があります。

異なるインスタンス名を使用して、同じアプリケーションの複数のインスタンスを起動できます。

例

次の例では、my_instance というアプリケーションセッションを再起動します。


call application session start my_instance

call application session stop

実行中の音声アプリケーションセッションを停止するには、特権 EXEC モードで callapplicationsessionstop コマンドを使用します。

call application session stop {callid call-id | handle ハンドル | id セッション ID | name instance-name}

構文の説明


callid `コール ID`	Tcl スクリプトが puts コマンドを使用する場合、debugvoipivrscript コマンドからの出力に表示されるコールレッグ ID。
handle `ハンドル`	Tcl mod_handle 情報タグからのセッションのハンドル。
id `セッション ID`	showcallapplicationsessions コマンドで表示できるセッション ID。
name `インスタンス名`	callapplicationsessionstart コマンドで設定されたインスタンス名。

コマンドデフォルト

None

コマンドモード

特権 EXEC（#）

コマンド履歴


リリース	変更
12.3(4)T	このコマンドが導入されました。

使用上のガイドライン

このコマンドは、コール ID、ハンドル、セッション ID、インスタンス名のいずれかの方法で識別される Tcl IVR 2.0 または VoiceXML アプリケーションセッションを停止します。現在実行中のアプリケーションのリストを表示するには、 showcallapplicationsessions コマンドを使用します。

このコマンドで停止された Tcl セッションは、セッション終了イベントを受け取ります。セッションでは、すべてのコールレッグを閉じて停止することが求められます。 10 秒のタイマーが経過してもセッションが終了しない場合は、セッションは強制的に停止され、制御するすべてのコールレッグが切断されます。

このコマンドを使用して VoiceXML セッションを停止すると、ドキュメントの解釈がただちに停止され、コールレッグが切断されます。 VoiceXML イベントはスローされません。

グローバル設定モードで callapplicationsessionstart コマンドを使用して開始するように設定されている Tcl セッションを停止する場合は、セッションを再開する前に、nocallapplicationsessionstart コマンドを使用してセッションを削除する必要があります。

停止されたセッションのリストを表示するには、 showcallapplicationsessions コマンドを使用します。グローバル設定モードで callapplicationsessionstart コマンドを使用して開始するように設定されている停止されたセッションのみが表示されます。特権 EXEC モードでコマンドを使用してセッションが開始された場合、そのセッションはシステムによって追跡されず、コマンドの出力に停止として表示されません。 callapplicationsessionstart showcallapplicationsessions

例

次の例では、my_instance というアプリケーションセッションを停止します。


call application session stop name my_instance

call application stats

（注）

Cisco IOS リリース 12.3(14)T では、アプリケーション設定モニタモードで、 callapplicationstats コマンドが stats コマンドに置き換えられました。詳細については、 stats コマンドを参照してください。

音声アプリケーションの統計収集を有効にするには、グローバル設定モードで callapplicationstats コマンドを使用します。デフォルトにリセットするには、このコマンドの no 形式を使用します。

call application stats

no call application stats

構文の説明

このコマンドには引数もキーワードもありません。

コマンドデフォルト

統計収集は無効です。

コマンドモード

グローバル設定 (#)

コマンド履歴


リリース	変更
12.3(8)T	このコマンドが導入されました。
12.3(14)T	このコマンドは、アプリケーション設定モニタモードでは stats コマンドに置き換えられました。
12.4(24)T	このコマンドは変更されました。新しい CLI への自動変換は、明示的なエラーメッセージに置き換えられます。

使用上のガイドライン

アプリケーションの統計情報を表示するには、 showcallapplicationsession-level 、 showcallapplicationapp-level 、または showcallapplicationgateway-level コマンドを使用します。履歴内のアプリケーションカウンターをゼロにリセットするには、 clearcallapplicationstats コマンドを使用します。

例

Cisco IOS リリース 12.4(24)T から、ユーザーに代替コマンドオプションを指示する次の警告メッセージが表示されます。


Router(config)# call application stats 
        Warning: This command has been deprecated. Please use the following:
             stats

次の例では、音声アプリケーションの統計収集を有効にします。


call application stats

コマンド	description
callapplicationevent-logerror-only	イベントログをアプリケーションインスタンスのエラーイベントのみに制限します。
callapplicationevent-logmax-buffer-size	各アプリケーションインスタンスのイベントログバッファの最大サイズを設定します。
callapplicationinterfaceevent-log	音声アプリケーションで使用される外部インターフェースのイベントログを有効にします。
callapplicationstats	音声アプリケーションの統計収集を有効にします。
callapplicationvoiceevent-log	特定の音声アプリケーションのイベントログを有効にします。
calllegevent-log	音声、ファックス、モデムのコールレッグのイベントログを有効にします。
event-log	アプリケーションのイベントログを有効にします。
monitorcallapplicationevent-log	アクティブなアプリケーションインスタンスのイベントログをリアルタイムで表示します。
showcallapplicationsession-level	音声アプリケーションインスタンスのイベントログと統計を表示します。

コマンド	description
callapplicationdumpevent-log	アプリケーションインスタンスのイベントログバッファーを外部ファイルにフラッシュします。
callapplicationevent-log	音声アプリケーションインスタンスのイベントログを有効にします。
callapplicationevent-logmax-buffer-size	各アプリケーションインスタンスのイベントログバッファの最大サイズを設定します。
event-logdumpftp	ゲートウェイがアプリケーションイベントログバッファの内容を外部ファイルに書き込めるようにします。
showcallapplicationsession-level	音声アプリケーションインスタンスのイベントログと統計を表示します。

コマンド	description
callapplicationevent-log	音声アプリケーションインスタンスのイベントログを有効にします。
callapplicationhistorysessionevent-logsave-exception-only	少なくとも 1 つのエラーがあるアプリケーションインスタンスのイベントログのみを履歴に保存します。
callapplicationvoiceevent-log	特定の音声アプリケーションのイベントログを有効にします。
event-logerror-only	イベントログをアプリケーションインスタンスのエラーイベントのみに制限します。
showcallapplicationapp-level	音声アプリケーションのアプリケーションレベルの統計を表示します。
showcallapplicationsession-level	音声アプリケーションインスタンスのイベントログと統計を表示します。

Command	Description
application	ダイヤルピア上の特定の IVR アプリケーションを有効にします。
callapplicationvoice	アプリケーションに使用する名前を定義し、このアプリケーションで使用する適切な IVR スクリプトの場所を示します。
global	アプリケーション設定モードに入ります。

コマンド	description
callapplicationinterfaceevent-log	音声アプリケーションで使用される外部インターフェースのイベントログを有効にします。
callapplicationinterfaceevent-logdumpftp	音声ゲートウェイがインターフェイスイベントログバッファの内容を外部ファイルに書き込めるようにします。
callapplicationinterfaceevent-logmax-buffer-size	各アプリケーションインターフェイスのイベントログバッファの最大サイズを設定します。
showcallapplicationinterface	アプリケーションインターフェイスのイベントログと統計を表示します。

コマンド	description
callapplicationinterfaceevent-logdumpftp	ゲートウェイがインターフェイスイベントログバッファの内容を外部ファイルに書き込めるようにします。
callapplicationinterfaceevent-logerror-only	イベントログをアプリケーションインターフェイスのエラーイベントのみに制限します。
callapplicationinterfaceevent-logmax-buffer-size	各アプリケーションインターフェイスのイベントログバッファの最大サイズを設定します。
callapplicationinterfacemax-server-records	保存されるアプリケーションインターフェイスレコードの最大数を設定します。
callapplicationinterfacestats	アプリケーションインターフェイスの統計収集を有効にします。
interfaceevent-log	音声アプリケーションにサービスを提供するインターフェースのイベントログを有効にします。
showcallapplicationinterface	アプリケーションインターフェイスのイベントログと統計を表示します。

コマンド	description
callapplicationinterfacedumpevent-log	アプリケーションインターフェイスのイベントログバッファーを外部ファイルにフラッシュします。
callapplicationinterfaceevent-log	音声アプリケーションで使用される外部インターフェースのイベントログを有効にします。
callapplicationinterfaceevent-logmax-buffer-size	各アプリケーションインターフェイスのイベントログバッファの最大サイズを設定します。
callapplicationinterfacemax-server-records	保存されるアプリケーションインターフェイスレコードの最大数を設定します。
interfaceevent-logdumpftp	ゲートウェイがインターフェイスイベントログバッファの内容を外部ファイルに書き込めるようにします。
showcallapplicationinterface	アプリケーションインターフェイスのイベントログと統計を表示します。

コマンド	description
callapplicationinterfaceevent-log	音声アプリケーションで使用される外部インターフェースのイベントログを有効にします。
clearcallapplicationinterface	アプリケーションインターフェイスの統計またはイベントログをクリアします。
interfacestats	アプリケーションインターフェイスの統計収集を有効にします。
showcallapplicationinterface	アプリケーションインターフェイスのイベントログと統計を表示します。
stats	音声アプリケーションの統計収集を有効にします。

コマンド	description
callapplicationsessionstart(privilegedEXEC)	特権 EXEC モードから Tcl アプリケーションの新しいインスタンス (セッション) を開始します。
callapplicationsessionstop	実行中の音声アプリケーションセッションを停止します。
debugvoipivr	VoIP IVR インタラクションのデバッグメッセージを表示します。
sessionstart	Tcl IVR 2.0 アプリケーションの新しいインスタンス (セッション) を開始します。
showcallapplicationservicesregistry	登録されているすべてのサービスの 1 行の概要を表示します。
showcallapplicationsessions	音声アプリケーションセッションの概要または詳細情報を表示します。

コマンド	description
callapplicationsessionstart(globalconfiguration)	グローバル設定モードで Tcl アプリケーションの新しいインスタンス (セッション) を開始します。
callapplicationsessionstop	実行中の音声アプリケーションセッションを停止します。
showcallapplicationservicesregistry	登録されているすべてのサービスの 1 行の概要を表示します。
showcallapplicationsessions	音声アプリケーションセッションの概要または詳細情報を表示します。

コマンド	description
callapplicationsessionstart(globalconfiguration)	グローバル設定モードから Tcl アプリケーションの新しいインスタンス (セッション) を開始します。
showcallapplicationservicesregistry	登録されているすべてのサービスの 1 行の概要を表示します。
showcallapplicationsessions	音声アプリケーションセッションの概要または詳細情報を表示します。

Cisco IOS 音声コマンドリファレンス - A ～ C

偏向のない言語

翻訳について

検索結果

章のタイトル： cable detect through call application stats

cable detect through call application stats

cable-detect

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cable-detect-poll-timer

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cac_off

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

cache (neighbor BE)

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cache reload time (global application configuration mode)

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

例

関連コマンド

cadence

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cadence-list

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cadence-max-off-time

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cadence-min-on-time

構文の説明

コマンド デフォルト

コマンド モード

コマンド履歴

使用上のガイドライン

例

関連コマンド

cadence-variation

構文の説明

コマンド デフォルト

コマンド モード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト

コマンドモード

コマンドモード

コマンドデフォルト

コマンドモード

コマンドデフォルト