Establecimiento de preferencias para el Asistente de transformación XML de CICS (XSDBind)

Editar en línea

Para establecer preferencias para CICS® XML Transformation Assistant (XSDBind), abra la página Asistente XML (XSDBind) en las preferencias de Enterprise Service Tools. Estas opciones afectan a los archivos XSDBind y de estructura de lenguaje generados.

Estas preferencias afectan a la generación de recursos sólo cuando se generan archivos para el entorno de ejecución de Transformación XML para CICS . Estas preferencias no afectan a la generación de recursos para los otros entornos de ejecución.

Para establecer preferencias para el asistente de transformación XML (XSDBind):

En el panel izquierdo de la ventana Preferencias, expanda Enterprise Service Tools y seleccione Asistente de transformación XML de CICS (XSDBind).
Cambie las preferencias (las preferencias se describen en las secciones siguientes).
Pulse Aceptar cuando haya terminado.

El asistente de transformación XML

Las preferencias en esta página afectan a los valores que Enterprise Service Tools pasa como parámetros de entrada al asistente de transformación XML. El asistente de transformación XML es un conjunto de programas de utilidad por lotes, que se proporcionan en CICS Transactions Server V5.2 o posterior, que generan necesarios para crear un nuevo servicio de transformación XML CICS .

El asistente de transformación XML se invoca mediante los siguientes asistentes o programas de utilidad en Enterprise Service Tools:

Asistente Crear nueva transformación XML (ascendente)
Asistente Crear nueva transformación XML (descendente)
Procesador por lotes de línea de comandos (ver Procesador por lotes )
Nota: El asistente Correlacionar una interfaz de servicio existente (encuentro en el medio) no está soportado.

De nuevo, el asistente de transformación XML se invoca sólo al generar archivos de salida para el entorno de ejecución de transformación XML para CICS .

El asistente de transformación XML incluye dos procedimientos, DFHLS2SC y DFHSC2LS:

DFHLS2SC genera un esquema XML y un archivo de enlace XML a partir de una estructura de datos de lenguaje de alto nivel.
DFHSC2LS: genera un archivo de enlace XML y estructuras de datos de lenguaje de alto nivel a partir de (1) un esquema XML o (2) la sección de tipos de un archivo WSDL.

El asistente de transformación XML se invoca si selecciona la conversión XML de tiempo de ejecución compilada o la conversión XML de tiempo de ejecución interpretativa (consulte Conversión XML de tiempo de ejecución: compilada o interpretativa). El tipo de archivo XSDBind generado depende del tipo de conversión XML de entorno de ejecución que seleccione:

Si selecciona la conversión XML interpretativa de entorno de ejecución, se genera un archivo XSDBind de interfaz nativa.
Si selecciona la conversión XML compilada de entorno de ejecución, se genera un archivo XSDBind de interfaz de proveedor.

Limitación: XMLCP de DFHLS2SC no está soportado.

Preferencias en la pestaña Comunes

Las preferencias en la pestaña Comunes se pasan al asistente de transformación XML independientemente del escenario de tiempo de ejecución que seleccione (ascendente, encuentro en el medio, descendente) e independientemente del tipo de conversión XML de tiempo de ejecución que seleccione (compilada o interpretativa):

Nivel de correlación: (se visualiza en el asistente de transformación XML como el parámetro: MAPPING-LEVEL)

Esta preferencia especifica la versión de la interfaz programática compartida entre CICS y la aplicación (consulte CICS® Transaction Server for z/OS®, Versión 5 Release 4, Documentación IBM® ). 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 con 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.
Los niveles de correlación 1.0 a 4.0 están soportados en CICS TS 5.2.
Los niveles de correlación 1.0 a 4.1 están soportados en CICS TS 5.3 con el APAR PI67641 aplicado.

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.

1.0

Este es el nivel de correlación predeterminado de tiempo de ejecución de CICS .

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 Variación de caracteres 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.

2.1

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

LÍMITE MÁXIMO DE OCURRENCIA EN LÍNEA
Consulte la descripción de la preferencia Límite maxOccurs en línea en la pestaña DFHSC2LS (consulte Límite maxOccurs en línea).

Se ha añadido soporte para el elemento de esquema XML <xsd:any> y el tipo de datos xsd:anyType (para DFHSC2LS) (consulte el Soporte para <xsd:any> y xsd:anyType).

2.2

Utilice este nivel de correlación con una región CICS 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 mejorado para<xsd:choice>elementos
Tipos de datos abstractos
Elementos abstractos
Grupos de sustitución

3.0

Utilice este nivel de correlación para CICS TS 4.1.

4.0

