Utilice este elemento del documento PlatformProperties.xml para especificar las propiedades de generación del código de conversor o, en el documento ServiceSpecification.xml, para alterar temporalmente las propiedades de generación de código establecidas en PlatformProperties.xml.
Inicie el valor del atributo name con com.ibm.etools.xmlent.ui.
Tabla 1 muestra los atributos de CodegenProperty.
| Campos | Descripción |
|---|---|
Atributo: |
El valor de este atributo indica a los generadores de conversor COBOL
que generen código basado en un nivel específico del compilador Enterprise COBOL. Por ejemplo, las limitaciones en el tamaño de los datos pueden variar
de una versión del compilador a otra. El establecimiento de la versión del compilador Enterprise COBOL en 3.4, por
ejemplo, permite un tamaño máximo de mensaje XML de 32 MB, mientras que una versión anterior
del compilador sólo permite 16 MB (consulte la sección Incrementar el tamaño de mensaje de mensajes XML (petición y respuesta)). Si el generador conversor determina que se puede sobrepasar
el tamaño máximo de mensaje, se muestra un mensaje de error y la generación de servicio se
cancela. Si se especifica un valor de versión de compilador no válida, se genera un mensaje de aviso y el resto de la
generación presupone el valor de 3.3. La selección de la versión 4.1 habilita la opción Análisis XML, consulte el atributo GEN_COBOL_XMLPARSE_OPTION de CodegenProperty. |
Atributo: GEN_AUTH_NAME |
El nombre de autor generado. Debe formarse de acuerdo con las normas del lenguaje COBOL. |
Atributo: GEN_BIDI_HOST |
Los valores de este atributo definen las características de
idiomas bidireccionales de los datos de
host. La transformación se realiza desde datos XML de petición con características especificadas por
GEN_BIDI_OUT a datos de host con características especificadas por este atributo después de que se rellenen los
datos y conviertan a la página host de lenguaje
bidireccional adecuada. Consulte la sección Páginas de códigos soportadas (CCSID). Los valores de este atributo son los mismos que los de la descripción de GEN_BIDI_IN. Si se especifica este atributo, también es necesario especificar GEN_BIDI_IN, GEN_BIDI_OUT o ambos. Nota: Si
no especifica ninguno de los atributos obligatorios, no se realizará ninguna
transformación de idioma bidireccional.
|
Atributo: GEN_BIDI_IN |
Los valores para este atributo definen las características de lenguaje
bidireccional de los datos XML de petición. La
transformación se realiza desde mensajes origen con estas características a los datos de
host con características especificadas por GEN_BIDI_HOST después de
llenar y convertir los datos a la página de host adecuada de idioma
bidireccional. Consulte la sección Páginas de código soportadas (CCSID). Si se especifica este atributo, también es necesario especificar GEN_BIDI_HOST. Nota: Si
no especifica ninguno de los atributos obligatorios, no se realizará ninguna
transformación de idioma bidireccional.
Los valores de este
atributo pueden formarse concatenando los atributos de transformación adecuados del
siguiente modo:
Por ejemplo: VISUALRTLSYMSWAP Puede especificar los atributos de transformación en cualquier orden. |
Atributo: GEN_BIDI_OUT |
Los valores para este atributo define las características de lenguaje
bidireccional de los datos XML de respuesta. La transformación se realizará desde datos
de host con características especificadas por
GEN_BIDI_HOST a datos XML de respuesta con características
especificadas por este atributo antes de que los datos de host se conviertan a la página de
códigos de respuesta. Consulte la sección Páginas de códigos soportadas (CCSID). Si se especifica este atributo, también es necesario especificar GEN_BIDI_HOST. Si no especifica ninguno de los atributos obligatorios, no se realizará ninguna transformación de idioma bidireccional. Los valores de este atributo son los mismos que los de la descripción de GEN_BIDI_IN. |
Atributo: |
El valor de este atributo indica a los generadores de conversor COBOL
que generen código basado en el analizador XML seleccionado para la sentencia COBOL XML PARSE. Esta opción sólo es válida si COBOL_COMPILER_LEVEL se establece en 4.1. |
Atributo: |
Este atributo sólo tiene efecto cuando
está generando un servicio Web utilizando el método ascendente y utiliza la conversión de XML compilado. Si este atributo se establece en TRUE, los comentarios del archivo de código fuente de COBOL se generan como documentación de anotación en los archivos XSD y WSDL generados. Consulte la sección Incluir comentarios de código fuente COBOL en archivos XSD y WSDL generados para obtener más información sobre este atributo. |
Atributo: |
Especifica el tipo de los servicios de conversión que se generan. El valor interpretive sólo es válido para los tipos de proyectos de
servicio único siguientes:
Para el resto de tipos de proyectos de servicio único, se utiliza siempre el valor compiled, incluso aunque especifique interpretive. Cuando este atributo se establece en interpretive, también puede especificar el nombre del archivo de anotaciones generador por el asistente de servicios Web mediante el atributo logFileName del elemento WSBindSpec de ServiceSpecification.xml. |
Atributo: GEN_CP_LIST |
Página de códigos para el programa conversor de host. Consulte la sección Combinaciones de páginas de códigos soportadas. |
Atributo: GEN_DEC_COMMA |
Este atributo se utiliza para controlar el formato del separador de fracciones decimales. Si esta opción se establece en true, el separador de fracciones decimales se establece en una coma. |
Atributo: |
Este atributo sólo tiene efecto cuando está generando código fuente para un servicio Web utilizando el método ascendente y utiliza conversión de XML compilado. Si se especifica este atributo, el generador de código fuente valida la sintaxis del archivo de entrada de COBOL principal y los archivos COBOL incluidos y, si se detectan errores de sintaxis de COBOL, graba la información de error adecuada en el archivo de salida que especifique. Si utiliza este atributo:
Consulte la sección Registrar errores de sintaxis detectados en archivos de entrada COBOL para obtener más información sobre este atributo. |
Atributo: |
El valor de este atributo determina el valor del atributo elementFormQualified en los esquemas XML generados por la herramienta. Esta opción solo afecta al tipo de conversión "Conversión XML compilada". |
Atributo: GEN_FLAT_GEN |
Este atributo se utiliza para controlar si los esquemas XML generados tienen una estructura plana o jerárquica. Si esta opción se establece en true, los generadores se establecen para generar esquemas planos. |
Atributo: GEN_IN_CP_LIST |
Página de códigos para el mensaje de petición (entrada). Consulte la sección
Páginas de códigos (CCSID) soportadas. Nota: Si genera artefactos para
la Pasarela SOAP de IMS, debe especificar
UTF-8 (valor="1208") como página de código para el mensaje de petición (entrada)
(GEN_IN_CP_LIST) y UTF-8 (valor="1208") como página de códigos para el mensaje de respuesta (salida)
(GEN_OUT_CP_LIST). Los demás
valores no están permitidos y provocarán un error de tiempo de ejecución si se
especifican.
|
Atributo: |
El valor de este atributo indica a los generadores de conversores COBOL y PL/I que deben generar código que sea compatible con las funciones IMS Asynchronous Callout (ASYNC) o IMS Synchronous Callout (SYNC). |
Atributo: |
Si se especifica "true" como valor para este atributo, los generadores del esquema XML y
del conversor XML evitarán la utilización de espacios de nombres XML en instancias XML. Los efectos específicos
de esta opción son: los esquemas XML tendrán un espacio de nombres destino nulo y el conversor XML
de respuesta omitirá los espacios de nombres del XML generado. Nota: Esta opción se debe establecer
en true al generar artefactos para el entorno de ejecución
de IMS Web
2.0.
|
Atributo: GEN_OUT_CP_LIST |
Página de códigos para el mensaje de respuesta (salida). Consulte la sección
Combinaciones de
páginas de códigos soportadas. Nota: Si genera artefactos para la Pasarela SOAP
de IMS, debe especificar
UTF-8 (valor="1208") como página de códigos para el mensaje de petición (entrada)
(GEN_IN_CP_LIST) y UTF-8 (valor="1208") como página de códigos para el mensaje (salida)
(GEN_OUT_CP_LIST). Los demás
valores no están permitidos y provocarán un error de tiempo de ejecución si se
especifican.
|
Atributo: GEN_OUT_FILTER |
Este atributo se utiliza para controlar si el conversor XML de respuesta filtrará los caracteres de la estructura de lenguaje que no están permitidos en XML 1.0. |
Atributo: GEN_OUT_HALT |
Este atributo se utiliza para controlar si el conversor XML de respuesta se parará e informará de un error si se encuentran caracteres no permitidos en XML 1.0 en la estructura de lenguaje. |
Atributo: GEN_PROG_NAME |
El nombre del programa generado. Debe formarse de acuerdo con las normas del lenguaje COBOL. El valor predeterminado se establece en el nombre de archivo del libro de copia COBOL (o programa fuente) abreviado a 7 caracteres y convertido a mayúsculas. |
Atributo: |
El valor de este atributo controla cómo se generan los nombres de tipo complejo a partir de elementos de grupo COBOL. El valor "true" hará que el nombre de tipo se reduzca para que sólo contenga el nombre derivado del propio nombre de grupo y no de los nombres de todos los grupos padre. El valor "false" hará que el nombre de tipo contenga los nombres derivados de todos los grupos padre. Este atributo no tiene ningún efecto en escenarios de tipo descendente o de encuentro en el medio. |
Atributo: GEN_SOAP_VERSION |
El valor de este atributo controla qué versión
del enlace de protocolo SOAP genera
IBM®
Rational Developer
para 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 GEN_WSDL_VERSION; si la versión de WSDL solicitada se establece en 1.1, el valor predeterminado de la versión de 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 de minimumRuntimeLevel en un valor de 2.0. Para obtener información adicional, consulte la descripción del atributo runtimeLevel
(runtimeLevel)
en la función WSBindSpec.
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.
|
Atributo: |
Este atributo se utiliza para controlar si los esquemas XML
generados tienen tipos
de datos numéricos COBOL totalDigits y fractionDigits. Si esta opción se establece en true, los
generadores se establecen para generar total/fractionDigits. Si el usuario elige la
generación de total/fractionDigits, se aplican las normas siguientes:
|
Atributo: |
El valor de este atributo indica al procesador
por lotes si debe generar o no artefactos de servicios Web compatibles con MTOM (Message
Transformation Optimization Mechanism)/XOP (XML-binary Optimization Package). Cuando el
valor de este atributo es true, el comportamiento del procesador por lotes se modifica de
la siguiente manera:
Nota: Este sólo afecta a la salida del procesador por lotes cuando GEN_CONVERSION_TYPE =
"interpretive" y se utiliza el elemento ServiceSpecification.xml/EISService (ascendente).
Para ver una descripción adicional, consulte la sección Generar un servicio Web de CICS MTOM/XOP (ascendente). |
Atributo: |
El valor de este atributo controla si el nombre del espacio de nombres del elemento de nivel superior de los documentos de instancia XML de petición XML se validará con el nombre de espacio de nombres especificado en el esquema XML de la petición. Esta opción solo afecta al tipo de conversión "Conversión XML compilada". |
Atributo: GEN_WSDL_VERSION |
El valor de este atributo controla qué versión
del WSDL (descripción de servicio Web) genera IBM Rational Developer
para 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
(mappingLevel)
y del atributo runtimeLevel (runtimeLevel)
en la función WSBindSpec.
|
Atributo: GEN_XSD_GROUPS |
Este atributo se utiliza para controlar la generación de grupos en el esquema XML. Si esta opción se establece en true, el esquema XML puede contener grupos y grouprefs de esquema. |
Atributo: |
En contraste con INIT_OMITTED_ITEMS_IN_INTERFACE
(el siguiente atributo descrito en esta tabla), este atributo habilita la inicialización de elementos
de datos de la estructura de lenguaje de petición que ha incluido en
la estructura de datos de entrada del servicio Web. Este atributo se aplica sólo al escenario ascendente para la generación de un servicio Web y sólo se aplica si especifica la Conversión XML compilada. Cuando se habilita este atributo, las cláusulas VALUE de la estructura de lenguaje de petición que ha especificado para el nuevo servicio Web entran en vigor mediante un código de inicialización que se ejecuta antes de que el nuevo servicio Web invoque la aplicación COBOL existente (aplicación de proveedor de servicios o aplicación de peticionario de servicios). Sin embargo, aunque este atributo esté habilitado, no afecta a un elemento de datos COBOL en particular a menos que el elemento XML correspondiente de la estructura de datos del esquema XSD de petición esté vacío. Los literales VALUE deben estar definidos en una línea. No se deben continuar. Consulte la sección Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL para obtener más información sobre este atributo. |
Atributo: |
En contraste con INIT_EMPTY_ITEMS_IN_INTERFACE
(el atributo anterior descrito en esta tabla), este atributo habilita la inicialización de elementos
de datos en la estructura de lenguaje de petición que ha excluido de la estructura de datos
de entrada de servicio Web. Este atributo se aplica sólo al escenario ascendente para la generación de un servicio Web y sólo se aplica si especifica la Conversión XML compilada. Cuando se habilita este atributo, las cláusulas VALUE de la estructura de lenguaje de petición que ha especificado para el nuevo servicio Web entran en vigor mediante el código de inicialización que se ejecuta antes de que el nuevo servicio Web invoque la aplicación COBOL existente (aplicación de proveedor de servicios o aplicación de peticionario de servicios). Los literales VALUE deben estar definidos en una línea. No se deben continuar. Consulte la sección Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL para obtener más información sobre este atributo. |
<CodegenPropertyArray type="Cobol">
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_PROG_NAME" value="XCNV"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_CONVERSION_TYPE" value="interpretive"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_AUTH_NAME" value="WSED"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_DEC_COMMA" value=" false"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_FLAT_GEN" value=" false"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.COBOL_COMPILER_LEVEL" value="3.4"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_SHORT_TYPE_NAMES" value="true"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_WSDL_VERSION" value="2.0"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_SOAP_VERSION" value="1.2"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_TOTAL_FRACTION_DIGITS" value="false"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_COMMENT_IN_XSD" value="true"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.GEN_ERROR_FEEDBACK_FILE_PATH" value="c:\Documents
and Settings\Mis documentos\ErrorFeedBack\SyntaxError.xml"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.INIT_EMPTY_ITEMS_IN_INTERFACE" value="true"/>
<CodegenProperty name="com.ibm.etools.xmlent.ui.INIT_OMITTED ITEMS_IN_INTERFACE" value="true"/>
</CodegenPropertyArray>