Rational Developer for System z, Versión 7.6.1

XSDBindSpec

Utilice este elemento del documento ServiceSpecification.xml para especificar las propiedades de generación del archivo de enlace XML nativo o del proveedor (archivo XSDBind).

El archivo XSDBind se utiliza para instalar un recurso de transformación XML (XMLTRANSFORM) en CICS Transaction Server versión 4.1 y posteriores. El recurso XMLTRANSFORM se utiliza en las API CICS EXEC: TRANSFORM XMLTODATA y TRANSFORM DATATOXML.

El recurso XMLTRANSFORM puede utilizarse para ejecutar la transformación XML en ambas direcciones (DATATOXML y XMLTODATA), para un documento XML y una estructura de datos. Esto no es así en el recurso WEBSERVICE, donde la transformación en un documento XML puede variar de la transformación en una estructura de datos.

Hay dos tipos de archivos XSDBind que se pueden generar: XSDBind nativo y XSDBind de proveedor.

A continuación, se muestra qué propiedades de generación se asocian con cada tipo de archivo XSDBind y ejemplos de cómo se pueden especificar.
XSDBind nativo (Conversión XML interpretativa):
  • Características:
    • CICS realiza la conversión XML utilizando un mecanismo interno
    • Especifique @type="interpretive" en el elemento PlatformProperties.xml/CodegenPropertyArray/CodegenProperty/@name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
    • Incluya "MessageSpec" dentro del elemento ServiceSpecification.xml/EISProject/EISService/Operation.

  • PlatformProperties.xml:
    <PlatformArray>
       <Platform>
          <CodegenPropertyArray>
             <CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE" 
                      value="interpretive"/>
           </CodegenPropertyArray>
       </Platform>
    </PlatformArray>
  • ServiceSpecification.xml (ascendente):
    <EISProject 
             xmlns="http:///com/ibm/etools/xmlent/batch/emf/BatchProcessModel.ecore" 
             name="CICSPROGProject">
       <EISService name="CICSPROG">
          <Operation>
             <MessageSpec  importFile="CICSPRG.cbl" importDirectory="."
                nativeTypeName="DFHCOMMAREA"/>
             <XseSpec>
                <XSDBindSpec fileName="CICSPROG.xsdbind" logFileName="CICSPRG.log"/>
             </XseSpec>
          </Operation>
       </EISService>
    </EISProject>
XSDBind de proveedor (Conversión XML compilada):
  • Características:
    • CICS realiza conversión XML mediante los programas de conversión XML generados por IBM® Rational Developer for System z
    • Especifique @type="compiled" en el elemento PlatformProperties.xml/CodegenPropertyArray/CodegenProperty/@name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
    • Incluya "MessageSpec" dentro del elemento ServiceSpecification.xml/EISProject/EISService/Operation.
  • PlatformProperties.xml:
    <PlatformArray>
       <Platform>
          <CodegenPropertyArray>
             <CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE" 
                      value="compiled"/>
          </CodegenPropertyArray>
       </Platform>
    </PlatformArray>
  • ServiceSpecification.xml (ascendente):
    <EISProject 
          xmlns="http:///com/ibm/etools/xmlent/batch/emf/BatchProcessModel.ecore" 
          name="CICSPROGProject">
       <EISService name="CICSPROG">
          <Operation>
             <MessageSpec  importFile="CICSPRG.cbl" importDirectory="." 
                   nativeTypeName="FHCOMMAREA"/>
             <XseSpec>
                <DriverSpec fileName="CICSPRGD.cbl" driverType="XML_TRANSFORM_CICS"
                      programName="CICSPRG"/>
                <ConverterSpecIn  fileName="CICSPRGD.cbl" programName="BUP001"/>
                <ConverterSpecOut fileName="CICSPRGD.cbl" programName="BUP001"/>
                <XSDBindSpec fileName="CICSPROG.xsdbind"  logFileName="CICSPROG.log"
                      mappingLevel="VENDOR" minimumRuntimeLevel="VENDOR"/>
             </XseSpec>
          </Operation>
       </EISService>
    </EISProject>

Contenido por

Contiene

Ninguno

Atributos

La Tabla 1 muestra los atributos de XSDBindSpec.

Tabla 1. Especificaciones de atributos para XSDBindSpec
Campos Descripción

Atributo: bundle
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Ninguno