Utilice este nivel de correlación con una región CICS TS 5.2 o posterior. En este nivel, están disponibles las funciones siguientes:

DFHLS2SC y DFHLS2WS dan soporte a la cláusula COBOL OCCURS DEPENDING ON y también dan soporte a la correlación de matrices de caracteres COBOL en series de XML. Puede establecer este comportamiento utilizando el parámetro CHAR-OCCURS en los asistentes CICS.
Los servicios web de CICS dan soporte a la conversión de datos de aplicación codificados utilizando UTF-16 Unicode.

Para más información, consulte Asistentes de mapeo de niveles para el CICS.

4.1

Utilice este nivel de correlación con una región CICS TS 5.3 con el APAR PI67641 o posterior. En este nivel de tiempo de ejecución, están disponibles las funciones siguientes:

Los parámetros TRUNCATE-NULL-ARRAYS y TRUNCATE-NULL-ARRAY-VALUES están soportados por DFHLS2SC, DFHLS2WS y DFHLS2JS.

El nivel de tiempo de ejecución mínimo: (se visualiza en el asistente de transformación XML como el parámetro: MINIMUM-RUNTIME-LEVEL)

Esta preferencia especifica el entorno de ejecución CICS mínimo en el que se puede desplegar el archivo de enlace XML. Si selecciona un nivel que no coincide con los otros parámetros que ha especificado, aparece un mensaje de error.

El valor que seleccione para esta preferencia sólo se utiliza si también selecciona la conversión XML interpretativa de entorno de ejecución. Si selecciona la conversión XML compilada de entorno de ejecución, el asistente o el programa de utilidad de Enterprise Service Tools establece siempre el nivel mínimo de entorno de ejecución en VENDOR.

MINIMUM: El nivel de tiempo de ejecución más bajo posible de CICS se asigna automáticamente dados los parámetros que ha especificado.
3.0: El archivo de enlace XML generado se despliega correctamente en CICS TS 4.1
4.0: El archivo de enlace de servicio web generado se despliega correctamente en una región CICS TS 5.2 o posterior. Con este nivel de ejecución, puede utilizar un nivel de correlación de 4.0 o anterior para el parámetro MAPPING-LEVEL.
4.1: El archivo de enlace de servicio web generado se despliega satisfactoriamente en una región CICS TS 5.3 o posterior. Con este nivel de ejecución, puede utilizar un nivel de correlación de 4.1 o anterior para el parámetro MAPPING-LEVEL.
CURRENT: El archivo de enlace XML generado se despliega correctamente en una región CICS en el nivel de tiempo de ejecución más alto disponible como el que está utilizando para generar el archivo de enlace XML.

CCSID: (se visualiza en el asistente de transformación XML como el parámetro: 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 los servicios de conversión Java™ y 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).

Recorte de datos: (se visualiza en el asistente de transformación XML como el parámetro: DATA-TRUNCATION)

Al seleccionar esta opción se especifica cómo maneja el mecanismo de conversión nativa CICS los datos truncados. Cuando se establece en ENABLED, CICS acepta datos de aplicación truncados y presupone que los datos que faltan se establecen en nulos. El valor ENABLED sólo está soportado en los niveles de correlación 3.0 y superiores. Cuando se establece en DISABLED, CICS rechaza los datos de aplicación truncados y envía un mensaje de error. El valor predeterminado es DISABLED.

Exploración de datos: (Se muestra en el asistente de transformación XML como el parámetro: DATA-SCREENING)

Seleccione esta opción para especificar si se han explorado los datos proporcionados por la aplicación en busca de errores. Cuando se establece en ENABLED, los datos de tiempo de ejecución proporcionados por la aplicación que no son compatibles con la estructura del lenguaje se tratan como un error y se muestra el mensaje DFHPI1010. Se devuelve una respuesta de error a la aplicación. Cuando se establece en DISABLED, los valores de datos de los datos de tiempo de ejecución proporcionados por la aplicación que no son compatibles con la estructura del lenguaje se sustituyen por valores predeterminados.

Preferencias en la pestaña DFHLS2SC

Las preferencias en la pestaña DFHLS2SC se pasan al asistente de transformación XML sólo cuando el tipo de escenario es Crear interfaz de servicio (ascendente) y el tipo de conversión XML de tiempo de ejecución es interpretativa. (El procesador por lotes equivalente a Crear interfaz de servicio (ascendente) es el elemento EISService).

Estas preferencias no están habilitadas si la opción seleccionada en el recuadro de lista Nivel de correlación o el recuadro de lista Nivel mínimo de entorno de ejecución de la pestaña Comunes no las admite.

Variación de caracteres: (se visualiza en el asistente de transformación XML como el parámetro: CHAR-VARYING)

