Rational Developer for System z, Versión 7.6.1

Establecer las preferencias del asistente de servicios Web CICS (WSBind)

Para establecer preferencias para el asistente de servicios Web CICS (WSBind), abra la página Asistente de servicios Web (WSBind) en las preferencias de Enterprise Service Tools. Estas opciones afectan a los archivos WSBind 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 Servicios Web 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 servicios Web (WSBind):
  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 servicios Web (WSBind).
  3. Cambie las preferencias (las preferencias se describen en las secciones siguientes).
  4. Pulse Aceptar cuando termine.

El asistente de servicios Web CICS

Las preferencias en esta página afectan a los valores que Enterprise Service Tools pasa como parámetros de entrada al asistente de servicios Web CICS. El Asistente de servicios Web CICS es un conjunto de programas de utilidad por lotes que se proporcionan en CICS Transaction Server V3.1 y que generan archivos fuente COBOL para crear un nuevo servicio Web o para invocar un servicio Web existente.

El asistente de servicios Web CICS lo invocan los siguientes asistentes o programas de utilidad en Enterprise Service Tools: Asimismo, el asistente de servicios Web CICS sólo se invoca cuando se generan archivos de salida para el entorno de ejecución Servicios Web para CICS.
El asistente de servicios Web incluye dos procedimientos, DFHLS2WS y DFHWS2LS:
El asistente de servicios Web CICS se invoca si selecciona la conversión XML compilada de entorno de ejecución o la conversión XML interpretativa de entorno de ejecución (consulte Conversión XML de entorno de ejecución: compilada o interactiva). El tipo de archivo WSBind 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 servicios Web independientemente del escenario de entorno de ejecución que seleccione (ascendente, encuentro en el medio, descendente) e independientemente del tipo de conversión XML de entorno de ejecución que seleccione (compilada o interpretativa):

Nivel de correlación: (se visualiza en el asistente de servicios Web como el parámetro: MAPPING-LEVEL)
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. Los niveles de correlación 1.0 a 1.2 están soportados en CICS TS 3.1 y posteriores con el APAR PK23547 aplicado. Los niveles de correlación 1.0 a 2.1 están soportados en CICS TS 3.2 y posteriores con el APAR PK59794 aplicado. El uso de niveles de correlación anteriores sólo está recomendado cuando se vuelven a generar los archivos de enlace para servicios Web 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 CICS Transaction Server Infocenter, visite:
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:

http://publib.boulder.ibm.com/infocenter/cicsts/v4r1/topic/com.ibm.cics.ts.applicationprogramming.doc/datamapping/dfhws_mappinglevels.html

o bien

Centro de información de CICS® Transaction Server para z/OS, Versión 4 Release 1

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 DFHLS2WS y la pestaña DFHWS2LS 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.
Nota: Utilice la correlación 2.0 si está desplegando el archivo WSBind en TXSeries for Multiplatforms.

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

o bien

Centro de información de CICS® Transaction Server para z/OS, Versión 4 Release 1

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 xsd:any y xsd:anyType (para DFHWS2LS), visite : http://publib.boulder.ibm.com/infocenter/cicsts/v4r1/topic/com.ibm.cics.ts.applicationprogramming.doc/datamapping/dfhws_anytypesupport.html

o bien

