在 i5/OS 上安装 WebSphere Business Integration Server Express 会在 i5/OS 系统上创建许多 i5/OS 对象。下表描述这些对象:
项 | 名称 | 描述 |
---|---|---|
用户概要文件 | QWBISVR44 | 缺省用户概要文件,它拥有所有已安装的内容且作业在它之下运行。 |
库 | QWBISVR44 | 包含所有 i5/OS 本机对象。 |
作业描述 | QWBIxxxx,其中 xxxx 对于每个进程是唯一的。 | 帮助标识在子系统中运行的作业,并且可以为各个作业进行定制。要查看作业描述,使用 WRKJOBD JOBD(QWBISVR44/*ALL)。 |
Interchange Server Express 实例 | QWBIDFT44 | 安装过程会创建、配置协作基础以及要运行任何已安装样本的内容并将它们部署至服务器。 |
MQ 队列管理器 | QWBIDFT44.QUEUE.MANAGER | 安装会创建队列管理器以及缺省端口上的 MQ 侦听器。 |
DB2/400 数据库 | QWBIDFT44 | QWBIDFT44 InterChange Server 的存储库。 |
子系统描述 | QWBISVR44/QWBISVR44 | 包含运行 i5/OS 进程的 QWBISVR44 子系统的属性。 |
TCP/IP 自动启动服务器 | QWBISVR44 | 激活 TCP/IP 自动启动服务器时自动启动子系统。 |
自动启动作业 | QWBITNAMES | InterChange Server、InterChange Adapters 和 InterChange Tools 互相通信所需要的名称服务器。对名称服务器使用缺省端口。 |
自动启动作业 | QWBIDFT44 | 启动已安装的 InterChange Server。 |
HTTP Server 和 WebSphere Application Server | ICSMON44 | HTTP Server 和 WebSphere Application Server 实例 |
i5/OS 的支持在 QWBISVR44 子系统中以用户概要文件名称 QWBISVR44 运行。i5/OS 为以下每个组件指定一个唯一的作业描述对象:
当搜索作业时,请使用 WRKACTJOB SBS(QWBISVR44)。对于每个组件,作业名与作业描述名称匹配。
存在几个与子系统中已命名的作业相关联的作业,这些作业不需要管理,例如 QP0ZSPWP、QP0ZSPWT 和 QZSHSH。
其它作业验证服务器状态和适配器状态,例如,QWBIDFT44 验证服务器状态,QWBIJTEXTC 验证 JText 适配器的适配器状态。如果您要运行多个相同的适配器,例如,两个 JText 适配器,则建议您为适配器的每个实例创建不同的作业名和描述,但并不是必须这样做。
在 i5/OS 上,所有作业都使用 QWBISVR44 用户概要文件的 CCSID 至 QCCSID 系统值运行。如果系统正在运行 5026 或 290 日语 CCSID,则您必须将 QWBISVR44 用户概要文件的 CCSID 参数更改为 5035,以便产品正常运行。
如果您不希望在系统上启动 TCP/IP 时自动启动 WebSphere Business Integration Server Express,则使用 RMVTCPSVR SVRSPCVAL(*QWBISVR44) 命令除去作为自动启动 TCP/IP 服务器的 QWBISVR44。
如果您不希望在系统上启动 TCP/IP 时自动启动子系统,并且不希望 QWBIDFT44 服务器自动启动,则使用 remove_autostart_server.sh 脚本从子系统除去自动启动的 InterChange Server。
在运行此脚本之前,首先运行 QSH CL 命令以进入 QShell 环境。对 remove_autostart_server.sh 脚本使用以下语法:
/QIBM/ProdData/WBIServer44/bin/remove_autostart_server.sh QWBIDFT44
建议您让名称服务器作为子系统中的自动启动作业。自动启动此作业使监视器能够检测到子系统或系统何时以受控方式结束。没有此监视器,QWBISVR44 子系统及其作业将不会由于受控方式而结束。
要自动启动 InterChange Server、适配器代理程序和 Object Discovery Agent,直接对 QWBISVR44 子系统运行 start_server.sh(对于 InterChange Server)、特定的适配器脚本(例如 start_JText.sh)或 Object Discovery Agent 脚本(例如 start_JDBCODA.sh)。
对用户概要文件保护所有可执行文件、存储数据库和特定文件,这对于使用 QWBISVR44 子系统很重要。另外,请始终在 QWBISVR44 用户概要文件下运行 InterChange Server,以避免不可预测的权限问题。
如果您想要适配器代理程序作业在不同用户概要文件下运行,则将作业描述中的用户参数从 QWBISVR44 更改为不同的用户概要文件。如果需要禁止 QWBISVR44 用户概要文件访问由不同用户概要文件保护的应用程序数据时,这将很有用。
执行下列步骤来更改 IBM ORB 端口:
如果您正在使用任何 Windows 客户机工具,则必须更改产品目录中的 CWSharedEnv.bat 文件、结束任何活动的工具并重新启动该工具。
当创建服务器实例时,可以使用 create_instance.sh 脚本来指定 MQ 侦听器端口。执行下列步骤来更改 MQ 侦听器端口:
<tns:name>PORT</tns:name>
<tns:value xml:space="preserve">1416</tns:value>
CHGJOBD JOBD(QWBISVR44/QWBIDFT44) RQSDTA('QSYS/CALL
PGM(QWBISVR44/QWBIDFT44) PARM(QWBIDFT44 ''1417'')')
当创建服务器实例时,可以使用 create_instance.sh 脚本来指定 InterChange Server 存储库名称。执行下列步骤来更改存储库名称:
当创建服务器实例时,使用 create_instance.sh 脚本来指定队列管理器名称。执行下列步骤来更改队列管理器名称:
WebSphere Business Integration Server Express 附带了许多 i5/OS 所独有的脚本。这些脚本位于 /QIBM/ProdData/WBIServer44/bin 目录中。
以下各节详细描述了每个脚本。
此脚本设置为在 InterChange Server 与 QWBISVR44 子系统一起启动时自动部署适配器代理程序。此脚本还将信息添加至服务器实例的自动启动作业,以允许服务器实例提交适配器代理程序的作业。
以下是 add_autostart_adapter.sh 的语法:
add_autostart_adapter.sh adapterName instanceName startScript jobDescription
其中:
以下是 JText 适配器的示例:
add_autostart_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC
此脚本将 InterChange Server 配置为自动与子系统一起启动。当使用 create_instance.sh 脚本创建服务器实例时,该实例设置为自动与子系统一起启动。如果使用 remove_autostart_server.sh 脚本除去此功能,则使用 add_autostart_server.sh 来重置为自动启动。
以下是 add_autostart_server.sh 的语法:
add_autostart_server.sh serverName jobDescription,
其中:
此脚本为 InterChange Server 创建一个新 Interchange Server 实例,并在 /QIBM/UserData/WBIServer44 中创建新的目录。此脚本还会将已安装的适配器复制到此目录,使用与实例相同的名称创建存储库 DB2/400 数据库和 MQ 队列,使用特定端口号为 MQ 队列创建 MQ 侦听器,并将自动启动作业条目添加至新的 InterChange Server 的 QWBISVR44 子系统。
以下是 create_instance.sh 的语法:
create_instance.sh [ -rrepositoryName ] [ -qqueueManagerName [ -exists ] ] [ -uuser -ppassword ] [ -dsystem -ndbUser -wdbPassword ] serverName mqPortNumber httpPortNumber
此脚本删除 Interchange Server 实例以及 /QIBM/UserData/WBIServer44 中服务器的目录、服务器的存储库 DB2/400 数据库,并从 QWBISVR44 子系统描述中删除服务器的自动启动作业条目。此脚本不删除服务器的现有队列管理器。
以下是 delete_instance.sh 的语法:
delete_instance.sh instanceName,
其中:
此脚本从当前自动与服务器实例一起启动的适配器代理程序中除去自动启动指定项,并编辑 InterChange Server 实例的自动启动作业和除去提交适配器代理程序作业的语句。
以下是 remove_autostart_adapter.sh 的语法:
remove_autostart_adapter.sh adapterName instanceName,
其中:
此脚本从 InterChange Server 实例中除去自动启动指定项,并从 QWBISVR44 子系统中除去 InterChange Server 实例的自动启动作业条目。
以下是 remove_autostart_adapter.sh 的语法:
remove_autostart_server.sh instanceName,
其中:
此脚本设置 InterChange Server 的模式。此脚本在 InterChange Server 下一次启动时应用新模式(design、production、testOn 或 testOff)。
以下是 set_ics_server_mode.sh 的语法:
set_ics_server_mode.sh instanceName mode,
其中:
此脚本从 i5/OS 上的 CL 程序或命令输入处平稳地停止 InterChange Server,它等同于系统管理器或系统监视器发出平稳关闭命令。
以下是 stop_server_gracefully.sh 的语法:
stop_server_gracefully.sh instanceName,
其中:
当使用系统管理器或系统监视器不可行时,此脚本平稳地停止适配器代理程序作业。
以下是 stop_adapter.sh 的语法:
stop_adapter.sh instanceName adapterName,
其中:
以下是 JText 适配器的示例:
stop_adapter.sh QWBIDFT44 JText
此脚本提交适配器代理程序作业以在 QWBISVR44 子系统中运行。在使用此命令之前,必须启动 QWBISVR44 子系统。
以下是 submit_adapter.sh 的语法:
submit_adapter.sh adapterName instanceName startScript jobDescription [parm5] [parm6] [parm7],
其中:
以下是 JText 适配器的示例:
submit_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC -c/ QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/JText.cfg
此脚本提交 InterChange Server 实例作业以在 QWBISVR44 子系统中运行,以提供使用 start_server.sh 脚本运行批处理作业所需要的逻辑。此脚本包括从 2 至 6 个可选参数,允许您通过 submit_ics_server.sh 脚本将参数从传递至 start_server.sh 脚本。
以下是 submit_ics_server.sh 的语法:
submit_ics_server.sh instanceName [parm2] [parm3] [parm4] [parm5] [parm6],
其中:
此脚本提交名称服务器作业以在 QWBISVR44 子系统中运行。
此脚本提交 Object Discovery Agent 作业以在 QWBISVR44 子系统中运行,以提供必要的逻辑,以便提交子系统 QWBISVR44 中的作业来运行作为参数 1 传递的脚本名称。
以下是 submit_oda.sh 的语法:
submit_oda.sh startODAScript jobDescription,
其中:
以下是 JDBC ODA 的示例:
submit_oda.sh /QIBM/ProdData/WBIServer44/product/oda/JDBC/start_JDBCODA.sh QWBIJDBODA
为了安全起见,可能需要更改适配器代理程序进程在其下运行的用户概要文件,例如,JDBC 数据库权限或 JText 目录或文件。更改用户概要文件会禁止 QWBISVR44 用户概要文件访问这些适配器进程。
执行下列步骤来更改用户概要文件:
当使用 i5/Os 停止子系统时,代码包括用于控制 ENDSBS *CNTRLD 操作的 sigaction 处理程序。此处理程序通过平稳地终止 InterChange Server 以及在本地系统上运行的任何作业或适配器,允许 QWBISVR44 子系统以受控方式结束。当该操作完成时,此处理程序自行终止。