Rational Developer para System z, Versión 7.6

CodegenProperty

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.

Contenido por

Contiene

Ninguno

Atributos

Inicie el valor del atributo name con com.ibm.etools.xmlent.ui.

Tabla 1 muestra los atributos de CodegenProperty.

Tabla 1. Especificaciones de atributo para CodegenProperty
Campos Descripción

Atributo:
COBOL_COMPILER_LEVEL
Valores válidos: 3.1, 3.2, 3.3, 3.4, 4.1  
Valor predeterminado: 3.3

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
Valores válidos: Consulte la descripción  
Valor predeterminado: WSED

El nombre de autor generado. Debe formarse de acuerdo con las normas del lenguaje COBOL.

Atributo: GEN_BIDI_HOST
Valores válidos: Consulte la descripción  
Valor predeterminado: Ninguno

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
Valores válidos: Consulte la descripción  
Valor predeterminado: Ninguno

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:
  • "VISUAL" o "LOGICAL" para Tipo de texto
  • "LTR" o "RTL" para Orientación de texto
  • "SYMSWAP" o en blanco para Intercambio simétrico
  • * "NUMSWAP" o en blanco para Intercambio numérico

Por ejemplo: VISUALRTLSYMSWAP Puede especificar los atributos de transformación en cualquier orden.

Atributo: GEN_BIDI_OUT
Valores válidos: Consulte la descripción  
Valor predeterminado: Ninguno

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:
GEN_COBOL_XMLPARSE_OPTION
Valores válidos: COMPAT, XMLSS      
Valor predeterminado: COMPAT

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:
GEN_COMMENT_IN_XSD
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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:
GEN_CONVERSION_TYPE
Valores válidos: Consulte la descripción  
Valor predeterminado: compiled

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:
  • Proyecto de servicios Web para CICS
Consulte Opciones de procesador por lotes aplicables al tipo de conversión interpretativa.

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
Valores válidos: Consulte la descripción  
Valor predeterminado: 1140

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
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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:
GEN_ERROR_FEEDBACK_FILE_PATH
Valores válidos: Consulte la descripción  
Valor predeterminado: 1140

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:
  • Especifique el atributo name para habilitar esta opción.
  • En el atributo value, especifique una vía de acceso del archivo de salida, o nombre de archivo.

Consulte la sección Registrar errores de sintaxis detectados en archivos de entrada COBOL para obtener más información sobre este atributo.

Atributo:
GEN_ELEMENT_FORM_QUALIFIED
Valores válidos: Consulte la descripción  
Valor predeterminado: true

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
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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
Valores válidos: Consulte la descripción  
Valor predeterminado: 1140

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:
GEN_IMS_MESSAGE_TYPE
Valores válidos: ASYNC | SYNC  
Valor predeterminado: ASYNC

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:
GEN_OMIT_XML_NAMESPACES
Valores válidos: true | false  
Valor predeterminado: false

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
Valores válidos: Consulte la descripción  
Valor predeterminado: 1140

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
Valores válidos: Consulte la descripción  
Valor predeterminado: true

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
Valores válidos: Consulte la descripción  
Valor predeterminado:   

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
Valores válidos: Consulte la descripción  
Valor predeterminado: 1140

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:
GEN_SHORT_TYPE_NAMES
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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
Valores válidos: Consulte la descripción  
Valor predeterminado: Consulte la descripción

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:
GEN_TOTAL_FRACTION_DIGITS
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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:
  • Para tipos decimales COBOL, se generan tanto totalDigits como fractionDigits. Por ejemplo:
    • pic 9(13)v9(2): totalDigits = 15, fractionDigits = 2
    • pic s99v9: totalDigits = 3, fractionDigits = 1
  • Para tipos integer COBOL, se generan sólo totalDigits. Por ejemplo:
    • pic 99 o 99v o s99: totalDigits = 2
  • No se generan si el elemento de datos numéricos COBOL tiene "ceros iniciales o finales". Por ejemplo:
    • pic P9 o 9PP.

Atributo:
GEN_USE_MTOM_XOP
Valores válidos: true | false  
Valor predeterminado: false

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:
  • Las estructuras de lenguaje de nivel 01 especificadas en los elementos InputMessage y OutputMessage se tratan como simples matrices de caracteres de nivel 01 antes de pasarse a DFHLS2WS; esto permite que cada estructura de lenguaje se represente como un elemento con tipo xsd:base64binary individual en la descripción de servicio Web.
  • El valor del atributo XseSpec/WSBindSpec/@charVarying se supone que es “true”.
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:
GEN_VALIDATE_ROOT_IN_NS
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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
Valores válidos: Consulte la descripción  
Valor predeterminado: 1.1

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
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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:
INIT_EMPTY_ITEMS_IN_INTERFACE
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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:
INIT_OMITTED_ITEMS_IN_INTERFACE
Valores válidos: Consulte la descripción  
Valor predeterminado: false

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.

Ejemplo

La Figura 1 es un ejemplo de elementos CodgenProperty del elemento CodgenPropertyArray.
Figura 1. Ejemplo de elementos CodegenProperty
<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>

Términos de uso | Comentarios

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