z/OS JCL カタログ式プロシージャー

WebSphere® Application Server for z/OS® サーバーは、スタンドアロン・アプリケーション・サーバーおよび Network Deployment セルに、JCL カタログ式プロシージャーを使用します。推奨される命名規則と、WebSphere Application Server for z/OS アドレス・スペースへのユーザー ID の割り当てについて学習します。

注: z/OS オペレーティング・システム上での WebSphere Application Server のカスタマイズ・プロセス中に、プロファイル管理ツール (z/OS のみ) または zpmt.sh コマンドによって、システム・プロシージャー・ライブラリー内にカタログ式プロシージャーをコピーするための、カスタマイズ・ジョブ BBOxPROC が作成されます。 ご使用のサーバーに現在のカタログ式プロシージャーを保持させるために、BBOxPROC ジョブを実行します。 WebSphere Application Server for z/OS バージョン 9.0 のコードを前の各バージョンのカタログ式プロシージャーを使用して実行した場合、サーバーの始動が失敗するおそれがあります。

WebSphere Application Server for z/OS の各サーバーは、 JCL カタログ式プロシージャーを使用します。 これらのプロシージャーはすべてよく似ていて、メインのカタログ式プロシージャーと、 DD ステートメントを含む INCLUDE メンバーで構成されています。以下に、プロファイル管理ツールまたは zpmt コマンドで生成される、コントローラー用のカタログ式プロシージャー・ライブラリー・メンバーの例を示します。

プロシージャー・ライブラリー・メンバー BBO8ACR:
//BBO8ACR  PROC ENV=,PARMS=' ',REC=N,AMODE=00                   
// SET ROOT='/wasv9config/bbobase/bbonode'                      
// SET FOUT='properties/service/logs/applyPTF.out'              
// SET WSDIR='AppServer'                                        
//************************************************************* 
//* Test that OMVS can successfully launch a shell and return *
//************************************************************* 
//TOMVS   EXEC PGM=BPXBATCH,REGION=0M,                          
// PARM='SH exit 13'                                            
//SYSOUT   DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//*********************************************************     
//* If the shell RC code is as expected (13) - proceed    *
//*********************************************************     
//IFTST   IF (RC = 13) THEN                                     
//*********************************************************     
//* Start the Multi-Product PTF Post-Installer            *
//*********************************************************     
//APPLY   EXEC PGM=BPXBATCH,REGION=0M,                          
// PARM='SH &ROOT./&ENV..HOME/bin/applyPTF.sh inline'           
//SYSOUT   DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',                  
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)   
//       IF (APPLY.RC <= 4) THEN                                
//*********************************************************          
//* If the RC from the Post-Installer is LE 4 then start  *
//* the WebSphere Application Server                      *
//*********************************************************          
//STEP1    EXEC PGM=BPXBATA2,REGION=0M,TIME=MAXIMUM,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bbooctlm &AMODE. &PARMS. //REC=&REC' STDENV DD PATH='&ROOT/&ENV/was.env'                      
//*                                                                  
//* Output DDs
//*                                                                  
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//         ENDIF                                                 
//IFTSTEND ENDIF 
プロシージャー・ライブラリー・メンバー BBO8ASR:
//BBO8ASR  PROC ENV=,AMODE=00
//  SET ROOT='/wasv9config/bbobase/bbonode'                         
// SET WSDIR='AppServer'                                        
//STEP1   EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bboosrmr &AMODE.' //STDENV DD PATH='&ROOT/&ENV/was.env'                                
//*                                                                 
//* Output DDs
//*                                                                 
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
カタログ式プロシージャーは、以下のようにプロシージャーが処理される場所を指定します。
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbooctlm ...' (controller)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboosrmr ...' (サーバント)
  • * EXEC PGM=BPXBATSL,PARM='PGM .../bboocram ...' (付属プロセス)
  • * EXEC PGM=BPXBATA2,PARM='PGM .../bbodmnm ...' (ロケーション・サービス・デーモン)
