CRM管理ガイド

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

SNAコンポーネントの管理

この項の各トピックでは、Oracle Tuxedo Mainframe Adapter for SNAアプリケーションを管理するためにCommunications Resource Manager(CRM)で管理者によって実行されるアクティビティについて説明します。

スタック管理および構成用のインタフェースは、スタック・プロバイダにより異なり、このガイドでは説明していません。ご使用の環境で使用されているスタックに関するベンダー・ドキュメントを参照してください。

この項では、以下のトピックを取り上げます。

 


CRMの起動

CRMはPU 2.1サーバーと直接通信してSNA接続性を提供するサーバーです。これらのサーバーは手動で起動できます。PU 2.1サーバーは、常にCRMの前に起動する必要があります。また、両方のサーバーとも、関連付けられているOracle Tuxedo Mainframe Adapter for SNA Gatewayを起動する前に起動する必要があります。

CRMは次の方法で起動できます。

UNIX上でのCRMの起動

CRMを適切に起動するには、次のタスクを完了します。このCRMの起動方法は、HP-UX 11.23またはメインフレーム上でCRMを分散構成している場合にのみ使用します。

  1. APPDIR をアプリケーション・ディレクトリに設定します。
  2. PU2.1サーバーを起動します。
  3. PU2.1サーバーの起動に関する詳細は、SNAスタック・ベンダーから提供される操作ドキュメントを参照してください。SNAスタックは、CRMの起動前に起動し、アクティブ化されている必要があります。

  4. CRMを起動します。
  5. コマンド・ラインでCRMコマンドを入力します。

CRMコマンド

CRMコマンドによりCommunications Resource Managerが起動します。UNIXコマンド・ラインからCRMを起動すると、CRM Command Line Consoleのウィンドウにプロンプトが表示され、これを終了すると、すべてのアクティブ・リンクがシャット・ダウンされます。

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

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

CRMコマンド・ラインの例:

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

コマンドライン・オプション

次の表で、CRMコマンドに有効なオプションについて説明します。

表3-1 CRMコマンド・オプション
キーワード
デフォルト値
必須/
省略可能
説明
-t [0|1|2|3]
0
省略可能
トレーシングを有効にし、トレーシングのレベルを指定します。
0=トレーシングなしです。
このレベルに設定するとCRMトレーシングを効率的に無効化でき、トレース・ファイルが存在する場合は閉じます。この後、トレーシングを再開すると新規のファイルが作成され、ファイル名には小さな数字から順に番号の接尾辞が付きます。0がデフォルトのトレース・レベルです。
1=最小限のトレーシングです。
このレベルでは、主要イベントのみがCRMでトレースされます。これはアプリケーションの会話のシーケンスを決定するだけには十分です。
2=中レベルのトレーシングです。
このレベルでは、すべてのI/OバッファもCRMでトレースされます。
3=最大のトレーシングです。
このレベルでは、すべてのAPPC動詞もCRMでトレースされます。

注意: CRMのトレース・オプションもCRM Monitorから設定できます。

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

注意: APPC Stack APIのトレース・オプションもCRM Monitorから設定できます。

-p <nbr>
100スレッド
省略可能
パフォーマンス・オプションを有効化し、開始するスレッド数を指定します。
この値は、同時に作成されるSNAリクエストのロードに対応している必要があります。リクエスト数がスレッド数を超える場合、これらのリクエストは実行可能ですが、完了時間に影響することがあります。200スレッドを超えないようにしてください。CRMは最大200スレッド用に調整されています。システムでアクティブ化可能なスレッド数に制限がある場合はスレッド値を下げます。
<addr>
なし
必須
ファミリ、ポート、アドレスの形式の//hostname:port_addrまたはsockaddr_inを使用してTCP/IPアドレスを指定します。
<0xFFFFPPPPAAAAAAAA>
このエントリでは、引数およびオプションは次のように定義されています。
FFFFはプロトコル・ファミリの16進値で、INETファミリの場合は常に0x0002です。
PPPPは、未使用のTCP/IPポートの16進値です。
AAAAAAAAは、CRMを実行しているマシンのIPアドレスの16進値です。
<group>
なし
必須
Oracle Tuxedo Mainframe Adapter for SNA Gatewayグループ名を指定します。

サンプル

次の項では、CRMの起動用の異なるオプションのうちの3つの例を示します。

