Saltar al contenido
Compilación

IGYCómo leer un mensaje del compilador

Todo mensaje del compilador COBOL de IBM empieza con IGY y trae la línea del fuente, la fase que lo emitió, un número y una letra de severidad. La letra decide el return code de la compilación.

Cómo se lee un mensaje

Cada mensaje del compilador tiene esta forma:

nnnnnn IGYppxxxx-l texto
  • nnnnnn: el número de línea del fuente al que se refiere. Ojo: es la línea del listado de compilación, que incluye los copys ya expandidos, no la de tu editor. Si se compiló con la opción NUMBER, en cambio, es el número que trae tu fuente en las columnas 1 a 6.
  • IGY: el código del producto, Enterprise COBOL.
  • pp: la fase del compilador que lo emitió. Por ejemplo, LI procesa los COPY, DS las divisiones IDENTIFICATION, ENVIRONMENT y DATA, PS revisa la sintaxis de la PROCEDURE DIVISION y PA hace su análisis semántico, como resolver los nombres de párrafo.
  • xxxx: el número del mensaje.
  • l: la severidad.

Por ejemplo:

  000245 IGYPS2121-S "WS-TOTL" was not defined as a data-name. The statement was discarded.

Severidades y return code

La letra final dice qué tan grave es, y el return code de la compilación queda en el de la severidad más alta que aparezca:

Letra Severidad Return code Qué significa
I Informativo 0 Solo un aviso. No hay que hacer nada.
W Advertencia 4 Posible error. Lo más probable es que el programa funcione.
E Error 8 Error seguro. El compilador lo “corrigió”, pero revísalo.
S Severo 12 Error grave que el compilador no pudo corregir. No lo ejecutes.
U Irrecuperable 16 Tan grave que la compilación se detuvo.

Con E el programa puede llegar a generarse, pero IBM avisa que el resultado puede no ser el que esperas. Corrígelo de todos modos.

Dónde están en el listado

Los mensajes aparecen después del fuente, al final del listado de compilación, ordenados por número. Cada uno trae la línea, así que lo práctico es:

  1. Ir al final del listado y leer la lista de mensajes.
  2. Tomar el número de línea del primero.
  3. Buscar esa línea en el fuente del listado (con copys expandidos) para ver el contexto.

Corrige primero el primer error

Muchos mensajes son consecuencia de uno anterior. Un punto de más, un END-EXEC que falta o un nombre mal escrito pueden generar decenas de errores en las líneas siguientes.

Por eso: corrige el primer error de severidad S o E, vuelve a compilar y revisa qué queda. Muchas veces la lista completa desaparece con un solo cambio.

¿Dónde está la explicación de cada mensaje?

IBM aclara que la mayoría de los mensajes del compilador no tienen más explicación que su propio texto, que se lee junto con el Language Reference. La guía Messages and Codes solo detalla algunos.

Si quieres la lista completa de mensajes con su número, severidad y texto, IBM indica una forma: compila un programa con PROGRAM-ID ERRMSG, y el listado trae todos.