Rational Developer for System z, Versión 7.6.1

Establecer las preferencias del asistente de transformación XML de CICS (XSDBind)

Para establecer preferencias para el asistente de transformación XML CICS (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 genera archivos para el entorno de ejecución 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):
  1. En la barra de menús del entorno de trabajo, seleccione Ventana > Preferencias. Se abrirá la ventana Preferencias.
  2. En el panel izquierdo de la ventana Preferencias, expanda Enterprise Service Tools y seleccione Asistente de transformación XML de CICS (XSDBind).
  3. Cambie las preferencias (las preferencias se describen en las secciones siguientes).
  4. Pulse Aceptar cuando termine.

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 suministrados en CICS Transaction Server V4.1, que generan todo lo necesario para crear un nuevo servicio de transformación XML de CICS.

El asistente de transformación XML se invoca mediante los siguientes asistentes o programas de utilidad en Enterprise Service Tools: Asimismo, el asistente de transformación XML sólo se invoca cuando se generan archivos de salida para el entorno de ejecución Transformación XML para CICS.
El asistente de transformación XML incluye dos procedimientos, DFHLS2SC y DFHSC2LS:
El asistente de transformación XML se invoca si selecciona la conversión XML compilada de tiempo de ejecución o la conversión XML interpretativa de tiempo de ejecución (consulte Conversión XML de entorno de ejecución: compilada o interactiva). El tipo de archivo XSDBind generado depende del tipo de conversión XML de entorno de ejecución que seleccione:

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)
Este preferencia 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.
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 posterior con el APAR PK59794 aplicado. En este nivel puede utilizar las características siguientes:

Se ha añadido soporte para el elemento de esquema XML <xsd:any> y el tipo de datos xsd:anyType (para DFHSC2LS) (consulte 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 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.

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 mínimo de CICS 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 mínimo posible de entorno de ejecución de CICS se asigna automáticamente a partir de los parámetros que ha 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.
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 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).

Recorte de datos: (se visualiza en el asistente de transformación XML como el parámetro: DATA-TRUNCATION)
La selección de esta opción especifica cómo maneja el mecanismo de conversión nativa CICS los datos truncados. Si se establece en ENABLED, CICS acepta los datos de aplicación truncados y se supone que los datos que faltan se han establecido en nulos. El valor ENABLED sólo está soportado en los niveles de correlación 3.0 y superiores. Si se establece en DISABLED, CICS rechaza los datos de aplicación truncados y envía un mensaje de error. El valor predeterminado es DISABLED.

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 las estructuras de lenguaje Enterprise y otras PL/I.
NO
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 cuando se transforma a partir de 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 de conversión interpretativa CICS (esta preferencia se ignora para el tipo de conversión compilada de proveedor). Si selecciona esta opción, especifica cómo se correlacionan los elementos XML de tipo xsd:dateTime con el formato CICS ASKTIME. 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.

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).

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 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.
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 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 se compone 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:
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 de conversión interpretativa CICS (esta preferencia se ignora para el tipo de conversión compilada de proveedor). Si selecciona esta opción, especifica cómo se correlacionan los elementos XML de tipo xsd:dateTime con el formato CICS ASKTIME. 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
Es el valor predeterminado. 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.

Términos de uso | Comentarios

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