EXEC PGM ステートメントの PARM= パラメーターには、 PGM= パラメーターで識別されるプログラムに渡されるパラメーターが含まれています。
注: 言語環境 (LE) パラメーターを変更するための該当するインターフェースは、was.env ファイルを使用します。ただし、LE パラメーターを変更する場合は、まず IBM® ソフトウェア・サポート・チームに相談してからにしてください。LE パラメーターは、アドレス・スペースで実行される主な LE アプリケーションである WebSphere Application Server の最高のパフォーマンスを確実に実現するために、内部で設定されます。 LE パラメーターを追加または変更する必要がある場合は、IBM ソフトウェア・サポート・チームと連携して、内部で設定されたパラメーターが損なわれないようにする必要があります。

STDENV DD ステートメントは、サーバーの was.env (開始パラメーター) ファイルを指します。このファイルのパスは、 構成 HFS ディレクトリー名 (ROOT JCL 変数を使用してハードコーディング済み) と、 この特定サーバーのシンボリック・リンク (開始時に ENV= パラメーターによって指定) で構成されています。

コントローラーのカタログ式プロシージャーには、BPXBATA2 を呼び出す EXEC ステートメントの前に、追加のステートメントがいくつか組み込まれています。これらは、 ポスト・インストーラー・プログラムの起動に使用されます。このプログラムによって、 製品 HFS とロード・モジュールにサービスが適用されたときに、 構成 HFS とそのホーム・ディレクトリーに、必要な保守が適用されます。

以下のセクションでは、各構成で必要なカタログ式プロシージャーについて説明し、 推奨される命名規則を示して、各サーバーの SAF ユーザー ID の決定方法を説明します。

スタンドアロン・アプリケーション・サーバーのカタログ式プロシージャー

スタンドアロン・アプリケーション・サーバーは、以下のカタログ式プロシージャーを使用します。
  • コントローラーのカタログ式プロシージャー
  • サーバントのカタログ式プロシージャー
  • 付属プロセスのカタログ式プロシージャー
  • ロケーション・サービス・デーモンのカタログ式プロシージャー

両サーバーで構成 HFS と製品コード・レベル (STEPLIB など) が同じであれば、異なるスタンドアロン・サーバーで同じカタログ式プロシージャーを使用することができます。

Network Deployment セルのカタログ式プロシージャー

Network Deployment セルは、以下のカタログ式プロシージャーを使用します。

デプロイメント・マネージャーの場合:
  • デプロイメント・マネージャー・コントローラーのカタログ式プロシージャー
  • デプロイメント・マネージャー・サーバントのカタログ式プロシージャー
個々のアプリケーション・サーバー・ノードの場合:
  • アプリケーション・サーバー・コントローラーのカタログ式プロシージャー (ノード・エージェントでも使用されます)
  • アプリケーション・サーバー・サーバントのカタログ式プロシージャー
  • 付属プロセスのカタログ式プロシージャー
ロケーション・サービス・デーモン (z/OS システムごとに 1 つ) の場合:
  • ロケーション・サービス・デーモンのカタログ式プロシージャー

たいていの場合、ライブラリー (CICS®、DB2® など) を STEPLIB 連結に入れるために変更が必要になるのは、 アプリケーション・サーバー・サーバントのカタログ式プロシージャーのみです。

Network Deployment セルの複数のノード、さらに複数のセルで同じカタログ式プロシージャーを使用することができます (すべてのノードまたはセルの構成 HFS が同じ場合)。

推奨されるカタログ式プロシージャーの命名規則

WebSphere Application Server for z/OS のカタログ式プロシージャーでは、 一貫した命名規則を使用してください。 プロシージャー名によって、WebSphere Application Server for z/OS のバージョン、構成 HFS が区別されます。