Esta preferencia especifica cómo se correlacionan las matrices de caracteres en la estructura de lenguaje cuando el nivel de correlación es 1.2 o superior.

Nota: Esta preferencia no se aplica a Enterprise ni a otras estructuras lingüísticas de PL/I.

NEE: Las matrices de caracteres se correlación 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 correlación con una xsd:string y se procesan como matrices terminadas nulas. CICS añade un carácter nulo de terminación al transformar desde un mensaje SOAP. La longitud máxima de la serie de caracteres se calcula como un carácter menos la longitud indicada en la estructura de lenguaje.
COLLAPSE: Genera la descripción de datos de caracteres XML con el atributo whiteSpace 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.

Fecha/hora: (se visualiza en el asistente de transformación XML como el parámetro: DATETIME)

Esta preferencia especifica que los elementos XML se correlacionan en un escenario ascendente y sólo es válida para el tipo interpretativo CICS (esta preferencia se ignora para el tipo de conversión compilada de proveedor). Al seleccionar esta opción se especifica cómo se asignan los elementos XML de tipo xsd:dateTime al formato ASKTIME CICS. Los valores válidos son PACKED15 o UNUSED.

Nota: Esta preferencia sólo está disponible en el nivel de correlación 3.0 y superior.

Apariciones de caracteres: (Se muestra en el asistente de transformación XML como el parámetro: CHAR-OCCURS)

Esta preferencia especifica cómo se correlacionan las matrices de caracteres en la estructura de lenguaje cuando el nivel de correlación es 4.0 o superior. Por ejemplo,PIC X OCCURS 20. Este parámetro sólo puede ser utilizado por el idioma COBOL.

ARRAY
Las matrices de caracteres se correlacionan con una matriz XML, lo que significa que cada carácter se correlaciona como un elemento XML individual. Esto también se aplica al comportamiento de los niveles de correlación 3.0 y anterior.
SERIE
Esta es opción la predeterminada. Las matrices de caracteres se correlacionan con una matriz XML, lo que significa que cada matriz COBOL completa se correlación como un único elemento XML.

Uso de caracteres: (Se muestra en el asistente de transformación XML como el parámetro: CHAR-USAGE)

En COBOL, el tipo de datos nacional, PIC N, se puede utilizar para datos UTF-16 o DBCS. Este valor está controlado por la opción del compilador NSYMBOL. En el asistente, debe establecer el parámetro CHAR-USAGE con el mismo valor que la opción de compilador NSYMBOL para asegurarse de que los datos se manejen correctamente. Normalmente, se establece en CHAR-USAGE=NATIONAL cuando se utiliza UTF-16.

DBCS
Los datos de los campos PIC ( n ) se tratan como datos codificados DBCS.
NATIONAL
Este es el valor por omisión. Los datos de los campos PIC ( n ) se tratan como datos codificados UTF-16.

Truncar matrices nulas: (Se muestra en el asistente de transformación XML como el parámetro: TRUNCATE-NULL-ARRAYS)

Esta preferencia especifica cómo se procesan las matrices estructuradas. Si está habilitado, CICS intentará reconocer registros vacíos en una matriz.

Truncar valores de matrices nulas: (Se muestra en el asistente de transformación XML como el parámetro: TRUNCATE-NULL-ARRAY-VALUES)

Esta preferencia especifica qué valores se tratan como vacíos en el proceso de TRUNCATE-NULL-ARRAYS. Si todos los bytes de almacenamiento de un registro de una matriz estructurada contienen nulos, se considera que el registro completo está vacío. Se puede especificar un valor NULL, SPACE y ZERO o varios en una lista separada por comas.

NULL
NULL: 0x00, o valores inferiores, se tratan como vacíos
SPACE
0x40 se trata como vacío
ZERO
0xF0 se trata como vacío

Preferencias en la pestaña DFHSC2LS

Las preferencias en la pestaña DFHSC2LS se pasan al asistente de transformación XML sólo cuando el tipo de escenario es Crear nueva transformación XML (descendente) y el tipo de conversión XML de entorno de ejecución es interpretativa. (El procesador por lotes equivalente a Crear nueva transformación XML (ascendente) es el elemento EISServiceImplementation).

Variación de caracteres: (se visualiza en el asistente de transformación XML como el parámetro: CHAR-VARYING)

Esta preferencia 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.

NEE: 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.
SÍ: Los datos de caracteres de longitud variable se correlacionan con un tipo de datos de Variación de caracteres en PL/I. En los lenguajes COBOL, C y C++, los datos de caracteres de longitud variable se correlacionan con una representación equivalente que consta de dos elementos relacionados: la longitud de datos y los datos.

