Sentencia $INSERT

Sintaxis

$INSERT
nombrevía.primos

Descripción

Utilice la sentencia $INSERT para indicar al compilador que inserte el código fuente del archivo especificado por nombrevía.primos y lo compile con el programa principal. La diferencia entre las sentencias $INSERT e $INCLUDE (y sus sinónimas #INCLUDE e INCLUDE) es que $INSERT tiene como argumento un nombre de vía de acceso PRIMOS, mientras que $INCLUDE tiene un nombre de archivo e ID de registro de InfoSphere DataStage. El nombre de vía de acceso PRIMOS se convierte en un nombre de vía de acceso; se pasa por alto cualquier *> inicial.

$INSERT se incluye para hacer posible la compatibilidad con los programas Prime INFORMATION; la sentencia $INCLUDE es la recomendada para un uso general.

Si nombrevía.primos es el nombre del programa únicamente, se interpreta como un nombre de vía de acceso relativo. En ese caso, el programa debe ser un archivo del mismo directorio que el programa que contiene la sentencia $INSERT.

Puede anidar sentencias $INSERT.

El valor de nombrevía.primos se convierte en un nombre de vía de acceso válido siguiendo estas reglas de conversión:

/ se convierte en ?\
? se convierte en ??
ASCII CHAR 0 (NUL) se convierte en ?0
. (punto) se convierte en ?.

Si especifica un nombre de vía de acceso completo, el carácter > entre los nombres de directorio cambia por un carácter / para dar como resultado:

[nombrevía/]
programa

$INSERT utiliza el argumento transformado directamente como nombre de vía de acceso del archivo que contiene el código fuente que se insertará. No utiliza la definición de archivo del archivo VOC.

Ejemplo

PRINT "START"
$INSERT END
PRINT "FINISH"

Al compilarse este programa, la sentencia $INSERT inserta el código del programa END (consulte el ejemplo en la página de la sentencia END). Esta es la salida del programa:

START
THESE TWO LINES WILL PRINT ONLY
WHEN THE VALUE OF 'A' IS 'YES'.

THIS IS THE END OF THE PROGRAM
FINISH