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=12puede 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.
- Opciones. Primero las que llegaron por el
PARMdel JCL o por una sentenciaCBLoPROCESS, y luegoOptions in effect: la lista completa de lo que estuvo activo. Aquí confirmas si se compiló conSOURCE,XREFoMAP. - 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. - El fuente. Con la opción
SOURCE, el programa completo numerado línea por línea, con los copys ya expandidos. - Mapas y referencias cruzadas. Según las opciones:
MAPdice dónde queda cada campo en memoria,XREFdónde se define y dónde se usa cada nombre,OFFSETda el offset de cada sentencia (su posición dentro del código generado) yLISTel código generado. Hoy no las necesitas; en la guía del abend sí. - Los mensajes de compilación. Ordenados por número de línea.
- 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:
LineIDes el número con el que el compilador identifica cada línea. Con la opciónNONUMBER, que es la habitual, lo asigna él mismo de corrido. ConNUMBER, usa los números que tú tienes en las columnas 1 a 6.PLySLson el nivel de anidamiento de programa y de sentencia. Un1enSLdentro de unIFte dice que esa línea está adentro delIF. Útil para ver dónde terminó unEND-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 vesUND, ese nombre no está definido. Si vesIMP, 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 unPERFORMque 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 errorSsolo 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.
- Ve al final y mira el
Return code. Si es 0 o 4, lee las advertencias y sigue con tu día. - Sube a la lista de mensajes y toma el primero con severidad
SoE. No el que se ve más fácil: el primero. - Busca esa línea en el fuente del listado. El
LineIDlleva ceros a la izquierda, así que conFIND 000310llegas directo. - 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.
- 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-EXECque 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-TOTLno existe. Buscas000310en el fuente del listado y la columna de la derecha ya te lo decía con unUND:000310 ADD WS-IMPORTE TO WS-TOTL 140 UNDEl campo se llama
WS-TOTAL-NOMINA. Es un nombre mal escrito. Corriges y sigues. Ficha: IGYPS2121-S. -
Línea 345,
S.DISPLYno es un verbo. El compilador se saltó hasta el siguiente verbo, así que todo lo que había en esa sentencia se descartó. Es unDISPLAYcon 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í el2va 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
SYSPRINTdel 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
LineIDcon ceros. - Con
XREF, unUNDen la columna derecha del fuente delata un nombre sin definir. - Corrige el primer
SoE, recompila y repite. Las cascadas se caen solas.