Rational Developer for System z, Versión 7.6.1

Establecer las preferencias de los conversores XML COBOL

Para establecer las preferencias de los conversores XML COBOL, abra la página Conversores XML COBOL en las preferencias de Enterprise Service Tools.

Estas preferencias afectan a los Proyectos de servicio único, incluidos:

Estas preferencias afectan a cómo convierten los datos los programas de conversión XML de ejecución generados por los asistentes de servicio único en Enterprise Service Tools entre el formato XML que se utiliza en las peticiones y las respuestas de servicio y las estructuras de datos de lenguaje de alto nivel que se utilizan en COBOL:

Para establecer las preferencias de generación de los programas de conversión XML de ejecución:
  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, seleccione Enterprise Service Tools.
  3. Cambie las preferencias:
    1. Las preferencias de la pestaña Básica se describen en la tabla siguiente:
      Preferencia: Efecto de esta preferencia:
      Prefijo de nombre de programa conversor Este campo de entrada especifica la raíz del nombre de programa que se incluye en la DIVISIÓN DE IDENTIFICACIÓN de cada programa COBOL generado. Por ejemplo, si escribe ACCT, el asistente identificará el programa conversor de entrada como ACCTI, el programa conversor de salida como ACCTO y el controlador como ACCTD.
      Nombre de autor Este campo de entrada especifica el valor que debe incluirse en el párrafo AUTOR de cada programa COBOL generado.
      Página de códigos de petición Este recuadro de lista especifica la página de códigos que se debe utilizar para la codificación del mensaje XML de petición.
      Página de códigos de host Este recuadro de lista especifica la página de códigos que utiliza el sistema host z/OS.
      Página de códigos de respuesta Este recuadro de lista especifica la página de códigos que se debe utilizar para codificar el mensaje XML de respuesta.
      El punto decimal es una coma Este recuadro de selección controla cómo se interpretan los caracteres de coma y punto en las series numéricas:
      • Cuando se marca este recuadro de selección:
        • La coma se interpreta como un punto decimal.
        • El punto se interpreta como un separador de miles.
      • Cuando se quita la marca de este recuadro de selección (este es el valor predeterminado):
        • La coma se interpreta como un separador de miles.
        • El punto se interpreta como un punto decimal.
  4. Las preferencias de la pestaña Avanzada son las siguientes:
    • En el grupo Especificar opciones de generación de esquema XML:

      Generar jerarquía mínima en esquemas XML
      Este recuadro de selección controla el formato de mensaje del esquema XML generado y, en consecuencia, el análisis y la generación de XML en los conversores XML. Los conversores XML basados en esquemas XML que tienen jerarquías minimizadas tienden a proporcionar un mejor rendimiento.
      • Seleccione este recuadro de selección si desea que los conversores XML se generen de forma que utilicen una jerarquía de estructuras XML reducida, en los casos en los que no sea necesaria una jerarquía de estructuras detallada para identificar de forma exclusiva cada elemento de la estructura.

        Cuando existan elementos con el mismo nombre de código, el nombre del elemento que aparezca más tarde en el documento se prefijará con los suficientes códigos padre para producir un nombre exclusivo. Este método aumenta la eficacia de los clientes de proceso de mensajes, al reducir el número y la complejidad de objetos de los que deben crearse instancias.

      • Deseleccione este recuadro de selección si desea que el asistente genere un esquema XML que represente la jerarquía completa de la estructura de lenguaje.
      Generar grupos en esquemas XML
      Este recuadro de selección controla si el conversor XML debe incluir grupos en los esquemas XML generados:
      • Seleccione este recuadro de selección si desea que el conversor XML incluya grupos en los esquemas XML generados.
      • Quite la marca del recuadro de selección si desea que el conversor XML incluya "contenido" de grupos en línea en lugar de utilizar referencias de grupo. Esta opción es útil para aplicaciones que no dan soporte a la utilización de grupos y referencias de grupo en esquemas XML.
      Generar nombres de tipo complejo cortos
      El método normal para generar un nombre de tipo complejo es concatenar el nombre del grupo con los nombres de todos los padres del grupo, con un carácter de subrayado "_" después de cada nombre, excepto del último.
      No obstante, si se marca este recuadro de selección, se genera un nombre de tipo complejo a partir sólo del nombre del grupo.
      Por ejemplo, en este grupo COBOL:
      01 ServiceRequest.
        02 CommonHeader.
          05 HeaderType1.
            10 Element1     PIC X(10).
      El nombre de tipo XML complejo del elemento HeaderType1 es:
      • servicerequest_commonheader_headertype1 si el recuadro de selección no está seleccionado.
      • HeaderType1 si el recuadro de selección está seleccionado.
      La abreviación de los nombres de tipos complejos permite la generación de un código de cliente más compacto (generalmente código de clase Java™) a partir de los archivos WSDL y XSD que contienen los tipos XML complejos.
      El hecho de marcar el recuadro de selección no tiene ningún efecto en escenarios descendentes o de encuentro en el medio.
      Al intentar reducir un nombre de tipo complejo, es posible que se produzca un conflicto si el nombre corto del tipo ya existe como resultado de un tipo definido anteriormente para un grupo con idéntico nombre pero nombres de grupo padre diferentes. Por ejemplo, en la siguiente estructura COBOL: Por ejemplo, en la siguiente estructura COBOL:
      01 ServiceRequest.
        02 CommonHeader.
          05 HeaderType.
            10 Element         PIC X(10).
        02 SpecificHeader.
          05 HeaderType.
            10 Element         PIC X(10).
      el nombre de tipo del grupo HeaderType bajo SpecificHeader entra en conflicto con el nombre de tipo del grupo HeaderType bajo CommonHeader.
      En caso de conflicto, todos los nombres en conflicto conservan los nombres de tipo largo originales. Por lo tanto, basándose en este ejemplo, los nombres de tipo resultantes son:
      • servicerequest_commonheader_headertype y
      • servicerequest_specificheader_headertype.
      El nombre corto de un tipo complejo se forma tomando el nombre del elemento XML que tiene ese tipo, más algunas modificaciones posibles. Las normas para formar nombres cortos son:
      1. Partimos del nombre del elemento XML que tiene el tipo (por ejemplo, HeaderType1).
      2. Si el nombre empieza por un carácter que no es válido para nombres Java (por ejemplo, un dígito), se le añadirá el prefijo de un doble subrayado "__".
      3. Si hay un guión "-" en el nombre de grupo COBOL original, se sustituirá por un subrayado simple "-" .
      4. Las mayúsculas/minúsculas del nombre de grupo se conservarán.
      Por ejemplo, el siguiente grupo:
      03 2-In--B.
                 04 var2 blank zero pic 999.99.
      genera el nombre de tipo complejo abreviado __2_In__B.
      Generar comentarios en XSD
      Seleccione este recuadro de selección para hacer que los comentarios del archivo de código fuente COBOL se generen 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)
      Esta opción se aplica solo al escenario de desarrollo ascendente para generar un servicio Web y se aplica solo si especifica Conversión XML compilada.
      Generar elementos XML calificados en esquemas XML
      Este recuadro de selección permite la generación de elementos XML calificados en los esquemas XML.

      Esto permite la opción de solicitar que todos los elementos XML estén cualificados con un espacio de nombres y tengan soporte para la generación de esquemas XML que se puedan incluir en otros esquemas con menos oportunidad de colisión de espacio de nombres.

    • En el grupo Especificar comportamiento de conversor XML de petición:

      Validar nombre de espacio de nombres de elemento raíz
      Seleccione este recuadro de selección para habilitar la validación del espacio de nombres destino del elemento raíz en documentos XML. El espacio de nombres destino del elemento raíz se puede encontrar en el esquema XML que lo define.
      Utilice literales VALUE para inicializar los elementos de datos omitidos
      Marque este recuadro de selección para habilitar la inicialización de los elementos de datos de la estructura de lenguaje de petición que ha excluido de la estructura de datos de entrada del servicio Web (consulte la sección Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL ).
      Esta opción se aplica solo al escenario de desarrollo ascendente para generar un servicio Web y se aplica solo si especifica Conversión XML compilada.
      Utilice literales VALUE para inicializar los elementos de datos vacíos
      Marque este recuadro de selección para habilitar la inicialización de los elementos de datos de la estructura de lenguaje de respuesta que ha incluido en la estructura de datos de entrada del servicio Web (consulte la sección Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL ).
      Esta opción se aplica solo al escenario ascendente para generar un servicio Web y se aplica solo si especifica Conversión XML compilada.
    • En el grupo Especificar comportamiento de XML de respuesta:

      Datos de lenguaje
      Esta opción controla cómo el programa de conversión XML de tiempo de ejecución de respuesta maneja los caracteres de los datos COBOL de respuesta que no están permitidos en la especificación XML 1.0:
      • Seleccione Filtrar caracteres no permitidos en XML 1.0 si desea que el programa de conversión explore los datos no numéricos y numéricos de la estructura de lenguaje y convierta los caracteres que no están permitidos en la especificación XML 1.0 a un espacio EBCDIC, ASCII o UNICODE (según la página de códigos de respuesta).
      • Seleccione Detener en caracteres ilegales en XML 1.0 si desea explorar datos tanto numéricos como no numéricos de la estructura de lenguaje y generar una excepción si se encuentran caracteres ilegales XML 1.0.
      • Seleccione No comprobar caracteres ilegales si desea que el programa de conversión no compruebe si hay caracteres no permitidos en la especificación XML 1.0.

      Para obtener más información, consulte la sección Diagnósticos de conversor XML.

    • En el grupo Especificar preferencias relacionadas con el compilador:
      Optimización
      Seleccione si la opción de optimización está habilitada para el compilador COBOL. Cuando el recuadro de selección está seleccionado, el compilador COBOL utilizará la optimización en la generación de código de entorno de ejecución a partir del código fuente COBOL.

      Si está intentando depurar un error de compilación en el código fuente COBOL, es recomendable deseleccionar este recuadro de selección y volver a compilar. Si la optimización activada, es más sencillo determinar qué parte del código fuente COBOL está provocando el error.

      Especifique la versión de compilador COBOL Enterprise
      Seleccione la versión del compilador COBOL que desee utilizar.
      Nota: La selección de la versión 3.4 permite un tamaño máximo de mensaje XML de 32 MB (consulte la sección Incrementar el tamaño de mensaje de mensajes XML (petición y respuesta)).
  5. Pulse Aceptar cuando termine.

Términos de uso | Comentarios

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