CRMおよびCRM Command Line Consoleの起動

UNIXコマンド・ラインから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
A Oracle 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 Command Line ConsoleによるCRMの起動

バックグラウンドで動作しているコンソールによってCRMを起動するには次のようなコマンドを使用します。

$ CRM -t 0 //myhost:5587 GROUP2 <dev/null>std.out 2>std.err &
詳細トレーシングおよびAPPC Stack APIトレーシングによるCRMの起動

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

CRM -t 2 -s //myhost:5587

診断

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

z/OS MVS上でのCRMの起動

z/OS MVSプラットフォームでは、ジョブ制御言語(JCL)を使用して環境設定およびCRMの起動を行います。

  1. CRMを起動する環境で、次の環境変数を設定します。サンプル・ファイルはデータ・ライブラリにあります(ENV)。
  2. APPDIR=<High level qualifier for datasets to be created in APPDIR>

  3. ご使用のシステム用に記述されているJCLを使用してCRMジョブを実行します。
注意: CRMがz/OS MVSプラットフォームにインストールされている場合は、Oracle Tuxedo Mainframe Adapter for SNA Gatewayが異常終了してもCRMを再起動する必要はありません。tmshutdownでは、CRMはシャットダウンされません。CRMをシャットダウンするにはcrmdownユーティリティを実行する必要があります。この永続機能があるのは、z/OS MVSバージョンおよびz/OS UNIXバージョンのCRMのみです。

CRMコマンド用のサンプルJCL

この項では、CRMコマンドを実行する際に使用可能なSETコマンドの説明およびJCLの例を示します。

SET STARTCMD

CRMコマンド・ラインのパラメータを設定します。

SET OBJLIB

CRM実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。

SET DATA

ENVFILEを含むデータセットを指定します。

SET ENVFILE

CRMの環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENVは製品に同梱されています。

SET SIZE

CRMタスクの実行用の領域サイズを定義します。このオプションの推奨設定は0Mで、CRMを起動し、必要なサイズにまで到達するようにできます。

SET ENV

ENVFILE DD名を指定します。この値は初期設定です。変更しないでください。

SET CEE

LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language EnvironmentはCRMの実行に必要です。
注意: これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CEE行を非コメント化し、STEPLIB連結を調整します。

SET CBC

C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。
リスト3-1 CRMコマンド用のサンプルcrmstart.jcl
//***************************************************************
//* THIS JOB IS USED TO RUN THE CRM PROCESS. *
//* *
//* @(#)$Id: crmstart.jcl,v 1.3 2001/05/07 23:41:27 crount Exp $*
//* Copyright (c)2000 BEA Systems, Inc., all rights reserved. *
//***************************************************************
//* YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY SNACRM *
//***************************************************************
//***************************************************************
//* USE THE SET STATEMENTS TO SET THE APPROPRIATE VALUES *
//* STARTCMD IS THE CRM COMMAND LINE *
//* OBJLIB IS THE LOAD LIBRARY CONTAINING THE PROGRAM EXECUTABLES*
//* DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES *
//* ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS *
//* RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS (OPTIONAL) *
//* SIZE SETS THE REGION SIZE FOR THE SNACRM PROCESS. 0M SETS NO *
//* LIMITS ON THE REGION SIZE *
//* TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT *
//* IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION *
//* CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY *
//* CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY *
//***************************************************************
// SET STARTCMD='"//<address>:<port>" <group>'
// SET OBJLIB=
// SET DATA=
// SET ENVFILE=ENV
// SET RUNOPTS=
// SET SIZE=0M
// SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRM EXEC PGM=CRM,REGION=&SIZE,
// PARM='POSIX(ON) &ENV &RUNOPTS/&STARTCMD'
//STEPLIB DD DSN=&OBJLIB,DISP=SHR
//* DD DSN=&CEE..SCEERUN,DISP=SHR
//* DD DSN=&CBC..SCLBDLL,DISP=SHR
//MSGFILE DD SYSOUT=*
//TRACE DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//ENV DD DSN=&DATA(&ENVFILE),DISP=SHR
//

 


CRM Monitorの使用

