CRM管理ガイド

     前  次    新規ウィンドウで目次を開く  新規ウィンドウで索引を開く  PDFとして表示 - 新規ウィンドウ  Adobe Readerを取得 - 新規ウィンドウ
コンテンツはここから始まります

コマンド・リファレンス・ページ

この項では、Oracle Tuxedo Mainframe Adapter for SNAアプリケーションを管理するためにCommunications Resource Manager(CRM)でアクティビティを実行する際に管理者によって使用されるコマンドについて説明します。これらのコマンドはz/OS MVS上でJCLを使用して機能します。

この項では、次のコマンドについて説明します。

 

CRM

Communications Resource Managerを起動します。

概要 

CRM [ -t 0|1|2|3 ] [-p<nbr>] [-s] [-n <type>:#:#] [-u <keyfile>] <addr> <group>

説明

コマンド・ラインからCRMを起動すると、CRM Command Line Consoleのウィンドウにプロンプトが表示されます。アクティブ・リンクが存在する場合はすべて停止されます。

Oracle Tuxedo Mainframe Adapter for SNA GatewayごとにCRMを1つ、また、CRM定義ごとにスタックを1つ、それぞれ構成する必要があります。各スタックで1つ以上のSNAリンクを管理できます。

CRMには、RSTRTLOGとBLOBLOGという2種類のログ・ファイルがあり、これらは$APPDIR内に格納されます。RSTRTLOGはリカバリ・プロセス中に使用されるトランザクション状態のログであるのに対し、BLOBLOGログにはセッションおよびリンク情報が格納されます。ログ・ファイルを削除する場合は、関係するリンクごとにコールド・スタートが必要です。CRMLOGSコマンドを使用して、CRMログ・ファイルのコンテンツおよび状態を表示できます。

トレース・オプション

UNIXコマンド・ラインからCRMを起動する際、-tオプションを使用して、次のいずれかのCRMトレース・レベルを指定できます。

APPC Stack APIトレースは、CRMコマンドの-sオプションを使用して有効化または無効化されます(「一般オプション」を参照)。一般に、有効化すると、すべてのAPIコールのパラメータおよび結果が表示されます。使用されるスタックによっては、トレースを有効化するためにCRMの他のオプション(ベンダー指定の環境変数など)をアクティブ化する必要がある場合があります。

注意: CRMトレースの時間タグ情報は、現在のシステムの時間を反映します。UNIXおよびMVSシステムで正しいタイム・ゾーンが使用されるようにするには、TZ環境変数が正しく設定されていることが重要です。システムでこの変数が正しく設定されていない場合、詳細はシステムのドキュメントを参照してください。

認証オプション

-u

CRMとクライアント・プロセス間の通信に有効なプロセス認証を確立します。

keyfile

CRMとクライアント・プロセスの両方で認識されるハッシュ・キーが含まれているファイルの場所です。このファイルには一意のハッシュ・キー(8文字に制限)を指定する1行が含まれています。このファイルは保護される必要があります。

暗号化オプション

-n

このプロセスに有効な暗号化を確立します。

type

暗号化のタイプです。現在有効なエントリはGPEのみです(汎用目的の暗号化)。

min

暗号化に使用される最小のビット数を指定します。これらのレベルはCRMとクライアント・プロセス間のネゴシエーション中に使用されます。任意の数を指定できますが、ネゴシエートされる値は0、56または128に解決されます。

max

暗号化に使用される最大のビット数を指定します。これらのレベルはCRMとクライアント・プロセス間のネゴシエーション中に使用されます。任意の数を指定できますが、ネゴシエートされる値は0、56または128に解決されます。

一般オプション

次のパラメータはこのコマンドに適用されます。

-s

APPC Stack APIトレースです(デフォルトは「none」)。

addr

ソケットのリスニング・アドレス(必須) //host:port group GWSNAXグループ名(必須)

環境変数

CRMを起動する前に次の環境変数を設定する必要があります。

移植性

CRMと通信可能なオペレーティング・システムおよびスタックのリストは、Oracle Tuxedo Mainframe Adapter for SNAリリース・ノートを参照してください。

診断

CRMは正しく完了すると、戻りコード0で終了します。

サンプル

次はCRMコマンドの例です。 

CRM -t 0 //myhost:5587 GROUP2 /dev/null>std.out 2>std.err &

UNIXコマンド・ラインからCRMを起動すると、次のCRM Command Line Consoleが表示されます。 

$ CRM -t 0 //myhost:5587 GROUP2
BEA Tuxedo Mainframe Adapter for SNA Resource Manager started Thu Dec 11
	18:40:49.098 1997
	[CRM]
 
	Console active. Enter commands
	?>
	da => Display active tasks
	dl => Display remote links
	ds => Display link statistics
	dt => Display trace status
	st => Start all links
	sh => Stop all links and terminate
	si => Terminate immediately (no quiesce)

バックグラウンドで動作しているコンソールによってCRMを起動するには次を入力します。 

$ CRM -t 0 //myhost:5587 GROUP2 <dev/null>std.out 2>std.err &

ホスト/ポート・アドレスを使用してコマンド・ラインから詳細トレーシングおよびAPPC Stack APIトレーシングを有効にしてCRMを起動するには、次を入力します。 

CRM -t 2 -s //myhost:5587

 

CRMLOGS

現在のディレクトリ内のOracle Tuxedo Mainframe Adapter for SNA Communications Resource Manager(CRM)ログ・ファイルのコンテンツおよび状態を表示します。

概要 

CRMLOGS <group> [<crm name>]

説明

CRMLOGSコマンドを使用して2つのCRMログ・ファイルのコンテンツおよび状態を表示します。RSTRTLOGはリカバリ・プロセス中に使用されるトランザクション状態のログで、BLOBLOGログにはセッションおよびリンク情報が格納されます。ログ・ファイルを削除する場合は、関係するリンクごとにコールド・スタートが必要です。

CRMLOGSには次のパラメータが必要です。

グループ

SNAドメインのグループ名です(必須)。

crm name

CRM名です(デフォルトはCRM)。

診断

CRMLOGSコマンドは正しく完了すると、戻りコード0で終了します。

サンプル

group2のRSTRTLOGログ・ファイルを表示するには、次を入力します。 

CRMLOGS GROUP2 CRM.GROUP2.RSTRTLOG

group1のBLOBLOGログ・ファイルを表示するには、次を入力します。 

CRMLOGS GROUP1 CRM.GROUP1.BLOBLOG

関連項目

CRM

 

crmlkon

1つ以上の指定CRMリンクを起動します。

概要 

crmlkon -n<hostname:port> [-v -i -h -u<keyfile>] <linkname> ...

説明

crmlkonは、コマンド・ラインで指定されるすべてのCRMリンクを起動します。このコマンドは、CRMサーバーの起動時に個別のリンクが1つ以上起動しない場合に便利です。CRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用します。crmlkonはスクリプト内で使用した場合、コマンドがターゲットCRMに送信されると0を戻します。コマンドがターゲットCRMに送信されなかった場合は1を戻します。

-n

CRMサーバーを実行しているマシンおよびポートを指定します。すぐ後のパラメータは、linknameが置かれているCRMを実行しているマシンのhostnameおよびポートを示します。

-v

詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。

-i

エラーを無視します。複数のリンクを指定した場合、CRMコマンドの発行時にエラーが発生すると、crmlkonはリンクの処理を停止し、戻ります。エラーはリンクごとに無視でき、続けて次の指定リンクを処理できます。

-u

このプロセスとCRM間の通信に有効なプロセス認証を確立します。

<keyfile>

このプロセスとCRMの両方で認識されるハッシュ・キーが含まれているファイルの場所です。このファイルには一意のハッシュ・キー(8文字に制限)を指定する1行が含まれています。このファイルは保護される必要があります。

<linkname>

起動するリンクを指定します。これは、このリンクを定義するDMCONFIG内のDM_SNALINKSエントリです。複数のリンク名を指定できます。

<hostname:port>

linknameが置かれているCRMを実行しているマシンのIPホスト名およびポートを指定します。

h

このコマンドの構文の使用方法を表示するヘルプ画面を起動します。

例

ポート5000のmach1上で動作するCRMで所有されるlink2およびcicstestリンクを起動するには、次のように指定します。 

crmlkon -n mach1:5000 link2 cicstest

診断

crmlkonはコマンドの構文のみをチェックします。リンクが実際にアクティブ化されたかどうかを判別するには、jsnacrmまたはメインフレームベースのファシリティのいずれかを個別に使用する必要があります。コマンドがCRMに送信されなかった場合は、crmlkonは、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmlkonはコード0で終了します。

 

crmlkoff

1つ以上の指定CRMリンクを停止します。

概要

crmlkoff -n<hostname:port> [-v -i -h -u<keyfile>] <linkname> ...

説明

crmlkoffは、コマンド・ラインで指定されるすべてのCRMリンクを停止します。このコマンドは、CRMサーバーの起動後に個別のリンクを1つ以上停止する必要がある場合に便利です。CRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用します。スクリプト内で使用した場合、コマンドがターゲットCRMに送信されると0を戻します。コマンドがターゲットCRMに送信されなかった場合は1を戻します。

-n

CRMサーバーを実行しているマシンおよびポートを指定します。すぐ後のパラメータは、linknameが置かれているCRMを実行しているマシンのhostnameおよびポートを示します。これは必須です。

-v

詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。

-i

エラーを無視します。複数のリンクを指定した場合、CRMコマンドの発行時にエラーが発生すると、crmlkoffはリンクの処理を停止し、戻ります。エラーはリンクごとに無視でき、続けて次の指定リンクを処理できます。

-u

このプロセスとCRM間の通信に有効なプロセス認証を確立します。

<keyfile>

このプロセスとCRMの両方で認識されるハッシュ・キーが含まれているファイルの場所です。このファイルには一意のハッシュ・キー(8文字に制限)を指定する1行が含まれています。このファイルは保護される必要があります。

<linkname>

停止するリンクを指定します。これは、このリンクを定義するDMCONFIG内の*DM_SNALINKSエントリです。複数のリンク名を指定できます。

h

このコマンドの構文の使用方法を表示するヘルプ画面を起動します。

例

ポート5000のmach上で動作するCRMで所有されるlink1およびcicstestリンクを停止するには、次のように指定します。 

crmlkoff -n mach:5000 link1 cicstest

診断

crmlkoffはコマンドの構文のみをチェックします。リンクが実際に非アクティブ化されたかどうかを判別するには、jsnacrmまたはメインフレーム・ベースのファシリティのいずれかを個別に使用する必要があります。コマンドがCRMに送信されなかった場合は、crmlkoffは、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmlkoffはコード0で終了します。

 

crmdown

CRMをシャットダウンします。

概要 

crmdown -n<hostname:port> [-v -i -h -u<keyfile>]

説明

crmdownは、コマンド・ラインで指定されるCRMをシャットダウンします。このコマンドは、CRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用できます。スクリプト内で使用した場合、コマンドがターゲットCRMに送信されると0を戻します。コマンドがターゲットCRMに送信されなかった場合は1を戻します。

-n

CRMサーバーを実行しているマシンおよびポートを指定します。

-v

詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。

-i

エラーを無視します。

-u

このプロセスとCRM間の通信に有効なプロセス認証を確立します。

<keyfile>

このプロセスとCRMの両方で認識されるハッシュ・キーが含まれているファイルの場所です。このファイルには一意のハッシュ・キー(8文字に制限)を指定する1行が含まれています。このファイルは保護される必要があります。

例

ポート5000のmach1で動作しているCRMを停止するには、次のようにします。 

crmdown -n mach1:5000

診断

crmdownはコマンドの構文のみをチェックします。コマンドがCRMに送信されなかった場合は、crmdownは、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmdownはコード0で終了します。


  先頭に戻る       前  次