Rational Build Agent シェル・スクリプトの構成

Jazz™ ビルド・システムには、Rational® Build Agent の開始に使用できる、startbfa.sh というサンプル・スクリプトが含まれています。

このサンプル・スクリプトは @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa ディレクトリーにあります。ここで、@pathPrefix@ は SMP/E のインストール時に指定した任意の接頭部です。このスクリプトは、Rational Build Agent を開始してエージェントが Jazz Team Server に接続できるようにするための資格情報を指定したり、Ant with Enterprise Extensions およびネイティブ・コンパイルに必要なライブラリーへのアクセスを提供したりするために必要です。このスクリプトは、BLZCPBTK ジョブによって、Rational Team Concert 構成ディレクトリー (通常は /etc/jazz40/ccm) に コピーされます。
重要: このスクリプトは、ご使用の環境に適合するように構成されている必要があります。 必須の変数の多くは、BLZCPBTK コピーおよび構成ジョブによって既に構成されています。 ただし、ユーザー ID やパスワード情報など、変数の一部は自動的に設定されていません。 以下の表で示されているように、サンプル・スクリプト内の必須の変数のストリングを確認して置き換えてください。
表 1. サンプル・スクリプトの変数ストリング
変数 説明
@pathPrefix@ Jazz ディレクトリーの前に付けられるディレクトリー・パス
注: これは、Jazz ディレクトリーに付けられる接頭部であるため、ご使用の接頭部には、SMP/E インストールの一環として指定した接頭部に続いて /usr/lpp を含める必要があります。
@javaPathPrefix@ IBM® 31-bit SDK for z/OS® Java 2 Technology へのディレクトリー・パス。
@yourUserid@ Jazz ユーザー ID。
@yourPasswordFile@ BLZBPASS ジョブで定義している Jazz パスワード・ファイル。 BLZBPASS ジョブの実行方法については、z/OS での Jazz ビルド・エンジンの実行を参照してください。
@stepLib@ z/OS ビルドで使用する STEPLIB DD (データ・セット定義)。 例えば、SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Rational Build Agent 実行可能ディレクトリーへのディレクトリー・パス。
@bfaConfPath@ Rational Build Agent 構成ファイル・ディレクトリーへのディレクトリー・パス。
@zLang@ ホスト・ファイルで使用されるエンコード方式。例えば、IBM-037 です。
@timeout@ ビルド・ステップ実行のタイムアウト値 (秒)。 指定しなかった場合のデフォルトは 300 秒です。
@workPath@ PDSE のメタデータが保管されるディレクトリー・パス。デフォルトで、これは /u/jazz40/ccm/ です。
@yourHomeDirectory@ ホーム・ディレクトリー。これは、別の個所で HOME 環境変数を定義していない場合にのみ使用してください。
_CMDSERV_BASE_HOME Rational Build Agent が ISPF ゲートウェイを開始できるように、ISPF 提供ファイルのロケーションを示します。_CMDSERV_BASE_HOME の詳細については、ビルド、デプロイメント、およびプロモーションをサポートするための ISPF ゲートウェイの構成を参照してください。
Rational Build Agent を開始してビルド依頼を受け入れる準備ができたら、 以下のいずれかの方法で startbfa.sh スクリプトを実行できます。
  • OMVS から startbfa.sh スクリプトを手動で開始します
  • ジョブの指示に従って、BLZ.SBLZSAMP ライブラリーで提供されるサンプル開始済みタスク BLZBFA を構成します。 これで、システムの始動時に Build Forge Agent を開始済みタスクとして実行できます。このジョブをシステムで割り振られた PROCLIB にコピーして、 開始済みタスクとして実行するために必要なセキュリティー設定をセットアップする必要があります。
注: bfagent.conf ファイルに別のシェルが指定されていない限り、z/OS 上で Rational Build Agent が開始したセッションでは、デフォルト・シェル (/bin/sh) が使用されます。 z/OS 上のデフォルト・シェルは常に、startbfa.sh が実行された後に、 システム全体の構成を設定するために /etc/profile スクリプトを実行します。そのため、 startbfa.sh シェル・スクリプトに設定された環境変数の一部がオーバーライドされる可能性があります。

Ant with Enterprise Extensions ビルドまたは依存関係ビルドを、Ant の引数に –verbose オプションまたは –debug オプションを指定して実行すると、Ant が起動される前に UNIX の export コマンドが実行されます。 ビルド・ログで export コマンドの出力を調べると、環境変数が正しく設定されているかを確認することができます。

いくつかの環境変数が /etc/profile によってオーバーライドされる場合は、/etc/profile を変更するようにシステム・プログラマーに依頼してください。/etc/profile を変更できない場合は、bash シェル (z/OS Ported Tools で利用可能) を使用することができます。 bfagent.conf ファイルに次の 2 行を追加して、–noprofile オプションを指定します。
shell /bin/bash   
shellflag --noprofile 

フィードバック