次の規則は、スタンドアロン・アプリケーション・サーバーか Network Deployment セルのいずれかに適用することができます。 例えば、cc は 2 文字のセル ID です。
手順 推奨の名前
デプロイメント・マネージャー・コントローラー cc8DCR
デプロイメント・マネージャー・サーバント cc8DSR
ロケーション・サービス・デーモン・コントローラー cc8DMN
アプリケーション・サーバー・コントローラー cc8ACR
アプリケーション・サーバー・サーバント cc8ASR
制御領域付加属性 cc8AAR
シスプレックス内の異なるシステム上のノードで別々のカタログ式プロシージャーが必要な場合 (例えば、非中断の再始動を許容するために独自に設定可能な STEPLIB ステートメントが必要な場合) は、ロケーション・サービス・デーモンおよびアプリケーション・サーバー・プロシージャーをシステム固有の PROCLIB に入れるか、ロケーション・サービス・デーモンおよびアプリケーション・サーバーのカタログ式プロシージャー名に、1 文字のシステム ID を付加します。

ユーザー ID の、 WebSphere Application Server for z/OS アドレス・スペースへの割り当て

z/OS Security Server (RACF®) を、 z/OS で SAF 準拠のセキュリティー・システムとして使用する場合は、 STARTED クラス・プロファイルを使用して、開始済みタスクのユーザー ID を、 WebSphere Application Server for z/OS の各サーバーに割り当てます。 これらの STARTED プロファイルは、プロファイル管理ツールまたは zpmt コマンドによって作成されたバッチ・ジョブによってセットアップされます。 この STARTED プロファイルは、自分で作成したサーバーに適切なユーザー ID を割り当てる場合には、必要に応じて更新します。

コントローラー (デプロイメント・マネージャー、ロケーション・サービス・デーモン、 ノード・エージェント、またはアプリケーション・サーバーのコントローラー) は、 MVS™ コンソールから、 または内部で実行される、コンソールの START コマンドによって開始されます。 これらのサーバーでは、検査される STARTED プロファイル名の形式は、procname.jobname のようになっています。

プロファイル管理ツールまたは zpmt コマンドは、コントローラーまたはデーモン・カタログ式プロシージャーを作成すると必ず、そのカタログ式プロシージャーを使用するすべてのコントローラーを、該当するコントローラー・ユーザー ID と構成グループに関連付ける STARTED プロファイルも作成します。スタンドアロン・アプリケーション・サーバーをデフォルト名でセットアップすると、プロファイル管理ツールまたは zpmt コマンドは、コントローラー用に以下の STARTED プロファイルを作成します。
  • RDEFINE STARTED BBO8ACR.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBO8DMN.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
注: TRACE(YES) は、プロファイルの使用時には必ず、 メッセージ IRR812I を MVS コンソールに書き込みます。

サーバント領域 (アプリケーション・サーバー・サーバントと付属プロセス) は、 ワークロード・マネージャー (WLM) を使用して開始されます。これらのサーバーでは、検査される STARTED プロファイル名の形式は、jobname.jobname のようになっています。

残念ながら、 特定サーバントのカタログ式プロシージャーを使用するすべてのサーバーを、 1 つのサーバント・ユーザー ID に割り当てる方法はありません。そのため、プロファイル管理ツールまたは zpmt コマンドは、 各サーバントおよび各制御領域付属に対して STARTED プロファイルを 1 つ作成します。デフォルト名が選択されている場合は、スタンドアロン・アプリケーション・サーバー用に以下のサーバント STARTED プロファイルが作成されます。
  • RDEFINE STARTED BBOS001S.* STDATA(USER(WSSRU1) GROUP(WSCFG1) TRACE(YES))
  • RDEFINE STARTED BBOS001A.* STDATA(USER(WSCRU1) GROUP(WSCFG1) TRACE(YES))
カタログ式プロシージャーの名前を選択する場合、 サーバーを該当する SAF ユーザー ID にマップするのに適した STARTED プロファイルが用意されていることを確認してください。 STARTED プロファイルを表示するには、 RACF ISPF パネルまたは RLIST STARTED コマンドを使用します。

SAF 準拠の別のセキュリティー・システムを使用する場合は、 セキュリティー・サーバー・ベンダーに連絡して、WebSphere Application Server for z/OS のセットアップ情報を入手してください。


トピックのタイプを示すアイコン 概念トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cins_plancatzos
ファイル名:cins_plancatzos.html