1. Database Net Servicesリファレンス
  2. Oracle Connection Manager制御ユーティリティ

2 Oracle Connection Manager制御ユーティリティ

この章では、Oracle Connection Manager制御ユーティリティのコマンドおよび構文について説明します。

2.1 Connection Manager制御ユーティリティのコマンド・モードと構文

Oracle Connection Manager制御ユーティリティ(CMCTL)を使用すると、クライアント接続リクエストの管理を開始、構成および変更できます。

Oracle Connection Manager制御ユーティリティの構文は、次のとおりです。 

cmctl command [argument]

Oracle Connection Manager制御ユーティリティでは、次のタイプのコマンドがサポートされます。

  • STARTUPやSHUTDOWNなどの初期化コマンドと終了コマンド

  • SET LOG_LEVELやSET EVENTなどの変更コマンド

  • SHOW STATUSやSHOW RULESなどの表示コマンド

  • SHOW GATEWAYSやRESUME GATEWAYSなどのゲートウェイ・コマンド

ノート:

SETコマンドは、リスナーがクライアント接続を受信する方法を制御する構成パラメータを動的に変更する場合に使用します。変更内容は、Oracle Connection Managerをシャットダウンするまで有効です。変更内容は、cman.oraファイルに保存できません。

Oracle Connection Manager制御ユーティリティは、コマンド・モードまたはバッチ・モードで使用します。

  • コマンド・モードの使用方法:

    • Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

      次のように、コマンドラインでcmctlと入力し、プログラム・プロンプトを表示してコマンドを実行します。 

      cmctl
CMCTL> command

    • オペレーティング・システムでは、次の構文に従って入力します。

      次のように、オペレーティング・システムのコマンド・プロンプトからコマンドを入力します。

      cmctl [command] [argument1 . . . argumentN] [-c instance_name]

      Oracle Connection Managerのインスタンス名は、この方法で実行するすべてのコマンドに引数として追加できます。Oracle Connection Managerのインスタンス名が含まれていない場合は、デフォルトのインスタンス名が使用されます。デフォルト名はcman_hostnameです。

  • バッチ・モードの使用方法:

    複数のコマンドは標準的なテキスト・ファイルにまとめて、一連のコマンドとして実行できます。バッチ・モードでコマンドを実行するには、次の構文を使用します。

    cmctl @input_file

関連項目:

Oracle Connection Managerアーキテクチャの詳細は、『Oracle Database Net Services管理者ガイド』を参照してください

親トピック: Oracle Connection Manager制御ユーティリティ

2.2 Oracle Connection Manager制御ユーティリティの概要

Oracle Connection Manager制御ユーティリティ(CMCTL)を使用すると、Oracle Connection Managerを管理できます。Oracle Connection Manager制御ユーティリティのコマンドを使用して、1つ以上のOracle Connection Managerのインスタンスを管理します。さらに、パラメータの設定を表示および変更できます。

親トピック: Oracle Connection Manager制御ユーティリティ

2.3 Oracle Connection Manager制御ユーティリティのコマンド

Oracle Connection Manager制御ユーティリティのコマンドを使用して、Oracle Connection Managerのインスタンスを管理および構成します。

  • ADMINISTER
    Oracle Connection Manager制御ユーティリティのコマンドADMINISTERは、管理の対象にするOracle Connection Managerインスタンスを選択するために使用します。
  • CLOSE CONNECTIONS
    Oracle Connection Manager制御ユーティリティのコマンドCLOSE CONNECTIONSは、接続を終了するために使用します。
  • CLOSE NON_ADMIN_ENDPOINTS
    Oracle Connection Manager制御ユーティリティ・コマンドCLOSE NON_ADMIN_ENDPOINTSは、管理以外のリスニング・エンドポイントをすべて閉じるために使用します。
  • EXIT
    Oracle Connection Manager制御ユーティリティのコマンドEXITは、Oracle Connection Managerユーティリティを終了するために使用します。
  • HELP
    Oracle Connection Manager制御ユーティリティのHELPコマンドは、Oracle Connection Manager制御ユーティリティのすべてのコマンドを表示する場合、または特定のコマンドの構文を表示する場合に使用します。
  • QUIT
    Oracle Connection Manager制御ユーティリティのコマンドQUITは、Oracle Connection Manager制御ユーティリティを終了するために使用します。
  • RELOAD
    Oracle Connection Manager制御ユーティリティのRELOADコマンドは、このユーティリティでパラメータとルールを動的に再読込みするために使用します。
  • RESUME GATEWAYS
    Oracle Connection Manager制御ユーティリティのコマンドRESUME GATEWAYSは、一時停止しているゲートウェイ・プロセスを再開するために使用します。
  • SET
    Oracle Connection Manager制御ユーティリティのSETコマンドは、このコマンドで変更できるパラメータのリストを表示するために使用します。
  • SET ASO_AUTHENTICATION_FILTER
    Oracle Connection Manager制御ユーティリティのコマンドSET ASO_AUTHENTICATION_FILTERは、クライアントがOracle Databaseセキュリティ認証を使用する必要があるかどうかを示すために使用します。
  • SET CONNECTION_STATISTICS
    Oracle Connection Manager制御ユーティリティのSET CONNECTION_STATISTICSコマンドは、ゲートウェイ・プロセスで接続統計を収集するかどうかを指定するために使用します。
  • SET EVENT
    Oracle Connection Manager制御ユーティリティのSET EVENTコマンドは、特定のイベントに関する情報をログに記録するために使用します。
  • SET IDLE_TIMEOUT
    Oracle Connection Manager制御ユーティリティのSET IDLE_TIMEOUTコマンドは、クライアントがデータを送信することなくアイドル状態を維持できる時間を指定するために使用します。
  • SET INBOUND_CONNECT_TIMEOUT
    Oracle Connection Manager制御ユーティリティのSET INBOUND_CONNECT_TIMEOUTコマンドは、Oracle Connection Managerのリスナーがタイムアウトになるまでに、クライアントの接続要求を待機する最大の時間を指定するために使用します。
  • SET LOG_DIRECTORY
    Oracle Connection Manager制御ユーティリティのSET LOG_DIRECTORYコマンドは、Oracle Connection Managerのログ・ファイルを書き込む場所を指定するために使用します。
  • SET LOG_LEVEL
    Oracle Connection Manager制御ユーティリティのSET LOG_LEVELコマンドは、Oracle Connection Managerのログ・レベルを設定するために使用します。
  • SET OUTBOUND_CONNECT_TIMEOUT
    Oracle Connection Manager制御ユーティリティのSET OUTBOUND_CONNECT_TIMEOUTコマンドは、Oracle Connection Managerインスタンスがタイムアウトになるまでにサーバー接続を待機する時間の上限を指定するために使用します。
  • SET SESSION_TIMEOUT
    Oracle Connection Manager制御ユーティリティのSET SESSION_TIMEOUTコマンドは、Oracle Connection Managerセッションの最大持続期間を指定するために使用します。
  • SET TRACE_DIRECTORY
    Oracle Connection Manager制御ユーティリティのSET TRACE_DIRECTORYコマンドは、Oracle Connection Managerインスタンスのトレース・ファイルを書き込む場所を指定するために使用します。
  • SET TRACE_LEVEL
    Oracle Connection Manager制御ユーティリティのSET TRACE_LEVELコマンドは、Oracle Connection Managerインスタンスのトレース・レベルを設定するために使用します。
  • SHOW
    Oracle Connection Manager制御ユーティリティのSHOWコマンドは、このコマンドの引数として使用可能なパラメータを表示する場合に使用します。
  • SHOW ALL
    Oracle Connection Manager制御ユーティリティのSHOW ALLコマンドは、SHOW PARAMETERSコマンドとSHOW RULESコマンドの出力を結合して表示するために使用します。
  • SHOW CONNECTIONS
    Oracle Connection Manager制御ユーティリティのSHOW CONNECTIONSコマンドは、接続情報を表示するために使用します。
  • SHOW DEFAULTS
    Oracle Connection Manager制御ユーティリティのSHOW DEFAULTSコマンドは、デフォルトのパラメータ設定を表示するために使用します。
  • SHOW EVENTS
    Oracle Connection Manager制御ユーティリティのSHOW EVENTSコマンドは、現在発生中のイベントを表示するために使用します。
  • SHOW GATEWAYS
    Oracle Connection Manager制御ユーティリティのSHOW GATEWAYSコマンドは、ゲートウェイ・プロセスのステータスを表示するために使用します。
  • SHOW PARAMETERS
    Oracle Connection Manager制御ユーティリティのSHOW PARAMETERSコマンドは、インスタンスのパラメータ設定を表示するために使用します。
  • SHOW RULES
    Oracle Connection Manager制御ユーティリティのSHOW RULESコマンドは、インスタンスのアクセス制御リストを表示するために使用します。
  • SHOW SERVICES
    Oracle Connection Manager制御ユーティリティのSHOW SERVICESコマンドは、Oracle Connection Managerインスタンスの情報を表示するために使用します。
  • SHOW STATS
    Oracle Connection Manager制御ユーティリティのSHOW STATSコマンドに-REGオプションを指定して使用し、データベース・サービス登録コマンドに関する統計を表示します。
  • SHOW STATUS
    Oracle Connection Manager制御ユーティリティのSHOW STATUSコマンドは、Oracle Connection Managerインスタンスの情報を表示するために使用します。
  • SHOW VERSION
    Oracle Connection Manager制御ユーティリティのSHOW VERSIONコマンドを使用します
  • SHUTDOWN
    Oracle Connection Manager制御ユーティリティのSHUTDOWNコマンドは、ゲートウェイ・プロセスまたはOracle Connection Managerインスタンス全体をシャットダウンするために使用します。
  • STARTUP
    Oracle Connection Manager制御ユーティリティのSTARTUPコマンドは、Oracle Connection Managerを起動するために使用します。
  • SUSPEND GATEWAY
    Oracle Connection Manager制御ユーティリティのSUSPEND GATEWAYコマンドは、新しいクライアント接続を受け入れられないゲートウェイ・プロセスを指定するために使用します。