CRM Monitorは、グラフィカル・ユーザー・インタフェース(GUI)を介したCRMサーバーへの接続および監視を可能にするJavaアプリケーションです。CRM Monitorを使用してリンク・ステータスやアクティビティの監視、およびCRMサーバーの診断トレーシングの開始または停止ができます。CRM Monitorでは、リモートのCRMサーバーへのネットワーク接続をTCP/IPネットワーク接続を介して行います。CRM Monitorはメインフレーム上ではなく、Gatewayとともにインストールされます。

WindowsデスクトップからのCRM Monitorの起動

CRM MonitorがWindows上にインストールされている場合は、Oracle Tuxedo Mainframe Adapter for SNAのインストール時にデスクトップの「スタート」メニュー内にショート・カットが作成されます。

デスクトップからCRM Monitorを起動するには、次のようにします。

コマンド・ラインからのCRM Monitorの起動

CRM Monitorは、UNIXのコマンド・ラインからも起動できます。

プラットフォーム。

コマンド・ラインからCRM Monitorを起動するには、次のようにします。

CRM Monitorオプションの設定

図3-1に、CRM Monitorの表示例を示します。

図3-1 CRM Monitorの表示

CRM Monitorの表示

CRM Monitorの起動後、次の指示に従ってCRM Monitorオプションを設定します。

  1. CRMを監視するには、CRMアドレスを入力テキスト・ボックスにCRMアドレスを次の形式で入力します。
  2. //host:port

    この場合、host はCRMホスト・マシンを明示的に指定し、portはCRMホスト・マシン上のCRMのポート数を指定します。

    この値は、CRM Monitorの起動インスタンスごとに1回のみ入力できます。

  3. 次のCRMのトレース・オプションのうち、1つを選択します。
    • CRMトレースを停止: CRMトレーシングを無効化し、トレース・ファイルが存在する場合はそれを閉じます。CRMコマンドの「トレース・オプション」の項で説明しているように、このオプションは、トレース・レベル0です。
    • 最小限のCRMトレースを設定: 主要イベントのみのトレーシングを設定します。このレベルはアプリケーションの会話のシーケンスを決定するだけには十分です。CRMコマンドの「トレース・オプション」の項で説明しているように、このオプションは、トレース・レベル1です。
    • 中レベルのCRMトレースを設定: 主要イベントおよびすべてのI/Oバッファのトレーシングを設定します。CRMコマンドの「トレース・オプション」の項で説明しているように、このオプションは、トレース・レベル2です。
    • 最大のCRMトレースを設定: 主要イベント、すべてのI/Oバッファ、およびすべてのAPPC動詞のトレーシングを設定します。CRMコマンドの「トレース・オプション」の項で説明しているように、このオプションは、トレース・レベル3です。
    • 注意: CRM Monitorではトレース・データは表示されません。このデータは、CRMサーバーのAPPDIRディレクトリ下のファイル内に格納されます(APPDIRはCRMディレクトリと関連付けられている変数の名前です)。トレース・ファイルの場所および解釈方法のご質問は、オラクル社カスタマー・サポートにお問い合せください。
      注意: CRMトレースの時間タグ情報は、現在のシステムの時間を反映します。UNIXおよびMVSシステムで正しいタイム・ゾーンが使用されるようにするには、TZ環境変数が正しく設定されていることが重要です。システムでこの変数が正しく設定されていない場合、詳細はシステムのドキュメントを参照してください。
  4. 次のAPPCスタック・トレース・オプションのうち、1つを選択します。
    • APPCスタック・トレースの開始: APPCスタックのトレーシングを設定します。このオプションは一般に、すべてのAPIコールのパラメータおよび結果を表示します。使用されるスタックによっては、ベンダー指定の環境変数など、他のオプションをアクティブ化する必要がある場合があります。このオプションは「CRM」の項で説明している-sオプションに対応します。
    • APPCスタック・トレースを停止: APPCスタック・トレースが設定されている場合は、これを無効化します。
    • 注意: CRMおよびAPPC Stack APIトレース・オプションはCRMコマンドからでも設定できます。トレース・オプションの詳細は、「CRM」の項を参照してください。
  5. CRMアドレスを入力し、トレース・オプションを選択した後、次のフィールドに、監視しているCRMに関する情報が表示されます。
  6. 表示フィールド
    説明
    選択されているCRM
    アドレス・フィールドで入力したアドレスにあるCRMの名前が表示されます。
    トレース・ステータス
    現在選択されているトレース・オプションが表示されます。
    リンク・ステータス
    選択されているCRMのすべてのリモート・リンクに関する現在のステータスが表示されます(テキストはスクロールされる場合があります)。
    リンクの統計
    選択されているCRMのすべてのリモート・リンクに関する現在の統計が表示されます(テキストはスクロールされる場合があります)。
    メッセージ行
    自動接続の試行結果またはトレース・オプションの変更のために発行されたコマンドのいずれかを示すメッセージが表示されます。

 


