z/OS 上でのビルド・サーバーの開始

z/OS® 上では、 z/OS ビルドまたは USS ビルドを実行するようにビルド・サーバーを構成できます。両方のビルドが必要な場合は、2 つのサーバーを開始する必要があります。サーバーは、それぞれのタイプに応じた固有の TCP/IP ポート上で listen します。

構文

ビルド・サーバーは、z/OS JCL コマンドを使用して開始します。パラメーター行の構文は、以下のとおりです。


Syntax: // PARM= '-p <portno> [-V ...] [-a {2|1|0} [-n <n>] [-q <q>] [-t]'
ここで、
-p
サーバーがクライアントと連絡するために listen するポート番号 (portno) を指定します。
-V
サーバーの冗長レベルを指定します。このパラメーターは、3 回まで (最大冗長レベル) 指定できます。
-a
以下のように認証モードを指定します。
2
サーバー状態: A (許可)。 サーバー・コードは、APF 許可ライブラリーにインストール済みです。リモートのビルド・クライアントを使用してビルドを開始する場合は、 ビルド記述子オプション destUserID を有効な TSO ユーザー ID で、destPassword を有効な TSO パスワードで指定しなければなりません。 サーバーは、このユーザー ID のアクセスおよび権限の下にビルド・トランザクションを実行します。モード 2 はデフォルトです。
1
サーバー状態: A。有効な TSO ユーザー ID およびパスワードを提供できます。サーバーは、このユーザーのアクセスおよび権限の下にビルド・トランザクションを実行します。ユーザー ID およびパスワードを使用しない場合は、 ビルド・トランザクションは、ビルド・サーバーのジョブに割り当てられたユーザー ID のアクセスおよび権限の下に実行されます。
0
サーバー状態: A または U (不許可)。 U の場合は、APF 許可のビルド・プログラムが失敗します。 TSO ユーザー ID およびパスワードを指定すると、サーバーはそれらを無視し、 ビルド・トランザクションが、ビルド・サーバーのジョブに割り当てられたユーザー ID のアクセスおよび権限の下に実行されます。
モード 1 および 2 は、サーバーのロード・モジュールが APF 許可ライブラリーから実行されている場合にのみ使用できます。
-n
並行ビルドの数を指定します。デフォルトは 1 です。許可したい並行ビルドの数と等しくなるように n を設定します。並行ビルドが n の数だけ実行されている場合は、 ビルド・サーバーは、ビルドが完了すると同時に追加要求をキューに入れて、 入れた順序に従ってそれらをサブミットします。
-q
クライアントのキュー (q) のサイズを指定します。デフォルトは 10 です。キューに入れられたそれぞれのクライアントは、TCP/IP ソケットを使用します。このため、サイズをあまり大きく設定すると、 必要なソケットの数が使用できるソケットの数を上回り、予想不能な結果を招く場合があります。キューがフル状態になると、後続のクライアントはサーバーにリジェクトされます。ただし、この場合ビルド・クライアントはビルドを再試行します。
-t
このサーバー・ジョブのトレースを開始して、出力を STDOUT に書き込みます。このパラメーターは、通常デバッグ用にのみ使用されます。

プロシージャー

z/OS ビルド・サーバーを開始するには、CCURUN.JCL (z/OS 用) または CCURUNU.JCL (USS 用) を使用して、以下の手順を実行します。
  1. ジョブ・カードを追加する。
  2. 必要に応じて EXEC カードの PARM 文上にあるパラメーターを変更する。 (上のパラメーター・リストを参照してください。)
  3. STEPLIB DD 文が、ビルド・サーバーのロード・モジュールが入っているデータ・セットを指すように変更する。 このライブラリーには、 リモートのビルド・サーバーを構成するすべてのロード・モジュールが入っています。
  4. CCUWJCL DD 文が、個々のビルド・ジョブを実行する JCL が入っているデータ・セットを指すように変更する。 このデータ・セットは、CCUMVS.JCL (z/OS ビルド用) または CCUUSS.JCL (USS ビルド用) の変更バージョンでなければなりません。
  5. CCUBLOG を順次データ・セットとして指定する。これは、ビルド・サーバーのログが書き込まれる場所です。
  6. ジョブに対して適切となるようにパラメーター (PARM=) 文を変更する (以下の例を参照してください)。
  7. ジョブを実行依頼する。

