Java 言語 XML スキーマ・リポジトリー・ストアード・プロシージャーの WLM 環境および JCL 始動プロシージャーの定義
XML スキーマ検証ストアード・プロシージャー XSR_COMPLETE は Java で書かれており、その他の Java ルーチンと WLM 環境を共有できます。WLM 環境の始動のために調整された JCL プロシージャーが必要です。
このタスクについて
インストール・ジョブ DSNTIJRW で実行されるタスクの 1 つに、WLM 環境をデフォルト名 DSNWLM_JAVA でインストールするプログラムを呼び出すことがあります。このインストール・プロセスでは、DSNWLM_JAVA を使用して XML スキーマ・リポジトリー・ストアード・プロシージャー XSR_COMPLETE を呼び出すことができるように、この DSNWLM_JAVA が構成されます。インストール・ジョブ DSNTIJMV で実行されるタスクの 1 つに、この WLM 環境用の WLM 始動プロシージャー ssnmWLMJ をインストールすることがあります。
事前定義の設定では対応できず WLM 環境または開始プロシージャーを変更する必要がある場合にのみ、以下の手順に従ってください。
手順
XSR_COMPLETE 用の WLM 環境および JCL 始動プロシージャーをセットアップするには、以下の手順に従います。
- TSO セッションで IWMARIN0 ユーティリティーを開始します。
例えば ISPF コマンド・シェルで次のように入力します。
EXEC 'SYS1.SBLSCLI0(IWMARIN0)' - 「WLM ISPF Choose Service Definition」メニューで、現在の WLM サービス定義セットアップに応じてオプション 1 またはオプション 2 を選択します。詳しくは、サービス定義に関する WLM 資料を参照してください。
- 「Application Environment Selection List」パネルで DSNWLM_JAVA の横に 3 (変更) と入力します。
- 「WLM ISPF Definition Menu」パネルでオプション 9 (アプリケーション環境) を選択します。
- 「Modify an Application Environment」パネルに、値が次のように表示されます。
Application-Environment Notes Options Help -------------------------------------------------------------------------- Modify an Application Environment Command ===> ____________________________________________________________ Application Environment Name . : DSNWLM_JAVA Description . . . . . . . . . . Environment for Java procedures Subsystem Type . . . . . . . . . DB2 Procedure Name . . . . . . . . . DSNWLMJ Start Parameters . . . . . . . . DB2SSN=&IWMSSNM,APPLENV='DSNWLM_JAVA' ________________________________________ Starting of server address spaces for a subsystem instance: 1 1. Managed by WLM 2. Limited to a single address space per system 3. Limited to a single address space per sysplex- Subsystem Type
- DB2 を指定します。
- Procedure Name
- このアプリケーション環境に関連付けられているストアード・プロシージャー・アドレス・スペースの JCL 始動プロシージャーの名前に一致する名前を指定します。
- Start Parameters
- ストアード・プロシージャーが実行される Db2® サブシステムが シスプレックスに存在しない場合、その Db2 サブシステムの名前に一致する DB2SSN 値を指定します。 同一の JCL が複数の Db2 サブシステムに使用されている場合は、DB2SSN=&IWMSSNM を指定してください。アプリケーション環境名フィールドに指定した値に一致する APPLENV 値を指定します。
- Starting of server address spaces for a subsystem instance
- 1 (WLM が管理元) または 2 (システムごとに単一アドレス・スペース に限定) を指定します。
- WLM アプリケーション環境に関連付けられたストアード・プロシージャー・アドレス・スペースの事前定義 JCL 始動プロシージャーを変更します。
インストール・プロセスにより、次に示すような JCL 始動プロシージャーが作成されます。
//DSNWLMJ PROC APPLENV=DSNWLM_JAVA, 1 // DB2SSN=DSN,RGN=0K,NUMTCB=5 2 //IEFPROC EXEC PGM=DSNX9WLM,REGION=&RGN,TIME=NOLIMIT, // PARM='&DB2SSN,&NUMTCB,&APPLENV' //STEPLIB DD DISP=SHR,DSN=CEE.SCEERUN 3 // DD DISP=SHR,DSN=DSNB10.SDSNEXIT // DD DISP=SHR,DSN=DSNB10.SDSNLOAD // DD DISP=SHR,DSN=DSNB10.SDSNLOD2 //JAVAENV DD DISP=SHR, 4 // DSN=DSNB10.DSNWLMJ.JAVAENV //JSPDEBUG DD SYSOUT=* 5 //JAVAOUT DD PATH='/tmp/javaout.txt', 6 // PATHOPTS=(ORDWR,OCREAT,OAPPEND), // PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP,SIROTH,SIWOTH) //JAVAERR DD PATH='/tmp/javaerr.txt', // PATHOPTS=(ORDWR,OCREAT,OAPPEND), // PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP,SIROTH,SIWOTH)注:
1 この行のプロシージャー名は、「Create an Application Environment」パネルまたは「Modify an Application Environment」パネルの「Procedure Name」の値と同じにする必要があります。APPLENV 値は、「Create an Application Environment」パネルまたは「Modify an Application Environment」パネルの「Application Environment Name」の値と同じにする必要があります。 「Create an Application Environment」パネルまたは「Modify an Application Environment」パネルの「Start Parameters」フィールドに APPLENV パラメーターが示されている場合、「Start Parameters」フィールドの APPLENV パラメーター値によって JCL 始動プロシージャーのこのパラメーターの値がオーバーライドされます。 2 この行の DB2SSN 値は、ご使用の Db2 for z/OS® サブシステム名と同じにする必要があります。NUMTCB の最大値は 5 です。 3 STEPLIB により、ストアード・プロシージャーの実行に必要な Db2 データ・セットおよび言語処理環境® データ・セットが指定されます。少なくとも、言語処理環境のランタイム・データ・セット SCEERUN と、(DSNX9WLM プログラムを含む) SDSNLOAD データ・セットが必要です。 SDSNLOD2 には JDBC および SQLJ ダイナミック・リンク・ライブラリー (DLL) が含まれています。 4 JAVAENV は、Java ストアード・プロシージャー用の言語処理環境の実行時オプションが含まれるデータ・セットを指定します。 この DD ステートメントが指定されていることで、Db2 に対し、この WLM 環境が Java ルーチン用の環境であることが示されます。このデータ・セットには、環境変数 JAVA_HOME が含まれている必要があります。この環境変数は、Db2 に対し、WLM 環境が Java ルーチン用であることを示します。また JAVA_HOME は、SDK for Java が含まれているディレクトリー・セットの最上位ディレクトリーを指定します。 5 Db2 が、ストアード・プロシージャーのデバッグに使用できる情報を格納する宛先を指定します。Db2 により収集される情報はセットアップの問題のデバッグを支援するものであり、IBM® ソフトウェア・サポートの指示のもとでのみ使用してください。実稼働環境ではこの DD ステートメントをコメント化してください。 6 ストアード・プロシージャーのデバッグに使用できる情報が Java ランタイム環境によって格納される場所となる、HFS ファイルを指定します。 この情報は、セットアップの問題のデバッグを支援するものです。実稼働環境ではこれらの DD ステートメントをコメント化してください。 - インストール・プロセスにより作成された言語処理環境の実行時オプション・データ・セット (JAVAENV データ・セット)、_CEE_ENVFILE ファイル、および JVMPROPS ファイルを変更します。
これらのデータ・セットのデフォルト名は、次のとおりです。
データ・セット・タイプ デフォルト名 JAVAENV DSNB10.DSNWLMJ.JAVAENV _CEE_ENVFILE /usr/lpp/db2b10/base/classes/dsnenvfile.txt JVMPROPS /usr/lpp/java/properties/dsnjvmsp 言語処理環境の実行時オプション・データ・セットの名前は、WLM アプリケーション環境に関連付けられているストアード・プロシージャー・アドレス・スペース用の JCL 始動プロシージャー内の JAVAENV DD ステートメントで指定されるデータ・セット名と同じでなければなりません。
インストール・プロセスでは以下のような JCL を使用して、言語処理環境の実行時オプション・データ・セットを割り振り、それにデータを入れます。
入力データ・セットには順序番号を含めないでください。カラム 72 より後にはテキストを追加しないでください。
//DSNTIJJ EXEC PGM=IEBGENER //SYSIN DD DUMMY //SYSPRINT DD SYSOUT=* //SYSUT2 DD DSN=DSNB10.DSNWLMJ.JAVAENV, 1 // DISP=(,CATLG,DELETE), // UNIT=SYSDA,SPACE=(TRK,1), // DCB=(RECFM=VB,LRECL=255) //SYSUT1 DD * ENVAR("_CEE_ENVFILE=/usr/lpp/db2b10/base/classes/dsnenvfile.txt", 2 "DB2_BASE=/usr/lpp/db2b10/base", 3 "JCC_HOME=/usr/lpp/db2b10/jdbc", 4 "JAVA_HOME=/usr/lpp/java150/J5.0", 5 "JVMPROPS=/usr/lpp/java/properties/dsnjvmsp"), 6 MSGFILE(JSPDEBUG,,,,ENQ), 7 XPLINK(ON) 8インストール・プロセスは、次の例のような JCL を使用して _CEE_ENVFILE ファイルの割り振りとデータの追加を行います。
//DSNTIJR EXEC PGM=IEBGENER //SYSIN DD DUMMY //SYSPRINT DD SYSOUT=* //SYSUT2 DD PATH='/usr/lpp/db2b10/base/classes/dsnenvfile.txt', 9 // FILEDATA=TEXT, // PATHDISP=(KEEP,DELETE), // PATHOPTS=(OWRONLY,OCREAT,OEXCL), // PATHMODE=(SIRWXU,SIRGRP) //SYSUT1 DD * CLASSPATH=/usr/include/java_classes/gxljapi.jar 10 LIBPATH=/usr/lib/java_runtime 11 STEPLIB=DSNB10.SDSNLOAD 12インストール・プロセスは、次の例のような JCL を使用して JVMPROPS ファイルの割り振りとデータの追加を行います。
//DSNTIJS EXEC PGM=IEBGENER //SYSIN DD DUMMY //SYSPRINT DD SYSOUT=* //SYSUT2 DD PATH='/usr/lpp/java/properties/dsnjvmsp', 13 // FILEDATA=TEXT, // PATHDISP=(KEEP,DELETE), // PATHOPTS=(OWRONLY,OCREAT,OEXCL), // PATHMODE=(SIRWXU,SIRGRP) //SYSUT1 DD * # Sets the initial size of middleware heap within non-system heap #-Xms64M # Sets the maximum size of nonsystem heap #-Xmx128M注:
1 これは、言語処理環境の実行時オプション・データ・セットの名前です。 2 この行とこれ以降の行により、言語処理環境の実行時オプション・データ・セットの内容が定義されます。 ご使用の環境に適合しないデータ・セット名をすべて変更します。 言語処理環境の実行時オプション・データ・セットの内容の最大長は 245 バイトです。 ENVAR オプション・ストリングの長さによって、実行時オプション・データ・セットの内容の長さが 245 バイトを超えるよう設定されている場合は、_CEE_ENVFILE ファイルを使用する必要があります (ENVAR パラメーターでこのファイル名を指定します)。 _CEE_ENVFILE は、複数のオプションを含めることができる追加ファイルを指定します。すべての実行時オプションを _CEE_ENVFILE ファイル内に記述できます。 または ENVAR パラメーターでいくつかのオプションを指定し、他のオプションを _CEE_ENVFILE ファイルで指定することもできます。
3 DB2_BASE の値は、Db2 for z/OS コードが含まれている HFS ディレクトリー・セットの最上位ディレクトリーです。 4 JCC_HOME の値は、JDBC ドライバーが含まれているディレクトリー・セットの最上位ディレクトリーです。 5 JAVA_HOME の値は、SDK for Java が含まれているディレクトリー・セットの最上位ディレクトリーです。SYSPROC.XSR_COMPLETE ストアード・プロシージャーを使用するには、 SDK for z/OS, Java 2 Technology Edition V5 以上が必要です。 6 JVMPROPS の値は、ストアード・プロシージャーが実行される JVM の始動オプションが記述された z/OS UNIX システム・サービス ファイルの名前です。 7 MSGFILE は、言語処理環境が実行時診断情報を格納する場所となるデータ・セットの DD 名を指定します。 MSGFILE パラメーターのサブパラメーターはすべてオプションです。1 番目のサブパラメーターは DD 名です。 8 XPLINK(ON) が必要です。 9 PATH の値は、_CEE_ENVFILE の値と同じにする必要があります。 10 CLASSPATH には、z/OS XML システム・サービス XML スキーマ登録用の JAR ファイル (gxljapi.jar) が入っている Java クラスのパスが含まれている必要があります。 11 LIBPATH には Java ネイティブ・ライブラリーのパスが含まれている必要があります。 12 STEPLIB には Db2 for z/OS ランタイム・ライブラリー (SDSNLOAD) が含まれている必要があります。 13 PATH の値は、JVMPROPS の値と同じにする必要があります。