リンクのアクティブ化および非アクティブ化

コマンド・ラインからいずれかのリンク・コマンドを1つ実行して、DMCONFIGファイルのDM_SNALINKSセクションで定義されているCRMリンクをアクティブ化および非アクティブ化できます。リンクのアクティブ化および非アクティブ化に使用されるコマンドには次の2つがあります。

z/OS多重仮想記憶(MVS)プラットフォーム上でジョブ制御言語(JCL)を使用して環境設定およびリンク・コマンドの起動を行うこともできます。次の項で、MVSオペレーティング・システムで使用可能なリンク・コマンドおよびサンプルのJCLについて説明します。

crmlkonコマンド

crmlkonコマンドは1つ以上の指定CRMリンクを起動します。

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

次に、crmlkonコマンド・ラインの例を示します。

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

次に、コマンド・ライン・オプションについて説明します。

コマンドライン・オプション

次の表で、crmlkonコマンドに有効なオプションについて説明します。

表3-2 crmlkonコマンド・オプション
キーワード
デフォルト値
必須/
省略可能
説明
-n<hostname:port>
なし
必須
CRMサーバーを実行しているマシンおよびポートを指定します。
-v
Off
省略可能
詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。
-i
Off
省略可能
エラーを無視します。複数のリンクを指定した場合、CRMコマンドの発行時にエラーが発生すると、crmlkonはリンクの処理を停止し、戻ります。エラーはリンクごとに無視でき、続けて次の指定リンクを処理できます。
<linkname>
なし
必須
起動するリンクを指定します。これは、このリンクを定義するgwsnax.cfg内のDM_SNALINKSエントリです。複数のリンク名を指定できます。
-u<keyfile>
なし
省略可能
CRMとともに使用される認証名が含まれているキー・ファイルを指定します。

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

crmlkon -n mach1:5000 link2 cicstest

診断

crmlkonはコマンドの構文のみをチェックします。CRM Monitorを使用してリンクが実際にアクティブ化されたかどうかを確認します。詳細は「CRM Monitorオプションの設定」を参照してください。コマンドがCRMに送信されなかった場合は、crmlkonは、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmlkonはコード0で終了します。

crmlkonコマンド用のサンプルJCL

この項では、crmlkonコマンドを実行する際に使用可能なSETコマンドの説明およびJCLの例を示します。サンプルのSETコマンドは、ご使用のシステムの構成を反映していない場合があります。ご使用の環境に合わせてSETコマンドをカスタマイズする必要があります。特定の設定に関する詳細は、システム管理者に問い合せてください。

SET LINKCMD

crmlkonコマンド・ライン・パラメータを設定します。このコマンド・ライン・パラメータの詳細は、「crmlkonコマンド」を参照してください。

SET OBJLIB

crmlkon実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。

SET DATA

ENVFILEを含むデータセットを指定します。

SET ENVFILE

CRMLKONの環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENVは製品に同梱されています。

SET SIZE

crmlkonタスクの実行用の領域サイズを定義します。

SET ENV

ENVFILE DD名を指定します。この値は初期設定です。

SET CEE

LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language Environmentはcrmlkonの実行に必要です。

SET CBC

C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。

