この概要は、WebSphere® Application Server for z/OS® で JCL カタログ式プロシージャーを使用する方法について説明します。
WebSphere Application Server for z/OS の各サーバーは、 JCL カタログ式プロシージャーを使用します。 これらのプロシージャーはすべてよく似ていて、メインのカタログ式プロシージャーと、 DD ステートメントを含む INCLUDE メンバーで構成されています。以下に、 カスタマイズ・ダイアログで生成される、コントローラー用のカタログ式プロシージャー・ライブラリー・メンバーの 例を示します。
//BBO6ASR PROC ENV=,Z=BBO6ASRZ // SET™ ROOT='/WebSphere/V6R1' //BBOSR EXEC PGM=BBOSR,REGION=0M,TIME=NOLIMIT, // PARM='TRAP(ON,NOSPIE),ENVAR("_EDC_UMASK_DFLT=007") /' //BBOENV DD PATH='&ROOT/&ENV/was.env' // INCLUDE MEMBER=&Z
For 64-bit addressability: //BBO6ASR PROC ENV=,Z=BBO6ASRZ,AMODE= // SET ROOT='/WebSphere/V6R1' //STEP1 EXEC PGM=BBOOMTST,PARM='&AMODE' // INCLUDE MEMBER=&Z //TEST1 IF (STEP1.RC = 0) THEN //BBOSR EXEC PGM=BBOSR,REGION=0M,TIME=NOLIMIT, // PARM='TRAP(ON,NOSPIE),ENVAR("_EDC_UMASK_DFLT=007") /' //BBOENV DD PATH='&ROOT/&ENV/was.env' // INCLUDE MEMBER=&Z // ELSE //BBGSR EXEC PGM=BBGSR,REGION=0M,TIME=NOLIMIT,MEMLIMIT=NOLIMIT, // PARM='TRAP(ON,NOSPIE),ENVAR("_EDC_UMASK_DFLT=007") /' //BBOENV DD PATH='&ROOT/&ENV/was.env' // INCLUDE MEMBER=&Z // ENDIF //プロシージャー・ライブラリー・メンバー BBO6ASRZ:
//* //* Output DDs //* //CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //* //*Steplib Setup //* //STEPLIB DD DISP=SHR,DSN=WAS.V61.SBBOLD2 // DD DISP=SHR,DSN=WAS.V61.SBBOLOAD
For 64-bit addressability: //* //* Output DDs //* //CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE //* //*Steplib Setup //* //STEPLIB DD DISP=SHR,DSN=WAS.V61.SBBOLD2 // DD DISP=SHR,DSN=WAS.V61.SBBOLOAD // DD DISP=SHR,DSN=WAS.V61.SBBGLOADカタログ式プロシージャーの EXEC ステートメントの PGM= パラメーターは、 WebSphere Application Server for z/OS サーバーのタイプを指定します。プログラム名は以下のとおりです。
BBOENV DD ステートメントは、 サーバーの was.env (開始パラメーター) ファイルを指します。 このファイルのパスは、 構成 HFS ディレクトリー名 (ROOT JCL 変数を使用してハードコーディング済み) と、 この特定サーバーのシンボリック・リンク (開始時に ENV= パラメーターによって指定) で構成されています。
メインのカタログ式プロシージャー内の INCLUDE ステートメントによって、 INCLUDE メンバー (この場合は BBO6ASRZ) から、すべての JCL ステートメントが組み込まれます。規則では、 INCLUDE メンバーの名前は、メインのカタログ式プロシージャー名の末尾に「Z」の文字を追加したものです。 INCLUDE メンバーは、開始済みタスクに共通の DD ステートメントを提供します。
以下のセクションでは、各構成で必要なカタログ式プロシージャーについて説明し、 推奨される命名規則を示して、各サーバーの SAF ユーザー ID の決定方法を説明します。
Network Deployment セルは、以下のカタログ式プロシージャーを使用し、 そのそれぞれに、対応する INCLUDE JCL メンバーがあります。
両サーバーの構成 HFS と製品コード・レベル (STEPLIB など) が同じであれば、 Network Deployment セルの複数のノードでも、あるいは複数セルに対しても、 同じカタログ式プロシージャーを使用することができます。 カスタマイズ・ダイアログは、同じ名前が使用されていたり、 カスタマイズ・ジョブとファイルが再生成されていたりすれば、 同じ名前の proclib メンバーを上書きします。 したがって、ローカルの STEPLIB が存在する場合や、プロシージャーに他の変更を加える場合は、 カスタマイズ・ダイアログの使用後に、必ずそれらを再適用してください。
WebSphere Application Server for z/OS のカタログ式プロシージャーでは、 一貫した命名規則を使用してください。 プロシージャー名によって、 WebSphere Application Server for z/OS のバージョン、構成 HFS、 および STEPLIB にリストされているデータ・セットが区別されます。 カスタマイズ・ダイアログで、 文字「Z」を付加して INCLUDE JCL メンバー名を作成できるようにするには、 カタログ式プロシージャー名を 7 文字までに制限します。
デプロイメント・マネージャー・コントローラー | cc6DCR |
デプロイメント・マネージャー・サーバント | cc6DSR |
ロケーション・サービス・デーモン・コントローラー | cc6DMN |
アプリケーション・サーバー・コントローラー | cc6ACR |
アプリケーション・サーバー・サーバント | cc6ASR |
制御領域付加属性 | cc6CRA |
z/OS Security Server (RACF®) を、 z/OS で SAF 準拠のセキュリティー・システムとして使用する場合は、 STARTED クラス・プロファイルを使用して、開始済みタスクのユーザー ID を、 WebSphere Application Server for z/OS の各サーバーに割り当てます。 これらの STARTED プロファイルは、 カスタマイズ・ダイアログのバッチ・ジョブによってセットアップされます。この STARTED プロファイルは、 自分で作成したサーバーに適切なユーザー ID を割り当てる場合には、必要に応じて更新します。
コントローラー (デプロイメント・マネージャー、ロケーション・サービス・デーモン、 ノード・エージェント、またはアプリケーション・サーバーのコントローラー) は、 MVS™ コンソールから、 または内部で実行される、コンソールの START コマンドによって開始されます。 これらのサーバーでは、検査される STARTED プロファイル名の形式は、 procname.jobname のようになっています。
サーバント領域 (アプリケーション・サーバー・サーバントと付属プロセス) は、 ワークロード・マネージャー (WLM) を使用して開始されます。これらのサーバーでは、検査される STARTED プロファイル名の形式は、 jobname.jobname のようになっています。
SAF 準拠の別のセキュリティー・システムを使用する場合は、 セキュリティー・サーバー・ベンダーに連絡して、WebSphere Application Server for z/OS のセットアップ情報を入手してください。
非同期の管理用タスクにも、カタログ式プロシージャーが必要です。 この非常に単純なカタログ式プロシージャーには、 STEPLIB も構成 HFS ポインターも組み込まれていません。しかしこれは、 実行されるセルのセキュリティー・ドメインに関連した特定のユーザー ID およびグループの下で実行する必要があるため、 個々のセキュリティー・ドメインまたはセルごとに、別々のカタログ式プロシージャー名を選択する必要があります。
推奨:
管理非同期タスクのカタログ式プロシージャーの名前は、 「cc6SH」にしてください。 ここで、cc は、2 文字のセル ID です。