Centro de información de CICS® Transaction Server para z/OS, Versión 4 Release 1

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 servicios Web 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 de servicio Web. 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.
1.0
El archivo de enlace de servicio Web generado se despliega satisfactoriamente en una región de CICS TS 3.1 que no tiene aplicados los APAR PK15904 y PK23547 .
1.1
El archivo de enlace de servicio Web generado se despliega satisfactoriamente en una región de CICS TS 3.1 que tiene aplicado como mínimo el APAR PK15904.
1.2
El archivo de enlace de servicio Web se despliega satisfactoriamente en una región de CICS TS 3.1 que tiene aplicados los APAR PK15904 y PK23547.
Nota: No se necesitan estos APAR para CICS TS 3.2 y posteriores.
2.0
El archivo de enlace de servicio Web generado se despliega satisfactoriamente en CICS TS 3.2.
2.1
El archivo de enlace de servicio Web generado se despliega satisfactoriamente en CICS TS 3.2 con el APAR PK59794 aplicado.
3.0
El archivo de enlace de servicio Web generado se despliega satisfactoriamente en CICS TS 4.1
CURRENT
El archivo de enlace de servicio Web 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 de servicio Web.
CCSID: (se visualiza en el asistente de servicios Web 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 de servicios Web. 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 de servicio Web se codifica en US EBCDIC (Cp037).

ID de usuario: (se visualiza en el asistente de servicios Web como el parámetro: USERID)

En un proveedor de servicio, esta preferencia específica un ID de usuario de 1-8 caracteres que puede utilizar cualquier cliente Web. Para una respuesta generada por la aplicación o un servicio Web, la transacción de alias se adjunta con este ID de usuario. El valor de esta preferencia se utiliza para definir el atributo USERID del recurso URIMAP cuando se crea automáticamente utilizando el mandato de exploración PIPELINE.

Los caracteres válidos son A-Z a-z 0-9 $ @ #.

Transacción: (se visualiza en el asistente de servicios Web como el parámetro: TRANSACTION)

En un proveedor de servicios, esta preferencia especifica el nombre de 1-4 caracteres de una transacción de alias que puede iniciar la interconexión o ejecutar una aplicación de usuario para componer una respuesta HTTP. El valor de esta preferencia se utiliza para definir el atributo TRANSACTION del recurso URIMAP cuando se crea automáticamente utilizando el mandato de exploración PIPELINE.

Los caracteres válidos son A-Z a-z 0-9 $.

Servicio: (se visualiza en el asistente de servicios Web como el parámetro: SERVICE)

Utilice esta preferencia solo cuando se lo indique el soporte técnico de IBM®.

Opciones por lotes necesarias:
  • PlatformProperties.xml/CodegenPropertyArray/CodegenProperty
    • @name="CONVERSION_TYPE"
    • @value="interpretive"
  • ServiceSpecification.xml/EISService
Recorte de datos: (se visualiza en el asistente de servicios Web 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.
Punto de sincronismo en retorno: (se visualiza en el asistente de servicios Web como el parámetro: SYNCONRETURN)
La selección de esta opción especifica que el servicio Web remoto puede emitir un punto de sincronismo. Lo que implica establecer esta opción en YES es que la tarea remota se confirma al volver. La tarea remota se clasifica como una unidad de trabajo (UOW) independiente. Esto significa que si el servicio Web remoto actualiza un recurso recuperable y se produce una anomalía después de volver, no se puede retrotraer la actualización. Si se toma esta opción de forma predeterminada o se establece en NO y el servicio Web remoto emite un punto de sincronismo, la tarea remota falla con ABEND ADPL. Para obtener más información, consulte la descripción de PK406622 en http://www.ibm.com/support/docview.wss?uid=swg1PK40662

Preferencias en la pestaña DFHLS2WS

Las preferencias en la pestaña DFHLS2WS se pasan al asistente de servicios Web sólo cuando el tipo de escenario es Crear interfaz de servicio (ascendente) y el tipo de conversión XML de entorno 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 servicios Web 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 PL/I y Otros.
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.
Versión de SOAP: (se visualiza en el asistente de servicios Web como el parámetro: SOAPVER)

Esta preferencia controla qué versión del enlace de protocolo SOAP genera IBM Rational Developer for System z en un archivo WSDL. Los valores válidos para esta opción son "1.1", "1.2" y "ALL". Cuando se especifica una versión determinada, se genera el enlace SOAP que se adecua a la versión de protocolo SOAP en el archivo WSDL. Si se selecciona ALL, se generan ambos enlaces en el archivo WSDL.

Si el usuario no especifica esta opción, el valor predeterminado de esta opción depende del valor de VERSIÓN DE WSDL: Si la versión de WSDL solicitada se establece en 1.1, el valor predeterminado de la versión SOAP se establece en 1.1. Si la versión de WSDL solicitada se establece en 2.0, el valor predeterminada de la versión SOAP se establece en 1.2.

Además, si especifica esta opción, se fuerza el establecimiento del Nivel mínimo de entorno de ejecución en un valor de 2.0. Para obtener información adicional, consulte Opciones del nivel mínimo de entorno de ejecución.
Nota: Esta opción afecta solamente al escenario ascendente interpretativo de servicios Web CICS. Para obtener más información sobre el comportamiento del archivo WSBind con varias versiones de SOAP, consulte la documentación de CICS TS 3.2.
Versión de WSDL: (se visualiza en el asistente de servicios Web como el parámetro: WSDL_1.1 o WSDL_2.0)
Esta preferencia controla qué versión del WSDL (descripción de servicio Web) genera IBM Rational Developer for System z Actualmente, los valores válidos para esta opción son "1.1" y "2.0". Esta opción afecta solamente al escenario ascendente interpretativo de servicios Web CICS.
Nota: La especificación de 2.0 como versión de WSDL fuerza que la opción de nivel mínimo de entorno de ejecución se establezca en 2.0 independientemente del nivel de correlación WSBind. Para obtener más información, consulte la descripción del atributo mappingLevel (consulte la sección Descripción del nivel de correlación) y el atributo runtimeLevel (consulte la sección Descripción de nivel de entorno de ejecución).
Fecha/hora: (se visualiza en el asistente de servicios Web 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 DFHWS2LS

Las preferencias en la pestaña DFHWS2LS se pasan al asistente de servicios Web sólo cuando el tipo de escenario es Crear implementación de servicio (descendente) y el tipo de conversión XML de entorno de ejecución es interpretativa. (El procesador por lotes equivalente a Crear implementación de servicio (descendente) 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 servicios Web 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 servicios Web 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 servicios Web 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 servicios Web 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 servicios Web 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 archivo WSDL origen. Para ver una descripción completa, visite:
Fecha/hora: (se visualiza en el asistente de servicios Web 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.
XML de paso a través: (se visualiza en el asistente de servicios Web como el parámetro: XML-ONLY)
Si está marcado, CICS no realiza ninguna transformación en XML y en su lugar necesita que la aplicación trabaje directamente con el contenido del contenedor DFHWS-BODY. Para ver una descripción completa, visite:

Términos de uso | Comentarios

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