注意: これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC行を非コメント化し、STEPLIB連結を調整します。
リスト3-2 crmlkonコマンド用サンプルJCL
//***************************************************************
//* THIS JOB IS USED FOR THE STAND-ALONE LINK COMMAND *
//* TO ACTIVATE A REMOTE LINK. SEE USER GUIDE FOR MORE INFO *
//* *
//* @(#)$Id: crmlkon.jcl,v 1.10 2001/05/07 23:41:27 crount Exp $ *
//* Copyright (c)2000 BEA Systems, Inc., all rights reserved. *
//***************************************************************
//* YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLKON *
//***************************************************************
//***************************************************************
//* LINKCMD INDICATES THE DISTRIBUTED SNACRM ADDRESS AND LINKNAME*
//* OBJLIB IS THE LOAD LIBRARY CONTAINING THE TUXEDO MAINFRAME *
//* ADAPTER FOR SNA PROGRAM OBJECTS *
//* RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS *
//* DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES *
//* ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS *
//* SIZE SETS THE REGION SIZE FOR THE SNACRM PROCESS *
//* TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT *
//* IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION *
//* CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY *
//* CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY *
//***************************************************************
// SET LINKCMD='-n<host name>:<port> <linkname>'
// SET OBJLIB=
// SET RUNOPTS=
// SET DATA=
// SET ENVFILE=ENV
// SET SIZE=1M
// SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRMLKON EXEC PGM=CRMLKON,REGION=&SIZE,
// PARM='POSIX(ON) &ENV &RUNOPTS/&LINKCMD'
//STEPLIB DD DSN=&OBJLIB,DISP=SHR
//* DD DSN=&CEE..SCEERUN,DISP=SHR
//* DD DSN=&CBC..SCLBDLL,DISP=SHR
//ENV DD DSN=&DATA(&ENVFILE),DISP=SHR
//MSGFILE DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//

crmlkoffコマンド

crmlkoffコマンドは1つ以上の指定CRMリンクを停止します。

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

次に、crmlkoffコマンド・ラインの例を示します。

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

コマンドライン・オプション

次の表で、crmlkoffコマンドに有効なオプションについて説明します。

表3-3 crmlkoffコマンド・オプション
キーワード
デフォルト値
必須/
省略可能
説明
-n<hostname:
port>
なし
必須
CRMサーバーを実行しているマシンおよびポートを指定します。
-v
Off
省略可能
詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。
-i
Off
省略可能
エラーを無視します。複数のリンクを指定した場合、CRMコマンドの発行時にエラーが発生すると、crmlkonはリンクの処理を停止し、戻ります。エラーはリンクごとに無視でき、続けて次の指定リンクを処理できます。
-h
なし
省略可能
このコマンドのヘルプを表示します。
-u<keyfile>
なし
省略可能
CRMとともに使用される認証名が含まれているキー・ファイルを指定します。
<linkname>
なし
必須
停止するリンクを指定します。これは、このリンクを定義するDMCONFIG内のDM_SNALINKSエントリです。複数のリンク名を指定できます。

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

crmlkoff -n mach:5000 link1 cicstest

診断

crmlkoffはコマンドの構文のみをチェックします。CRM Monitorを使用してリンクが実際にアクティブ化されたかどうかを確認します。詳細は「CRM Monitorオプションの設定」を参照してください。コマンドがCRMに送信されなかった場合は、crmlkoffは、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmlkoffはコード0で終了します。

crmlkoffコマンド用のサンプルJCL

この項では、crmlkoffコマンドを実行する際に使用可能なSETコマンドの説明およびJCLの例を示します。サンプルのSETコマンドは、ご使用のシステムの構成を反映していない場合があります。ご使用の環境に合わせてSETコマンドをカスタマイズする必要があります。特定の設定に関する詳細は、システム管理者に問い合せてください。

SET LINKCMD

crmlkoffコマンド・ライン・パラメータを設定します。このコマンド・ライン・パラメータの詳細は、「crmlkonコマンド」を参照してください。

SET OBJLIB

crmlkoff実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。

SET DATA

ENVFILEを含むデータセットを指定します。

SET ENVFILE

crmlkoffの環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENVは製品に同梱されています。

SET SIZE

crmlkoffタスクの実行用の領域サイズを定義します。

SET ENV

ENVFILE DD名を指定します。

SET CEE

Language Environment(LE)ランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM LEデータ・セットの接頭辞に設定する必要があります。Language Environmentはcrmlkoffの実行に必要です。

SET CBC

C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。

