Saltar al contenido
Interpretar errores

Principiante12 min de lectura

Los errores de compilación más comunes

Casi todos los errores de compilación vienen de seis causas. Aquí las ves una por una, con cómo se ven en el listado, el despiste que las provoca y cómo se corrigen.

Al terminar sabrás

  • Reconocer, por cómo se ve en el listado, cuál de las seis causas típicas tienes enfrente.
  • Qué despiste provoca cada una y cómo se corrige en una o dos líneas.
  • Cómo distinguir un error de verdad de una cascada provocada por otro.
  • Qué revisar antes de mandar a compilar para que el listado salga limpio a la primera.

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 COLS inserta una regla de columnas debajo de la línea donde lo tecleas. Déjala puesta mientras aprendes; se quita con RESET.

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 como UND y con su propio IGYPS2121-S. Si ves veinte campos “no definidos” que empiezan todos con el mismo prefijo, no busques veinte errores: busca el COPY.
  • 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, con IGYPS2121-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 EXEC que no pasó por su preprocesador. Si el programa tiene EXEC SQL o EXEC CICS y lo compilaste con un procedimiento que no activa el coprocesador o el traductor (las piezas que procesan los EXEC), esas sentencias no se procesan. IBM documenta que con NOCICS o NOSQL el compilador las diagnostica y las descarta, y NOSQL es el valor por omisión. Si te salen errores en todos los EXEC del 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' OR sin nada después del OR es 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-EXEC que falta: el coprocesador se traga todo hasta el siguiente END-EXEC y las sentencias que vienen después caen con IGYDS1089-S, aunque sean MOVE o ADD de la PROCEDURE 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-S aunque esté perfecta.

Ojo con esto: cuando los mensajes son muchos, no leas la lista completa. Toma el primero con severidad S o E, 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:

  1. Regla de columnas visible. COLS en ISPF. Párrafos en la 8, sentencias en la 12, nada después de la 72.
  2. Nombres copiados, no escritos de memoria. Del copy o de la DATA DIVISION, con copiar y pegar.
  3. Cada END- en cuanto abres. END-IF, END-PERFORM, END-EXEC, ). Primero el cierre, luego el relleno.
  4. Un solo punto por párrafo, al final. Dentro del párrafo, terminadores explícitos.
  5. Copys incluidos y de la librería correcta. Si dudas, abre el miembro antes de compilar.
  6. Espacio después de cada coma, sobre todo entre subíndices. O sin comas: en COBOL son opcionales.
  7. El procedimiento de compilación del equipo, sobre todo si el programa tiene EXEC SQL o EXEC CICS.

Resumen

  • Seis causas explican casi todos los errores: nombres, cierres que faltan, columnas, copys, verbos mal escritos y cascadas.
  • Un UND en el XREF o un nombre entre comillas: nombre mal escrito o sin definir.
  • El punto cierra todo lo abierto; el END-EXEC y 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 *, /, D o -.
  • Copy que no se encuentra: mensaje arriba del listado y cascada de UND abajo.
  • Corrige el primer S o E y recompila. Lee las W antes de dar el programa por bueno.