配置 ISPF 网关以支持构建、部署和提升

您可以配置 ISPF 网关,以支持可用于“IBM® Enterprise Platforms 开发者”客户访问许可证的构建、部署和提升组件。

ISPF 提供了称为“ISPF 网关”的接口,供客户机应用程序能够连接到 z/OS® 主机以及运行 TSO 和 ISPF 命令。ISPF 网关作为 ISPF 的组成部分进行安装,从而以装入模块和文件形式存在于 HFS 中。这些文件通常安装在 /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)并将变量设置为必需值。然后,必须在 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 网关启动脚本:startispf.sh
这是用于启动 ISPF 网关以便执行部署和提升的 Shell 脚本。
为了启动 ISPF 网关,Rational Team Concert™ 提供了从部署和提升 Ant 任务调用的 Shell 脚本。此脚本将安装到 /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway 中。在标准定制过程中,此脚本由 BLZCPBTK 作业复制到 Rational Team Concert 配置目录(通常是 /etc/jazz40/ccm)。根据您的设置,您可能需要修改此 Shell 脚本来设置一些环境变量。
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 文件的每个副本中,将 CGI_ISPFCONF 变量设置为指向相关 ISPF.conf 文件所在的位置。然后,在 startispf.sh 脚本的每个副本中,将 PATH 变量设置为指向 ISPF.conf 文件的相应副本。然后使用与特定项目所需环境对应的 startispf.sh 脚本。

“企业扩展”构建启动脚本:startbfa.sh
这是用于通过“企业扩展”构建启动 Rational® 构建代理程序的 Shell 脚本。
“企业扩展”构建提供了一种用于启动构建(而此构建又启动程序)的机制、ISPF 命令/可执行文件或者 TSO 命令/可执行文件。如果此构建所启动的对象在 ISPF 分配的库中,那么您必须将此构建配置为提供对所需对象的访问权。在 startbfa.sh 中,必须列示 ISPF 提供的文件的位置,以使 Rational 构建代理程序能够启动 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.conf) 中分配 ISPF 程序和可执行文件,如稍后所述。Rational 构建代理程序还需要访问 ISPF.conf。访问权是在 ISPF 网关环境文件 (ISPZXENV) 中设置的。如果您计划在构建中使用 ISPF 能力,并且不使用缺省位置 /usr/lpp/ispf/bin,那么必须在可写入的配置目录中创建 ISPZXENV 的副本并将 Rational 构建代理程序指向该位置。请将构建属性 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 调用方法,那么还必须将您自己的 EXEC 库添加到 ISPF.conf 中的 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 网关。任何运行使用 ISPF 网关的 Rational Team Concert 功能的用户标识,必须具备 ISPF Planning and Customizing (GC34-4814)(网址为 http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf)中描述的必需许可权。

Rational Team Concert startispf.sh 脚本使用需要访问 /tmp 目录的 UNIX 系统服务命令。用于启动 startispf.sh 脚本的构建用户标识必须对 /tmp 目录具有访问权。您可以通过向 /etc/jazz40/ccm/startispf.sh 添加以下行来覆盖使用 /tmp 作为临时目录:
export TMPDIR=/yourTemporaryDir
其中 yourTemporaryDir 是构建用户对其具有写访问权的目录。

反馈