Utilice este elemento del documento ServiceSpecification.xml para especificar las opciones 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.
<PlatformArray>
<Platform>
<CodegenPropertyArray>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
value="interpretive"/>
</CodegenPropertyArray>
</Platform>
</PlatformArray>
<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>
<PlatformArray>
<Platform>
<CodegenPropertyArray>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE"
value="compiled"/>
</CodegenPropertyArray>
</Platform>
</PlatformArray>
<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>
La Tabla 1 muestra los atributos de XSDBindSpec.
| Campos | Descripción |
|---|---|
Atributo: bundle |
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 |
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) |
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 las estructuras
de lenguaje Enterprise PL/I y Otros.
Las opciones que puede seleccionar son:
Elementos necesarios:
|
Atributo: charVarying |
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:
Opciones por lotes necesarias:
|
Atributo: charVaryingLimit |
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:
|
Atributo: defaultCharMaxLength |
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 documento de
descripción de servicio Web 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:
|
Atributo: fileName |
Especifica el nombre del archivo de salida. El valor predeterminado es: Nombre de archivo de origen de datos concatenado con ".xsdbind" |
Atributo: inlineMaxOccursLimit |
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 |
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 |
Especifica la versión de la interfaz de programación compartida
entre CICS y la
aplicación. Generalmente, es mejor especificar el nivel de correlación más alto
disponible:
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. Los detalles
sobre los niveles de correlación se pueden encontrar en línea en el centro de
información de CICS Transaction Server. Para ello, visite:
|
Atributo: mappingLevel (continuación) |
|
Atributo: minimumRuntimeLevel |
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.
|
Atributo: vendorConverterName |
Especifica el nombre de programa de la entrada de programa principal. El valor predeterminado es: DriverSpec/@fileName |
Atributo: dateTime |
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:
Si se especifica este atributo en un escenario
ascendente (es decir, si XSDBindSpec se especifica dentro de EISService), los valores
válidos son:
|
Atributo: dataTruncation |
Especifica cómo trata el mecanismo de conversión
nativa CICS los datos truncados:
Nota: El valor
ENABLED sólo está soportado en los niveles de correlación 3.0 y superiores.
|
Consulta relacionada
Asistente de servicios Web CICS:
http://publib.boulder.ibm.com/infocenter/cicsts/v3r2/topic/com.ibm.cics.ts.webservices.doc/concepts/dfhws_utility.html
<XSDBindSpec fileName="CICSPROG.xsdbind"
mappingLevel="VENDOR" logFileName="CICSPROG.log" ccsid="37"
minimumRuntimeLevel="VENDOR">
</XSDBindSpec>