Especifica la vía de acceso y el nombre del directorio de paquetes. Si especifica este valor, el esquema XML (que debe especificar en el elemento XSDSpec) y el archivo de enlace XML se generan en el directorio de paquetes y también se crea un manifiesto de paquete. La información de vía de acceso de este parámetro altera temporalmente la información de vía de acceso en el atributo fileName de XSDSpec y el atributo fileName de XSDBindSpec.

Atributo: ccsid
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Consulte la descripción

Especifica el CCSID utilizado durante la ejecución para codificar los datos entre el programa de aplicación y el archivo de enlace XML. El valor de este parámetro altera temporalmente el valor del parámetro de inicialización del sistema LOCALCCSID. El valor debe ser un CCSID EBCDIC soportado por Java™ y los servicios de conversión z/OS. Si no especifica este parámetro, el programa de aplicación utiliza el CCSID especificado en el parámetro de inicialización del sistema, y el archivo de enlace XML se codifica en US EBCDIC (Cp037).

Atributo: charVarying (EISService)
Valores válidos: NO | NULL |
COLLAPSE | BINARY
¿Obligatorio?: No
Valor predeterminado: NULL o COLLAPSE  
(consulte la descripción)

Especifica cómo se deben correlacionar las matrices de caracteres de la estructura de lenguaje cuando el nivel de correlación es 1.2 y superior.
Nota: Este parámetro no se aplica a Enterprise ni a otras estructuras de lenguaje PL/I.
Las opciones que puede seleccionar son:
  • NO -Las matrices de caracteres se correlacionan con una xsd:string y se procesan como campos de longitud fija. La longitud máxima de los datos es igual a la longitud de la matriz.
  • NULL - Las matrices de caracteres se correlacionan con una xsd:string y se procesan como matrices terminadas nulas. CICS añade un carácter nulo de terminación cuando se transforma a partir de un documento XML. La longitud máxima de la serie de caracteres se calcula como un carácter menos la longitud indicada en la estructura de lenguaje. Este es el valor predeterminado para los niveles de correlación 1.2 y 2.0.
  • COLLAPSE - Genera la descripción de datos de caracteres XML con el atributo de espacio en blanco establecido en "collapse". Este valor sólo está disponible en los niveles de correlación de 1.2 y superiores. Es el valor predeterminado para los niveles de correlación 2.1 y superiores.
  • BINARY- Las matrices de caracteres definidas en la estructura de lenguaje se correlacionan con campos xsd:base64Binary de longitud fija en WSDL en lugar de campos xsd:string.
Elementos necesarios:
  • PlatformProperties.xml/CodegenPropertyArray/CodegenProperty
    • @name="CONVERSION_TYPE"
    • @value="interpretive"
  • ServiceSpecification.xml/EISService

Atributo: charVarying
(EISServiceImplementation)
Valores válidos: NO | NULL
¿Obligatorio?: No
Valor predeterminado: NO  

Especifica cómo deben correlacionarse los datos de caracteres de longitud variable cuando el nivel de correlación es 1.2. Los tipos de datos binarios de longitud variable se correlacionan siempre con un contenedor o una estructura variable. Si no especifica este parámetro, la correlación predeterminada dependerá del lenguaje especificado. Las opciones que puede seleccionar son:
  • NO - Los datos de caracteres de longitud variable se correlacionan como series de longitud fija.
  • NULL - Los datos de caracteres de longitud variable se correlacionan con series terminadas nulas.
  • YES - Los datos de caracteres de longitud variable se correlacionan con un tipo de datos CHAR VARYING en PL/I. En los lenguajes COBOL, C y C++, los datos de caracteres de longitud variable se correlacionan con una representación equivalente formada por dos elementos relacionados: la longitud de datos y los datos.
Opciones por lotes necesarias:
  • PlatformProperties.xml/CodegenPropertyArray/CodegenProperty

    @name="CONVERSION_TYPE" @value="interpretive"

  • ServiceSpecification.xml/EISService

Atributo: charVaryingLimit
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: 32767

