Saltar al contenido
Interpretar errores

Principiante8 min de lectura

Cómo leer un listado de compilación

El listado es la respuesta del compilador a tu programa. Aquí aprendes dónde encontrarlo, en qué orden leerlo y cómo ir de un mensaje a la línea exacta que lo provocó.

Al terminar sabrás

  • Dónde sale el listado después de compilar y qué partes tiene.
  • Cómo se lee cada mensaje: línea, código, severidad y texto.
  • Qué significa el return code del step de compilación.
  • Cómo ir de un mensaje a la línea del fuente, y por qué corriges primero el primer error severo.

Qué es el listado y dónde lo encuentras

Cuando mandas a compilar, el job tiene un step que ejecuta el compilador, el programa IGYCRCTL. Ese step escribe su reporte completo en el DD SYSPRINT. Ese reporte es el listado de compilación: tu programa tal como lo vio el compilador, más todo lo que tiene que decirte sobre él.

Para verlo, abre la salida del job en SDSF o en la herramienta que use tu instalación, entra al step de compilación y busca SYSPRINT. Si el job también linkedita (arma el ejecutable) y ejecuta, cada step tiene su propio SYSPRINT. El del compilador es fácil de reconocer: empieza con la lista de opciones del compilador. Los términos del oficio que usa esta guía (step, DD, SDSF) están en el glosario del mapa.

Ojo con esto: el return code que ves junto al job es el más alto de todos sus steps. Un RC=12 puede venir del compilador o del binder. Entra al step para saber cuál fue.

Las partes del listado, en orden

Las secciones van siempre en este orden. Las de los extremos salen siempre; las de en medio, según las opciones de compilación.

  1. Opciones. Primero las que llegaron por el PARM del JCL o por una sentencia CBL o PROCESS, y luego Options in effect: la lista completa de lo que estuvo activo. Aquí confirmas si se compiló con SOURCE, XREF o MAP.
  2. Mensajes de arranque. Si algo falló con las opciones o con los COPY (un copy que no se encontró, una librería que no existe), el mensaje sale aquí arriba, no al final.
  3. El fuente. Con la opción SOURCE, el programa completo numerado línea por línea, con los copys ya expandidos.
  4. Mapas y referencias cruzadas. Según las opciones: MAP dice dónde queda cada campo en memoria, XREF dónde se define y dónde se usa cada nombre, OFFSET da el offset de cada sentencia (su posición dentro del código generado) y LIST el código generado. Hoy no las necesitas; en la guía del abend sí.
  5. Los mensajes de compilación. Ordenados por número de línea.
  6. El resumen. Cuántos mensajes hubo de cada severidad, estadísticas del programa, la severidad más alta y el Return code.

Cuando solo quieres saber por qué falló, brinca directo al final. Ahí están los mensajes y el return code. Al principio solo vas cuando el problema es un copy que no apareció.

El fuente numerado: tus líneas no son las del editor

Así se ve un pedazo del fuente dentro del listado. Es CALCNOM1, el mismo programa inventado de las guías anteriores:

LineID  PL SL  ----+-*A-1-B--+----2----+----3----+----4----+----5----+----6----+----7-|--+----8  Map and Cross Reference
000120                01  WS-TOTALES.
000121                    05  WS-TOTAL-NOMINA      PIC S9(9)V99 COMP-3.
000122                    05  WS-CONTADOR          PIC 9(5).
...
000305                200-ACUMULA-EMPLEADO.
000306                    ADD WS-IMPORTE TO WS-TOTAL-NOMINA                                    140 121
000307                    ADD 1 TO WS-CONTADOR                                                 122

Tres cosas que conviene saber de esta parte:

  • LineID es el número con el que el compilador identifica cada línea. Con la opción NONUMBER, que es la habitual, lo asigna él mismo de corrido. Con NUMBER, usa los números que tú tienes en las columnas 1 a 6.
  • PL y SL son el nivel de anidamiento de programa y de sentencia. Un 1 en SL dentro de un IF te dice que esa línea está adentro del IF. Útil para ver dónde terminó un END-IF.
  • La columna de la derecha aparece cuando se compila con XREF. Junto a cada nombre te dice en qué línea se definió. Si ves UND, ese nombre no está definido. Si ves IMP, está definido de forma implícita, como una figurativa. Es la forma más rápida de encontrar un nombre mal escrito: ni siquiera hace falta ir a los mensajes.

Ojo con esto: el número de línea del listado no tiene por qué coincidir con el de tu editor. Los copys expandidos y los comentarios corren la numeración. Cuando un mensaje te mande a una línea, búscala en el fuente del listado, no en el editor, y después ubica esa línea en el editor por su texto.

Anatomía de un mensaje

Al final del listado, antes del resumen, viene la lista de mensajes:

LineID  Message code  Message text
   310  IGYPS2121-S   "WS-TOTL" was not defined as a data-name.  The statement was discarded.

Cada mensaje trae cuatro cosas, siempre en el mismo orden:

Parte En el ejemplo Qué es
Línea 310 El LineID del fuente al que se refiere. Ahí es donde vas a buscar.
Código IGYPS2121 IGY es el compilador, PS la fase que lo detectó y 2121 el número.
Severidad S Qué tan grave es. Decide el return code.
Texto "WS-TOTL" was not ... Qué encontró y qué hizo con la sentencia.

La severidad es la letra que importa. Hay cinco:

