ctgstart コマンド解説

UNIX および Linux® で ctgstart コマンドを使用して、オプションを指定して CICS® Transaction Gateway を開始できます。

ctgstart コマンドの形式は次のとおりです。
ctgstart <options> [<-j>JVMArg1 <-j>JVMArg2...] [<-c>CicscliArg1 <-c>CicscliArg2...]
始動オプションとその目的をリストするには、 ctgstart -? と入力します。

バックグラウンド・プロセスとしてゲートウェイ・デーモンを実行している場合は、 -adminportを除き、これらの始動オプションを ctgd パラメーター CTGD_PARAMSに指定できます。 詳しくは、 ctgd コマンド・リファレンスを参照してください。

始動オプション

表 1. 開始オプションと説明
オプション名と構文 説明
-port=数値 ゲートウェイ・デーモンが listen する TCP/IP ポート番号を指定します。
-sslport=数値 ゲートウェイ・デーモンが SSL 要求を listen する TCP/IP ポート番号を指定します。
-httpport= ポート番号 ゲートウェイ・デーモンが HTTP 要求を listen する TCP/IPポートを指定します。
-httpsport=ポート番号 ゲートウェイ・デーモンが HTTPS 要求を listen する TCP/IPポートを指定します。
-keyring=ファイル SSL 鍵リングのパスとファイル名を指定します。
-keyringpw=パスワード SSL 鍵リングのパスワードを指定します。 ctgstart 、対応する keyring パラメータを指定せずに keyringpw パラメータを単独で使用すると、エラーメッセージが生成される。
-adminport=数値 ctgadmin コマンドによってゲートウェイ・デーモンを制御している場合に、ゲートウェイ・デーモンとの通信に使用するポートを指定します。
-statsport=番号 ゲートウェイ・デーモンが統計 API 要求を listen する TCP/IP ポート番号を指定します。
-initconnect=数値 ConnectionManager スレッドの初期数を指定します。 パフォーマンスについては、 ゲートウェイのチューニングを参照してください。
-maxconnect=数値 ConnectionManager スレッドの最大数を指定します。 この値を -1 に設定すると、ConnectionManager スレッドの数に制限は適用されません。 パフォーマンスについては、 ゲートウェイのチューニングを参照してください。
-maxhttpconnect=数値 HTTP および HTTPS クライアント・スレッドの最大数を指定する。
-initworker=数値 worker スレッドの初期数を指定します。 パフォーマンスについては、 ゲートウェイのチューニングを参照してください。
-maxworker=数値 worker スレッドの最大数を指定します。 この値を -1 に設定すると、ConnectionManager スレッドの数に制限は適用されません。 パフォーマンスについては、 ゲートウェイのチューニングを参照してください。
-トレース 標準トレースを有効にする（ トレース参照）。 デフォルトでは、トレース出力は、 どのデータ・ブロック (例えば COMMAREA やネットワーク・フロー) についても最初の 128 バイトだけを 表示します。 CLASSPATH 変数の値やコード・ページなど、その他の有用な情報は、 トレース出力の先頭に表示されます。

-tfile オプションを使用しない限り、トレース出力は /var/cicscli/gateway.trcに書き込まれます。 指定されたファイルへの書き込み権限がゲートウェイ・デーモンにない場合、トレースは書き込まれません。 トレースが使用可能に指定されているゲートウェイ・デーモンが開始されるたびに、トレース・ファイルは新しいトレースによって上書きされます。

この表の末尾の注を参照のこと。
-静か コンソールからの入力を読み取り不可にし、かつ stdout へ書き込み不可にします。 -quiet オプションを使用するときには、ゲートウェイ・デーモン・ログの宛先を file に設定する必要があります。 詳細については、 ゲートウェイデーモンのロギングを参照してください。
-ディーエヌエスネームズ TCP/IP のシンボリック・ホスト名をメッセージに表示できるようにします。 詳細については、 TCP/IPホスト名の表示を参照してください。
-tfile=パス名 トレースが使用可能の場合、pathname で指定されたファイルにトレース・メッセージが書き込まれます。 このオプションにより、トレース出力のデフォルト宛先がオーバーライドされます (-trace オプションを参照してください)。
-x 完全なデバッグトレースを有効にする（「 トレース 」を参照）。 デフォルトでは、 トレース出力は、データ・ブロック (例えば COMMAREA あるいはネットワーク・フロー) 全体を表示します。 また、ゲートウェイ・デーモンの内部処理に関する情報を標準トレースよりも多く表示します。 トレース出力先については -trace および -tfile オプションを参照してください。

デバッグ・トレースを行うと、パフォーマンスがかなり低下します。
-tfilesize=数値 トレース出力ファイルの最大サイズを K バイトで指定します。
-truncationsize=数値 値 number は、トレースに表示されるデータ・ブロックの最大サイズを指定します。 このオプションを -trace または -x のいずれかの オプションと共に指定すると、デフォルト・サイズをオーバーライドすることができます。 有効な値は正の整数です。 値として 0 を指定すると、トレースにはデータ・ブロックは表示されません。
-dumpoffset=数値 値 number は、データ・ブロックの表示が始まるオフセットを指定します。 オフセットが表示されるデータの全長より大きい場合、0 のオフセットが使用されます。
スタック Java™ の例外スタック・トレースを有効にします (「 トレース 」を参照)。 Java 例外 (標準的な操作中に予期される例外を含む) がトレースされます。 生じうる例外には次のものがあります。
  • Java クライアント・アプリケーションがネットワーク・プロトコルを終了または切断した結果、IOException が発生しました。
  • CICS Transaction Gateway プロトコル・ハンドラーのタイムアウト (アイドル・タイムアウトや ping タイムアウトなど) の結果の InterruptedException 。

それ以外のトレース出力は 作成されません。 トレース出力先については -trace および -tfile オプションを参照してください。
-j 引数を JVM に渡します。 例えば、-j-D<name>=<value> を指定すると、JVM のシステム・プロパティーが適切に設定されます。 このオプションの使用方法については、JVM の コマンド行インタープリターのヘルプを参照してください。 複数の引数を JVM に渡すことができます。 -j オプションを複数回指定して、複数の引数を JVM に渡します。
-classpath=クラスパス JVM の始動時に使用される JVM クラスパスに追加する 追加の項目を指定します。 例えば、要求出口を含む jar ファイルの 場所です。
-c 引数をクライアント・デーモン制御プログラム cicscli に渡します。 例えば、 ctgstart -c-s=myserver -c-d -c-m=all は cicscli -s=myserver -d -m=all を呼び出す。

サーバー名を指定する必要があります。

クライアントデーモンに渡せるオプションの詳細については、 クライアントデーモン管理セクションを参照してください。
-requestExits=出口 要求モニター出口の 1 つ以上の完全修飾クラス名のコンマ区切りリストです。
注: ctgstart コマンドで指定するトレース・オプションは、トレースに必要なオプションの全セットを指定する必要があります。 トレース・オプションを 1 つ指定した場合、その他のオプションにはデフォルト値が使用され、 ctg.ini 内のトレース・オプションはすべて無視されます。