Especifica el tamaño máximo de datos binarios y datos de carácter de longitud variable correlacionados con la estructura de lenguaje cuando el nivel de correlación es 1.2. Si los datos binarios o los caracteres tienen una longitud mayor de la especificada en este parámetro, se correlacionan con un contenedor y el nombre del contenedor se utiliza en la estructura de lenguaje generada. El valor puede ir de 0 al valor predeterminado, 32767 bytes.
Opciones por lotes necesarias:
  • PlatformProperties.xml/CodegenPropertyArray/CodegenProperty

    @name="CONVERSION_TYPE" @value="interpretive"

  • ServiceSpecification.xml/EISService

Atributo: defaultCharMaxLength
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: 255  

Especifica la longitud de matriz predeterminada de los datos de carácter en los caracteres de correlaciones en las que no hay longitud implícita en el esquema XML cuando el nivel de correlación es 1.2. El valor de este parámetro puede ser un entero positivo en el rango de 1 a 2147483647.
Opciones por lotes necesarias:
  • PlatformProperties.xml/CodegenPropertyArray/CodegenProperty

    @name="CONVERSION_TYPE" @value="interpretive"

  • ServiceSpecification.xml/EISService

Atributo: fileName
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Consulte la descripción

Especifica el nombre del archivo de salida.

El valor predeterminado es: Nombre de archivo de origen de datos concatenado con ".xsdbind"

Atributo: inlineMaxOccursLimit
Valores válidos: 0 a 32767
¿Obligatorio?: No
Valor predeterminado: 1

Este atributo es equivalente al parámetro INLINE-MAXOCCURS-LIMIT de DFHLS2SC del asistente XML de CICS. El valor se utiliza para decidir si se debe incorporar el contenido repetitivo variable basándose en el valor del atributo maxOccurs del WSDL de origen. Puede encontrar una descripción completa en el centro de información de CICS Transaction Server V 4.1. Para ello, visite:

Atributo: logFileName
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Consulte la descripción

Especifica el nombre del archivo de anotaciones generado por el asistente de XML. Este valor de atributo sólo se utiliza cuando se especifica lo siguiente en el archivo PlatformProperties.xml: <CodegenPropertyname="com.ibm.etools.xmlent.ui. GEN_CONVERSION_TYPE "value="interpretive"/>

El valor predeterminado es: fileName concatenado con ".log"

Atributo: mappingLevel
Valores válidos: 1.0 | 1.1 | 1.2 |
2.0 | 2.1 |2.2 | 3.0
¿Obligatorio?: No
Valor predeterminado: 2.1

Especifica la versión de la interfaz programática compartida entre CICS y la aplicación (consulte el Centro de información de CICS® Transaction Server para z/OS, Versión 4 Release 1). Generalmente, es mejor especificar el nivel de correlación más alto disponible:
  • Los niveles de correlación 1.0 a 1.2 están soportados en CICS TS 3.1 con el APAR PK23547 aplicado.
  • Los niveles de correlación 1.0 a 2.1 están soportados en CICS TS 3.2 con el APAR PK59794 aplicado.
  • Los niveles de correlación 1.0 a 2.2 están soportados en CICS TS 3.2 con el APAR PK69738 aplicado.
  • Los niveles de correlación 1.0 a 3.0 están soportados en CICS TS 4.1.

El uso de niveles de correlación anteriores sólo está recomendado cuando se vuelven a generar los archivos de enlace XML para los recursos de transformación XML que se han desplegado previamente con un nivel de correlación anterior (consulte el Centro de información de CICS® Transaction Server for z/OS, Versión 4 Release 1).

1.0
Este es el nivel de correlación predeterminado de entorno de ejecución de CICS. Para obtener más información sobre los niveles de correlación, consulte la documentación de CICS TS 4.1 en: https://publib.boulder.ibm.com/infocenter/cicsts/v4r1/topic/com.ibm.cics.ts.webservices.doc/concepts/dfhws_utility.html
1.1
Utilice este nivel de correlación si necesita volver a generar un archivo de enlace en este nivel específico.
1.2
Este nivel de correlación proporciona las siguientes características:
  • Habilita el parámetro CHAR-VARYING en la pestaña DFHLS2SC y la pestaña DFHSC2LS de las preferencias.
  • Da soporte a las matrices VARYING y VARYINGZ.
Nota: El nivel de correlación 1.2 requiere el APAR PK23547.
2.0
Utilice este nivel de correlación para CICS TS 3.2.

Para obtener más información sobre los niveles de correlación, consulte la documentación de CICS TS 4.1 en: https://publib.boulder.ibm.com/infocenter/cicsts/v4r1/topic/com.ibm.cics.ts.webservices.doc/concepts/dfhws_utility.html

