WSBindSpec

使用 ServiceSpecification.xml 文档的此元素来指定本机或供应商 WSBind 文件的生成属性。

WSBind 文件用于在 CICS® Transaction Server V 3.1 和更高版本下安装新的 Web Service。

可以生成两种类型的 WSBind 文件: 本机 WSBind 和供应商 WSBind。

下面显示了哪些生成属性与每个 WSBind 文件类型相关联以及如何指定这些属性的示例。

本机 WSBind (解释 XML 转换):

特征:
- CICS 使用内部机制执行 XML 转换
- 在元素 'PlatformProperties.xml/CodegenPropertyArray/CodegenProperty/@name="com 上指定 @type="interpretive" .ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
- 指定 ServiceSpecification.xml/../WSBindSpec/@businessPgmName="name of CICS program"

PlatformProperties.xml：

<PlatformArray>
   <Platform>
      <CodegenPropertyArray>
         <CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE" 
            value="interpretive"/>
       </CodegenPropertyArray>
   </Platform>
</PlatformArray>

ServiceSpecification.xml (自底向上):

<EISProject 
         xmlns="http:///com/ibm/etools/xmlent/batch/emf/BatchProcessModel.ecore" 
         name="CICSPROGProject">
   <EISService name="CICSPROG">
      <Operation>
         <OutputMessage importFile="CICSPROG.cbl" importDirectory="."
            nativeTypeName="DFHCOMMAREA"/>
         <InputMessage  importFile="CICSPROG.cbl" importDirectory="." 
            nativeTypeName="DFHCOMMAREA"/>
         <XseSpec>
            <WSBindSpec fileName="CICSPROG.wsbind" 
            uri="/cics/services/CICSPROG" logFileName="CICSPROG.log"
                  businessPgmName="CICSPROG"/>
         </XseSpec>
      </Operation>
   </EISService>
</EISProject>

供应商 WSBind (编译的 XML 转换):

特征:
- CICS 使用 Developer for z/OS® 生成的 XML 转换程序执行 XML 转换
- 在元素 'PlatformProperties.xml/CodegenPropertyArray/CodegenProperty/@name="com 上指定 @type="compiled" .ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
- 指定ServiceSpecification.xml/../DriverSpec/@driverType="WEB_SERVICES_CICS"
- 指定 ServiceSpecification.xml/../DriverSpec/@businessPgmName="name of CICS program"。

PlatformProperties.xml：

<PlatformArray>
   <Platform>
      <CodegenPropertyArray>
         <CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE" 
                  value="compiled"/>
      </CodegenPropertyArray>
   </Platform>
</PlatformArray>

ServiceSpecification.xml (自底向上):

<EISProject 
      xmlns="http:///com/ibm/etools/xmlent/batch/emf/BatchProcessModel.ecore" 
      name="CICSPROGProject">
   <EISService name="CICSPROG">
      <Operation>
         <OutputMessage importFile="CICSPRG.cbl" importDirectory="." 
               nativeTypeName="DFHCOMMAREA"/>
         <InputMessage  importFile="CICSPRG.cbl" importDirectory="." 
               nativeTypeName="DFHCOMMAREA"/>
         <XseSpec>
            <DriverSpec fileName="CICSPRGD.cbl" driverType="WEB_SERVICES_CICS"
               programName="CICSPRG"  businessPgmName="CICSPROG"/>
            <ConverterSpecIn  fileName="CICSPRGD.cbl" programName="BUP001"/>
            <ConverterSpecOut fileName="CICSPRGD.cbl" programName="BUP001"/>
            <WSBindSpec fileName="CICSPROG.wsbind" uri="/cics/services/CICSPROG" 
               logFileName="CICSPROG.log"
               mappingLevel="VENDOR" minimumRuntimeLevel="VENDOR"/>
         </XseSpec>
      </Operation>
   </EISService>
</EISProject>

包含于

包含

无

属性

表1 显示了 WSBindSpec 的属性。

