在 i5/OS 上管理服务器

在 i5/OS 上安装 WebSphere Business Integration Server Express 会在 i5/OS 系统上创建许多 i5/OS 对象。下表描述这些对象:

表 5. 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 上运行服务器

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 服务器的 QWBISVR44

如果您不希望在系统上启动 TCP/IP 时自动启动 WebSphere Business Integration Server Express,则使用 RMVTCPSVR SVRSPCVAL(*QWBISVR44) 命令除去作为自动启动 TCP/IP 服务器的 QWBISVR44。

除去自动启动的 InterChange Server

如果您不希望在系统上启动 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

要自动启动 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 用户概要文件访问由不同用户概要文件保护的应用程序数据时,这将很有用。

注:
建议您不要从 i5/OS 命令输入处使用 QSHell 来运行这些脚本,因为这将导致在 QINTER 子系统中,作业在登录期间使用的用户概要文件下运行。

更改 IBM ORB 端口

执行下列步骤来更改 IBM ORB 端口:

  1. 打开文件 /QIBM/UserData/WBIServer44/bin/CWSharedEnv.sh
  2. 将 ORB_PORT 值从 14500 更改为适当的端口值。
  3. 停止子系统。
  4. 使用新端口重新启动子系统。

如果您正在使用任何 Windows 客户机工具,则必须更改产品目录中的 CWSharedEnv.bat 文件、结束任何活动的工具并重新启动该工具。

注:
必要时,您还可以为 ORB_HOST 指定一个不同的主机或系统别名。

更改 MQ 侦听器端口

当创建服务器实例时,可以使用 create_instance.sh 脚本来指定 MQ 侦听器端口。执行下列步骤来更改 MQ 侦听器端口:

  1. 打开文件 /QIBM/UserData/WBIServer44/instanceName/InterchangeSystem.cfg
  2. 更改 MQ 侦听器端口值,例如,在以下行中将 1416 更改为新的端口号。
    <tns:name>PORT</tns:name>
    <tns:value xml:space="preserve">1416</tns:value>
    注:
    编辑此文件时必须谨慎,否则可能导致 InterChange Server 不启动。
  3. 将作业描述中的 RQSDTA 端口更改为端口号 1417,例如:
    CHGJOBD JOBD(QWBISVR44/QWBIDFT44) RQSDTA('QSYS/CALL
    PGM(QWBISVR44/QWBIDFT44) PARM(QWBIDFT44 ''1417'')')
    注:
    缺省情况下,此端口与 InterChange Server 共享一个名称并驻留在 QWBISVR44 库中。

更改 InterChange Server 存储库名称

当创建服务器实例时,可以使用 create_instance.sh 脚本来指定 InterChange Server 存储库名称。执行下列步骤来更改存储库名称:

注:
如果您为服务器实例更改 Interchange Server 存储库名称,则 delete_instance.sh 脚本将不删除实例服务器存储数据库。您将必须通过使用废弃集合 SQL 命令手工删除实例服务器存储库。

  1. 在系统管理器中将服务器存储库导入到项目。
  2. 停止 QWBISVR44 子系统。
  3. 从 i5/OS 命令输入处运行 STRSQL
  4. 运行 CREATE COLLECTION(newname),其中 newname 是存储库的新名称。
    注:
    STRSQL 概要文件对新存储库具有 *RWX 权限。使用 EDTOBJAUT 命令和 *RWX 权限来使 QWBIDFT44 成为新的拥有概要文件。
  5. /QIBM/UserData/WBIServer44/instanceName/InterchangeSystem.cfg 中的三个位置(jdbc:db2:localhost/newName)编辑 DATA_SOURCE_NAME,其中 newName 是存储库的新名称。
  6. 通过使用系统管理器、使用 stop_server_gracefully.sh 脚本或通过结束 QWBISVR44 子系统,停止名称服务器实例。
  7. 启动 SQL 服务器并运行 drop collection instanceName,其中 instanceName 是 InterChange Server 的名称。
  8. 忽略接受到的任何 CPA7025 消息。
  9. 运行 submit_ics_server.sh 脚本来启动服务器。

更改队列管理器名称

当创建服务器实例时,使用 create_instance.sh 脚本来指定队列管理器名称。执行下列步骤来更改队列管理器名称:

  1. 输入 CHGJOBD JOBD(QWBISVR44/QWBIDFT44) 命令并单击 F4 以对参数进行提示。
  2. 编辑 RQSDTA 值以替换现有的队列管理器值。例如,缺省实例的队列管理器名称是 QWBIDFT44.QUEUE.MANAGER。使用新名称替换现有的队列管理器名,必要时保留队列管理器名称末尾的空格,以便队列管理器名称字符串有 48 个字符或更多字符。
  3. /QIBM/UserData/WBIServer44/instanceName/InterchangeSystem.cfg 中的队列管理器名称编辑为新的队列管理器名称。
  4. 通过使用系统管理器、使用 stop_server_gracefully.sh 脚本或通过结束 QWBISVR44 子系统,停止名称服务器实例。
  5. 使用 ENDMQMDLTMQM 命令来停止并删除 instanceName.QUEUE.MANAGER 队列管理器。
  6. 运行 submit_ics_server.sh 脚本来启动服务器。

i5/OS 脚本

WebSphere Business Integration Server Express 附带了许多 i5/OS 所独有的脚本。这些脚本位于 /QIBM/ProdData/WBIServer44/bin 目录中。

以下各节详细描述了每个脚本。

add_autostart_adapter.sh

此脚本设置为在 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

add_autostart_server.sh

此脚本将 InterChange Server 配置为自动与子系统一起启动。当使用 create_instance.sh 脚本创建服务器实例时,该实例设置为自动与子系统一起启动。如果使用 remove_autostart_server.sh 脚本除去此功能,则使用 add_autostart_server.sh 来重置为自动启动。

语法

以下是 add_autostart_server.sh 的语法:

add_autostart_server.sh serverName jobDescription

其中:

create_instance.sh

此脚本为 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

delete_instance.sh

此脚本删除 Interchange Server 实例以及 /QIBM/UserData/WBIServer44 中服务器的目录、服务器的存储库 DB2/400 数据库,并从 QWBISVR44 子系统描述中删除服务器的自动启动作业条目。此脚本不删除服务器的现有队列管理器。

注:
如果您为服务器实例更改 Interchange Server 存储库名称,则 delete_instance.sh 脚本将不删除实例服务器存储数据库。您将必须通过使用废弃集合 SQL 命令手工删除实例服务器存储库。
语法

以下是 delete_instance.sh 的语法:

delete_instance.sh instanceName

其中:

remove_autostart_adapter.sh

此脚本从当前自动与服务器实例一起启动的适配器代理程序中除去自动启动指定项,并编辑 InterChange Server 实例的自动启动作业和除去提交适配器代理程序作业的语句。

语法

以下是 remove_autostart_adapter.sh 的语法:

remove_autostart_adapter.sh adapterName instanceName

其中:

remove_autostart_server.sh

此脚本从 InterChange Server 实例中除去自动启动指定项,并从 QWBISVR44 子系统中除去 InterChange Server 实例的自动启动作业条目。

语法

以下是 remove_autostart_adapter.sh 的语法:

remove_autostart_server.sh instanceName

其中:

set_ics_server_mode.sh

此脚本设置 InterChange Server 的模式。此脚本在 InterChange Server 下一次启动时应用新模式(design、production、testOn 或 testOff)。

语法

以下是 set_ics_server_mode.sh 的语法:

set_ics_server_mode.sh instanceName mode

其中:

stop_server_gracefully.sh

此脚本从 i5/OS 上的 CL 程序或命令输入处平稳地停止 InterChange Server,它等同于系统管理器或系统监视器发出平稳关闭命令。

语法

以下是 stop_server_gracefully.sh 的语法:

stop_server_gracefully.sh instanceName

其中:

注:
如果启用了 RBAC,则 stop_server_gracefully.sh 也需要
-uusername-ppassword 参数。

stop_adapter.sh

当使用系统管理器或系统监视器不可行时,此脚本平稳地停止适配器代理程序作业。

语法

以下是 stop_adapter.sh 的语法:

stop_adapter.sh instanceName adapterName

其中:

示例

以下是 JText 适配器的示例:

stop_adapter.sh QWBIDFT44 JText

submit_adapter.sh

此脚本提交适配器代理程序作业以在 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

submit_ics_server.sh

此脚本提交 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]

