ビルド、デプロイメント、およびプロモーションをサポートするための ISPF ゲートウェイの構成

Developer for IBM® Enterprise Platforms のクライアント・アクセス・ライセンスで使用可能なビルド、デプロイメント、およびプロモーションのコンポーネントをサポートするように ISPF ゲートウェイを構成することができます。

ISPF には、クライアント・アプリケーションが z/OS® ホストに接続して TSO コマンドおよび ISPF コマンドを実行するための、 ISPF ゲートウェイと呼ばれるインターフェースが用意されています。 ISPF ゲートウェイは、HFS の中の ロード・モジュールおよびファイルとして、ISPF の一部としてインストールされます。これらのファイルは、 通常、/usr/lpp/ispf/bin にインストールされます。 ビルド、デプロイメント、およびプロモーションのコンポーネントは、SMP/E インストールの一環として作成されます。 セットアップによっては、ISPF ゲートウェイが提供するスクリプトおよびコンポーネントに、 さらに修正が必要な場合があります。デフォルト設定とデフォルトの変更手順については後述します。

次のコンポーネントが含まれます。

ISPF ゲートウェイ環境ファイル: ISPZXENV
ISPF ゲートウェイのカスタマイズ可能設定を含む ISPF ゲートウェイ環境ファイル。
ISPZXENV ファイルは、z/OS の一部として提供されます。デフォルトでは、このファイルは /usr/lpp/ispf/bin にインストールされます。 ただし、このディレクトリーには、一般的に、インストールの後、「読み取り専用」のマークが付けられます。 この環境ファイルは、ISPF ゲートウェイの実行に必要な特定の環境変数の値を取得するために、ISPF ゲートウェイによって 実行されます。デフォルトでは、これらの変数は次のように設定されます。
STEPLIB
デフォルトでは STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD' に設定されています。
CGI_ISPCONF
デフォルトでは CGI_ISPCONF = '/etc/ispf' に設定されています。
CGI_ISPWORK
デフォルトでは CGI_ISPWORK = '/var/ispf' に設定されています。

変数をデフォルト以外の値に設定するには、ISPZXENV を書き込み可能な構成ディレクトリー (/etc/ispf など) にコピーし、それらの変数を必要な値に設定します。その後、デフォルトの ISPF bin パスより前にその場所を読み込むように、startispf.sh の PATH 環境変数を変更する必要があります (この環境変数については後述します)。

以下に例を示します。
export PATH=/etc/ispf:$PATH  