表 1. WSBindSpec 的属性规范
字段	描述
属性: arithExtend 有效值: NO \| YES 必需?: 否缺省值: NO	控制映射到 COBOL 语言结构的十进制变量长度的最大大小。如果设置为 YES，则 DECIMAL 和 INTEGER 类型将使用 31 位数字。如果设置为 NO (缺省值) ，那么位数保持为 18。此选项在所有映射级别都可用。
属性： businessPgmName' 有效值：参见描述 '必填：否缺省值: 请参阅描述	指定 CICS Web Service 运行时调用的现有业务程序。这是支持处理和/或生成 XML 消息以充当 Web Service 的程序。此属性仅对 CICS 本机转换有意义，并用于指定编译转换中的多个操作的目标业务程序入口点。缺省值为: 生成的 WSDL 文件中的服务名称截断为 8 个字符。
属性: ccsid 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	指定在运行时用于在应用程序与 Web Service 绑定文件之间对数据进行编码的 CCSID。此参数的值将覆盖 LOCALCCSID 系统初始化参数的值。该值必须是 Java™ 和 z/OS 转换服务支持的 EBCDIC CCSID。如果未指定此参数，那么应用程序将使用系统初始化参数中指定的 CCSID ，并且 Web Service 绑定文件将以 US EBCDIC (Cp037) 编码。
属性: charVarying (EISService) 有效值: NO \| NULL \| 折叠 \| BINARY 必需?: 否缺省值: NULL 或折叠 (请参阅 "描述")	指定当映射级别为 1.2 及更高时应如何映射语言结构中的字符数组。注：该参数不适用于企业版和其他 PL/I 语言结构。您可以选择的选项包括: NO-字符数组映射到 xsd: string ，并作为固定长度字段进行处理。数据的最大长度等于数组的长度。 NULL-字符数组映射到 xsd: string ，并作为以 null 结束的数组进行处理。 CICS 在从 SOAP 消息转换时添加终止空字符。字符串的最大长度计算为比语言结构中指示的长度小一个字符。此值是映射级别 1.2 和 2.0 的缺省值折叠-在将 whiteSpace 属性设置为 "折叠" 的情况下生成 XML 字符数据描述。此值仅在 1.2 及更高级别的映射级别可用。此值是映射级别 2.1 及更高版本的缺省值。 BINARY-语言结构中定义的任何字符数组都将映射到 WSDL 中的固定长度 xsd:base64Binary 字段，而不是映射到 xsd: string 字段。必须元素： PlatformProperties.xml/CodegenPropertyArray/CodegenProperty @name= "CONVERSION_TYPE " @value=" 解释 " ServiceSpecification.xml/EISService
属性: charVarying (EISServiceImplementation) 有效值: NO \| NULL \| YES 必需?: 否缺省值: NO	指定当映射级别为 1.2 或更高时如何映射可变长度字符数据。可变长度二进制数据类型始终映射到容器或不同的结构。如果未指定此参数，那么缺省映射取决于指定的语言。您可以选择的选项包括: NO-可变长度字符数据映射为固定长度字符串。 NULL-可变长度字符数据映射到以 null 结束的字符串。是 - 长度可变的字符数据在 PL/I 中被映射为 CHAR VARYING 数据类型。在 COBOL、C 和 C++ 语言中，长度可变的字符数据被映射为由两个相关元素（数据长度和数据）组成的等价表示。必需的批处理选项: PlatformProperties.xml/CodegenPropertyArray/CodegenProperty @name= "CONVERSION_TYPE " @value=" 解释 " ServiceSpecification.xml/EISService
属性： charVaryingLimit' 有效值：参见描述 '必需？否缺省值: 32767	指定映射级别为 1.2 或更高时映射到语言结构的二进制数据和可变长度字符数据的最大大小。如果字符或二进制数据大于此参数中指定的值，那么会将其映射到容器，并在生成的语言结构中使用容器名称。该值的范围可以从 0 到缺省 32767 字节。必需的批处理选项: PlatformProperties.xml/CodegenPropertyArray/CodegenProperty @name= "CONVERSION_TYPE " @value=" 解释 " ServiceSpecification.xml/EISService
属性: contid 有效值: 请参阅描述必需?: 否 (如果 pgmint 设置为 CHANNEL) 缺省值: 无 (请参阅注释 1)	如果CICS应用程序（指定元素的DriverSpec/businessPgmName或WSBindSpec/businessPgmName属性）通过 CHANNEL 通信，则指定程序期望的 CONTAINER 名称。
属性: dataTruncation 有效值: DISABLED \| ENABLED 必需?: 否缺省值: DISABLED	指定 CICS 本机转换机制如何处理截断的数据: 如果设置为 ENABLED ，那么 CICS 允许截断应用程序数据，并假定缺失数据设置为空。如果设置为 DISABLED ，那么 CICS 将拒绝截断的应用程序数据并发出错误消息。注: 仅在映射级别 3.0 及更高版本上支持 ENABLED 设置。
属性: dateTime 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	指定如何将 xsd:dateTime 类型的 XML 元素映射为 CICS ASKTIME 格式。此属性仅对 CICS 解释转换类型有效。如果为 "供应商 (已编译)" 转换类型指定了该值，那么将忽略该值。此属性仅在映射级别 3.0 及更高版本上有效。如果在自顶向下方案中指定此属性 (即，在 EISServiceImplementation中指定了 WSBindSpec ) ，那么有效值为: PACKED15 (缺省值) 或者 STRING 如果在自底向上 (即，在 EISService 中指定了 WSBindSpec ) 中指定了此属性，那么有效值为: 未用 (缺省值) 或者 PACKED15
属性： defaultCharMaxLength' 有效值：参见描述 '必需？否缺省值: 255	当映射级别为 1.2 或更高时，指定映射的字符数据的缺省数组长度 (以字符计) ，其中 Web Service 描述文档中不包含任何长度。此参数的值可以是 1 到 2147483647 范围内的正整数。必需的批处理选项: PlatformProperties.xml/CodegenPropertyArray/CodegenProperty @name= "CONVERSION_TYPE " @value=" 解释 " ServiceSpecification.xml/EISService
属性: fileName 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	指定输出文件的名称缺省值为: 数据源文件名与 ". wsbind" 并置 (请参阅注释 1)。
属性： inlineMaxOccursLimit' 有效值： 0 至 32767 '必填：否缺省值: 1	此属性等同于 CICS Web Service 助手 DFHLS2WS的 INLINE-MAXOCCURS-LIMIT 参数。该值用于根据源 WSDL 文件中 maxOccurs 属性的值来决定是否直接插入变量重复内容。可以在 CICS Transaction Server V 5.3 文档中找到完整描述，请参阅: DFHWS2LS: WSDL到高级语言的转换
属性： logFileName' 有效值：请参阅说明 '必需？否缺省值: 请参阅描述	指定 Web Service 助手生成的日志文件的名称。 This attribute value is used only when the following is specified in thePlatformProperties.xml file:<CodegenPropertyname="comibm.etools.xmlent.ui. GEN_CONVERSION_TYPE "value = "之解释" /> 缺省值为: fileName 与 ". log" 并置
属性: mappingLevel 有效值: 1.0 \| 1.1 \| 1.2 \| 2.0 \| 2.1 \|2.2 \| 3.0 \| 4.0 必需?: 否缺省值: 2.1 (请参阅注释 1)	指定 CICS 与应用程序共享的程序界面的版本（请参阅 CICS 助手的映射级别）。通常，最好指定可用的最高映射级别: 在应用了 APAR PK23547 的 CICS TS 3.1 中支持将级别 1.0 映射到 1.2 。在应用了 APAR PK59794 的 CICS TS 3.2 中支持将级别 1.0 映射到 2.1 。在应用了 APAR PK69738 的 CICS TS 3.2 中支持将级别 1.0 映射到 2.2 。 CICS TS 4.1中支持将级别 1.0 映射到 3.0 。在 CICS TS 5.2 和 5.3中支持将级别 1.0 映射到 4.0 。仅当为之前使用旧映射级别部署的XML转换资源重新生成XML绑定文件时，才建议使用旧映射级别（请参阅 CICS® Transaction Server for z/OS ，第5版第2版知识中心）。 1.0 这是 CICS 运行时缺省映射级别。如需了解有关地图级别的更多信息，请参阅 CICS TS 4.1 文档： CICS 网络服务助手 1.1 如果需要在此特定级别重新生成绑定文件，请使用此映射级别。 1.2 此映射级别提供以下功能: 它在首选项的 DFHLS2WS 选项卡上和 DFHWS2LS 选项卡上启用 CHAR-VARYING 参数。它支持 VARYING 和 VARYINGZ 阵列，注: 映射级别 1.2 需要 APAR PK23547。 2.0 将此映射级别用于 CICS TS 3.2。如需了解有关地图级别的更多信息，请参阅 CICS TS 4.1 文档： CICS 网络服务助手 2.1 将此映射级别用于应用了 APAR PK59794 的 CICS TS 3.2 和更高版本。在此级别，您可以启用以下功能: inline-maxoccurs-limit 请参阅向导的 DFHWS2LS 选项卡上 Inline maxOccurs limit 首选项的描述 (请参阅 Inline maxOccurs limit)。 XML-ONLY (也称为传递 XML) 请参阅向导的 DFHWS2LS 选项卡上传递 XML 首选项的描述 (请参阅传递 XML)。 WSDL-NAMESPACE 请参阅向导的 WSDL 和 XSD 选项卡上 WSDL 名称空间首选项的描述 (请参阅 WSDL 名称空间)。添加了对 XML 架构元素 <xsd:any> 和数据类型 xsd:anyType （用于 DFHWS2LS ）的支持（请参阅对 <xsd:any> 和 xsd:anyType 支持）。 2.2 将此映射级别与应用了 APAR PK69738 的 CICS TS 3.2 区域配合使用。映射级别 2.2 提供以下支持: 具有固定值的元素增强了对`<xsd:choice>`元素抽象数据类型抽象元素替换组。 3.0 将此映射级别用于 CICS TS 4.1。 4.0 将此映射级别用于 CICS TS 5.2 和 5.3。
属性: mappingOverides 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	指定在生成语言结构时是否覆盖指定映射级别的缺省行为。您可以选择的选项包括: LESS-DUP-NAMES - 仅用于 PL/I。此参数生成名称末尾带有 _value 的非结构结构字段名称，以允许直接引用该字段。仅当结构名称与非结构名称之间存在名称冲突时，才会追加后缀 _value。 UNDERSCORES-AS-HYPHENS - 仅适用于 COBOL。该参数将 WSDL 文档中的下划线转换为连字符，而不是 X 字符，以提高生成的 COBOL 语言结构的可读性。如果发生任何字段名称冲突，那么将对这些字段进行编号以确保它们是唯一的。
属性 'minimumRuntimeLevel' '有效值：最小值 \| ' '1.0\| '1.1\| '1.2\| ' '2.0\| '2.1\| '4.0当前 ' 需要什么？否缺省值: MINIMUM (请参阅注释 1)	指定可以将 Web Service 绑定文件部署到的最低 CICS 运行时环境。如果选择的级别与指定的其他参数不匹配，那么将显示错误消息。 MINIMUM 如果指定了参数，那么将自动分配 CICS 的最低可能运行时级别。 1.0 生成的 Web Service 绑定文件成功部署到未应用 APAR PK15904 和 PK23547 的 CICS TS 3.1 区域。 1.1 生成的 Web Service 绑定文件成功部署到至少应用了 APAR PK15904 的 CICS TS 3.1 区域中。 1.2 生成的 Web Service 绑定文件成功部署到应用了 APAR PK15904 和 PK23547 的 CICS TS 3.1 区域中。注: CICS TS 3.2 和更高版本不需要这些 APAR。 2.0 生成的 Web Service 绑定文件成功部署到 CICS TS 3.2中。 2.1 生成的 Web Service 绑定文件成功部署到应用了 APAR PK59794 的 CICS TS 3.2 中。 3.0 生成的 Web Service 绑定文件成功部署到 CICS TS 4.1 4.0 生成的 Web Service 绑定文件成功部署到 CICS TS 5.2 和 5.3 CURRENT 生成的 Web Service 绑定文件成功部署到具有最高可用运行时级别的 CICS 区域中，就像您用来生成 Web Service 绑定文件一样。
属性: nameTruncation 有效值: RIGHT \| LEFT 必需?: 否缺省值: right	指定如果生成的字段名称太长而无法在指定的高级语言中使用，那么如何缩短该字段名称。此选项在所有映射级别都可用。 RIGHT 将从右侧截断字段名称，必要时将添加数字后缀。 LEFT 字段名称从左侧截断，如果需要，将添加数字后缀。
属性: overwrite 有效值: true \| false 必需?: 否缺省值: true	指定是否覆盖输出文件 (如果存在)。
属性: pgmint 有效值: 0 \| 1\| 2 必需?: 否缺省值: 2	指定 CICS 应用程序是否通过以下方式进行通信: 0-通道描述文档使用 CHANNEL DESCRIPTION DOCUMENT ，当 Web Service 在其应用程序接口中使用许多容器时，必须首先创建一个通道描述文档来描述容器。通道描述文档是符合 CICS提供的模式的 XML 文档。通道描述文档仅对 (1) CICS 解释 (自底向上) 转换类型和 (2) 映射级别 3.0 及更高版本有效。 1-通道当 Web Service 在其应用程序接口中使用一个容器时，请使用 CHANNEL。 2-DFHCOMMAREA 这是缺省值。
属性: requestChannel 有效值: 请参阅描述必需?: 否 (如果 pgmint 设置为 CHANNEL DESCRIPTION DOCUMENT) 缺省值: 无	如果CICS应用程序（指定了元素的DriverSpec/businessPgmName或WSBindSpec/businessPgmName属性）通过 CHANNEL（多个容器）进行通信，请指定请求的通道描述文件的位置。此属性仅对 CICS 解释 (自底向上) 转换类型有效。如果为 "供应商 (已编译)" 转换类型指定了该值，那么将忽略该值。此属性仅在映射级别 3.0 及更高版本上有效。注: 通道描述文档中指定的语言结构位置应该位于本地文件系统上 (例如: `<structure location=”c:\MyStructures\copybook.cpy”/>`)
属性: responseChannel 有效值: 请参阅描述必需?: 否缺省值: 无	如果CICS应用程序（指定了元素的DriverSpec/businessPgmName或WSBindSpec/businessPgmName属性）通过 CHANNEL（多个容器）进行通信，请为响应指定通道说明文档的位置。此属性仅对 CICS 解释 (自底向上) 转换类型有效。如果为 "供应商 (已编译)" 转换类型指定了该值，那么将忽略该值。此属性仅在映射级别 3.0 及更高版本上有效。注: 通道描述文档中指定的语言结构位置应该位于本地文件系统上 (例如: `<structure location=”c:\MyStructures\copybook.cpy”/>`) 如果应用程序对响应使用的容器集与对请求使用的容器集相同，请指定与 requestChannel 相同的值
属性: service 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	仅当 IBM® 支持人员指示时才使用此参数。必需的批处理选项: PlatformProperties.xml/CodegenPropertyArray/CodegenProperty @name= "CONVERSION_TYPE " @value= "解释" ServiceSpecification.xml/EISService
属性: suppressGeneration 有效值: true \| false 必需?: 否缺省值: false	指示是否禁止生成 Web Service 绑定文件 (WSBind)。
属性: synconreturn 有效值: YES \| NO 必需?: 否缺省值: NO	指定远程 Web Service 可以发出同步点。此属性等同于 CICS Web Service 助手向导页面 DFHLS2WS 和 DFHWS2LS的 SYNCONRETURN 参数。将此选项设置为 YES 的含义是在返回时落实远程任务。远程任务被分类为单独的工作单元 (UOW)。这意味着如果远程 Web Service 更新可恢复资源，并且在返回后发生故障，那么无法回退更新。如果此选项为缺省值或设置为 NO ，并且远程 Web Service 发出同步点，那么远程任务将与 ABEND 民协失败。
属性: transaction 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	在服务提供商中，此参数指定一个1-4个字符的别名事务名称，该别名事务可以启动管道或运行用户应用程序以生成 HTTP 响应。此参数的值用于在使用 PIPELINE 扫描命令自动创建 URIMAP 资源时定义 TRANSACTION 属性。可接受的字符: `A-Z a-z 0-9 $`
属性: uri 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	网络服务的本地 URI，例如"/exampleApp/InquireSingle"。注意：这与网络服务的位置不同，例如http://server:port[localURI]。如果不指定此属性，则必须在安装时在CICS 中手动创建 Web 服务资源定义时定义。
属性: userid 有效值: 请参阅描述必需?: 否缺省值: 请参阅描述	在服务提供者中，此参数指定可由任何 Web 客户机使用的 1-8 字符用户标识。对于应用程序生成的响应或 Web Service ，将在此用户标识下附加别名事务。此参数的值用于在使用 PIPELINE 扫描命令自动创建 URIMAP 资源时定义该资源的 USERID 属性。可接受的字符: `A-Z a-z 0-9 $ @ #`
属性： vendorConverterName' 有效值：参见描述 '必填：否缺省值: 请参阅描述	指定主程序项的程序名。默认值为DriverSpec/@fileName（参见注释1）
属性: xmlOnly 有效值: true \| false 必需?: 否缺省值: false	如果此属性设置为 true ，那么 CICS 根本不会对 XML 执行任何变换，而是要求应用程序直接使用 DFHWS-BODY 容器的内容。有关完整说明，请参阅 CICS® Transaction Server for z/OS 版本 5 第 2 版 IBM 文档
注: 存在多个操作时，以下 WSBind 缺省设置适用: contid 值 :WSDL 中的服务名称 fileName:WSDL 文件位置和 WSDL 文件名，扩展名为 .wsbind mappingLevel: 1.2 minimumRuntimeLevel: 1.2 vendorConverterName:WSDL 中的服务名称截断为 8 个字符

相关参考

CICS 网络服务助理：
CICS 网络服务助理

示例

<WSBindSpec fileName="CICSPROG.wsbind" uri="/cics/services/CICSPROG" 
         mappingLevel="VENDOR" logFileName="CICSPROG.log" ccsid="37" 
         minimumRuntimeLevel="VENDOR" userid="WEBUSER" transaction="WBTR">
</WSBindSpec>