ctgservice コマンド解説

Windows で ctgservice コマンドを使用して、ゲートウェイ・デーモンのオーバーライド・パラメーターを設定したり、 IBM® CICS® Transaction Gateway サービスの開始権限と停止権限を付与または拒否したりすることができます。

ゲートウェイ・デーモンのオーバーライド・パラメーターを設定したり開始権限や停止権限を定義したりするには、管理者が ctgservice コマンドを実行する必要があります。コマンド・プロンプトから ctgservice を使用しても、 IBM CICS Transaction Gateway サービスは開始されません。

IBM CICS Transaction Gateway サービスは、デフォルトのセキュリティー記述子を使用して作成されます。デフォルトのセキュリティー記述子のアクセス権は、Windows サービス・コントロール・マネージャーによって定義されます。詳しくは、Windows の資料を参照してください。 ctgservice コマンドを使用して、デフォルトのアクセス権限を変更し、 IBM CICS Transaction Gateway サービスを開始および停止する権限をユーザーまたはグループに付与できます。

ctgservice コマンドは、 IBM CICS Transaction Gateway サービスの開始時に使用されるゲートウェイ・デーモンのオーバーライド・パラメーターを設定します。これらのオーバーライド・パラメーターは、構成ファイルで指定されているゲートウェイ・デーモンのパラメーター値をオーバーライドします。オーバーライド・パラメーターは、サービスの開始時に検証されます。ctgservice コマンドを使用して設定する際には、パラメーターは検証されません。 ctgservice コマンドは ctgjava コマンドにより指定された JVM を使用します。詳しくは、 JVM の指定を参照してください。

ctgservice コマンドの構文は次のとおりです。

ctgservice -?|-T|-G Name|-D Name|-R [-ACTGParam1 [-ACTGParam2] [-A-jArgument]...]

ここで、それぞれ以下のとおりです。

-?: ctgservice で使用可能なコマンド構文とオプションのリストを表示します。
-T: 登録されたパラメーターのオーバーライドと、サービスを開始および停止できるユーザーおよびグループを表示します。
-G <名前: アクセス権 SERVICE_QUERY_CONFIG、SERVICE_QUERY_STATUS、SERVICE_START、および SERVICE_STOP を許可することによって、 IBM CICS Transaction Gateway サービスを開始および停止する権限をユーザーまたはグループに付与します。名前にスペースが含まれている場合は、名前全体を引用符で囲む必要があります。
-D <名前: アクセス権限 SERVICE_START および SERVICE_STOP を拒否することにより、ユーザーまたはグループが IBM CICS Transaction Gateway サービスを開始および停止する権限を拒否します。名前にスペースが含まれている場合は、名前全体を引用符で囲む必要があります。
-R: 開始時に使用する、ゲートウェイ・デーモンのオーバーライド・パラメーターを登録します。 -R オプションを使用すると、登録されたオーバーライド・パラメーターがリセットされます。以下のオプションを指定せずに ctgservice -R を使用すると、すべてのオーバーライド・パラメーターが削除される。ゲートウェイ・デーモンのオーバーライド・パラメーターを定義するには、 -R オプションとともに -A < オーバーライド> オプションを使用する必要があります。
-A <オーバーライド: ゲートウェイ・デーモンの始動オーバーライド・パラメーターか、またはゲートウェイ・デーモン JVM の引数を指定します。 -A < オーバーライド> オプションは、 -R オプションと一緒に使用する必要があります。

注: -G および -D パラメーターは、管理者権限を持つユーザーのみが指定できます。これらのパラメーターは、CICS TG サービスのアクセス制御リスト (ACL) を更新します。ユーザーやグループに対して、CICS TG サービスを開始または停止する権限の付与または拒否が行われます。 -T パラメーターは、CICS TG サービスに関連付けられたアクセス制御リスト項目をリストするように更新されました。

例:

「パワー・ユーザー」に IBM CICS Transaction Gateway サービスを開始および停止する権限を付与するには、以下のようにします。
```
ctgservice -G "Power Users"
```
「ゲスト」グループによる IBM CICS Transaction Gateway サービスの開始と停止を拒否します。
```
ctgservice -D Guests
```
ゲートウェイ・デーモンのオーバーライド・パラメーターを設定するには、次のようにします。
```
ctgservice -R -A-x -A-tfile=C:\temp\ctgtrace.txt -A-j-Dgateway.T.setJNITFile=C:\temp\ctgJNItrace.txt
```

以下のゲートウェイ・デーモン・オーバーライドは、-R オプションを使用した設定に使用できます。