其中:

submit_name_server.sh

此脚本提交名称服务器作业以在 QWBISVR44 子系统中运行。

submit_oda.sh

此脚本提交 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

i5/OS 的用户概要文件安全性

为了安全起见,可能需要更改适配器代理程序进程在其下运行的用户概要文件,例如,JDBC 数据库权限或 JText 目录或文件。更改用户概要文件会禁止 QWBISVR44 用户概要文件访问这些适配器进程。

执行下列步骤来更改用户概要文件:

  1. 使用 CHGJOBD CL 命令来更改适配器代理程序的作业描述。将 USER 参数设置为新的用户概要文件。
  2. 通过将 USER 参数设置为新的用户概要文件,并将 AUT 参数设置为 *READ*EXECUTE,使用 GRTOBJAUT CL 命令来给新的用户概要文件授予对新作业描述的权限。
  3. 通过将 USER 参数设置为新的用户概要文件,并将 AUT 参数设置为 *READ*EXECUTE,使用 GRTOBJAUT CL 命令来给新的用户概要文件授予对 QWBISVR44 库的权限。
  4. 通过将 USER 参数设置为新的用户概要文件,并将 AUT 参数设置为 *READ*EXECUTE,使用 GRTOBJAUT CL 命令来给新的用户概要文件授予对 QWBISVR44 子系统描述的权限。
  5. 通过将 USER 参数设置为新的用户概要文件,并将 AUT 参数设置为 *READ*EXECUTE,使用 GRTOBJAUT CL 命令来给新的用户概要文件授予对 QWBISVR44 类的权限。
  6. 通过将 USER 参数设置为新的用户概要文件,并将 DTAAUT 参数设置为 *RWX,使用 CHGAUT CL 命令来给新的用户概要文件授予对集成文件系统中连接器所在目录的权限。

使用 i5/OS 停止子系统

当使用 i5/Os 停止子系统时,代码包括用于控制 ENDSBS *CNTRLD 操作的 sigaction 处理程序。此处理程序通过平稳地终止 InterChange Server 以及在本地系统上运行的任何作业或适配器,允许 QWBISVR44 子系统以受控方式结束。当该操作完成时,此处理程序自行终止。

Copyright IBM Corp. 2004, 2005