親トピック: Oracle Connection Manager制御ユーティリティ

2.3.1 ADMINISTER

Oracle Connection Manager制御ユーティリティのコマンドADMINISTERは、管理の対象にするOracle Connection Managerインスタンスを選択するために使用します。

用途

Oracle Connection Managerのインスタンスを選択します。

前提条件

なし

構文

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> ADMINISTER [-c] instance_name

引数

instance_name: 管理の対象にするOracle Connection Managerインスタンスの名前。インスタンスはcman.oraファイルに定義されます。

使用上のノート

ADMINISTERコマンドはユーティリティ内でのみ実行できます。このコマンドは、オペレーティング・システムから発行できません。

ADMINISTERを使用すると、管理の対象にするOracle Connection Managerインスタンスを選択できます。Oracle Connection Managerインスタンスを起動するには、STARTUPコマンドを実行します。

コマンドでインスタンス名を指定しない場合、管理対象のインスタンスはローカル・インスタンスにデフォルト設定されます。

ローカル・インスタンスでないインスタンスを管理する場合は、-cオプションを使用します。

例

CMCTL> ADMINISTER cman_indl040ad
Current instance cman_indl040ad is already started
Connections refer to (address=(protocol=TCP)(host=indl040ad)(port=1560)).
The command completed successfully

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.2 CLOSE CONNECTIONS

Oracle Connection Manager制御ユーティリティのコマンドCLOSE CONNECTIONSは、接続を終了するために使用します。

用途

