この項の各トピックでは、Oracle Tuxedo Mainframe Adapter for SNAアプリケーションを管理するためにCommunications Resource Manager(CRM)で管理者によって実行されるアクティビティについて説明します。
スタック管理および構成用のインタフェースは、スタック・プロバイダにより異なり、このガイドでは説明していません。ご使用の環境で使用されているスタックに関するベンダー・ドキュメントを参照してください。
CRMはPU 2.1サーバーと直接通信してSNA接続性を提供するサーバーです。これらのサーバーは手動で起動できます。PU 2.1サーバーは、常にCRMの前に起動する必要があります。また、両方のサーバーとも、関連付けられているOracle Tuxedo Mainframe Adapter for SNA Gatewayを起動する前に起動する必要があります。
CRMを適切に起動するには、次のタスクを完了します。このCRMの起動方法は、HP-UX 11.23またはメインフレーム上で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
には、RSTRTLOG
とBLOBLOG
という2種類のログ・ファイルがあり、これらは$APPDIR
内に格納されます。RSTRTLOG
はリカバリ・プロセス中に使用されるトランザクション状態のログであるのに対し、BLOBLOG
ログにはセッションおよびリンク情報が格納されます。ログ・ファイルを削除する場合は、関係するリンクごとにコールド・スタートが必要です。CRMLOGS
コマンドを使用して、CRM
ログ・ファイルのコンテンツおよび状態を表示できます。
CRM
[ -t 0|1|2|3 ] [-p<nbr>] [-s] [-n <type>:#:#] [-u <keyfile>] <addr> <group>
次の表で、CRM
コマンドに有効なオプションについて説明します。
次の項では、CRMの起動用の異なるオプションのうちの3つの例を示します。
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を起動するには次のようなコマンドを使用します。
$ CRM -t 0 //myhost:5587 GROUP2 <dev/null>std.out 2>std.err &
ホスト/ポート・アドレスを使用してコマンド・ラインから詳細トレーシングおよびAPPC Stack APIトレーシングを有効にしてCRMを起動するには、次のようなコマンドを使用します。
CRM -t 2 -s //myhost:5587
z/OS MVSプラットフォームでは、ジョブ制御言語(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
コマンドを実行する際に使用可能なSET
コマンドの説明およびJCLの例を示します。
SET STARTCMD
SET OBJLIB
SET DATA
SET ENVFILE
SET SIZE
SET ENV
SET CEE
CEE
はIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language EnvironmentはCRMの実行に必要です。
注意: | これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CEE 行を非コメント化し、STEPLIB 連結を調整します。 |
SET CBC
//***************************************************************
//* 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は、グラフィカル・ユーザー・インタフェース(GUI)を介したCRMサーバーへの接続および監視を可能にするJavaアプリケーションです。CRM Monitorを使用してリンク・ステータスやアクティビティの監視、およびCRMサーバーの診断トレーシングの開始または停止ができます。CRM Monitorでは、リモートのCRMサーバーへのネットワーク接続をTCP/IPネットワーク接続を介して行います。CRM Monitorはメインフレーム上ではなく、Gatewayとともにインストールされます。
CRM MonitorがWindows上にインストールされている場合は、Oracle Tuxedo Mainframe Adapter for SNAのインストール時にデスクトップの「スタート」メニュー内にショート・カットが作成されます。
デスクトップからCRM Monitorを起動するには、次のようにします。
「プログラム」|「BEA Weblogic E-Business Platform」|
「Oracle Tuxedo Mainframe Adapter for SNA
10g R3」|「CRM Monitor」
の順に選択します。CRM Monitorは、UNIXのコマンド・ラインからも起動できます。
コマンド・ラインからCRM Monitorを起動するには、次のようにします。
図3-1に、CRM Monitorの表示例を示します。
CRM Monitorの起動後、次の指示に従ってCRM Monitorオプションを設定します。
//host:port
この場合、host
はCRMホスト・マシンを明示的に指定し、port
はCRMホスト・マシン上のCRMのポート数を指定します。
この値は、CRM Monitorの起動インスタンスごとに1回のみ入力できます。
0
です。1
です。2
です。3
です。注意: | CRM Monitorではトレース・データは表示されません。このデータは、CRMサーバーのAPPDIR ディレクトリ下のファイル内に格納されます(APPDIR はCRMディレクトリと関連付けられている変数の名前です)。トレース・ファイルの場所および解釈方法のご質問は、オラクル社カスタマー・サポートにお問い合せください。 |
注意: | CRMトレースの時間タグ情報は、現在のシステムの時間を反映します。UNIXおよびMVSシステムで正しいタイム・ゾーンが使用されるようにするには、TZ環境変数が正しく設定されていることが重要です。システムでこの変数が正しく設定されていない場合、詳細はシステムのドキュメントを参照してください。 |
-s
オプションに対応します。注意: | CRMおよびAPPC Stack APIトレース・オプションはCRMコマンドからでも設定できます。トレース・オプションの詳細は、「CRM」の項を参照してください。 |
コマンド・ラインからいずれかのリンク・コマンドを1つ実行して、DMCONFIG
ファイルのDM_SNALINKS
セクションで定義されているCRMリンクをアクティブ化および非アクティブ化できます。リンクのアクティブ化および非アクティブ化に使用されるコマンドには次の2つがあります。
z/OS多重仮想記憶(MVS)プラットフォーム上でジョブ制御言語(JCL)を使用して環境設定およびリンク・コマンドの起動を行うこともできます。次の項で、MVSオペレーティング・システムで使用可能なリンク・コマンドおよびサンプルのJCLについて説明します。
crmlkon
コマンドは1つ以上の指定CRMリンクを起動します。
crmlkon
は、コマンド・ラインで指定されるすべてのCRMリンクを起動します。このコマンドは、CRMサーバーの起動時に個別のリンクが1つ以上起動しない場合に便利です。このコマンドはCRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用できます。スクリプト内で使用でき、コマンドがターゲットCRMに送信されると0
を戻します。コマンドがターゲットCRMに送信されなかった場合は1
を戻します。
crmlkon -n<hostname:port> [-v -i -h -u<keyfile>] <linkname> ...
次の表で、crmlkon
コマンドに有効なオプションについて説明します。
ポート5000のmach1
上で動作するCRMで所有されるlink2
およびcicstest
リンクを起動するには、次のコマンドを使用します。
crmlkon -n mach1:5000 link2 cicstest
crmlkon
はコマンドの構文のみをチェックします。CRM Monitorを使用してリンクが実際にアクティブ化されたかどうかを確認します。詳細は「CRM Monitorオプションの設定」を参照してください。コマンドがCRMに送信されなかった場合は、crmlkon
は、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1
で終了します。正常に完了した場合は、crmlkonはコード0
で終了します。
この項では、crmlkon
コマンドを実行する際に使用可能なSET
コマンドの説明およびJCLの例を示します。サンプルのSET
コマンドは、ご使用のシステムの構成を反映していない場合があります。ご使用の環境に合わせてSET
コマンドをカスタマイズする必要があります。特定の設定に関する詳細は、システム管理者に問い合せてください。
crmlkon
コマンド・ライン・パラメータを設定します。このコマンド・ライン・パラメータの詳細は、「crmlkonコマンド」を参照してください。
crmlkon
実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。
CRMLKON
の環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENV
は製品に同梱されています。
LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language Environmentはcrmlkon
の実行に必要です。
C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBC
はIBM C++データ・セットの接頭辞に設定する必要があります。
注意: | これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC 行を非コメント化し、STEPLIB 連結を調整します。 |
//***************************************************************
//* 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
コマンドは1つ以上の指定CRMリンクを停止します。
crmlkoff
は、コマンド・ラインで指定されるすべてのCRMリンクを停止します。このコマンドは、CRMサーバーの起動時に個別のリンクを1つ以上停止する必要がある場合に便利です。このコマンドはCRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用できます。スクリプト内で使用でき、コマンドがターゲットCRMに送信されると0
を戻します。コマンドがターゲットCRMに送信されなかった場合は1
を戻します。
crmlkoff -n<hostname:port> [-v -i -h -u<keyfile>] <linkname> ...
次の表で、crmlkoff
コマンドに有効なオプションについて説明します。
ポート5000のmach
上で動作するCRMで所有されるlink1
およびcicstest
リンクを停止するには、次のコマンドを使用します。
crmlkoff -n mach:5000 link1 cicstest
crmlkoff
はコマンドの構文のみをチェックします。CRM Monitorを使用してリンクが実際にアクティブ化されたかどうかを確認します。詳細は「CRM Monitorオプションの設定」を参照してください。コマンドがCRMに送信されなかった場合は、crmlkoff
は、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1で終了します。正常に完了した場合は、crmlkoffはコード0で終了します。
この項では、crmlkoff
コマンドを実行する際に使用可能なSET
コマンドの説明およびJCLの例を示します。サンプルのSET
コマンドは、ご使用のシステムの構成を反映していない場合があります。ご使用の環境に合わせてSET
コマンドをカスタマイズする必要があります。特定の設定に関する詳細は、システム管理者に問い合せてください。
crmlkoff
コマンド・ライン・パラメータを設定します。このコマンド・ライン・パラメータの詳細は、「crmlkonコマンド」を参照してください。
crmlkoff
実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。
crmlkoff
の環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENV
は製品に同梱されています。
Language Environment(LE)ランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM LEデータ・セットの接頭辞に設定する必要があります。Language Environmentはcrmlkoff
の実行に必要です。
C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。
注意: | これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC行を非コメント化し、STEPLIB連結を調整します。 |
//***************************************************************
//* 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=*
//
CRMLOGS
コマンドまたはCRMLOGS JCLを使用して、CRMログ・ファイルの内容および状態を表示できます。
CRMLOGS
コマンドを使用して2つのCRM
ログ・ファイルのコンテンツおよび状態を表示します。RSTRTLOG
はリカバリ・プロセス中に使用されるトランザクション状態のログで、BLOBLOG
ログにはセッションおよびリンク情報が格納されます。ログ・ファイルを削除する場合は、関係するリンクごとにコールド・スタートが必要です。
次の表で、CRMLOGS
コマンドに有効なオプションについて説明します。
dalvs5:8002およびGROUP2のCRM
ログ・ファイルの内容および状態を表示するには、次のコマンドを使用します。
CRMLOGSコマンドは正しく完了すると、戻りコード0で終了します。
次の項では、CRMLOGS
コマンドを実行する際に使用可能なSET
コマンドの説明およびJCLの例を示します。
CRMLOGS
実行可能ファイルがインストールされているPDSEライブラリの名前を指定します。
CRMLOGS
必須のパラメータ・ファイルFMBがインストールされていたPDSライブラリの名前を指定します。
CRMLOGS
の環境変数を含むPDSメンバーの名前を指定します。サンプル・メンバーのENV
は製品に同梱されています。
LEランタイム・ライブラリ用の高度な修飾子を指定します。CEEはIBM Language Environmentデータ・セットの接頭辞に設定する必要があります。Language EnvironmentはCRMLOGS
の実行に必要です。
C/C++ランタイム・ライブラリ用の高度な修飾子を指定します。CBCはIBM C++データ・セットの接頭辞に設定する必要があります。
//***************************************************************
//* 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
//
z/OS CRMは、Gatewayが異常終了またはtmshutdown
コマンドで終了されても起動し続けます。
crmdown
コマンドは、コマンド・ラインで指定されているCRMを停止します。
crmdown
は、CRMサーバーを実行しているマシンと同じTCP/IPネットワーク内の任意のマシンから使用できます。スクリプト内で使用した場合、コマンドがターゲットCRMに送信されると0
を戻します。コマンドがターゲットCRMに送信されなかった場合は1
を戻します。
crmdown -n<hostname:port> [-v -i -h -u<keyfile>]
次の表で、crmdown
コマンドに有効なオプションについて説明します。
ポート5000のmach1
で動作しているCRMを停止するには、次のコマンドを使用します。
crmdown -n mach1:5000
crmdown
はコマンドの構文のみをチェックします。コマンドがCRMに送信されなかった場合は、crmdown
は、冗長モードのときはエラー・メッセージをプリントし、エラー・コード1
で終了します。正常に完了した場合は、crmdown
はコード0
で終了します。
この項では、crmdown
コマンドを実行する際に使用可能なSET
コマンドの説明およびJCLの例を示します。
SET STOPCMD
SET OBJLIB
SET DATA
SET ENVFILE
SET SIZE
SET ENV
SET CEE
crmdown
の実行に必要です。
SET CBC
注意: | これらのライブラリがシステムのリンク・ライブラリの連結にない場合は、SET CBC 行を非コメント化し、STEPLIB 連結を調整します。 |
//***************************************************************
//* 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=*
//