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:
Rational Developer
for System z no soporta construcciones PL/I o COBOL locales, la comprobación de sintaxis local o la muestra de dependencias en la plataforma Linux®.
Procedimiento
Para definir opciones para preprocesadores locales:
- Abra un grupo de propiedades en el editor de grupos de propiedades.
- Vaya al separador 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 de 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 cualificador 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.
- Guarde el grupo de propiedades para guardar los cambios realizados.