接続を終了します。特定の修飾子を使用して閉じる接続を選択します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl CLOSE CONNECTIONS [in state] [gt time] [from source] [to destination]
[for service] [using gateway_process_id] [connect_identifier_list]
[-c cman_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。 

CMCTL> CLOSE CONNECTIONS [in state] [gt time] [from source] [to destination] 
[for service] [using gateway_process_id] [connect_identifier_list

引数

state: 次のいずれかの値を使用して、選択する接続の状態を指定します。

  • idle: 接続が確立しているが非アクティブな接続。

  • connecting: 接続試行中の接続。

  • established: 接続が確立し、データを転送している接続。

  • terminating: 切断されている接続。

状態を指定しない場合、CLOSE CONNECTIONSのデフォルト設定は可能性のあるすべての状態になります。これらの条件下で時間修飾子を指定すると、その時間の長さはクライアントが接続を開始した後の経過時間を示します。

time: 時間形式。次のフォーマットを使用して時間を示し、それよりも長く持続している接続を指定します。

gt[hh:mm:]ss

source: 接続元アドレス。次のいずれかのフォーマットを使用して、接続元アドレスを指定します。

  • from IP

  • from hostname

  • from subnet

destination: 接続先アドレス。次のいずれかのフォーマットを使用して、接続先アドレスを指定します。

  • to IP

  • to hostname

  • to subnet

service: サービス名。service_nameパラメータを使用して、sales.us.example.comなどのサービスを指定します。

gateway_process_id: ゲートウェイ・プロセス識別子は数値です。この数値を使用してゲートウェイ・プロセスを識別し、そのゲートウェイ・プロセスによって委任される接続を指定します。ゲートウェイ・プロセス識別子を調べるには、Oracle Connection Manager制御ユーティリティのshow gatewaysコマンドを使用します。

connect_identifier_list: 接続識別子。複数の接続識別子を指定する場合は、スペースで区切ります。

使用上のノート

CLOSE CONNECTIONSコマンドによって接続は終了するため、クライアント側とサーバー側の両方でエラー・メッセージが生成される可能性があります。

IDLE状態修飾子には、常に時間修飾子を指定する必要があります。

引数を指定せずにCLOSE CONNECTIONSを発行すると、すべての接続がクローズします。

例

次の例では、すべての状態の接続がシャットダウンの対象となります。接続後の経過時間は1時間30分を超えている必要があります。接続元は指定されているサブネット、接続先は指定されているホスト名です。

CMCTL> CLOSE CONNECTIONS gt 1:30:00 from 192.0.2.32/24 to host1

次の例では、ゲートウェイ・プロセス0によって委任されており、アイドル時間が30分を超えている接続がシャットダウンされます。

CMCTL> CLOSE idle CONNECTIONS gt 30:00 using 0

次の例では、サービスsales.us.example.comに接続している接続がシャットダウンされます。

CMCTL> CLOSE established CONNECTIONS for sales.us.example.com

CLOSE CONNECTIONSコマンドのREST API

POST /close/connections
JSON Payload
{
“in” : [ “idle” | “connecting” | “established” | “terminating”]
 “gt” : “[hh:mm:]ss”,
  “from” : [“source ip “ | “hostname “ | “subnet”],
  “to” : [“destination ip” | “hostname” | “subnet”],
  “for” : “service name”,
  “using” : “gateway process identifier”,
  “connect_id_list” : [id1, id2, .. ]
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.3 CLOSE NON_ADMIN_ENDPOINTS

Oracle Connection Manager制御ユーティリティ・コマンドCLOSE NON_ADMIN_ENDPOINTSは、管理以外のリスニング・エンドポイントをすべて閉じるために使用します。

用途

管理以外のリスニング・アドレスをすべて停止します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl close non_admin_endpoints [-c instance_name]

Oracle Connection Manager制御ユーティリティから、次のようにします。

CMCTL> CLOSE NON_ADMIN_ENDPOINTS

使用上のノート

ADDRESSネットワーク・パラメータを指定することで、Oracle Connection Managerアドレスを管理者エンドポイントとしてタグ付けできます。したがって、CLOSE NON_ADMIN_ENDPOINTSコマンドを実行しても、Oracle Connection Manager制御ユーティリティはタグ付けされたリスニング・エンドポイントを使用して管理コマンドを引き続き実行します。クローズされたエンドポイントは、Oracle Connection Managerの他のプロセスや別のインスタンスで使用できます。

例

CMCTL> CLOSE NON_ADMIN_ENDPOINTS
The command completed successfully.

関連トピック

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.4 EXIT

Oracle Connection Manager制御ユーティリティのコマンドEXITは、Oracle Connection Managerユーティリティを終了するために使用します。

用途

Oracle Connection Manager制御ユーティリティを終了します。

前提条件

なし

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl EXIT [-c instance_name]

Oracle Connection Manager制御ユーティリティから、次のようにします。

CMCTL> EXIT

使用上のノート

このコマンドは、QUITコマンドと同じです。

例2-1 例

CMCTL> EXIT

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.5 HELP

Oracle Connection Manager制御ユーティリティのHELPコマンドは、Oracle Connection Manager制御ユーティリティのすべてのコマンドを表示する場合、または特定のコマンドの構文を表示する場合に使用します。

用途

Oracle Connection Manager制御ユーティリティのすべてのコマンドをリスト表示します。または、特定のコマンドの構文に関するヘルプを表示します。

前提条件

なし

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl HELP [command] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> HELP [command]

オペレーティング・システムでは、次の構文に従って入力します。

cmctl HELP [command] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> HELP [command]

引数

command: HELPコマンドを指定します。次の出力例にコマンドを示します。

HELPの引数としてコマンドを入力すると、そのコマンドの使用方法に関する情報が表示されます。引数なしでHELPを入力すると、すべてのコマンドがリスト表示されます。

例

CMCTL> HELP
The following operations are available
An asterisk (*) denotes a modifier or extended command:

administer      close*          exit            reload
resume*         save_passwd     set*            show*
shutdown        sleep           startup         suspend*
show_version    quit

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.6 QUIT

Oracle Connection Manager制御ユーティリティのコマンドQUITは、Oracle Connection Manager制御ユーティリティを終了するために使用します。

用途

Oracle Connection Manager制御ユーティリティを終了して、オペレーティング・システムのプロンプトに戻ります。

前提条件

なし

構文

CMCTL> QUIT

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

cmctl QUIT

オペレーティング・システムでは、次の構文に従って入力します。

使用上のノート

このコマンドは、EXITコマンドと同じです。

例

CMCTL> QUIT

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.7 RELOAD

Oracle Connection Manager制御ユーティリティのRELOADコマンドは、このユーティリティでパラメータとルールを動的に再読込みするために使用します。

用途

パラメータとルールを動的に再度読み込みます。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl RELOAD [-with_ha] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> RELOAD [-with_ha]

引数

-with_ha: 登録を削除せずにcman.oraをリロードするために使用します。

使用上のノート

RELOADコマンドで変更した構成情報は、新しい接続にのみ適用されます。既存の接続には影響しません。SET RELOADコマンドにより、cman.oraで設定された構成がリストアされ、SETコマンドはオーバーライドされます。

RELOADコマンドを使用すると、Oracle Connection Managerのリスナーにゲートウェイが登録されます。その登録が完了するまで、新しい接続が拒否される可能性があります。

RELOADには、登録を削除しないようにするための-with_haオプションを使用できます。そうすることで、リロード中のサービスの可用性が高くなります。

例

CMCTL> RELOAD
The command completed successfully

RELOADコマンドのREST API


POST /reload

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.8 RESUME GATEWAYS

Oracle Connection Manager制御ユーティリティのコマンドRESUME GATEWAYSは、一時停止しているゲートウェイ・プロセスを再開するために使用します。

用途

一時停止しているゲートウェイ・プロセスを再開します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl RESUME GATEWAYS [gateway_process_id] [cman_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> RESUME GATEWAYS [gateway_process_id]

引数

gateway_process_id: 再オープンする1つ以上のゲートウェイ・プロセス。複数のゲートウェイ・プロセスを指定する場合は、プロセス識別子をスペースで区切ります。

使用上のノート

引数なしでRESUME GATEWAYSコマンドを実行すると、閉じられていたすべてのゲートウェイ・プロセスが再開されます。

例

CMCTL> RESUME GATEWAYS 1
The command completed successfully

RESUME GATEWAYSコマンドのREST API


POST /resume/gateways
JSON Payload
   {
    “gateway_id_list” : [id1, id2, .. ]
   }

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.9 SET

Oracle Connection Manager制御ユーティリティのSETコマンドは、このコマンドで変更できるパラメータのリストを表示するために使用します。

用途

このコマンドで変更できるパラメータを一覧表示します。

前提条件

なし

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET

例

CMCTL> SET
The following operations are available after set
An asterisk (*) denotes a modifier or extended command:

aso_authentication_filter     outbound_connect_timeout
connection_statistics         session_timeout
event                         trace_directory
idle_timeout                  trace_level
inbound_connect_timeout                                                            
log_directory
log_level

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.10 SET ASO_AUTHENTICATION_FILTER

Oracle Connection Manager制御ユーティリティのコマンドSET ASO_AUTHENTICATION_FILTERは、クライアントがOracle Databaseセキュリティ認証を使用する必要があるかどうかを示すために使用します。

用途

クライアントが認証時にOracle Databaseセキュリティを使用する必要があるかどうかを指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET ASO_AUTHENTICATION_FILTER {on | off}[-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET ASO_AUTHENTICATION_FILTER {on | off}

引数

on: クライアントの認証でSecure Network Service(SNS)を使用していない接続を拒否します。SNSはOracle Databaseセキュリティの一部です。

off: クライアント接続に認証が不要なことを指定します。これはデフォルトです。

例

CMCTL> set aso_authentication_filter ON
CMAN_user.us.example.com parameter aso_authentication_filter set to ON
The command completed successfully

SET ASO_AUTHENTICATION_FILTERコマンドのREST API


POST /set/authlevel
JSON Payload
{
  “authlevel”: “true”|”false”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.11 SET CONNECTION_STATISTICS

Oracle Connection Manager制御ユーティリティのSET CONNECTION_STATISTICSコマンドは、ゲートウェイ・プロセスで接続統計を収集するかどうかを指定するために使用します。

用途

ゲートウェイ・プロセスで接続統計を集計するかどうかを指定します。

前提条件

ゲートウェイ・プロセスで接続統計を集計するかどうかを指定します。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET CONNECTION_STATISTICS {yes | no}[-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET CONNECTION_STATISTICS {yes | no}

引数

yes: ゲートウェイ・プロセスで接続統計を収集します。

no: ゲートウェイ・プロセスで接続統計を収集しません。これはデフォルトです。

使用上のノート

SET CONNECTION_STATISTICSをyesに設定しておくと、SHOW CONNECTIONSコマンドを実行することで統計を取得できます。

例

CMCTL> set connection_statistics ON
CMAN_user.us.example.com parameter connection_statistics set to ON
The command completed successfully

SET CONNECTION_STATISTICSコマンドのREST API


POST /set/connstats/
JSON Payload
{
“connection_statistics” : “yes”|”no”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.12 SET EVENT

Oracle Connection Manager制御ユーティリティのSET EVENTコマンドは、特定のイベントに関する情報をログに記録するために使用します。

用途

特定のイベントに関する情報をログに記録します。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET EVENT event_group [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET EVENT event_group {on | off}

引数

event_group: 次のいずれかのイベント・グループを指定します。

  • init_and_term: 初期化と終了に関するイベントのグループ。

  • memory_ops: メモリー操作に関するイベントのグループ。

  • conn_hdlg: 接続処理に関するイベントのグループ。

  • proc_mgmt: プロセス管理に関するイベントのグループ。

  • reg_and_load: 登録およびロード更新に関するイベントのグループ。

  • wake_up: Connection Manager Administration (CMADMIN)起動キューに関連するイベントのグループ。

  • timer: ゲートウェイ・タイムアウトに関するイベントのグループ。

  • cmd_proc: コマンド処理に関するイベントのグループ。

  • relay: 接続制御ブロックに関連するイベントのグループ。

on: イベント・グループを有効にします。

off: イベント・グループを無効にします。

使用上のノート

SET EVENTコマンドは、1度に1つの引数のみ受け入れます。複数のイベントをログに記録するには、イベントごとに個別にコマンドを実行します。

例

CMCTL> set event memory_ops off 
cman11 event memory_ops set to OFF.
The command completed successfully.

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.13 SET IDLE_TIMEOUT

Oracle Connection Manager制御ユーティリティのSET IDLE_TIMEOUTコマンドは、クライアントがデータを送信することなくアイドル状態を維持できる時間を指定するために使用します。

用途

クライアントがデータを転送せずにアイドル状態を維持できる時間を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET IDLE_TIMEOUT [time] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET IDLE_TIMEOUT [time]

引数

time: アイドル状態がタイムアウトになるまでの秒数を指定します。デフォルトは0(ゼロ)で、この機能を無効にします。

例

CMCTL> SET IDLE_TIMEOUT 30
CMAN_user.us.example.com parameter idle_timeout set to 30
The command completed successfully

SET IDLE_TIMEOUTコマンドのREST API


POST /set/maxidletime
JSON Payload
{
“idle_timeout” : “time”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.14 SET INBOUND_CONNECT_TIMEOUT

Oracle Connection Manager制御ユーティリティのSET INBOUND_CONNECT_TIMEOUTコマンドは、Oracle Connection Managerのリスナーがタイムアウトになるまでに、クライアントの接続要求を待機する最大の時間を指定するために使用します。

用途

Oracle Connection Managerのリスナーがタイムアウトになるまでに、クライアントからの有効な接続リクエストを待機する最大時間を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET INBOUND_CONNECT_TIMEOUT [time] [-c instance_name]

Oracle Connection Manager制御から、次のようにします。

CMCTL> SET INBOUND_CONNECT_TIMEOUT [time]

引数

time: 着信接続がタイムアウトになるまでの秒数を指定します。デフォルトは0(ゼロ)で、この機能を無効にします。

例

CMCTL> SET INBOUND_CONNECT_TIMEOUT 30
CMAN_user.us.example.com parameter inbound_connect_timeout set to 30
The command completed successfully

SET INBOUND_CONNECT_TIMEOUTコマンドのREST API


POST /set/maxcntdtime
JSON Payload
{
“inbound_connect_timeout” : “time”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.15 SET LOG_DIRECTORY

Oracle Connection Manager制御ユーティリティのSET LOG_DIRECTORYコマンドは、Oracle Connection Managerのログ・ファイルを書き込む場所を指定するために使用します。

ノート:

このコマンドは、自動診断リポジトリ(ADR)を有効にしていない場合にのみ動作します。ADRはデフォルトで有効になっていて、ログ・ディレクトリORACLE_HOME/logを使用します。

用途

Oracle Connection Managerのログ・ファイルが書き込まれる場所を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET LOG_DIRECTORY [directory_path] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET LOG_DIRECTORY [directory_path]

引数

directory_path: ログ・ディレクトリの位置。デフォルトのパスは次のとおりです。

  • LinuxおよびUNIX:

    ORACLE_HOME/network/log directory

  • Microsoft Windows:

    ORACLE_HOME\network\log directory

使用上のノート

ログ・ファイルの位置を調べるには、SHOW PARAMETERSコマンドを使用します。

例

CMCTL>
SET LOG_DIRECTORY /disk1/user_cman_test/oracle/network/admin

CMAN_user.us.example.com parameter log_directory set to 
/disk1/user_cman_test/oracle/network/admin

The command completed successfully

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.16 SET LOG_LEVEL

Oracle Connection Manager制御ユーティリティのSET LOG_LEVELコマンドは、Oracle Connection Managerのログ・レベルを設定するために使用します。

用途

Oracle Connection Managerのログ・レベルを設定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET LOG_LEVEL [level] [-c instance_name]

CMCTL> SET LOG_LEVEL [level]

Oracle Connection Manager制御ユーティリティから、次のようにします。

引数

  • off: ロギングなし。

  • user: ユーザー・ログ情報。

  • admin: 管理ログ情報。

  • support: Oracleサポート・サービス用のログ情報。これはデフォルトです。

level: 次のログ・レベルのいずれかを指定します。

使用上のノート

最小限のログ情報を記録する場合は、offを指定します。最大限のログ情報を記録する場合は、supportを指定します。

例

CMCTL> SET LOG_LEVEL SUPPORT
CMAN_user.us.example.com parameter log_level set to SUPPORT
The command completed successfully

SET LOG_LEVELコマンドのREST API


POST /set/loglevel
JSON Payload
{
“log_level” : “level”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.17 SET OUTBOUND_CONNECT_TIMEOUT

Oracle Connection Manager制御ユーティリティのSET OUTBOUND_CONNECT_TIMEOUTコマンドは、Oracle Connection Managerインスタンスがタイムアウトになるまでにサーバー接続を待機する時間の上限を指定するために使用します。

用途

Oracle Connection Managerのインスタンスがタイムアウトになるまでに、サーバーとの有効な接続を待機する最大時間を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET OUTBOUND_CONNECT_TIMEOUT [time] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET OUTBOUND_CONNECT_TIMEOUT [time]

引数

time: 発信接続がタイムアウトになるまでの秒数を指定します。デフォルトは0です。

例

CMCTL> SET OUTBOUND_CONNECT_TIMEOUT 30
CMAN_user.us.example.com parameter outbound_connect_timeout set to 30
The command completed successfully

SET OUTBOUND_CONNECT_TIMEOUTコマンドのREST API


POST /set/octo
JSON Payload
{
“outbound_connect_timeout” : “time”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.18 SET SESSION_TIMEOUT

Oracle Connection Manager制御ユーティリティのSET SESSION_TIMEOUTコマンドは、Oracle Connection Managerセッションの最大持続期間を指定するために使用します。

用途

Oracle Connection Managerのセッションの最大時間を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET SESSION_TIMEOUT [time] [-c  instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET SESSION_TIMEOUT [time]

引数

time: セッションがタイムアウトになるまでの秒数。デフォルトは0(ゼロ)で、この機能を無効にします。

例

CMCTL> SET SESSION_TIMEOUT 60
CMAN_user.us.example.com parameter session_timeout set to 60
The command completed successfully

SET SESSION_TIMEOUTコマンドのREST API


POST /set/mct
JSON Payload
{
“session_timeout” : “time”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.19 SET TRACE_DIRECTORY

Oracle Connection Manager制御ユーティリティのSET TRACE_DIRECTORYコマンドは、Oracle Connection Managerインスタンスのトレース・ファイルを書き込む場所を指定するために使用します。

ノート:

このコマンドは、自動診断リポジトリ(ADR)を有効にしていない場合にのみ動作します。デフォルトでは、ADRは有効です。

用途

Oracle Connection Managerインスタンスのトレース・ファイルの書込み場所を指定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET TRACE_DIRECTORY [directory_path] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET TRACE_DIRECTORY [directory_path]

引数

directory_path: トレース・ディレクトリの位置。デフォルト・パスはORACLE_HOME/network/traceです。

使用上のノート

SHOW PARAMETERSコマンドを使用して、トレース・ファイルの場所を判断します。

例

CMCTL> SET TRACE_DIRECTORY /disk1/mpurayat_newtest/oracle/network/trace
cman1 parameter trace_directory set to /disk1/mpurayat_newtest/oracle/network
/trace
The command completed successfully

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.20 SET TRACE_LEVEL

Oracle Connection Manager制御ユーティリティのSET TRACE_LEVELコマンドは、Oracle Connection Managerインスタンスのトレース・レベルを設定するために使用します。

用途

Oracle Connection Managerインスタンスのトレース・レベルを設定します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SET TRACE_LEVEL [level] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SET TRACE_LEVEL [level]

引数

level: 次のログ・レベルのいずれかを指定します。

  • off: トレースなし。これはデフォルトです。

  • user: ユーザー用のトレース情報。

  • admin: 管理用のトレース情報。

  • support: Oracleサポート・サービス用のトレース情報。

使用上のノート

最小限のトレース情報を記録する場合は、offを指定します。最大限のログ情報を記録する場合は、supportを指定します。

現行のトレース・レベルを調べるには、SHOW PARAMETERSコマンドを使用します。

例

CMCTL> SET TRACE_LEVEL USER
CMAN_user.us.example.com parameter trace_level set to USER
The command completed successfully

SET TRACE_LEVELコマンドのREST API


POST /set/tracelevel
JSON Payload
{
“trace_level” : “level”
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.21 SHOW

Oracle Connection Manager制御ユーティリティのSHOWコマンドは、このコマンドの引数として使用可能なパラメータを表示する場合に使用します。

用途

SHOWコマンドの引数として使用可能なパラメータのリストを表示します。このコマンドをパラメータとともに入力すると、そのパラメータの値が表示されます。

前提条件

なし

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW

例

CMCTL> SHOW
The following operations are available after show
An asterisk (*) denotes a modifier or extended command:

all             gateways        status
connections     parameters      version
defaults        rules
events          services

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.22 SHOW ALL

Oracle Connection Manager制御ユーティリティのSHOW ALLコマンドは、SHOW PARAMETERSコマンドとSHOW RULESコマンドの出力を結合して表示するために使用します。

用途

SHOW PARAMETERSコマンドとSHOW RULESコマンドの結果を結合して表示します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW ALL [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW ALL

例

CMCTL> SHOW ALL
listener_address          |
(address=(protocol=tcp)(host=users.us.example.com)(port=1630))
aso_authentication_filter |   OFF
connection_statistics     |   OFF
event_group               |   OFF
log_directory             | /disk1/user_cman_test/oracle/network/log/
log_level                 | SUPPORT
max_connections           |   256
idle_timeout              |     0
inbound_connect_timeout   |     0
session_timeout           |     0
outbound_connect_timeout  |     0
max_gateway_processes     |    16
min_gateway_processes     |     2
max_cmctl_sessions        |     4
trace_directory           | /disk1/user_cman_test/oracle/network/trace/
trace_level               |   OFF
trace_timestamp           |   OFF
trace_filelen             |     0
trace_fileno              |     0
(rule_list=
 (rule=
  (src=*)
  (dst=*)
  (srv=*)
  (act=accept)
 )
)
The command completed successfully

SHOW ALLコマンドのREST API

 
GET /show/all

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.23 SHOW CONNECTIONS

Oracle Connection Manager制御ユーティリティのSHOW CONNECTIONSコマンドは、接続情報を表示するために使用します。

用途

特定の接続またはすべての接続に関する情報を表示します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW CONNECTIONS [information] [in state] [gt time] [from source]
[to destination] [for service] [using gateway_process_id] 
[connect_identifier_list] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW CONNECTIONS [information][in state] [gt time] [from source]
[to destination] [for service] [using gateway_process_id] 
[connect_identifier_list]

引数

information: 次のいずれかの値を指定して、接続の情報を表示します。情報カテゴリには、接続識別子、接続元、接続先、サービス、現行の状態、合計アイドル時間および合計経過時間が含まれます。

  • count: 他の修飾子で指定した条件を満たしている接続の合計数。これはデフォルトです。

  • detail: 他の修飾子で指定した接続に関するすべての情報。

state: 次のいずれかの値を指定して、選択する接続の状態を指定します。

  • idle: 接続が確立しているが非アクティブな接続。

  • connecting: 接続試行中の接続。

  • established: 接続が確立し、データを転送している接続。

  • terminating: 切断されている接続。

状態を指定しない場合、SHOW CONNECTIONSのデフォルト設定は可能性のあるすべての状態になります。これらの条件下で時間修飾子を指定すると、その時間の長さはクライアントが接続を開始した後の経過時間を示します。

ノート:

この引数は、Oracle Connection ManagerのTraffic Directorモードではサポートされていません。

time: 次のフォーマットを使用して時間を入力し、その時間より長い接続を指定します。

gt[hh:mm:]ss

ノート:

この引数は、Oracle Connection ManagerのTraffic Directorモードではサポートされていません。

source: 次のいずれかのフォーマットを指定して、接続元アドレスを指定します。

  • from IP

  • from ホスト名

  • from サブネット

destination: 次のいずれかのフォーマットを指定して、接続先アドレスを指定します。

  • to IP

  • to ホスト名

  • to サブネット

service: service_nameのフォーマットを使用してサービスをリクエストします。

gateway_process_id: 次のフォーマットを使用してゲートウェイ・プロセスを識別し、そのゲートウェイ・プロセスによって委任される接続を指定します。 

using gateway_process_id

connect_identifier_list: 複数の接続識別子を指定する場合は、スペースで区切ります。

使用上のノート

接続は、ゲートウェイ・プロセス識別子と接続識別子によって昇順にソートされます。

引数を指定せずにSHOW CONNECTIONSを発行すると、すべての接続が表示されます。

例

次のコマンドでは、すべての状態の接続の詳細情報が表示されます。接続後の経過時間は1時間30分を超えている必要があります。接続元は指定されているサブネット、接続先は指定されているホスト名です。

CMCTL> SHOW CONNECTIONS gt 1:30:00 from 192.0.2.32/24 to host1

次のコマンドでは、ゲートウェイ・プロセス識別子0を使用してOracle Connection Managerによって接続され、アイドル状態が30分を超えている接続の数が表示されます。

CMCTL> SHOW idle CONNECTIONS count gt 30:00 using 0

次のコマンドでは、サービスsales.us.example.comに接続されている接続の詳細情報が表示されます。 

CMCTL> SHOW established CONNECTIONS detail for sales.us.example.com

SHOW CONNECTIONSコマンドのREST API


POST /show/connections 
JSON Payload
{
“count” : “[yes | no]”,
“in”: “[ idle | connecting | established | terminated]”,
“gt” : “ time elapsed since client connection, [hh:mm:]ss format”,
“from” : “[ IP | hostname | subnet]”,
“to” : “[ IP | hostname | subnet]”,
“for” : “service name”,
“using” : “ gateway process id”,
“connect_ids” : [id1, id2]
}

jsonスキーマを使用してsales.us.example.comの確立された接続詳細を表示する例を次に示します。 

{ 
“count”: “no”,
“state” : “established”,
“for” : “sales.us.example.com”
}

Traffic Directorモードで表示されるその他の統計

Traffic DirectorモードのOracle Connection Managerへの接続ごとに、次の付加的な統計が表示されます。

  • ソース・ホスト名:クライアント接続のホスト名。

  • ソース・プロセスID: 接続したクライアントのプロセスID。

  • ソース・プログラム名: 接続したクライアント・プログラムの名前。

  • 宛先ホスト名: クライアントがOracle Connection Managerを介して接続しているデータベース・サーバーのホスト名。

  • 状態: 次のいずれかの値を持つインバウンド接続の状態

    • THREAD WAIT: 接続はワーカー・スレッドを待機中です。専用スレッド・モードでは表示されません

    • ACTIVE: 接続はデータ転送中であり、スレッドを占有しています

    • IDLE: 接続は確立されていますが非アクティブです。cman.ora内でtdm_bind_thread=trueとなっている場合は、まだスレッドを占有できます。

  • アイドル時間: 接続がIDLE状態である累積時間(µs単位)。

  • スレッド待機時間: 接続がTHREAD WAIT状態である累積時間(µs単位)。専用スレッド・モードでは常に0です。

  • アクティブ時間: 接続がACTIVE状態である累積時間(µs単位)。

  • PRCP状態: Proxy Resident Connection Pool (PRCP)に関するインバウンド接続の状態。次のいずれかの値になります。

    • WAIT: 接続はPRCPからのセッションを待機中です。

    • CHECKED-OUT: 接続はPRCPからのアウトバウンド・セッションを保持していますが、OCIコールは行われていません。

    • ACTIVE: 接続はPRCPからのアウトバウンド・セッションを保持しており、OCIコールでビジー状態です。

    • CHECKED-IN: 接続によってCHECKED-OUTセッションがリリースされPRCPに戻されました

    • NO STATE: PRCPが構成されていないサービスに対するクライアントは、この状態になります

  • PRCP待機時間、PRCPチェックアウト時間およびPRCPアクティブ時間: 接続がPRCP WAIT、CHECKED-OUTおよびACTIVE状態である累積時間(µs単位)。PRCP以外のサービスの場合、これら3つの状態はすべて0です。

  • セッション取得合計: この接続からのPRCPセッション取得リクエストの合計数。PRCPが構成されていない場合は、常に1です。

  • セッション取得ヒット: すべてのリクエストから生じた、PRCP内のセッションの存在が検出された回数。PRCPが構成されていない場合は、常に0です。

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.24 SHOW DEFAULTS

Oracle Connection Manager制御ユーティリティのSHOW DEFAULTSコマンドは、デフォルトのパラメータ設定を表示するために使用します。

用途

デフォルトのパラメータ設定を表示します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW DEFAULTS [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW DEFAULTS

例

CMCTL> SHOW DEFAULTS
listener_address          |
(address=(protocol=tcp)(host=users.us.example.com)(port=1521))
aso_authentication_filter |   OFF
connection_statistics     |   OFF
event_group               |   OFF
log_directory             | /disk1/user_cman_test/oracle/network/log/
log_level                 | SUPPORT
max_connections           |   256
idle_timeout              |     0
inbound_connect_timeout   |     0
session_timeout           |     0
outbound_connect_timeout  |     0
max_gateway_processes     |    16
min_gateway_processes     |     2
max_cmctl_sessions        |     4
trace_directory           | /disk1/user_cman_test/oracle/network/trace/
trace_level               |   OFF
trace_timestamp           |   OFF
trace_filelen             |     0
trace_fileno              |     0
The command completed successfully

SHOW DEFAULTSコマンドのREST API

GET /show/defaults

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.25 SHOW EVENTS

Oracle Connection Manager制御ユーティリティのSHOW EVENTSコマンドは、現在発生中のイベントを表示するために使用します。

用途

操作中のイベントを表示します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW EVENTS [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW EVENTS

例

CMCTL> SHOW EVENTS
Event Groups:
memory_ops
The command completed successfully

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.26 SHOW GATEWAYS

Oracle Connection Manager制御ユーティリティのSHOW GATEWAYSコマンドは、ゲートウェイ・プロセスのステータスを表示するために使用します。

用途

特定のゲートウェイ・プロセスの現行の状態を表示します。表示される統計には、アクティブな接続の数、ピーク時のアクティブな接続の数、処理された接続の合計数、拒否された接続の数などがあります。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW GATEWAYS [gateway] [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。

CMCTL> SHOW GATEWAYS [gateway]

引数

gateway: 状態を表示するゲートウェイの識別子。

引数を指定せずにSHOW GATEWAYSを発行すると、すべてのゲートウェイ・プロセスの状態が表示されます。

使用上のノート

複数のゲートウェイを表示する場合は、コマンドを入力するときに識別子をスペースで区切ります。

例

CMCTL> SHOW GATEWAYS 1
Gateway ID                     1
Gateway state                  READY
Number of active connections   0
Peak active connections        0
Total connections              0
Total connections refused      0
The command completed successfully

SHOW GATEWAYSコマンドのREST API


POST /show/gateways
JSON Payload
{
“gateway_ids” : [id1, id2.. ]
}

親トピック: Oracle Connection Manager制御ユーティリティのコマンド

2.3.27 SHOW PARAMETERS

Oracle Connection Manager制御ユーティリティのSHOW PARAMETERSコマンドは、インスタンスのパラメータ設定を表示するために使用します。

用途

インスタンスの現行のパラメータ設定を表示します。

前提条件

Oracle Connection Managerが実行されていることが必要です。

構文

オペレーティング・システムでは、次の構文に従って入力します。

cmctl SHOW PARAMETERS [-c instance_name] 
Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW PARAMETERS

                     
                     

                        
使用上のノート

                        
構成パラメータには、SETコマンドで動的に変更できるものがあります。そのため、SHOW PARAMETERSコマンドで表示される情報は、cman.oraファイル内の情報と異なる場合があります。
                        

                     

                     
                     

                        
例
CMCTL> SHOW PARAMETERS
listener_address          |
(address=(protocol=tcp)(host=users.us.example.com)(port=1630))
aso_authentication_filter |    ON
connection_statistics     |    ON
event_group               | (memory_ops)
log_directory             | /disk1/user_cman_test/oracle/network/log/
log_level                 | SUPPORT
max_connections           |   256
idle_timeout              |     0
inbound_connect_timeout   |     0
session_timeout           |     0
outbound_connect_timeout  |     0
max_gateway_processes     |    16
min_gateway_processes     |     2
max_cmctl_sessions        |     4
trace_directory           | /disk1/user_cman_test/oracle/network/trace/
trace_level               | SUPPORT
trace_timestamp           |   OFF
trace_filelen             |     0
trace_fileno              |     0
The command completed successfully


                     
                     

                        
SHOW PARAMETERSコマンドのREST API

                        
                        
                        
 
GET /show/parameters


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.28 SHOW RULES
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHOW RULESコマンドは、インスタンスのアクセス制御リストを表示するために使用します。
                     

                     

                        
用途

                        
インスタンスが現在使用しているアクセス制御リストを表示します。

                     

                     
                     

                        
前提条件

                        
Oracle Connection Managerが実行されていることが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHOW RULES [-c instance_name] 

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW RULES
cmctl SHOW RULES [-c instance_name] 

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW RULES

                     
                     

                        
使用上のノート

                        
ルール・リストは、RELOADコマンドを発行することによって更新できます。
                        

                     

                     
                     

                        
例
CMCTL> SHOW RULES
Number of filtering rules currently in effect: 5
(rule_list=
  (rule=
    (src=usunnae12)
    (dst=usunnae13)
    (srv=*)
    (act=accept)
    (action_list=(mit=120)(mct=1800)(conn_stats=on)(aut=off))
  )
  (rule=
    (src=usunnae12)
    (dst=usunnae14)
    (srv=service2)
    (act=accept)
  )
  (rule=
    (src=*)
    (dst=usunnae15)
    (srv=*)
    (act=accept)
    (action_list=(mit=120)(mct=3000)(moct=200)(aut=on))
  )

  (rule=
    (src=*)
    (dst=usunnae16)
    (srv=*)
    (act=reject)
    (action_list=(moct=20)(aut=on))
  )

  (rule=
    (src=users.us.example.com)
    (dst=users.us.example.com)
    (srv=cmon)
    (act=accept)
    (action_list=(mit=100)(mct=1130)(moct=200)(aut=on))
  )
)

                     
                     

                        
SHOW RULESコマンドのREST API

                        
                        
                        
GET /show/rules


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.29 SHOW SERVICES
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHOW SERVICESコマンドは、Oracle Connection Managerインスタンスの情報を表示するために使用します。
                     

                     

                        
用途

                        
Oracle Connection Managerのインスタンスに関する包括的な情報を表示します。表示される情報には、ゲートウェイ・プロセスおよびCMADMINプロセスのハンドラ数、ハンドラのリスニング・ポート、拒否された接続数と現在の接続数が含まれます。

                     

                     
                     

                        
前提条件

                        
Oracle Connection Managerが実行されていることが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHOW SERVICES [-c instance_name]

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW SERVICES

                     
                     

                        
例
CMCTL> SHOW SERVICES
Services Summary...
Proxy service "cmgw" has 1 instance(s).
  Instance "cman", status READY, has 2 handler(s) for this service...
    Handler(s):
      "cmgw001" established:0 refused:0 current:0 max:256 state:ready
         <machine: user-sun, pid: 29190>
         (ADDRESS=(PROTOCOL=tcp)(HOST=user-sun)(PORT=33175))
      "cmgw000" established:0 refused:0 current:0 max:256 state:ready
         <machine: user-sun, pid: 29188>
         (ADDRESS=(PROTOCOL=tcp)(HOST=user-sun)(PORT=33174))
Service "cmon" has 1 instance(s).
  Instance "cman", status READY, has 1 handler(s) for this service...
    Handler(s):
      "cmon" established:0 refused:0 current:0 max:4 state:ready
         <machine: user-sun, pid: 29184>
         (ADDRESS=(PROTOCOL=tcp)(HOST=users)(PORT=33168))
The command completed successfully

                     
                     

                        
SHOW SERVICESコマンドのREST API

                        
                        
                        

GET /show/services


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               

               
2.3.30 SHOW STATS
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHOW STATSコマンドに-REGオプションを指定して使用し、データベース・サービス登録コマンドに関する統計を表示します。
                     

                     

                        
用途

                        
クライアント接続リクエストの処理中にOracle Connection Manager (CMAN)リスナーが受信する、登録コマンドの数に関する統計を表示します。 

                        
これらの統計を使用すると、REGISTER、UPDATE、RE-REGISTER、UN-REGISTERなどのサービス登録またはサービス更新操作を監視できます。これは、CMANでこれらの操作のトラフィックとオーバーヘッドを評価するのにも役立ちます。
                        

                     

                     
                     

                        
前提条件

                        
CMANが稼動している必要があります。 

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHOW STATS -REG
Oracle Connection Manager制御ユーティリティ(CMCTL)で、次のようにします。
                        
CMCTL> SHOW STATS -REG

                     
                     

                        
使用上のノート

                        
    
                           
  • 
                              
    CMCTLの他に、このコマンドをリスナー制御(LSNRCTL)ユーティリティから実行できます。
                              
    
                           
    • 
                           
  • 
                              
    引数を指定せずにSHOW STATS -REGを入力した場合、出力には、すべてのインスタンス、登録済サービス、各サービスに割り当てられたハンドラ、リスニング・エンドポイントおよびアクセス制御リスト(ACL)のグローバル・レベルのデータが表示されます。 
                              
    
                           
    • 
                           
  • 
                              
    最近の数は、前回のリセット以降、つまり、-clearを使用してRecentセクションをクリアした時点以降にリスナーが受信したすべてのコマンドの周期的な数です。現時点で-clearを使用していない場合、このフィールドには、累積数(CMANインスタンスの起動以降に収集されたコマンドの合計数)が表示されます。 
                              
    
                              
    出力の他のセクションの詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。
                              
    
                           
    • 
                        

                     

                     
                     

                        
引数および例

                        

                           

                              
                                 

                                    引数および説明
                                    例
                                 

                              
                              
                                 

                                    
                                       
すべての登録コマンドの最近および累積数を、グローバル・レベルで表示します。

                                       
-reg

                                    		
                                    
CMCTL:cman1> show stats -reg
------------------------
Global Level:
                     Recent
Recent Duration: 5 days 17 hr. 15 min. 25 sec
Command    Instance Service ENDP  Handler  INF
Registration    2      2      2      4      0
Updates         3      0      0     12      0
Re-Register     0      3      0      0      0
Un-Register     0      0      0      0      0
                     Cumulative
Registration    3      3      3      6      0
Updates         4      0      0     12      0
Re-Register     0      3      0      0      0
Un-Register     0      0      0      0      0
The command completed successfully

                                 

                                 

                                    
                                       
指定されたインスタンス名のすべての登録コマンドの、最近および累積数を表示します。

                                       
-inst instance_name

                                    		
                                    
CMCTL:cman1> show stats -reg -inst sales1
------------------------
Instance Name: sales1
                    Recent
Recent Duration: 5 days 15 hr. 17 min. 18 sec
Command    Instance Service ENDP Handler INF
Registration    2      2     2     4     0
Updates         3      0     0    12     0
Re-Register     0      0     0     0     0
Un-Register     0      0     0     0     0
                    Cumulative
Registration    2      2     2     4     0
Updates         3      3     0    12     0
Re-Register     0      0     3     0     0
Un-Register     0      0     0     0     0
The command completed successfully

                                 

                                 

                                    
                                       
すべてのインスタンスの登録コマンドの、最近および累積数を表示します。

                                       
-all_inst

                                    		
                                    
CMCTL:cman1> show stats -reg -all_inst
------------------------
Instance Name: sales1
                   Recent
Recent Duration: 5 days 15 hr. 3 min. 2 sec
Command   Instance Service ENDP Handler INF
Registration   1      1      1     2     0
Updates       21      0      0     5     0
Re-Register    0      0      0     0     0
Un-Register    0      0      0     0     0
                   Cumulative
Registration   1      1      1     4     0
Updates       25      0      2     5     0
Re-Register    0      3      0     0     0
Un-Register    0      0      0     0     0
------------------------
Instance Name: sales2
                   Recent
Recent Duration: 2 days 5 hr. 3 min. 2 sec
Command   Instance Service ENDP Handler INF
Registration   1      1      1     2     0
Updates        2      0      0     3     0
Re-Register    0      1      0     0     0
Un-Register    0      0      0     0     0
                   Cumulative
Registration   1      1      1     3     0
Updates       10      0      2     5     0
Re-Register    0      3      0     0     0
Un-Register    0      0      0     0     0

The command completed successfully

                                 

                                 

                                    
                                       
指定されたサービス名のすべての登録コマンドの、最近および累積数を表示します。

                                       
-serv service_name 
                                       

                                    		
                                    
CMCTL:cman1> show stats -reg -serv sales.us.example.com
------------------------
Service Name: sales.us.example.com
Recent Duration: 5 days 15 hr. 4 min. 10 sec
               Flags    Goodness   Delta
Recent           2         0         0
Cumulative       0         0         0
The command completed successfully

                                 

                                 

                                    
                                       
すべてのデータベース・サービスの登録コマンドの、最近および累積数を表示します。

                                       
-all_serv

                                    		
                                    
CMCTL:cman1> show stats -reg -all_serv
------------------------
Service Name: sales.us.example.com
Recent Duration: 5 days 15 hr. 5 min. 25 sec
               Flags    Goodness   Delta
Recent           1         2         0
Cumulative       2         0         0
------------------------
Service Name: employee.us.example.com
Recent Duration: 8 days 2 hr. 5 min. 25 sec
               Flags    Goodness   Delta
Recent           1         0         0
Cumulative       1         0         0
The command completed successfully

                                 

                                 

                                    
                                       
値のフェッチ後に、Recentセクションを0にリセットします。
                                       

                                       
-clear

                                       
これにより、Recentセクションに新しいデータ・セットが提供されます。-clearは、すべてのSHOW STATS引数とともに使用できます。
                                       

                                    		
                                    
CMCTL:cman1> show stats -reg -clear
------------------------ 
Global Level:
                  Recent 
Recent Duration: 0 days 0 hr. 0 min. 4 sec 
Command    Instance Service ENDP Handler INF
Registration   0     0      0      0      0 
Updates        0     0      0      0      0 
Re-Register    0     0      0      0      0 
Un-Register    0     0      0      0      0
                  Cumulative
Registration   3     3      3      6      0 
Updates        4     0      0      13     0 
Re-Register    1     0      0      0      0 
Un-Register    0     1      0      0      0 
The command completed successfully

                                 

                              
                           

                        

                        
                     

                     
                  

                  

                     

                        
関連トピック

                        
                     

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

               
2.3.31 SHOW STATUS
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHOW STATUSコマンドは、Oracle Connection Managerインスタンスの情報を表示するために使用します。
                     

                     

                        
用途

                        
バージョン、開始時刻、現行の統計情報など、インスタンスの基本的な情報を表示します。

                     

                     
                     

                        
前提条件

                        
Oracle Connection Managerが実行されていることが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHOW STATUS

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW STATUS

                     
                     

                        
例
CMCTL> SHOW STATUS
Status of the Instance
----------------------
Instance name             CMAN_user.us.example.com
Version                   CMAN for Linux: Version 23.4.0.0.0
Start date                12-MAR-2024 14:50:35
Uptime                    0 days 1 hr. 25 min. 24 sec
Num of gateways started   2
Average Load level        0
Log Level                 SUPPORT
Trace Level               OFF
Instance Config file      /disk1/user_cman_test/oracle/network/admin/cman.ora
Instance Log directory    /disk1/user_cman_test/oracle/network/log/
Instance Trace directory  /disk1/user_cman_test/oracle/network/trace/
The command completed successfully

                     
                     

                        
SHOW STATUSコマンドのREST API

                        
                        
                        

GET /show/status


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.32 SHOW VERSION
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHOW VERSIONコマンドを使用します 
                     

                     

                        
用途

                        
Oracle Connection Manager制御ユーティリティの現行のバージョンと名前を表示します。

                     

                     
                     

                        
前提条件

                        
なし

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHOW VERSION [-c instance_name] 

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHOW VERSION

                     
                     

                        
例
CMCTL> SHOW VERSION
CMAN for Linux: Version 23.4.0.0.0
The command completed successfully

                     
                     

                        
SHOW VERSIONコマンドのREST API

                        
                        
                        

GET /show/version


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.33 SHUTDOWN 
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSHUTDOWNコマンドは、ゲートウェイ・プロセスまたはOracle Connection Managerインスタンス全体をシャットダウンするために使用します。
                     

                     

                        
用途

                        
特定のゲートウェイ・プロセスまたはOracle Connection Managerのインスタンス全体をシャットダウンします。

                     

                     
                     

                        
前提条件

                        
Oracle Connection Managerが実行されていることが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SHUTDOWN [gateways gateway] [normal | abort] [timeout value] [notify] [-c instance_name]
Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SHUTDOWN [gateways gateway] {normal | abort} [timeout value] [notify]

                     
                     

                        
引数

                     

                     
                     
gateways: 特定のゲートウェイをシャットダウンします。複数のゲートウェイを指定する場合は、各ゲートウェイをスペースで区切ります。
                     

                     
normal: 新しい接続を拒否し、既存の接続をクローズした後で終了します。これはデフォルトです。
                     

                     
abort: Oracle Connection Managerをただちにシャットダウンし、オープン状態の接続をすべてクローズします。
                     

                     
timeout value: Oracle Connection Managerが停止する前に待機する必要がある時間(秒)を指定します。
                     

                     
notify: Oracle Connection Managerが停止していることをクライアントに通知します。
                     

                     

                        
使用上のノート

                        
引数なしでSHUTDOWNコマンドを実行すると、すべてのゲートウェイがシャットダウンされます。
                        

                     

                     
                     

                        
例
CMCTL> SHUTDOWN GATEWAYS 0
CMCTL> SHUTDOWN ABORT
CMCTL> SHUTDOWN NOTIFY

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.34 STARTUP
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSTARTUPコマンドは、Oracle Connection Managerを起動するために使用します。
                     

                     

                        
用途

                        
Oracle Connection Managerを開始します。

                     

                     
                     

                        
前提条件

                        
同じプロトコル・アドレスで構成されている他のOracle Connection Managerインスタンスが実行されていないことが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl STARTUP [-c instance_name]
Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> STARTUP 

                     
                     

                        
使用上のノート

                        
    
                           
  • 
                              
    このコマンドの実行前に、ADMINISTERコマンドを使用して、開始するインスタンスを選択しておく必要があります。
                              
    
                              
    このコマンドを発行すると、すべてのインスタンス・コンポーネント(リスナー、CMADMINおよびゲートウェイ・プロセス)が開始されます。いずれかのコンポーネントがすでに実行されている場合、コマンドは失敗します。
                              
    
                           
    • 
                           
  • Oracle Connection Managerパラメータへのパスワード・アクセスの使用は、Oracle Database 23aiではサポートが終了しました。
    Oracleには、拡張接続方法であるローカル・オペレーティング・システム認証(LOSA)が用意されています。これにより、CMANを起動したユーザーのみが管理操作を実行できます。この方法は、Oracle Databaseで使用される他のオペレーティング・システム認証方法と一致しています。CMANへのパスワード・アクセスを現在使用している場合、OracleではCMANパスワードを削除し、かわりにLOSAを使用することをお薦めします。 
    
                           
    • 
                        

                     

                     
                     

                        
例
CMCTL> STARTUP
Starting Oracle Connection Manager instance cman_1. Please wait...
CMAN for Linux: Version 23.4.0.0.0
Status of the Instance
----------------------
Instance name             cman_1
Version                   CMAN for Linux: Version 23.4.0.0.0
Start date                22-Feb-2024 01:16:55
Uptime                    0 days 0 hr. 0 min. 9 sec
Num of gateways started   8
Average Load level        0
Log Level                 SUPPORT
Trace Level               OFF
Instance Config file      $ORACLE_HOME/network/admin/cman.ora
Instance Log directory    $ORACLE_BASE/diag/netcman/node_name/cman_1/alert
Instance Trace directory  $ORACLE_BASE/diag/netcman/node_name/cman_1/trace
The command completed successfully

                     
                     

                        
STARTUP -MIGRATE

                        
                        
                        
                        
STARTUP -MIGRATEパラメータは、Oracle接続マネージャ(CMAN)を移行モードで起動する場合に使用します。移行モードでCMANの新しいインスタンスを開始して、接続されているセッションをOracle CMANのすでに実行中のインスタンスから移行できます。
                        

                        
                     

                     
                     

                        
前提条件

                        
                        
                        
新しいインスタンスと同じ構成のCMANインスタンスが、新しいCMANが開始されているのと同じホスト上の異なるORACLE_HOMEで実行している必要があります。 
                        

                        
                     

                     
                     

                        
構文

                        
                        
                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl STARTUP –MIGRATE [-c instance_name]

                        
                     

                     
                     

                        
使用上のノート

                        
                        
                        
このコマンドによって、リスナー、CMADMIN、ゲートウェイ・プロセスなどの新しいインスタンス・コンポーネントが開始します。
                        

                        
                        
新しいリスナーは、リスニング・エンドポイントおよびリスニング・キューを古いリスナーから継承します。新しい接続リクエストも受け入れます。 

                        
                        
古いゲートウェイ・プロセスは、接続されているセッションを新しいゲートウェイに移行します。この移行は、クライアントまたはサーバーの介入なしで実行されます。

                        
                        
古いリスナーは、保留中の接続を処理した後に終了します。古いインスタンス、CMADMINおよびゲートウェイ・プロセスは、移行が完了した直後、または7分のタイムアウト後に終了します。
                        

                        
                        
instance_name_oldは、古いインスタンスを監視するインスタンス名として使用します。
                        

                        
                     

                     
                     

                        
例

                        
                        
CMCTL STARTUP –MIGRATE –C cman_1
CMCTL for Linux: Version 23.4.0.0.0 

Copyright (c) 1996, 2024, Oracle.  All rights reserved.

Current instance cman_1_ is already started
Connecting to (DESCRIPTION=(address=(protocol=tcp)(host=localhost)(port=2556)))
CMAN Session Migration Stats
–---------------------------
No of Gateways               |     1
Total Connections            |     0
TCP Connections              |     0
TCPS Connections(Migratable) |     0

Starting CMAN Session Migration....
–----------------------------------
Old CMADMIN address alias parameter cman_1_old set to (configuration=(ADDRESS=(PROTOCOL=ipc)(KEY="#124470.1")(KEYPATH=/var/tmp/.oracle_754500)))
.
Starting Oracle Connection Manager instance cman_1. Please wait...
CMAN for Linux: Version 23.4.0.0.0 - Development
Status of the Instance
–---------------------
Instance name             cman_1
Version                   CMAN for Linux: Version 23.4.0.0.0 
Start date                27-FEB-2024 05:31:03
Uptime                    0 days 0 hr. 0 min. 9 sec
Num of gateways started   1
Average Load level        0
Log Level                 SUPPORT
Trace Level               SUPPORT
Instance Config file      /network/admin/cman.ora
Instance Log directory $ORACLE_BASE/diag/netcman/node_name/cman_1/alert
Instance Trace directory $ORACLE_BASE/diag/netcman/node_name/cman_1/trace
The command completed successfully.
Now session migration will be initiated by gateways separately....

                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド

                        

                     

                  

                  
               
2.3.35 SUSPEND GATEWAY
                  

                  

                     
Oracle Connection Manager制御ユーティリティのSUSPEND GATEWAYコマンドは、新しいクライアント接続を受け入れられないゲートウェイ・プロセスを指定するために使用します。
                     

                     

                        
用途

                        
新規のクライアント接続をこれ以上受け入れないようにするゲートウェイ・プロセスを指定します。

                     

                     
                     

                        
前提条件

                        
Oracle Connection Managerが実行されていることが必要です。

                     

                     
                     

                        
構文

                        
オペレーティング・システムでは、次の構文に従って入力します。
cmctl SUSPEND GATEWAY [gateway_process_id] [-c instance_name] 

Oracle Connection Manager制御ユーティリティでは、次の構文に従って入力します。
CMCTL> SUSPEND GATEWAY [gateway_process_id]

                     
                     

                        
引数

                        
gateway_process_id: 新規接続をこれ以上受け入れないようにするゲートウェイ・プロセス。複数のゲートウェイ・プロセスを指定する場合は、エントリ間にスペースを入力します。
                        

                        
引数を指定せずにSUSPEND GATEWAYを発行すると、すべてのゲートウェイ・プロセスが一時停止されます。
                        

                     

                     
                     

                        
使用上のノート

                        
ゲートウェイ・プロセスで新規接続を受け入れるようにするには、RESUME GATEWAYSコマンドを使用します。
                        

                     

                     
                     

                        
例
CMCTL> SUSPEND GATEWAY 1
The command completed successfully

                     
                     

                        
SUSPEND GATEWAYコマンドのREST API

                        
                        
                        
 
POST /suspend
{
“gateway” : “gateway id”
}


                        

                     
                  

                  

                     

                        

                           
親トピック: Oracle Connection Manager制御ユーティリティのコマンド