Rational® Developer for System z® V8.0 支持使用 Enterprise Service Tools 批处理器并根据用户提供的 WSDL 文件来创建新的自顶向下的 PL/I 和 IMS™ Enterprise Suite SOAP Gateway 服务提供者 MPP。为了启用此新支持,已经对 RDz 和 IMS Connect 的 Enterprise Service Tools 组件进行了多项改进。
增强了 Enterprise Service Tools 批处理器。
已经增强了批处理器,以支持通过将本文档其余部分所描述的新功能集成到可重复执行的组合生成过程,从而生成自顶向下的 IMS PL/I 工件。
WSDL2ELS(从 WSDL 到企业语言结构)
WSDL2ELS 由 Enterprise Service Tools 批处理器调用;当给定一个 WSDL 文件作为输入时,它将生成下列工件。
- 为用户提供的 WSDL 服务和端口的每项操作的每条输入和输出消息都生成了 PL/I 语言结构。对所生成的语言结构应用了一种编程模型,此模型有助于稀疏数组、可变数组和无限数组以及可选元素。
- 为由用户指定的 WSDL 服务和端口的每项操作的每条输入和输出消息都生成了映射会话文件,以表示 XSD 元素和属性声明与 PL/I 语言结构成员之间的映射。并非已生成的所有语言结构成员都会映射至 XSD 元素或属性,使用注释表示的某些成员之间将互相具有关系。
- 生成了 WSDL2ELS 元数据,以捕获由用户提供的 WSDL 与由 WSDL2ELS 生成的工件之间的高级关系。此文件采用 XML 格式,Enterprise Service Tools 批处理器按程序使用此文件来生成 XML 转换器、IMS Enterprise SOAP Gateway 相关因子文件和模板 IMS Web Service 提供程序 MPP。
- 提供了日志文件,以帮助确定问题。
所给定的 WSDL 的 IMS PL/I 提供程序 MPP 模板程序
根据 WSDL2ELS 元数据生成了模板 IMS PL/I 提供程序 MPP。此模板程序包括由 WSDL2ELS 生成的语言结构,并从用于获取服务调用上下文的逻辑开始。一旦从消息协议头中检索到服务上下文,模板就会分支到一项用于处理与所调用操作相对应的过程的操作。每个操作处理过程都演示了如何通过使用由 RDz 提供的 API,以根据新的消息协议来检索语言结构并存储在 IMS 消息队列中。
使用自顶向下方案开发的服务提供者 MPP 和 XML 转换器所必需的新消息协议和分段 API (IRZPWSIO) 提供了多项增强功能,作为使用自底向上方案的服务提供者来启用的 MPP 并不具备这些增强功能:
有关更多信息,请参阅数据集 FEK.SFEKSAMP 中的 PL/I 包含成员 IRZPWSH。
具有 REFER 和编程模型支持的自顶向下 IMS Connect PL/I XML 转换器
可以将 IMS Enterprise Suite SOAP Gateway 的 RDz PL/I 自顶向下支持描述为具有下列特点:已增强、自动化和中间会合。为了支持无限数组,应用于由 WSDL2ELS 生成的语言结构的编程模型、消息协议和分段 API 以及由自顶向下方案的 Enterprise Service Tools 批处理器生成的 PL/I XML 转换器,与为其他方案生成的相应内容显著不同,并且依赖于通过 APAR PM11648 交付的 IMS Connect 增强功能。
注: 要构建自顶向下的 IMS PL/I XML 转换器,需要 PL/I 包含成员 FEK.SFEKSAMP(IRZPWSH) 以及 PL/I 装入模块 FEK.SFEKLOAD(IRZPWSIO)。
为 IMS PL/I 自顶向下方案所生成的 XML 转换器可能会发生下列新的 Language Environment® 情况:
- IRZ0500S 未能在 PROCEDURE-NAME 过程中完成将 XML 转换为语言结构,这是因为在尝试将语言结构 STRUCTURE-NAME 存储到 IMS Connect 消息输出缓冲区时,从 API IRZXSETS 中接收到返回码 RETURN-CODE。
- IRZ0501S 未能在 PROCEDURE-NAME 过程中完成将语言结构转换为 XML,这是因为在尝试从 IMS Connect 消息输入缓冲区中检索语言结构 STRUCTURE-NAME 时,从 API IRZXGETS 中接收到返回码 RETURN-CODE。
- IRZ0502S 未能在 PROCEDURE-NAME 过程中完成将语言结构转换为 XML,这是因为对 ARRAY-NAME 数组的数组计数器变量 COUNTER-NAME 指定的值 COUNTER-VALUE 超过了该数组的限制值 ARRAY-LIMIT。
IMS Enterprise Suite SOAP Gateway 多操作相关因子文件
Enterprise Service Tools 批处理器将为 IMS PL/I 自顶向下方案中所提供的 WSDL 中的每项操作都生成唯一的 XML 转换器。因此,对于每项用于指定各个 XML 转换器名称的操作,由此批处理器所生成的 SOAP Gateway 相关因子文件中都将有一个条目。