表 1. -R オプションで使用するゲートウェイデーモンのオーバーライド。
オーバーライド・パラメーター	説明
-port=数値	ゲートウェイ・デーモンが listen する TCP/IP ポート番号を指定します。
ヒット・ポート =ポート番号	ゲートウェイ・デーモンが HTTP 要求を listen する TCP/IPポートを指定します。
-Httpsport=ポート番号	ゲートウェイ・デーモンが HTTPS 要求を listen する TCP/IPポートを指定します。
-sslport=数値	ゲートウェイ・デーモンが SSL 要求を listen する TCP/IP ポート番号を指定します。
-keyring=ファイル	SSL 鍵リングのパスとファイル名を指定します。
-keyringpw=パスワードです。	SSL 鍵リングのパスワードを指定します。 ctgstart コマンド (UNIX の場合) または ctgserviceコマンド行で、対応する `keyring` パラメーターを指定せずに `keyringpw` パラメーターを単独で使用すると、エラー・メッセージが生成されます。
-adminport=数値	ctgadmin コマンド (Unix の場合) または ctgservice コマンド (Windows の場合) を使用してゲートウェイ・デーモンを制御する場合に、ゲートウェイ・デーモンとの通信に使用するポートを指定します。
-statsport=数値	ゲートウェイ・デーモンが統計 API 要求を listen する TCP/IP ポート番号を指定します。
-initconnect=数値	ConnectionManager スレッドの初期数を指定します。パフォーマンスについては、ゲートウェイのチューニングを参照してください。
-maxconnect=数値	ConnectionManager スレッドの最大数を指定します。この値を -1 に設定すると、ConnectionManager スレッドの数に制限は適用されません。パフォーマンスについては、ゲートウェイのチューニングを参照してください。
-initworker=数値	worker スレッドの初期数を指定します。パフォーマンスについては、ゲートウェイのチューニングを参照してください。
-maxworker=数値	worker スレッドの最大数を指定します。この値を -1 に設定すると、ConnectionManager スレッドの数に制限は適用されません。パフォーマンスについては、ゲートウェイのチューニングを参照してください。
-trace	標準トレースを有効にする（トレース参照）。デフォルトでは、トレース出力は、どのデータ・ブロック (例えば COMMAREA やネットワーク・フロー) についても最初の 128 バイトだけを表示します。 CLASSPATH 変数の値やコード・ページなど、その他の有用な情報は、トレース出力の先頭に表示されます。トレース出力は stderr に書き込まれます。ただし、 -T ファイルオプションを使用した場合、または構成ツールを使用してデフォルトのトレース宛先を定義した場合は除きます。ゲートウェイ・デーモンに指定されたファイルへの書き込み権限がない場合、トレースは書き込まれません。トレースを有効にしてゲートウェイ・デーモンを開始するたびに、トレース・ファイルが新しいトレースで上書きされます。
-quiet	コンソールからの入力を読み取り不可にし、かつ stdout へ書き込み不可にします。
-dnsnames	TCP/IP のシンボリック・ホスト名をメッセージに表示できるようにします。詳細については、 TCP/IPホスト名の表示を参照してください。
-T ファイル =パス名	トレースが使用可能の場合、pathname で指定されたファイルにトレース・メッセージが書き込まれます。このオプションにより、トレース出力のデフォルト宛先がオーバーライドされます (-trace オプションを参照してください)。
-x	完全なデバッグトレースを有効にする（「トレース」を参照）。デフォルトでは、トレース出力は、データ・ブロック (例えば COMMAREA あるいはネットワーク・フロー) 全体を表示します。また、標準トレースよりも多くの内部ゲートウェイ・デーモン処理に関する情報も表示されます。トレース出力先については -trace および -tfile オプションを参照してください。デバッグ・トレースを行うと、パフォーマンスがかなり低下します。
-tfilesize=数値	トレース出力ファイルの最大サイズを K バイトで指定します。
-truncationsize=数値	トレース出力ファイルの最大サイズを K バイトで指定します。
-dumpoffset=数値	値 number は、データ・ブロックの表示が始まるオフセットを指定します。オフセットが表示されるデータの全長より大きい場合、0 のオフセットが使用されます。
-stack	Java™ の例外スタック・トレースを有効にします (「トレース」を参照)。 Java の例外は、通常の操作中に生じうる例外も含めてトレースされます。生じうる例外には次のものがあります。 Java クライアント・アプリケーションがネットワーク・プロトコルを終了または切断した結果の IOException。 CICS Transaction Gateway プロトコル・ハンドラーのタイムアウト (アイドル・タイムアウトや ping タイムアウトなど) の結果の InterruptedException 。それ以外のトレース出力は作成されません。トレース出力先については -trace および -tfile オプションを参照してください。
-j	引数を JVM に渡します。例えば、`-j-D<name>=<value>` を指定すると、JVM のシステム・プロパティーが適切に設定されます。このオプションの使用方法については、JVM のコマンド行インタープリターのヘルプを参照してください。 Windows では、このオプションは、以前のバージョンの CICS Transaction Gatewayで使用されていた -X オプションに代わるものです。複数の引数を JVM に渡すことができます。 -j オプションを複数回指定して、複数の引数を JVM に渡します。
-classpath=`クラスパス`	JVM の始動時に使用される JVM クラスパスに追加する項目を指定します。例えば、要求出口を含む jar ファイルの場所です。
-requestExits= `終了`	要求出口のモニターに使用されるクラスのリスト。