次に示すのは、ビルド・サーバーを z/OS ビルド用のバッチ・プログラムとして開始させる JCL の一例です。
//jobcard
//*------------------------------------------------------
//RUNPGM  EXEC PGM=CCUMAIN,DYNAMNBR=30,REGION=7400K,TIME=NOLIMIT,
// PARM='-p 2604 -a 2 -n 3 -q 20'
//STEPLIB  DD DSN=CCUBLD..LOADLIB,DISP=SHR
//CCUWJCL  DD DISP=SHR,DSN=CCUBLD.JCL(CCUMVS)  for z/OS builds
//*CCUWJCL DD DISP=SHR,DSN=CCUBLD.JCL(CCUUSS)  for USS builds
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//CCUBLOG  DD SYSOUT=*
USS ビルド用の JCL を変更するには、 コメント標識 (//*CCUWJCL の中の *) を、直前の行の // の後ろに移動させます。

z/OS ビルドに関する特殊な考慮事項

APF 許可ライブラリー (モード 1 および 2 では必須ですが、モード 0 では オプションです) から z/OS 上でビルド・サーバーを開始する場合は、 ビルド・スクリプトが APF 許可プログラムを実行可能ファイルとして指定できます。

注: この場合、ビルド・スクリプトは、非 APF 許可プログラムを指定することもできます。ただし、マルチステップの JCL スクリプト内では、許可プログラムが 不許可プログラムの後に実行されることはありません。

ビルド・サーバーが APF 許可ライブラリーから開始していない場合は、 ビルド・スクリプトは、非 APF 許可プログラムのみを実行可能ファイルとして指定できます。

ビルド・サーバーから戻されるメッセージの言語の設定

z/OS 上のビルド・サーバーは、 次の表にリストされている言語のいずれかでメッセージを戻します。英語がデフォルトです。

言語 コード
ブラジル・ポルトガル語 ptb
中国語 (簡体字) chs
中国語 (繁体字) cht
英語 (米国) enu
フランス語 fra
ドイツ語 deu
イタリア語 ita
日本語 jpn
韓国語 kor
スペイン語 esp

英語以外の言語でビルド・サーバーのメッセージが戻されるようにするには、 クライアント・マシンの 環境変数 CCU_LANG の設定を変更します。この変数には、上記の表にリストされている言語コードのいずれかが含まれています。例えば、フランス語でメッセージを戻すには、CCU_LANG を fra に設定します。

また、ビルド・サーバーを呼び出す Rational® Developer 製品のコンポーネントは、ビルド・サーバーとの通信が失敗した場合にメッセージを発行することが必要となることがあります。英語以外の言語でメッセージを戻すには、クライアント・マシンの 環境変数 CCU_CATALOG の設定を変更します。 CCU_CATALOG の値は、次のようなストリングです (1 行)。
  installationDir¥egl¥eclipse¥plugins
  ¥com.ibm.etools.egl.distributedbuild¥executables
  ¥ccu.cat.xxx
installationDir
製品のインストール・ディレクトリー。 例えば、C:¥Program Files¥IBM¥RSPD¥6.0 など。 これから使用しようとしている製品をインストールする前に Rational Developer 製品をインストールし、保持していた場合は、以前のインストールで使用されていたディレクトリーを指定することが必要になる場合があります。
xxx
必要な言語のコード (上記の表にリストされているコードのいずれか)

最後に、ビルド・サーバーを USS の下で実行しており英語以外の言語でメッセージを戻したい場合も、 シェル・スクリプト ccubldw.sh のコンテンツを変更する必要があります。 USS ビルド・サーバー・コンポーネントがインストールされている場合は、 このスクリプトをカスタマイズします。

USS で複数の言語をサポートするには、 各コンポーネントが異なるポートを listen するよう設定し、 異なるバージョンのスクリプトを使用して、言語ごとに異なる USS ビルド・サーバー・コンポーネントを開始します。

USS シェル・スクリプト ccubldw.sh を特定の言語に設定するには、 文を以下のように追加します (1 行)。
  export CCU_CATALOG=
    /installationDir/usr/lpp/EnterpriseDeveloper
    /BuildServer/ccu.cat.xxx
installationDir
USS ビルド・サーバー・コンポーネントがインストールされるディレクトリー
xxx
スクリプトでサポートされている言語のコード (上記の表にリストされている小文字のコードのいずれか)

ビルド・サーバー構成に関する追加詳細

ビルド・サーバーを構成する方法の追加詳細については、 文書番号が GI10-3242 の Enterprise Developer プログラム・ディレクトリーを参照してください。

関連する概念
ビルド・サーバー

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.