Límite de variación de caracteres: (se visualiza en el asistente de transformación XML como el parámetro: CHAR-VARYING-LIMIT)

Esta preferencia 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. El valor está comprendido en el rango de 0 a 32767 bytes. El valor predeterminado es de 32767 bytes.

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.

Longitud máxima de caracteres predeterminada: (se visualiza en el asistente de transformación XML como el parámetro: DEFAULT-CHAR-MAXLENGTH)

Esta preferencia 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 puede ser un entero positivo en el rango de 1 a 2147483647.

Multiplicador de caracteres: (se visualiza en el asistente de transformación XML como el parámetro: CHAR-MULTIPLIER)

Esta preferencia especifica el número de bytes que se debe permitir para cada carácter 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. Todas las correlaciones basadas en caracteres no numéricos están sujetas a este multiplicador. Los campos binarios, numéricos, de zona y decimal empaquetado no están sujetos a este multiplicador.

Este parámetro puede ser muy útil si, por ejemplo, tiene previsto utilizar caracteres DBCS cuando podría optar por un multiplicador de 3 para dejar espacio para posibles caracteres de desplazamiento a teclado ideográfico y a teclado estándar en cada carácter de doble byte durante la ejecución.

Límite de apariciones máximas de incorporación en línea: (se visualiza en el asistente de transformación XML como el parámetro: INLINE-MAXOCCURS-LIMIT)

El valor especificado por esta preferencia se utiliza para decidir si se debe incorporar el contenido repetitivo variable basándose en el valor del atributo maxOccurs del esquema XML de origen. Para ver una descripción completa, visite:

Matrices variables de elementos

Fecha/hora: (se visualiza en el asistente de transformación XML como el parámetro: DATETIME)

Esta preferencia especifica que los elementos XML se correlacionan en un escenario descendente y sólo es válida para el tipo interpretativo CICS (esta preferencia se ignora para el tipo de conversión compilada de proveedor). Al seleccionar esta opción se especifica cómo se asignan los elementos XML de tipo xsd:dateTime al formato ASKTIME CICS. Los valores válidos son PACKED15 o UNUSED.

Nota: Esta preferencia sólo está disponible en el nivel de correlación 3.0 y superior.

Recorte de nombre: (se visualiza en el asistente de transformación XML como el parámetro: NAME-TRUNCATION)

Esta preferencia 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: Este es el valor por omisión. 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.

Soporte decimal de 31 dígitos: (Se visualiza en el asistente de transformación XML como el parámetro: WIDE-COMP3)

Esta preferencia controla el tamaño máximo de longitud de variable decimal de paquete que se correlaciona con una estructura en lenguaje COBOL. Si se configura como SI, utilizará 31 dígitos para los tipos DECIMAL y ENTERO. Si se configura como NO (predeterminado), el número de dígitos seguirá siendo 18. Esta opción está disponible en todos los niveles de correlación.

Menos nombres duplicados (Se visualiza en el Asistente de transformación XML como parámetro: LESS-DUP-NAMES)

Sólo para PL/I. Este parámetro genera nombres de campo de estructura no estructurales con _valor al final del nombre para habilitar las referencias directas al campo. El sufijo _valor sólo se añade cuando existe un conflicto de nombres entre el nombre estructural y el nombre no estructural.

Subrayados como guiones (se visualiza en el asistente de transformación XML como el parámetro: UNDERSCORES-AS-HYPHENS)

Solo para COBOL. Este parámetro convierte los subrayados en el documento WSDL en guiones, en lugar del carácter X, para mejorar la legibilidad de las estructuras de lenguaje COBOL generadas. Si se produce algún conflicto de nombre de campo, los campos se numeran para asegurar que sean exclusivo.

Guiones como subrayados: (Se muestra en el asistente de transformación XML como el parámetro: HYPHEN-AS-UNDERSCORES)

Sólo para PL/I. Este parámetro convierte los guiones del documento WSDL en signos de subrayado, en lugar de en el carácter X, para mejorar la lectura de las estructuras de lenguaje PL/I generadas. Esta opción no está seleccionada de forma predeterminada.

Dígitos de fracción predeterminados: (Se muestra en el asistente de transformación XML como el parámetro: DEFAULT-FRACTGION-DIGITS)

Este parámetro especifica el número predeterminado de dígitos de fracción que se han de utilizar en el tipo de esquema decimal JSON. El valor predeterminado es 3. Para COBOL, el rango válido es de 0 a 17, o de 0 a 30 si se está utilizando el parámetro WIDE-COMP3. En C o PL/I, el rango válido es de 0 a 30.