Rational Developer for System z, Versión 7.6

Establecer opciones de preprocesador local

Este tema describe las opciones que puede establecer para preprocesadores locales.

Antes de empezar
Necesita haber definido un grupo de propiedades en un sistema local o remoto.
Por qué y cuándo se efectúa esta tarea
El soporte de preprocesador local está disponible para las operaciones de comprobación de sintaxis o compilación siguientes:

Para definir opciones para preprocesadores locales:

  1. Abra un grupo de propiedades en el editor de grupos de propiedades.
  2. Vaya a la pestaña Preprocesadores locales de Valores COBOL locales o de la página Valores PLI locales. Esta página contiene dos secciones: la sección Preprocesadores muestra todos los preprocesadores a los que se ha añadido el grupo de propiedades. Hay dos formas de trabajar con esta lista:
    • Marque el recuadro de selección situado junto a un nombre de preprocesador para habilitar el preprocesador para que se ejecute antes de una operación de compilación o comprobación de sintaxis. Esta acción se llama "seleccionar un preprocesador." El preprocesador sólo está activado para ejecutarse cuando el recuadro de selección está marcado.
    • Seleccione el nombre de preprocesador en la lista para visualizar las correspondientes opciones establecidas en la sección Opciones de preprocesador. Esta acción se llama "resaltar un preprocesador."
    La sección Opciones de preprocesador muestra las opciones para el preprocesador seleccionado.
    Descripción de preprocesador
    Escriba una descripción, por ejemplo "Preprocesador de inclusión."
    Nombre de preprocesador (totalmente calificado)
    Escriba el nombre completo de la vía de acceso para el preprocesador de inclusión. Puede utilizar la variable ${INSTDIR} para señalar al directorio de instalación de Rational Developer for System z. Esta variable se utiliza para buscar el preprocesador de inclusión.
    Argumentos de preprocesador
    Especifique los argumentos que vaya a pasar al preprocesador. Estos argumentos se especificarían como si los estuviera pasando al preprocesador desde el indicador de mandatos. Los argumentos pueden incluir la vía de acceso totalmente calificada del archivo que se está preprocesando. Si sus argumentos incluyen el nombre totalmente calificado del archivo XML, o el archivo de salida que el preprocesador está generando, es necesario que se creen el archivo XML y el archivo de salida en la carpeta BuildOutput del proyecto local.
    Nombre de archivo de salida de preprocesador
    Especifique el nombre del archivo expandido que el preprocesador generará. Este nombre de archivo no debe estar calificado. El archivo de salida debe generarse en la carpeta BuildOutput del proyecto local.
    Información de errores de soporte
    Seleccione este recuadro de selección para anotar los errores generados por el preprocesador. Seleccionar este recuadro de selección habilita el campo Nombre de archivo XML de información de errores. Esta opción está habilitada por defecto.
    Nombre de archivo XML de información de errores
    Especifique el nombre del archivo XML que debe generarse para la información de retorno de error. Este archivo XML no debe estar calificado, ya que es necesario que se cree en la carpeta BuildOutput del proyecto local.
    Variables de entorno (sentencias set)
    Especifique las variables de entorno que deben pasarse al preprocesador. Este campo contiene un valor para SYSLIB, pero deberá cambiar el valor para que señale a la carpeta que contiene los archivos de inclusión.

    También puede utilizar las siguientes variables en cualquiera de los campos de entrada como ayuda para generalizar construcciones de proyectos:

    ${project_loc}
    La ubicación del proyecto. Puede utilizarse para añadir la ubicación en disco del proyecto. Si necesita pasar el nombre de una carpeta del proyecto al preprocesador, puede especificarla como ${project_loc}\folder1. Al invocar al preprocesador, se sustituye ${project_loc}.
    ${resource_fn}
    El nombre de archivo no calificado del recurso actual que se está preprocesando. Si estuviera realizando una construcción de proyecto, y hubiera 3 archivos COBOL en el proyecto, RED.cbl, WHITE.cbl y BLUE.cbl, para cada preproceso durante la construcción del proyecto se asignaría un valor a esa variable. El valor sería RED, WHITE o BLUE. Esta variable tiene valor cuando está especificando valores de preprocesador en el proyecto. Por ejemplo, especificar ${resource_fn}_PP1.dek en el campo de entrada Nombre de archivo de salida de preprocesador lleva a los archivos de salida RED_PP1.dek, WHITE_PP1.dek, y BLUE_PP1.dek, en la carpeta BuildOutput.
    ${resource_loc}
    La ubicación en disco del recurso que se está preprocesando. Si el preprocesador necesita la ubicación exacta del archivo en disco para preprocesarlo, puede utilizar esta variable y, al invocar, se sustituirá el valor de la ubicación del recurso en disco.
    ${INSTDIR}
    El directorio de instalación de Rational Developer for System Z.

    Cuando se invoca al preprocesador local mediante la comprobación de sintaxis o la acción de mostrar dependencias, el directorio actual para esta acción será la carpeta BuildOutput del proyecto local. El archivo XML y el archivo fuente expandido que el preprocesador crea deberán crearse en esta carpeta.

  3. Pulse Finalizar para guardar los cambios realizados.

Términos de uso | Comentarios

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