注意: これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC行を非コメント化し、STEPLIB連結を調整します。
リスト3-3 crmlkoffコマンド用サンプルJCL
//***************************************************************
//* THIS JOB IS USED FOR THE STAND-ALONE LINK COMMAND *
//* TO DEACTIVATE A REMOTE LINK. SEE USER GUIDE FOR MORE INFO *
//* *
//* @(#)$Id: crmlkoff.jcl,v 1.10 2001/05/07 23:41:27 crount Exp $*
//* Copyright (c)2000 BEA Systems, Inc., all rights reserved. *
//***************************************************************
//* YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLKOFF *
//***************************************************************
//***************************************************************
//* LINKCMD INDICATES THE DISTRIBUTED SNACRM ADDRESS AND LINKNAME*
//* OBJLIB IS THE LOAD LIBRARY CONTAINING THE TUXEDO MAINFRAME *
//* ADAPTER FOR SNA PROGRAM OBJECTS *
//* RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS *
//* DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES *
//* ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS *
//* SIZE SETS THE REGION SIZE FOR THE SNACRM PROCESS *
//* TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT *
//* IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION *
//* CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY *
//* CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY *
//***************************************************************
// SET LINKCMD='-n<host name>:<port> <linkname>'
// SET OBJLIB=
// SET RUNOPTS=
// SET DATA=
// SET ENVFILE=ENV
// SET SIZE=1M
// SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRMLKOFF EXEC PGM=CRMLKOFF,REGION=&SIZE,
// PARM='POSIX(ON) &ENV &RUNOPTS/&LINKCMD'
//STEPLIB DD DSN=&OBJLIB,DISP=SHR
//* DD DSN=&CEE..SCEERUN,DISP=SHR
//* DD DSN=&CBC..SCLBDLL,DISP=SHR
//ENV DD DSN=&DATA(&ENVFILE),DISP=SHR
//MSGFILE DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//

 


CRMログ・ファイルの確認

CRMLOGSコマンドまたはCRMLOGS JCLを使用して、CRMログ・ファイルの内容および状態を表示できます。

CRMLOGSコマンド

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

コマンドライン・オプション

次の表で、CRMLOGSコマンドに有効なオプションについて説明します。

表3-4 CRMLOGSコマンド・オプション
キーワード
デフォルト値
必須/
省略可能
説明
グループ
なし
必須
SNAドメインのグループ名です。
crm name
デフォルトのCRM
省略可能
CRM名です。

dalvs5:8002およびGROUP2のCRMログ・ファイルの内容および状態を表示するには、次のコマンドを使用します。

CRMLOGS GROUP2 dalvs5:8002

診断

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

CRMLOGSコマンド用のサンプルJCL

次の項では、CRMLOGSコマンドを実行する際に使用可能なSETコマンドの説明およびJCLの例を示します。

SET LNKCMD

CRMLOGSコマンド・ラインのパラメータを設定します。

SET OBJLIB

CRMLOGS実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。

SET DATA1

CRMLOGS必須のパラメータ・ファイルFMBがインストールされていたPDSライブラリの名前を指定します。

SET DATA2

ENVFILEを含むデータセットを指定します。

SET ENVFILE

CRMLOGSの環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENVは製品に同梱されています。

SET SIZE

CRMLOGSタスクの実行用の領域サイズを定義します。

SET ENV

ENVFILE DD名を指定します。

SET CEE

LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language EnvironmentはCRMLOGSの実行に必要です。

SET CBC

C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。

リスト3-4 CRMLOGSコマンド用サンプルJCL
//***************************************************************
//* THIS JOB IS USED TO CHECK THE RECOVERY LOGS FOR *
//* OUTSTANDING TRANSACTION DATA. SEE USER GUIDE FOR MORE INFO *
//* *
//* @(#)$Id: crmlogs.jcl,v 1.6 2001/05/07 23:41:27 crount Exp $ *
//* Copyright (c)2000 BEA Systems, Inc., all rights reserved. *
//***************************************************************
//* YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLOGS *
//***************************************************************
//***************************************************************
//* SNACMD IS USED TO SET THE DESIRED SNACRM GROUP NAME *
//* OBJLIB IS THE LOAD LIBRARY CONTAINING THE TMA SNA PROGRAM *
//* OBJECTS RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS (OPTIONAL)*
//* DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES *
//* ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS *
//* SIZE SETS THE REGION SIZE FOR THE SNACRM PROCESS *
//* ENV SETS THE ENVIRONMENT VARIABLES DD NAME *
//* TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT *
//* IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION *
//* CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY *
//* CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY *
//***************************************************************
// SET LOGSCMD=<group>
// SET OBJLIB=
// SET DATA=
// SET ENVFILE=ENV
// SET RUNOPTS=
// SET SIZE=10M
// SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRMLOGS EXEC PGM=CRMLOGS,REGION=&SIZE,
// PARM='POSIX(ON) &ENV &RUNOPTS/&LOGSCMD'
//STEPLIB DD DSN=&OBJLIB,DISP=SHR
//* DD DSN=&CEE..SCEERUN,DISP=SHR
//* DD DSN=&CBC..SCLBDLL,DISP=SHR
//MSGFILE DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//ENV DD DSN=&DATA(&ENVFILE),DISP=SHR
//

 