ISPF ゲートウェイ作業ディレクトリー (デフォルトでは /var/ispf) に、 読み取りアクセス権および書き込みアクセス権がすべてのユーザーに対して設定された、WORKAREA という名前で作成された既存ディレクトリーがある必要があります。 ISPF ゲートウェイの使用時に、フォーマットが /var/ispf/WORKAREA/<userid>/* の一時ディレクトリーが作成されます。 ISPF によって提供されているデフォルトの ISPF ゲートウェイ・インストール済み環境を使用している場合、このディレクトリーは通常、/var/ispf/WORKAREA 内にあります。このディレクトリーが存在しない場合は、「対話式システム生産性向上機能 (ISPF) 計画とカスタマイズ」 (GC88-8957) の「ゲートウェイのインストールおよびカスタマイズ」というタイトルの章の説明に従ってください。

ISPF ゲートウェイ開始スクリプト: startispf.sh
デプロイメントおよびプロモーションのために ISPF ゲートウェイを開始するシェル・スクリプト
ISPF ゲートウェイを開始するために、Rational Team Concert™ にはデプロイメントおよびプロモーションの Ant タスクから呼び出されるシェル・スクリプトが用意されています。このスクリプトは /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway にインストールされます。 標準カスタマイズの一部として、このスクリプトは、BLZCPBTK ジョブによって Rational Team Concert 構成ディレクトリー (通常は /etc/jazz40/ccm) にコピーされます。セットアップによっては、このシェル・スクリプトを変更していくつか環境変数を設定する必要がある場合もあります。
PATH
PATH 変数は、ISPF ゲートウェイの ホーム・ディレクトリーを指している必要があります。
export PATH=$PATH:/usr/lpp/ispf/bin             
ISPZXENV を変更した場合は 、PATH を次のように設定する必要がある場合もあります。
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

ISPF.conf で別のライブラリー連結を使用する必要がある場合は、startispf.sh スクリプト、ISPF.conf ファイル、および ISPZXENV ファイルの複数のコピーを作成することにより、複数のプロジェクトとストリームをサポートするようにインストール済み環境を構成してください。ISPZXENV ファイルの各コピーで、関連する ISPF.conf ファイルのロケーションを指すように CGI_ISPFCONF 変数を設定します。次に、startispf.sh スクリプトの各コピーで、ISPF.conf ファイルの適切なコピーを指すように PATH 変数を設定します。それから、特定プロジェクトに必要な環境に対応するように startispf.sh スクリプトを使用します。

Enterprise Extensions ビルドの開始スクリプト: startbfa.sh
Enterprise Extensions ビルドを使用して Rational® Build Agent を開始するシェル・スクリプト。
Enterprise Extensions ビルドでは、プログラム、ISPF コマンドまたは実行可能ファイル、あるいは TSO コマンドまたは実行可能ファイルを開始するビルドを開始するためのメカニズムが提供されています。ビルドによって開始されるオブジェクトが ISPF 割り振りライブラリーにある場合は、必要なオブジェクトへのアクセスを提供するようにそのビルドを構成する必要があります。Rational Build Agent が ISPF ゲートウェイを開始できるように、startbfa.sh に ISPF 提供ファイルのロケーションをリストする必要があります。デフォルトでこれらのファイルは /usr/lpp/ispf にあり、 startbfa.sh に変数 _CMDSERV_BASE_HOME を使用して指定されます。 ISPF ゲートウェイのバイナリー・ファイルを別の場所にインストールした場合には、この変数を変更してください。 以下に例を示します。
#                                                  
# Specify the home directory for the ISPF programs.
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

後述するように、ISPF プログラムと実行可能ファイルは、ISPF ゲートウェイ構成ファイル (ISPF.conf) で割り振る必要があります。また、Rational Build Agent は、ISPF.conf へのアクセスを必要とします。 アクセスは ISPF ゲートウェイ環境ファイル (ISPZXENV) で設定されます。 ビルドで ISPF 機能を使用する予定で、 デフォルトの場所 /usr/lpp/ispf/bin を使用しない場合は、 書き込み可能な構成ディレクトリーに ISPZXENV のコピーを作成し、 Rational Build Agent がその場所を指すようにしてください。 ビルド・プロパティー teamz.build.ant.myISPFBinPath を、ISPZXENV ファイルが入っているディレクトリーの場所に設定します。 値の編集やプロパティーの追加は、ビルド定義の「プロパティー」タブを使用して行えます。 詳細情報については、「z/OS ビルドの管理を参照してください。

ISPF ゲートウェイ構成ファイル: ISPF.conf
ISPF ゲートウェイのカスタマイズ可能設定を含む ISPF ゲートウェイ構成ファイル。
ISPF.conf ファイルは、z/OS の一部として提供されます。ISPF ゲートウェイ構成ファイルは、作成されたタスクで ISPF セッションを開始するために必要な割り振りを提供します。ビルド、デプロイメント、およびプロモーションの機能が特定のタスクを実行するためのモジュールを開始するには、それらのモジュールが ISPF の連結で使用可能になっている必要があります。デフォルトでは、これらの割り振りは次のようにセットアップされます。
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
デプロイメントおよびプロモーションが動作するようにするには、Rational Team Concert の製品ロード・ライブラリー (hlq.SBLZLOAD) と製品メッセージ・ライブラリー (hlq.SBLZMENU) を ISPLLIB と ISPMLIB の連結に追加します。変更された割り振りは、以下の例のようになります。
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

解釈デプロイメント・モジュールの実行

独自のデプロイメント・プロセスまたは機能を追加する場合には、 デプロイメント・モジュールの解釈版を実行することができます。 デプロイメント・コンポーネントは、以下のプログラムを実行します。
表 1. デプロイメント・コンポーネントによって実行されるプログラム
プログラム 機能 説明
BLZPKGZP デプロイメントのパッケージ マニフェスト・ファイルを使用して、指定した内容の .zip ファイルを作成します。
BLZBKPZP デプロイメントのバックアップ パッケージ・ファイルを使用して、デプロイメントが上書きするモジュールのバックアップ・コピーを作成します。
BLZDEPZP デプロイメント デプロイメント・マニフェスト・ファイルを使用して、指定した .zip ファイルの内容をデプロイします。
Rational Team Concert デプロイメント・タスクは、これらのプログラムを呼び出して、記述された機能を実行します。これらのプログラムを変更するには、 ライブラリー hlq.SBLZSAMP 内の提供サンプルを変更して、 その後、ISPF.conf でその変更版を指すようにします。 hlq.SBLZSAMP で直接変更を行う場合には、ISPF.conf の割り振りは以下の例のようになります。
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
ISPF は、 コマンドにパーセント記号 % の接頭部がある場合を除いて、ISPLLIB の連結を最初に検査します。 そのため、変更したモジュールを名前変更するか、hlq.SBLZLOAD データ・セットから削除してください。

独自の EXEC ライブラリーを ISPF ゲートウェイ構成ファイルに追加

Enterprise Extensions ビルドでは、ISPF の呼び出し方法を使用する場合に、 ISPF.conf で独自の EXEC ライブラリーを SYSEXEC または SYSPROC の連結に追加することも必要です。 EXEC 名を指定している、または SELECT CMD(exec) を指定している場合、 ISPF は、該当の連結内の必要な EXEC に対するアクセスを必要とします。 ISPF.conf を変更して、必要な EXEC ライブラリーを含めてください。例えば、以下のようにします。
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

ISPF ゲートウェイの詳細は、「対話式システム生産性向上機能 (ISPF) 計画とカスタマイズ」(GC88-8957) の『計画とカスタマイズ』の中の『TSO/ISPF クライアント・ゲートウェイ』 を参照してください。

ISPF ゲートウェイ構成のトラブルシューティング

ISPF ゲートウェイが正しく構成されていることを確認します。ISPF ゲートウェイを使用する Rational Team Concert 機能を実行するすべてのユーザー ID は、「対話式システム生産性向上機能 (ISPF) 計画とカスタマイズ」(GC88-8957) で説明されている必須アクセス権を備えている必要があります。

Rational Team Concert startispf.sh スクリプトは、/tmp ディレクトリーに対するアクセス権限を必要とする UNIX System Services コマンドを使用します。 startispf.sh スクリプトを開始するビルド・ユーザー ID は、/tmp ディレクトリーにアクセスできる必要があります。以下の行を /etc/jazz40/ccm/startispf.sh に追加することで、一時ディレクトリーとしての /tmp の使用をオーバーライドできます。
export TMPDIR=/yourTemporaryDir
ここで、yourTemporaryDir は、ビルド・ユーザーの書き込み権限を備えたディレクトリーです。

フィードバック