Antes de empezar
Esta guía da por hecho que ya sabes moverte en un listado: dónde están los mensajes, qué
significa la severidad y por qué se corrige primero el primer S o E. Si no, empieza por
Cómo leer un listado de compilación y regresa.
Seguimos con el mismo programa inventado, CALCNOM1, el que acumula la nómina de los empleados.
Cada sección es una causa, no un código: los códigos cambian, los despistes no. En cada una vas a
ver lo mismo, en el mismo orden: cómo se ve en el listado, el ejemplo mínimo que lo provoca, cómo
se corrige y la ficha donde está el detalle.
Nombres mal escritos o sin definir
Cómo se ve. El mensaje trae el nombre entre comillas y dice que no está definido. Si el
listado tiene XREF, la columna de la derecha ya lo marcaba con UND antes de que llegaras a los
mensajes:
310 IGYPS2121-S "WS-TOTL" was not defined as a data-name. The statement was discarded.
Qué lo provoca. Una letra de menos, una de más o un guion que se volvió guion bajo. También un campo que existe, pero en otro programa; o que debía venir de un copy que no se incluyó. De eso hablamos más abajo.
01 WS-TOTALES.
05 WS-TOTAL-NOMINA PIC S9(9)V99 COMP-3.
05 WS-CONTADOR PIC 9(5).
* El campo se llama WS-TOTAL-NOMINA
ADD WS-IMPORTE TO WS-TOTL
Cómo se corrige. Busca el nombre correcto en la DATA DIVISION del listado (no en el editor,
que ahí no están los copys) y cópialo tal cual. El compilador descartó la sentencia completa, así
que después de corregir el nombre revisa que la sentencia haga lo que querías.
Ficha: IGYPS2121-S.
Lo que abres y no cierras
En COBOL, varias cosas abren un alcance que algo tiene que cerrar: un IF lo cierra END-IF o un
punto; un EXEC SQL lo cierra END-EXEC; un paréntesis lo cierra otro paréntesis. Cuando falta el
cierre, el compilador sigue leyendo como si todo fuera parte de lo que abriste, y el error aparece
líneas después de donde está el despiste.
El punto
El punto es el terminador implícito: cierra todas las sentencias abiertas hasta ahí. Un punto de
más dentro de un IF lo cierra antes de tiempo, y lo que sigue queda fuera del IF aunque la
sangría diga otra cosa. El END-IF que viene después ya no tiene IF que cerrar y el compilador
lo marca como sobrante.
IF WS-TIPO-EMPLEADO = 'E'
ADD WS-IMPORTE TO WS-TOTAL-NOMINA.
* El punto de arriba cerró el IF: este ADD corre siempre
ADD 1 TO WS-CONTADOR
END-IF
Un punto de menos hace lo contrario: la siguiente sentencia o definición se lee como continuación
de la anterior. En la DATA DIVISION eso da un IGYDS1089-S en la línea de abajo, que está bien
escrita:
01 WS-EMPLEADO.
* Falta el punto al final de esta línea
05 WS-NUM-EMPLEADO PIC 9(6)
05 WS-NOMBRE PIC X(40).
Cómo se corrige. Dentro de un párrafo, usa terminadores explícitos (END-IF, END-PERFORM,
END-READ) y deja el punto solo al final del párrafo. Así ningún punto cierra nada por accidente.
Es lo que IBM recomienda en la Programming Guide.
El END-EXEC
IBM documenta este caso en una nota de soporte. Cuando el coprocesador de Db2 (la parte del
compilador que procesa el SQL) encuentra un EXEC SQL, entra en “modo SQL”: junta todo lo que sigue
para pasárselo a Db2 y no revisa reglas de COBOL hasta encontrar un END-EXEC. Si falta, el
siguiente END-EXEC válido puede estar ya en la PROCEDURE DIVISION, y todo lo de en medio se
traga como si fuera SQL. Lo que viene después se marca como inválido con mensajes IGYDS, los de la
DATA DIVISION, aunque sean sentencias de la PROCEDURE DIVISION: para el compilador, la
DATA DIVISION nunca terminó.
232 IGYDS1089-S "MOVE" was invalid. Scanning was resumed at the next area "A" item,
level-number, or the start of the next clause.
233 IGYDS1089-S "ADD" was invalid. Scanning was resumed at the next area "A" item,
level-number, or the start of the next clause.
La pista es esa: mensajes de la DATA DIVISION sobre verbos como MOVE o ADD, en líneas que
están bien escritas.
EXEC SQL
DECLARE CUR-EMPLEADOS CURSOR FOR
SELECT NUM_EMPLEADO, IMPORTE
FROM EMPLEADO
* Aquí falta END-EXEC
PROCEDURE DIVISION.
Cómo se corrige. Ve a la primera línea marcada, sube hasta el último EXEC SQL y ciérralo con
END-EXEC y su punto. Dos reglas de IBM que ayudan: EXEC SQL y END-EXEC van cada uno completo
en una sola línea, y dentro de un EXEC SQL no va código COBOL. Para la próxima, escribe el
END-EXEC en cuanto abres el EXEC SQL, y luego llenas el medio.
El paréntesis
El compilador esperaba ) y encontró otra palabra. Supone que el paréntesis iba antes de esa
palabra y sigue, pero con su interpretación, no con la tuya:
356 IGYPS2070-E Expected a right parenthesis, but found "WS-NOMBRE" in the "DISPLAY"
statement. A right parenthesis was assumed before "WS-NOMBRE".
* Falta el ) después de WS-I
DISPLAY WS-DEPARTAMENTO (WS-I WS-NOMBRE
Cómo se corrige. Cierra el paréntesis donde va. En un COMPUTE largo, cuenta los que abren y
los que cierran, o pártelo en varias líneas.
Fichas: IGYDS1089-S y IGYPS2070-E.
Columnas y áreas A y B
En formato fijo cada columna tiene dueño. Las columnas 1 a 6 son para numerar; la 7 es el área
indicadora; de la 8 a la 11 es el área A; de la 12 a la 72 es el área B. En el área A van
los encabezados de división y sección, los nombres de párrafo y los niveles 01 y 77. En el área
B van las sentencias y las cláusulas. Lo que esté después de la columna 72 no existe para el
compilador.
Cómo se ve. Dos mensajes distintos para dos despistes de columnas:
288 IGYDS0002-E A character other than '*', 'D', '/' or '-' was found in column 7. A blank
was assumed.
305 IGYPS2010-E Procedure-name "200-ACUMULA-EMPLEADO" was found in area "B" followed by a
period or section.
Qué lo provoca. Código corrido una columna, casi siempre al pegarlo desde otro lado; o un nombre de párrafo que quedó en la columna 12 porque lo escribiste con la misma sangría que las sentencias. Mira las columnas con la regla del propio listado:
----+-*A-1-B--+----2----+----3----+----4----+----5
MOVE WS-NOMBRE TO DET-NOMBRE
200-ACUMULA-EMPLEADO.
ADD WS-IMPORTE TO WS-TOTAL-NOMINA
La M de MOVE quedó en la columna 7, el área indicadora, donde solo caben *, /, D o -.
El nombre del párrafo empezó en la columna 12, área B, cuando le tocaba la 8. El compilador
“corrige” los dos casos a su manera y sigue, pero los marca con E: return code 8 y un programa
que quizá no es el que escribiste.
Así debían quedar:
----+-*A-1-B--+----2----+----3----+----4----+----5
MOVE WS-NOMBRE TO DET-NOMBRE
200-ACUMULA-EMPLEADO.
ADD WS-IMPORTE TO WS-TOTAL-NOMINA
Cómo se corrige. Mueve la línea a su columna. Si son muchas, revisa cómo llegó el fuente: puede
venir empaquetado (con la opción PACK del perfil de ISPF) o copiado desde un editor que se comió
los espacios iniciales.
Ojo con esto: en ISPF, el comando de línea
COLSinserta una regla de columnas debajo de la línea donde lo tecleas. Déjala puesta mientras aprendes; se quita conRESET.
Fichas: IGYDS0002-E e IGYPS2010-E.
Problemas con el COPY
Un COPY trae texto de un miembro de una librería, por omisión la del DD SYSLIB, y lo pega en tu
programa antes de compilar. Cuando algo falla ahí, el síntoma casi nunca está en la línea del
COPY.
Cómo se ve. Hay dos variantes:
- El copy no se encontró. El mensaje sale al principio del listado, con los mensajes de
arranque, porque lo emite la fase que procesa los
COPY, antes de compilar nada. Luego, al final, viene la cascada: cada campo que debía definir ese copy aparece comoUNDy con su propioIGYPS2121-S. Si ves veinte campos “no definidos” que empiezan todos con el mismo prefijo, no busques veinte errores: busca elCOPY. - El copy existe, pero no es el que creías. Compilaste con una librería distinta a la del
equipo, o alguien cambió el copy y tu programa usa campos que ya no están. El listado no se queja
del
COPY: se queja de los campos, conIGYPS2121-S.
* El miembro CPEMPLEA no está en ninguna librería del SYSLIB
COPY CPEMPLEA.
Cómo se corrige. Si no se encontró, revisa tres cosas: que el nombre del miembro esté bien
escrito, que la librería esté en el SYSLIB del job de compilación y que el miembro exista en esa
librería. Si existe pero los campos no cuadran, abre el copy expandido en el listado y compara con
lo que tu programa usa. Y un detalle que se olvida: cada COPY termina con punto. Sin él, la
siguiente línea se lee como parte de la sentencia COPY.
Fichas: IGYPS2121-S y, por el orden del listado, IGY: cómo leer un mensaje del compilador.
Verbos y palabras que el compilador no reconoce
Cómo se ve. El compilador esperaba un verbo y encontró otra cosa. Como no sabe qué hacer con ella, se salta todo hasta el siguiente verbo, punto o nombre de párrafo, y te lo dice:
345 IGYPS2072-S "DISPLY" was invalid. Skipped to the next verb, period or procedure-name
definition.
Qué lo provoca. Tres cosas, de más a menos frecuente:
- Un verbo mal escrito.
DISPLY,MOV,PERFROM. Todo lo que había en esa sentencia se descarta, no solo la palabra. - Un
EXECque no pasó por su preprocesador. Si el programa tieneEXEC SQLoEXEC CICSy lo compilaste con un procedimiento que no activa el coprocesador o el traductor (las piezas que procesan losEXEC), esas sentencias no se procesan. IBM documenta que conNOCICSoNOSQLel compilador las diagnostica y las descarta, yNOSQLes el valor por omisión. Si te salen errores en todos losEXECdel programa, antes de tocar el código revisa que estés compilando con el procedimiento de tu equipo. - Una condición incompleta.
IF WS-TIPO-EMPLEADO = 'E' ORsin nada después delORes un error de sintaxis: el compilador lo marca en esa línea, y el mensaje exacto puede variar según la versión. Escribe la condición completa, o usa un nivel 88 (un nombre para un valor del campo).
MOVE WS-NOMBRE TO DET-NOMBRE
* DISPLY no es un verbo: toda la sentencia se descarta
DISPLY 'EMPLEADO: ' WS-NOMBRE
ADD 1 TO WS-CONTADOR
Hay un pariente menor que no frena la compilación pero ensucia el listado: la coma sin espacio
después. En COBOL la coma separadora es “coma seguida de espacio”; si lo que sigue va pegado, el
compilador avisa con la columna exacta, supone el espacio y sigue, con una W:
402 IGYPS0001-W A blank was missing before character "2" in column 53. A blank was assumed.
* El 2 va pegado a la coma: falta un espacio antes de él
MOVE WS-IMPORTE TO WS-TABLA-DEPTOS (WS-I,2)
Se arregla con el espacio, (WS-I, 2), o quitando la coma: entre subíndices es opcional.
Cómo se corrige. Lee la palabra entre comillas. Si es un verbo con una letra cambiada,
corrígelo y listo. Si la palabra se ve bien, el problema está antes: un punto o un END- mal
puesto dejó al compilador desubicado y la siguiente palabra “ya no cuadra”.
Fichas: IGYPS2072-S, IGYPS2048-S y IGYPS0001-W.
Errores en cascada: uno que parece veinte
Cómo se ve. Una ráfaga de mensajes en líneas consecutivas, o el mismo mensaje repetido con
Same message on line: y una lista larga de números. Vas a las líneas y están bien escritas.
Qué lo provoca. Un solo error que cambió cómo el compilador lee lo que sigue. Los tres de siempre ya los viste:
- Un
END-EXECque falta: el coprocesador se traga todo hasta el siguienteEND-EXECy las sentencias que vienen después caen conIGYDS1089-S, aunque seanMOVEoADDde laPROCEDURE DIVISION. - Un copy que no se encontró: cada campo del copy da su
IGYPS2121-S. - Un punto o verbo mal puesto que desubica al compilador, y la línea siguiente cae con
IGYPS2072-Saunque esté perfecta.
Ojo con esto: cuando los mensajes son muchos, no leas la lista completa. Toma el primero con severidad
SoE, corrígelo, recompila y mira qué queda. Muchas veces no queda nada.
Cómo se corrige. Así, con el primero. Si el primero también se ve bien, sube unas líneas desde ahí: el despiste está antes de donde el compilador se dio cuenta.
Las advertencias que sí importan
Una W deja return code 4 y el programa se genera. Por eso mucha gente las ignora. Pero algunas
avisan de un error de lógica que te va a costar caro en ejecución, como un PERFORM a un párrafo
que nunca regresa porque adentro hay un GO TO o un STOP RUN sin condición:
420 IGYOP3093-W The "PERFORM" statement at "PERFORM (line 420)" cannot reach its exit.
Lo que escribiste después de ese PERFORM nunca se ejecuta. A veces es justo lo que querías: una
rutina de error que termina el programa con STOP RUN o GOBACK no tiene por qué regresar. Otras
veces es un GO TO que se te fue. La advertencia no distingue entre las dos; la lees para
confirmar cuál es tu caso, y si es intencional la dejas en paz.
Ficha: IGYOP3093-W.
Antes de mandar a compilar, revisa esto
Un minuto de revisión ahorra una compilación entera. La lista, en el orden en que más duelen:
- Regla de columnas visible.
COLSen ISPF. Párrafos en la 8, sentencias en la 12, nada después de la 72. - Nombres copiados, no escritos de memoria. Del copy o de la
DATA DIVISION, con copiar y pegar. - Cada
END-en cuanto abres.END-IF,END-PERFORM,END-EXEC,). Primero el cierre, luego el relleno. - Un solo punto por párrafo, al final. Dentro del párrafo, terminadores explícitos.
- Copys incluidos y de la librería correcta. Si dudas, abre el miembro antes de compilar.
- Espacio después de cada coma, sobre todo entre subíndices. O sin comas: en COBOL son opcionales.
- El procedimiento de compilación del equipo, sobre todo si el programa tiene
EXEC SQLoEXEC CICS.
Resumen
- Seis causas explican casi todos los errores: nombres, cierres que faltan, columnas, copys, verbos mal escritos y cascadas.
- Un
UNDen el XREF o un nombre entre comillas: nombre mal escrito o sin definir. - El punto cierra todo lo abierto; el
END-EXECy el paréntesis que faltan explotan líneas después. - Área A para párrafos y niveles
01; área B para sentencias. La columna 7 solo acepta*,/,Do-. - Copy que no se encuentra: mensaje arriba del listado y cascada de
UNDabajo. - Corrige el primer
SoEy recompila. Lee lasWantes de dar el programa por bueno.