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):
- En la
barra de menús del entorno de trabajo, seleccione
. Se abrirá la ventana Preferencias.
- En el panel izquierdo de la ventana Preferencias, expanda
Enterprise Service
Tools y seleccione
Asistente de servicios Web
(WSBind).
- Cambie las preferencias (las preferencias se describen en las secciones
siguientes).
- 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:
- Asistente Crear interfaz de servicio (ascendente)
- El asistente Correlacionar una interfaz de servicio existente (encuentro en el
medio)
- Asistente Crear implementación de servicio (descendente)
- Procesador por lotes de línea de mandatos (consulte
Procesador por lotes)
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:
- DFHLS2WS genera una descripción de servicio Web y un archivo de enlace de servicio
Web a partir de una estructura de datos de lenguaje de alto nivel. Este procedimiento se
invoca cuando desea exponer un programa de aplicación
CICS como proveedor de servicio
(escenario ascendente).
- DFHWS2LS genera una estructura de lenguaje de alto nivel y un archivo de enlace de
servicio Web a partir de una descripción de servicio Web. Este procedimiento se invoca
cuando desea crear un programa de proveedor de servicios para una
aplicación CICS nueva o existente, o cuando desea
crear un programa de peticionario de servicios (escenario
descendente).
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:
- Si
selecciona la conversión XML interpretativa de entorno de ejecución, se genera un
archivo WSBind de interfaz nativa.
- Si selecciona la conversión XML compilada de entorno de ejecución, se genera un
archivo WSBind de interfaz de proveedor.
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:
- 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: