Utilice este elemento del documento ServiceSpecification.xml para especificar las propiedades de generación del archivo WSBind nativo o del proveedor.
El archivo WSBind se utiliza para instalar un nuevo servicio Web bajo CICS Transaction Server versión 3.1 y posteriores.
Hay dos tipos de archivos WSBind que se pueden generar: WSBind nativo y WSBind de proveedor.
A continuación, se muestra qué propiedades de generación se asocian con cada tipo de archivo WSBind 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>
<OutputMessage importFile="CICSPROG.cbl" importDirectory="."
nativeTypeName="DFHCOMMAREA"/>
<InputMessage importFile="CICSPROG.cbl" importDirectory="."
nativeTypeName="DFHCOMMAREA"/>
<XseSpec>
<WSBindSpec fileName="CICSPROG.wsbind"
uri="/cics/services/CICSPROG" logFileName="CICSPROG.log"
businessPgmName="CICSPROG"/>
</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>
<OutputMessage importFile="CICSPRG.cbl" importDirectory="."
nativeTypeName="DFHCOMMAREA"/>
<InputMessage importFile="CICSPRG.cbl" importDirectory="."
nativeTypeName="DFHCOMMAREA"/>
<XseSpec>
<DriverSpec fileName="CICSPRGD.cbl" driverType="WEB_SERVICES_CICS"
programName="CICSPRG" businessPgmName="CICSPROG"/>
<ConverterSpecIn fileName="CICSPRGD.cbl" programName="BUP001"/>
<ConverterSpecOut fileName="CICSPRGD.cbl" programName="BUP001"/>
<WSBindSpec fileName="CICSPROG.wsbind" uri="/cics/services/CICSPROG"
logFileName="CICSPROG.log"
mappingLevel="VENDOR" minimumRuntimeLevel="VENDOR"/>
</XseSpec>
</Operation>
</EISService>
</EISProject>
La Tabla 1 muestra los atributos para WSBindSpec.
| Campos | Descripción |
|---|---|
Atributo: businessPgmName |
Especifica el programa comercial existente al que llama el entorno de ejecución de
servicios Web CICS.
Este es el programa que está habilitando para procesar y/o generar mensajes XML para
actuar como servicio Web. Este atributo sólo es significativo para la conversión
nativa de CICS y para especificar el punto de entrada de programa comercial destino para
varias operaciones en la conversión compilada. El valor predeterminado es: El nombre de servicio del archivo WSDL generado truncado en 8 caracteres. |
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 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). |
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 Enterprise ni a otras estructuras de lenguaje PL/I.
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: contid |
Si el programa de aplicación CICS (especificado en el atributo DriverSpec/businessPgmName o WSBindSpec/businessPgmName del elemento) se comunica por medio de un CHANNEL, especifique el nombre del CONTAINER esperado por el programa. |
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.
|
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 WSBindSpec se especifica dentro de
EISServiceImplementation), los valores válidos son:
Si se especifica este atributo en un escenario
ascendente (es decir, si WSBindSpec se especifica dentro de EISService), los valores
válidos son:
|
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 origen de datos concatenado con ".wsbind" (consulte la Nota 1). |
Atributo: inlineMaxOccursLimit |
Este atributo es equivalente al parámetro INLINE-MAXOCCURS-LIMIT de DFHLS2WS del asistente de servicios Web 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 archivo WSDL origen. Puede encontrar una descripción completa en línea en CICS Transaction Server V 4.1 InfoCenter. Para ello, consulte: |
Atributo: logFileName |
Especifica el nombre del archivo de anotaciones generado por el asistente de servicios Web. 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 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:
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).
|
Atributo: minimumRuntimeLevel |
Especifica el entorno de ejecución CICS mínimo en el que el archivo de enlace de
servicio Web puede desplegarse. Se visualiza un mensaje de error si se selecciona un nivel que
no coincide con los demás parámetros especificados.
|
Atributo: nameTruncation |
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.
|
Atributo: overwrite |
Especifica si debe sobrescribirse el archivo de salida si existe. |
Atributo: pgmint |
Especifique si el programa de aplicación
CICS se comunica por medio de:
|
Atributo: requestChannel |
Si el programa de aplicación CICS (especificado en el atributo DriverSpec/businessPgmName o WSBindSpec/businessPgmName del elemento) se comunica por medio de un CHANNEL (varios contenedores), especifique la ubicación del documento de descripción de canal de la petición. Este atributo sólo es válido
para el tipo de conversión interpretativa CICS
(ascendente). 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.
Nota: Las ubicaciones de estructura de lenguaje especificadas en el documento de descripción de
canal deben estar en el sistema de archivos local (por ejemplo: <ubicación de
estructura=”c:\MyStructures\copybook.cpy”/>)
|
Atributo: responseChannel |
Si el programa de aplicación CICS (especificado en el atributo DriverSpec/businessPgmName o WSBindSpec/businessPgmName del elemento) se comunica por medio de un CHANNEL (varios contenedores), especifique la ubicación del documento de descripción de canal de la respuesta. Este atributo sólo es válido
para el tipo de conversión interpretativa CICS
(ascendente). 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.
Nota: Las ubicaciones de estructura de lenguaje especificadas en el documento de descripción de
canal deben estar en el sistema de archivos local (por ejemplo: <ubicación de
estructura=”c:\MyStructures\copybook.cpy”/>)
Si la aplicación utiliza el mismo conjunto de contenedores para la respuesta que para la petición, especifique el mismo valor que en requestChannel |
Atributo: service |
Utilice este parámetro sólo cuando se lo indique el soporte técnico
de IBM. Opciones por lotes necesarias:
|
Atributo: suppressGeneration |
Indica si debe suprimirse la generación del archivo de enlace de servicio Web (WSBind). |
Atributo: synconreturn |
Especifica que el servicio Web remoto puede emitir un punto de sincronismo. Este atributo es equivalente al parámetro SYNCONRETURN de las páginas DFHLS2WS y DFHWS2LS del asistente de servicios Web de CICS. 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 |
Atributo: transaction |
En un proveedor de servicios, este parámetro 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 este parámetro
se utiliza para definir el atributo TRANSACTION del recurso URIMAP cuando se crea
automáticamente utilizando el mandato de exploración PIPELINE. Caracteres aceptables: A-Z a-z 0-9 $ |
Atributo: uri |
URI local deseado para el servicio Web, por ejemplo, "/exampleApp/InquireSingle". Nota: este URI es diferente de la ubicación del servicio Web, por ejemplo, http://servidor:puerto[URI local]. Si no especifica esta propiedad, deberá definirla durante la instalación cuando cree manualmente las definiciones de recursos de servicio Web en CICS. |
Atributo: userid |
En un proveedor de servicio, este parámetro 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 este parámetro se utiliza para definir el atributo USERID del
recurso URIMAP cuando se crea automáticamente utilizando el mandato de exploración
PIPELINE. Caracteres aceptables: A-Z a-z 0-9 $ @ # |
Atributo: vendorConverterName |
Especifica el nombre de programa de la entrada de programa principal. El valor predeterminado es: DriverSpec/@fileName (consulte la Nota 1) |
Atributo: xmlOnly |
Si este atributo se establece en true, 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, consulte: Centro de información de CICS® Transaction Server para z/OS, Versión 4 Release 1 |
Nota: Cuando hay varias operaciones
presentes, se aplican los siguientes valores predeterminados de WSBind:
|
|
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
<WSBindSpec fileName="CICSPROG.wsbind" uri="/cics/services/CICSPROG"
mappingLevel="VENDOR" logFileName="CICSPROG.log" ccsid="37"
minimumRuntimeLevel="VENDOR" userid="WEBUSER" transaction="WBTR">
</WSBindSpec>