配置 ISPF 閘道以取得建置、部署及調升支援

您可以配置 ISPF 閘道來支援 Developer for IBM® Enterprise Platforms 用戶端存取授權所提供的建置、部署及調升元件。

ISPF 提供一個稱為 ISPF 閘道的介面,供用戶端應用程式連接 z/OS® 主機,以及執行 TSO 和 ISPF 指令。ISPF 閘道是隨著 ISPF 而安裝的,成為 HFS 中的載入模組和檔案。 這些檔案通常安裝在 /usr/lpp/ispf/bin 中。 建置、部署及調升元件是隨著安裝 SMP/E 所建立的。 依您的設定而定,ISPF 閘道提供的 Script 和元件可能還需要其他修正。 稍後會說明預設值及修改預設值的程序。

其中包括下列元件:

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,然後將變數設為您需要的值。 之後,您必須變更 startispf.sh 中的路徑環境變數(稍後說明),以便讀取位於預設 ISPF bin 路徑之前的該位置。

例如:
export PATH=/etc/ispf:$PATH  

在 ISPF 閘道工作目錄(依預設,是 /var/ispf)中,您必須已建立好稱為 WORKAREA 的現有目錄,具備所有使用者的讀取和寫入許可權。 當使用 ISPF 閘道時,會建立 /var/ispf/WORKAREA/<userid>/* 格式的暫存目錄。 如果您使用 ISPF 所提供的預設 ISPF 閘道安裝架構,則這個目錄通常在 /var/ispf/WORKAREA 中。 如果目錄不存在,請遵循 ISPF Planning and Customizing (GC34-4814) 中標題為 Installing and customizing the gateway 章節的指示。

ISPF 閘道啟動 Script:startispf.sh
啟動 ISPF 閘道以進行部署及調升的 Shell Script。
為了啟動 ISPF 閘道,Rational Team Concert™ 提供一個從部署和調升 Ant 作業呼叫的 Shell Script。 這個 Script 會安裝到 /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway 中。 在標準自訂作業中,BLZCPBTK 工作會將這個 Script 複製到 Rational Team Concert 配置目錄中,通常是 /etc/jazz40/ccm。依您的設定而定,您可能需要修改這份 Shell Script 來設定部分環境變數。
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 Script、ISPF.conf 檔及 ISPZXENV 檔副本,將您的安裝架構配置成支援多個專案和串流。在每一個 ISPZXENV 檔案副本中,將 CGI_ISPFCONF 變數設為指向相關的 ISPF.conf 檔的位置。然後,在每一個 startispf.sh Script 副本中,將 PATH 變數設為指向 ISPF.conf 檔的適當副本。 接著使用特定專案所需的環境相對應的 startispf.sh Script。

「企業延伸」建置啟動 Script:startbfa.sh
利用「企業延伸」建置來啟動 Rational® Build Agent 的 Shell Script。
「企業延伸」建置提供啟動建置(進而啟動程式)的機制、ISPF 指令或執行檔,或是 TSO 指令或執行檔。 如果建置所啟動的物件是在 ISPF 配置的程式庫中,您必須將這項建置配置成提供必要物件的存取權。 在 startbfa.sh 中,您必須列出 ISPF 提供之檔案的位置,Rational Build Agent 才能夠啟動 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 閘道配置檔中

對於「企業延伸」建置,如果您使用 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 Planning and Customizing (GC34-4814) 中,標題為 TSO/ISPF client gateway in ISPF Planning and Customizing 的一章。

ISPF 閘道配置的疑難排解

驗證 ISPF 閘道配置適當。執行 Rational Team Concert 功能的使用者 ID 只要會利用 ISPF 閘道,就必須具備 ISPF Planning and Customizing (GC34-4814)(網址是 http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf)所說明的必要許可權。

Rational Team Concert startispf.sh Script 使用「UNIX 系統服務」指令,這些指令需要存取 /tmp 目錄。啟動 startispf.sh Script 的建置使用者 ID 必須具備 /tmp 目錄的存取權。您可以在 /etc/jazz40/ccm/startispf.sh 中新增下列字行,以暫存目錄取代 /tmp:
export TMPDIR=/yourTemporaryDir
其中 yourTemporaryDir 是建置使用者需具備寫入權的目錄。

意見