Rational Developer for System z, Versión 7.6.1

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.

Acerca de 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:

Procedimiento

  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}.
    ${rdz_cache_home}
    Cuando se utiliza un preprocesador con un archivo remoto, puede ser necesario llegar a la ubicación de memoria caché raíz. Esta ubicación es la ubicación de memoria caché de Rational Developer for System z descrita en la explicación de la variable ${rdz_cache_sysn}. Esta variable no incluye las subcarpetas "FttRemoteTempFiles"\Nombre de conexión RSE. La carpeta BuildOutput para una comprobación de sintaxis local de un archivo remoto está en la ubicación ${rdz_cache_home}. Esta carpeta es aquella de la que se invoca el preprocesador local.
    ${rdz_cache_sysn}
    Cuando se utiliza un preprocesador con un archivo remoto, puede ser necesario poder apuntar a su archivo en la ubicación de descargas de Rational Developer for System z. Esta ubicación depende de la ubicación del espacio de trabajo. Rational Developer for System z descarga las dependencias de compilación en una comprobación de sintaxis local de un archivo remoto. La ubicación de descarga es la ubicación de memoria caché de Rational Developer for System z. Al realizar una comprobación de sintaxis local de un archivo remoto debe tener el preprocesador ejecutándose en el sistema remoto. Se realiza una combinación de un preproceso y una compilación en el sistema remoto y se crea una lista de dependencias de construcción. Es la misma lista de archivos que se visualiza cuando realiza la operación Mostrar dependencias en el archivo. Esta es la misma lista de archivos que ve si pulsa el botón Archivos dependientes en el diálogo Comprobar dependencias en la acción Comprobación de sintaxis local. Estos archivos se descargan en la ubicación de memoria caché. Será necesario apuntar a un archivo o a una carpeta mediante la variable ${rdz_cache_sysn}. Si un miembro de conjunto de datos USERID.A001.COPYLIB(MEM1) es uno de sus archivos dependientes, por ejemplo, deberá apuntar a la ubicación de memoria caché de ese archivo para el consumo de su preprocesador local. Una forma de hacerlo es establecer una variable de entorno en la carpeta que contiene el miembro descargado. Puede hacer esto en el campo de entrada de la variable de entorno de preprocesador: SET SYSLIB=${rdz_cache_sysn}\USERID\USERID.A001.COPYLIB. El padre de la carpeta correspondiente al conjunto de datos es el calificador de alto nivel del nombre del conjunto de datos que contiene el miembro. La variable ${rdz_cache_sysn} se sustituye por la ubicación de memoria caché de Rational Developer for System z "FttRemoteTempFiles"\Nombre de conexión RSE.
    ${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 sustituye el valor de la ubicación del recurso en disco. Cuando está realizando una comprobación de sintaxis local de un archivo remoto, el valor de ${resource_loc} en las opciones de preprocesador local es la ubicación del archivo en la memoria caché de Rational Developer for System z.
    ${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)