Rational Developer
for System z proporciona un preprocesador de inclusión local que le permite incorporar archivos fuente externos en sus programas mediante directivas de inclusión que no sean la directiva de PL/I %INCLUDE o la sentencia COPY COBOL.
Antes de empezar
Antes de utilizar el preprocesador de inclusión local, debe haber creado un grupo de propiedades local y asociarlo con un archivo fuente PL/I local o un proyecto local.
Por qué y cuándo se efectúa esta tarea
El preprocesador de inclusión local está situado en el directorio
bin de la vía de acceso de instalación de Rational Developer
for System z. El nombre de archivo es
PPINCL01.EXE.Puede utilizar el preprocesador de inclusión local con un programa PL/I individual o un proyecto z/OS local que contenga uno o varios programas PL/I. También puede utilizarlo solo o como parte de una operación de construcción de varios preprocesadores.
- Cuando el preprocesador de inclusión es el único preprocesador al que se llama antes de una compilación, el archivo de entrada es el programa COBOL o PL/I que se seleccionó para una operación Comprobación de sintaxis o Mostrar dependencias.
- Cuando se llama al preprocesador de inclusión para una construcción de proyecto, cada programa COBOL o PL/I del proyecto se procesa y luego se compila.
El archivo de entrada en este caso es el fuente COBOL o PL/I actual que se procesa.
- Cuando se llama al preprocesador de inclusión como parte de una operación de varios preprocesadores y se invoca después de un preprocesador anterior, el archivo de entrada para el preprocesador de inclusión es el archivo de salida del preprocesador activo anterior. Este archivo es el listado en el campo de entrada Nombre de archivo de salida de preprocesador del preprocesador activo anterior. Consulte Utilizar varios preprocesadores locales para obtener más información acerca de la configuración de operaciones de varios procesadores.
Para utilizar el preprocesador de inclusión local:
- Abra el editor del grupo de propiedades para el grupo de propiedades asociado con el recurso o proyecto o vaya a la página PL/I.
- En la lista de la izquierda, pulse Preprocesador local para abrir la página Preprocesador local.
- Para añadir un preprocesador local nuevo al grupo de propiedades, pulse Nuevo.
- Complete los campos de la sección Opciones de preprocesador de la página Preprocesador local
- 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
- El preprocesador de inclusión puede tener los siguientes argumentos:
- TRACE(ON|OFF) En la estación de trabajo, esta opción proporciona salida adicional a la Consola remota TPF. En los sistemas 390, esta opción proporciona salida de JES adicional. Esta salida está pensada para que la utilice un representante del soporte técnico de IBM® y no debe utilizarse durante el desarrollo normal ya que aumenta la cantidad de salida no deseada y puede reducir el rendimiento. Si necesita ponerse en contacto con su representante del soporte técnico de IBM para determinar problemas, puede copiar esta salida en su correspondencia.
El valor predeterminado para esta opción es TRACE(OFF). Si no se ha especificado la opción, se utiliza el valor predeterminado.
- FORMAT(ON|OFF) En la estación de trabajo y en los sistemas 390, esta opción cambia la legibilidad del XML generado para los mensajes de error. FORMAT(ON) hace que la tabla de sentencias se escriba en 6 columnas, haciendo que el archivo XML sea más legible. Estableciendo esta opción se reduce significativamente el rendimiento de analizar el archivo XML, provocando que las operaciones tarden más tiempo. El valor predeterminado para esta opción es FORMAT(OFF).
Si no se ha especificado la opción, se utiliza el valor predeterminado.
- Nombre de archivo de salida de preprocesador
- Especifique un nombre de archivo a utilizar para la salida del preprocesador. Si omite esta opción, se generará un nombre de archivo de salida.
- 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 no calificado del archivo XML que debe generarse para la información de retorno de error. Si omite esta opción, se generará un nombre de archivo XML de información de retorno de error.
- 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.