CRMの停止

z/OS CRMは、Gatewayが異常終了またはtmshutdownコマンドで終了されても起動し続けます。

CRMは次の方法で停止できます。

crmdownコマンド

crmdownコマンドは、コマンド・ラインで指定されているCRMを停止します。

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

次に、crmdownコマンド・ラインの例を示します。

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

コマンドライン・オプション

次の表で、crmdownコマンドに有効なオプションについて説明します。

表3-5 crmdownコマンド・オプション
キーワード
デフォルト値
必須/
省略可能
説明
-n<hostname:port>
なし
必須
CRMサーバーを実行しているマシンおよびポートを指定します。
-v
Off
省略可能
詳細を指定します。スクリプト内で容易に使用できるように、通常、このコマンドではメッセージは生成されません。
-i
Off
省略可能
エラーを無視します。複数のリンクを指定した場合、CRMコマンドの発行時にエラーが発生すると、crmlkonはリンクの処理を停止し、戻ります。エラーはリンクごとに無視でき、続けて次の指定リンクを処理できます。
-h
なし
省略可能
このコマンドのヘルプを表示します。
-u<keyfile>
なし
省略可能
CRMとともに使用される認証名が含まれているキー・ファイルを指定します。

ポート5000のmach1で動作しているCRMを停止するには、次のコマンドを使用します。

crmdown -n mach1:5000

診断

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

CRMDOWNコマンド用のサンプルJCL

この項では、crmdownコマンドを実行する際に使用可能なSETコマンドの説明およびJCLの例を示します。

SET STOPCMD

crmdownコマンド・ラインのパラメータを設定します。

SET OBJLIB

crmdown実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。

SET DATA

ENVFILEを含むデータセットを指定します。

SET ENVFILE

crmdownの環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENVは製品に同梱されています。

SET SIZE

crmdownタスクの実行用の領域サイズを定義します。

SET ENV

ENVFILE DD名を指定します。

SET CEE

LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language Environmentはcrmdownの実行に必要です。

SET CBC

C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。
注意: これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC行を非コメント化し、STEPLIB連結を調整します。
リスト3-5 crmdownコマンド用サンプルJCL
//***************************************************************
//* THIS JOB IS USED FOR THE STAND-ALONE COMMAND USED *
//* TO SHUTDOWN THE SNACRM PROCESS. SEE USER GUIDE FOR MORE INFO *
//* *
//* @(#)$Id: crmdown.jcl,v 1.5 2001/05/07 23:41:27 crount Exp $ *
//* Copyright (c)2000 BEA Systems, Inc., all rights reserved. *
//***************************************************************
//* YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMDOWN *
//***************************************************************
//***************************************************************
//* STOPCMD INDICATES THE COMMAND LINE FOR CRMDOWN *
//* OBJLIB IS THE LOAD LIBRARY CONTAINING THE PROGRAM EXECUTABLES*
//* RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS (OPTIONAL) *
//* DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES *
//* ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS *
//* SIZE SETS THE REGION SIZE FOR THE SNACRM PROCESS *
//* *
//* TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT *
//* IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION *
//* CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY *
//* CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY *
//***************************************************************
// SET STOPCMD='-n<host name>:<port>'
// SET OBJLIB=
// SET RUNOPTS=
// SET DATA=
// SET ENVFILE=ENV
// SET SIZE=1M
// SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRMDOWN EXEC PGM=CRMDOWN,REGION=&SIZE,
// PARM='POSIX(ON) &ENV &RUNOPTS/&STOPCMD'
//STEPLIB DD DSN=&OBJLIB,DISP=SHR
//* DD DSN=&CEE..SCEERUN,DISP=SHR
//* DD DSN=&CBC..SCLBDLL,DISP=SHR
//ENV DD DSN=&DATA(&ENVFILE),DISP=SHR
//MSGFILE DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//

  先頭に戻る       前  次