Letra Nombre Return code Qué hacer
I Informativo 0 Nada. Es un aviso.
W Advertencia 4 Leerlo. Casi siempre el programa funciona, pero revísalo.
E Error 8 Corregirlo. El compilador lo “arregló” a su manera.
S Severo 12 Corregirlo antes de nada. No intentes ejecutar.
U Irrecuperable 16 La compilación se detuvo ahí. Suele ser un problema serio.

Si el mismo mensaje se repite en otras líneas, el compilador no lo imprime otra vez: agrega Same message on line: con los números. No lo pases por alto, son errores también.

El detalle fino de cada parte del mensaje está en la ficha IGY: cómo leer un mensaje del compilador.

El resumen y el return code

Lo último del listado es el resumen:

Messages    Total    Informational    Warning    Error    Severe    Terminating
Printed:       3                        1                   2
* Statistics for COBOL program CALCNOM1:
*    Source records = 480
*    Data Division statements = 96
*    Procedure Division statements = 212
End of compilation 1,  program CALCNOM1,  highest severity 12.
Return code 12

El return code es la severidad más alta que apareció en cualquier mensaje. Un solo mensaje S entre cien W da 12. Por eso la primera lectura del listado es esta:

  • 0 o 4: compiló. Si hay W, léelas igual; a veces avisan de un error de lógica, como un PERFORM que nunca regresa.
  • 8: compiló, pero hay algo que el compilador tuvo que corregir por ti. No confíes en el resultado hasta revisarlo.
  • 12: no tienes programa que probar. Por omisión el compilador usa NOCOMPILE(S): desde el primer error S solo revisa la sintaxis y no genera módulo.
  • 16: el compilador ni siquiera terminó. Revisa los mensajes de arranque.

Del mensaje a la línea, paso a paso

Esta es la rutina. Con dos o tres compilaciones ya te sale sola.

  1. Ve al final y mira el Return code. Si es 0 o 4, lee las advertencias y sigue con tu día.
  2. Sube a la lista de mensajes y toma el primero con severidad S o E. No el que se ve más fácil: el primero.
  3. Busca esa línea en el fuente del listado. El LineID lleva ceros a la izquierda, así que con FIND 000310 llegas directo.
  4. Lee esa línea y las dos o tres anteriores. El compilador marca la línea donde se dio cuenta del problema, que no siempre es donde está el error. Un punto que falta en la línea 308 explota en la 310.
  5. Corrige, recompila y vuelve al paso 1. No intentes arreglar todos los mensajes de una sentada.

Ojo con esto: muchos mensajes son consecuencia de uno solo. Un END-EXEC que falta, un punto de más o un copy que no se encontró pueden generar decenas de errores en líneas que están bien. Corrige el primero, recompila y mira qué queda. A veces desaparecen todos.

Práctica: un listado con tres mensajes

Compilaste CALCNOM1 y el job terminó con RC=12. Vas al final del SYSPRINT:

LineID  Message code  Message text
   310  IGYPS2121-S   "WS-TOTL" was not defined as a data-name.  The statement was discarded.
   345  IGYPS2072-S   "DISPLY" was invalid.  Skipped to the next verb, period or procedure-name
                      definition.
   402  IGYPS0001-W   A blank was missing before character "2" in column 53.  A blank was assumed.
Messages    Total    Informational    Warning    Error    Severe    Terminating
Printed:       3                        1                   2
End of compilation 1,  program CALCNOM1,  highest severity 12.
Return code 12

Lo lees así:

  • Línea 310, S. Es el primero y es severo: empiezas aquí. WS-TOTL no existe. Buscas 000310 en el fuente del listado y la columna de la derecha ya te lo decía con un UND:

    000310                    ADD WS-IMPORTE TO WS-TOTL                                          140 UND

    El campo se llama WS-TOTAL-NOMINA. Es un nombre mal escrito. Corriges y sigues. Ficha: IGYPS2121-S.

  • Línea 345, S. DISPLY no es un verbo. El compilador se saltó hasta el siguiente verbo, así que todo lo que había en esa sentencia se descartó. Es un DISPLAY con una letra menos. Ficha: IGYPS2072-S.

  • Línea 402, W. Falta un espacio entre una coma y lo que sigue. En COBOL la coma separadora es “coma seguida de espacio”; aquí el 2 va pegado a la coma, en la columna 53 que señala el mensaje:

    000402                    MOVE WS-IMPORTE TO WS-TABLA-DEPTOS (WS-I,2)

    El compilador supuso el espacio y siguió. No frena nada, pero corrígelo de paso, (WS-I, 2), para que la siguiente compilación salga limpia. Ficha: IGYPS0001-W.

Después de tres correcciones chiquitas (un nombre, una letra y un espacio), recompilas y el return code baja a 0. Así son la mayoría de las compilaciones fallidas: errores chiquitos que el listado te señala con precisión, siempre que sepas dónde mirar.

Resumen

  • El listado sale en el SYSPRINT del step que ejecuta el compilador.
  • Opciones y mensajes de arranque al principio; fuente en medio; mensajes y return code al final.
  • Cada mensaje trae línea, código, severidad y texto. La severidad decide el return code.
  • Los números de línea son los del listado, no los del editor. Busca por LineID con ceros.
  • Con XREF, un UND en la columna derecha del fuente delata un nombre sin definir.
  • Corrige el primer S o E, recompila y repite. Las cascadas se caen solas.