2.1
Utilice este nivel de correlación para CICS TS 3.2 con el APAR PK59794 y posteriores. En este nivel puede utilizar las características siguientes:

Se ha añadido soporte para xsd:any y xsd:anyType (para DFHSC2LS), visite : https://publib.boulder.ibm.com/infocenter/cicsts/v4r1/topic/com.ibm.cics.ts.applicationprogramming.doc/datamapping/dfhws_anytypesupport.html

2.2
Utilice este nivel de correlación con una región CICSS TS 3.2 que tenga aplicado el APAR PK69738. El nivel de correlación 2.2 proporciona el siguiente soporte:
  • Elementos con valores fijos
  • Soporte ampliado para elementos <xsd:choice>
  • Tipos de datos abstractos
  • Elementos abstractos
  • Grupos de sustitución.
3.0
Utilice este nivel de correlación para CICS TS 4.1.

Atributo: minimumRuntimeLevel
Valores válidos: MINIMUM |
3.0 | CURRENT
¿Obligatorio?: No
Valor predeterminado: MINIMUM

Especifica el entorno de ejecución CICS mínimo en el que el archivo de enlace XML puede desplegarse. Se visualiza un mensaje de error si se selecciona un nivel que no coincide con los demás parámetros especificados.
MINIMUM
El nivel mínimo posible de entorno de ejecución de CICS se asigna automáticamente a partir de los parámetros que se han especificado.
3.0
El archivo de enlace XML generado se despliega satisfactoriamente en CICS TS 4.1
CURRENT
El archivo de enlace XML se despliega satisfactoriamente en una región CICS con el nivel más alto posible de entorno de ejecución como el que está utilizando para generar el archivo de enlace XML

Atributo: nameTruncation
Valores válidos: RIGHT | LEFT
¿Obligatorio?: No
Valor predeterminado: RIGHT

Especifica cómo se acorta un nombre de campo si es demasiado largo para utilizarlo en el nivel de lenguaje especificado. Esta opción está disponible en todos los niveles de correlación.
RIGHT
El nombre de campo se trunca desde la derecha y se añade un sufijo numérico si es necesario.
LEFT
El nombre de campo se trunca desde la izquierda y se añade un sufijo numérico si es necesario.

Atributo: vendorConverterName
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Consulte la descripción

Especifica el nombre de programa de la entrada de programa principal.

El valor predeterminado es: DriverSpec/@fileName

Atributo: dateTime
Valores válidos: Consulte la descripción
¿Obligatorio?: No
Valor predeterminado: Consulte la descripción

Especifica cómo se correlacionan los elementos XML de tipo xsd:dateTime con el formato CICS ASKTIME. Este atributo sólo es válido para el tipo de conversión interpretativa CICS. Si se especifica para el tipo de conversión de proveedor (compilada), se ignora.

Este atributo sólo es válido en el nivel de correlación 3.0 y superior.

Si se especifica este atributo en un escenario descendente (es decir, si XSDBindSpec se especifica dentro de EISServiceImplementation), los valores válidos son:
  • PACKED15 (valor predeterminado)

    o bien

  • STRING
Si se especifica este atributo en un escenario ascendente (es decir, si XSDBindSpec se especifica dentro de EISService), los valores válidos son:
  • UNUSED (valor predeterminado)

    o bien

  • PACKED15

Atributo: dataTruncation
Valores válidos: DISABLED | ENABLED
¿Obligatorio?: No
Valor predeterminado: DISABLED

Especifica cómo trata el mecanismo de conversión nativa CICS los datos truncados:
  • Si se establece en ENABLED, CICS tolera los datos de aplicación truncados y se supone que los datos que faltan se han establecido en nulos.
  • Si se establece en DISABLED, CICS rechaza los datos truncados y emite un mensaje de error.
Nota: El valor ENABLED sólo está soportado en los niveles de correlación 3.0 y superiores.

Ejemplo

<XSDBindSpec fileName="CICSPROG.xsdbind"
         mappingLevel="VENDOR" logFileName="CICSPROG.log" ccsid="37" 
         minimumRuntimeLevel="VENDOR">
</XSDBindSpec>

Términos de uso | Comentarios

Este Information Center está basado en tecnología Eclipse. (http://www.eclipse.org)