Nivel inicial8 min de lectura · Publicado el

IDENTIFICATION DIVISION en COBOL: PROGRAM-ID y párrafos

IDENTIFICATION DIVISION de COBOL: PROGRAM-ID resaltado como obligatorio y AUTHOR, INSTALLATION, DATE-WRITTEN, DATE-COMPILED y SECURITY, en gris. Obligatorio: solo PROGRAM-IDrubentejera.com IDENTIFICATION DIVISION.PROGRAM-ID. PROG0001.AUTHOR.INSTALLATION.DATE-WRITTEN.DATE-COMPILED.SECURITY.obligatorioopcionalesy obsoletos
PROGRAM-ID da nombre al programa y es lo único obligatorio. Los otros cinco párrafos solo son comentarios: obsoletos desde COBOL 85 y retirados en 2002, aunque GnuCOBOL e IBM los siguen aceptando.

La IDENTIFICATION DIVISION es la primera división de un programa COBOL y la más sencilla de escribir. Solo sirve para identificar el programa: no tiene ningún efecto en su ejecución.

Es como la portada de un trabajo de clase: el título es obligatorio, porque sin él nadie sabe de qué trabajo se trata. El nombre del autor, el centro o la fecha son útiles para quien lo lee, pero no cambian ni una coma del contenido. En COBOL, el título es PROGRAM-ID y el resto de la portada son los párrafos opcionales.

Si aún no tienes clara la estructura general, empieza por la estructura de un programa COBOL: la IDENTIFICATION DIVISION es la primera de sus cuatro divisiones.

Los párrafos de la IDENTIFICATION DIVISION

Párrafo ¿Obligatorio? Qué indica
PROGRAM-ID Sí, y el primero Nombre del programa. Es lo que usan otros programas para llamarlo.
AUTHOR No (obsoleto) Autor del programa.
INSTALLATION No (obsoleto) Empresa o centro donde se ejecuta.
DATE-WRITTEN No (obsoleto) Fecha en que se escribió. El formato es libre: el compilador no la comprueba.
DATE-COMPILED No (obsoleto) Fecha de compilación. En IBM Enterprise COBOL, el compilador la escribe en el listado.
SECURITY No (obsoleto) Nivel de confidencialidad del programa.

Los cinco párrafos opcionales tienen un comentario detrás del punto (lo que el estándar llama comment-entry): un texto libre que el compilador no interpreta. Por eso da igual escribir 24/10/2018 o octubre de 2018 en DATE-WRITTEN.

PROGRAM-ID en COBOL: el único obligatorio

Es el único párrafo que no puedes quitar y tiene que ser el primero de la división. Si falta, el compilador se detiene. Esto es lo que responde GnuCOBOL a una IDENTIFICATION DIVISION sin PROGRAM-ID:

sinpid.cbl:2: error: syntax error, unexpected PROCEDURE, expecting FUNCTION-ID or PROGRAM-ID

DATE-COMPILED: el que se rellena solo

DATE-COMPILED se puede dejar vacío. En IBM Enterprise COBOL, al compilar, el compilador pone la fecha de compilación en el listado (el informe que genera junto al programa). Si habías escrito algo detrás, lo sustituye por la fecha.

GnuCOBOL 3.2 no hace esto: en su listado (cobc -t listado.lst) la línea aparece tal cual, DATE-COMPILED., sin fecha.

Dónde se escribe cada cosa

En formato fijo, el de la hoja de codificación de COBOL:

  • El encabezado IDENTIFICATION DIVISION. y el nombre de cada párrafo (PROGRAM-ID., AUTHOR.…) empiezan en el área A (columnas 8 a 11).
  • El valor va detrás del punto, separado por un espacio, y siempre en el área B (columnas 12 a 72). Es costumbre alinear los valores en la misma columna, por ejemplo la 35, para que se lean mejor, pero no es obligatorio.

Si un comentario empieza en el área A, el compilador cree que es un párrafo o una división nueva. Este fragmento pone ANA GARCIA. en la columna 8:

       AUTHOR.
       ANA GARCIA.

Y GnuCOBOL se pierde: piensa que ha empezado otra cosa y da cuatro errores, el primero ENVIRONMENT DIVISION header missing. Las reglas de palabras y puntos de COBOL las tienes en Usos y reglas de COBOL.

Un ejemplo completo que compila

Este es el ejemplo del artículo original, corregido para que compile tal cual (la sangría de 7 espacios deja las columnas 1 a 7 libres):

       IDENTIFICATION DIVISION.
       PROGRAM-ID. PROG0001.
       AUTHOR. ANA GARCIA.
       INSTALLATION. EJEMPLO.
       DATE-WRITTEN. 24/10/2018.
       DATE-COMPILED.
       SECURITY. NO ES CONFIDENCIAL.
       PROCEDURE DIVISION.
           DISPLAY "Hola desde PROG0001".
           STOP RUN.

Compílalo y ejecútalo con GnuCOBOL:

cobc -x prog0001.cbl   # -x genera un ejecutable
./prog0001
Hola desde PROG0001

Sin opciones, GnuCOBOL compila en silencio. Si te sobra todo menos lo imprescindible, esta versión también es válida:

       IDENTIFICATION DIVISION.
       PROGRAM-ID. MINIMO.
       PROCEDURE DIVISION.
           DISPLAY "Solo PROGRAM-ID".
           STOP RUN.

Este programa mínimo salta directamente a la PROCEDURE DIVISION porque no usa datos. En cuanto necesites variables o ficheros, aparece antes la DATA DIVISION; las dos están explicadas en DATA DIVISION y PROCEDURE DIVISION en COBOL.

El título de la portada es obligatorio; el resto, decoración.

¿Están obsoletos AUTHOR, DATE-WRITTEN y los demás?

Sí. El estándar COBOL 85 los marcó como obsoletos (se mantienen, pero se van a retirar) y el estándar de 2002 los retiró. Los compiladores actuales los siguen aceptando porque hay millones de líneas de COBOL que los usan.

Lo puedes ver tú mismo con GnuCOBOL. Con -Wall (activa los avisos), avisa de cada uno:

cobc -x -Wall prog0001.cbl
prog0001.cbl:3: warning: AUTHOR is obsolete in GnuCOBOL [-Wobsolete]
prog0001.cbl:4: warning: INSTALLATION is obsolete in GnuCOBOL [-Wobsolete]
prog0001.cbl:5: warning: DATE-WRITTEN is obsolete in GnuCOBOL [-Wobsolete]
prog0001.cbl:6: warning: DATE-COMPILED is obsolete in GnuCOBOL [-Wobsolete]
prog0001.cbl:7: warning: SECURITY is obsolete in GnuCOBOL [-Wobsolete]

Son avisos, no errores: el programa se genera igual. Si le pides que siga un estándar concreto con -std, el resultado cambia:

Opción de GnuCOBOL Qué pasa con estos párrafos
Sin opciones Compila sin avisos
-Wall Avisa: «is obsolete in GnuCOBOL»
-std=cobol85 -Wall Avisa: «is obsolete in COBOL 85»
-std=cobol2002 o -std=cobol2014 Error: «does not conform to COBOL 2002» (o «2014») y no compila
-std=ibm Compila sin avisos, como en el mainframe de IBM

Con -std=cobol2014 el mismo programa falla:

prog0001.cbl:3: error: AUTHOR does not conform to COBOL 2014
prog0001.cbl:4: error: INSTALLATION does not conform to COBOL 2014
prog0001.cbl:5: error: DATE-WRITTEN does not conform to COBOL 2014
prog0001.cbl:6: error: DATE-COMPILED does not conform to COBOL 2014
prog0001.cbl:7: error: SECURITY does not conform to COBOL 2014

Entonces, ¿los uso o no?

  • Programa nuevo: escribe solo PROGRAM-ID y pon el autor, la fecha y la descripción en un comentario normal (un * en la columna 7). Dice lo mismo y no depende de un párrafo obsoleto. Y quién cambió qué y cuándo lo cuenta mejor el control de versiones, como Git.
  • Programa existente: si tu equipo o tu instalación los usan como norma, sigue la norma. Quitarlos no cambia el comportamiento, pero sí ensucia el historial de cambios sin aportar nada.
       IDENTIFICATION DIVISION.
       PROGRAM-ID. PROG0001.
      * Autor: Ana Garcia. Escrito el 24/10/2018.
      * Muestra un saludo por pantalla.
       PROCEDURE DIVISION.
           DISPLAY "Hola desde PROG0001".
           STOP RUN.

Pruébalo sin instalar nada

Si tienes Docker, puedes compilar los ejemplos con GnuCOBOL desde la carpeta donde guardes prog0001.cbl:

docker run --rm -v "$PWD":/w -w /w debian:stable \
  bash -c "apt-get update -qq && apt-get install -y -qq gnucobol && cobc -x -Wall prog0001.cbl && ./prog0001"
  1. Compila el ejemplo completo con -Wall y comprueba los cinco avisos.
  2. Quita PROGRAM-ID y lee el error.
  3. Mueve el valor de AUTHOR a la línea siguiente, empezando en la columna 8, y mira qué pasa.

Fuentes

Comprobado en noviembre de 2026:

  • IBM Enterprise COBOL for z/OS 6.5, Language Reference: PROGRAM-ID paragraph (obligatorio, primero y hasta 30 caracteres) y Optional paragraphs (comentarios en el área B y fecha de DATE-COMPILED en el listado).
  • IBM Enterprise COBOL for z/OS 6.5, Programming Guide: opción PGMNAME (COMPAT por defecto, recorte a 8 caracteres y mayúsculas).
  • El estado de obsoletos en COBOL 85 y la retirada en COBOL 2002 se comprobaron con los mensajes y los ficheros de configuración de los dialectos de GnuCOBOL 3.2 (cobol85.conf: comment-paragraphs: obsolete; cobol2002.conf y cobol2014.conf: unconformable).

Todos los programas y comandos se han ejecutado con GnuCOBOL 3.2.0 (paquete gnucobol3 3.2-3) en un contenedor debian:stable (Debian 13.7). En esa imagen, los ejecutables muestran además el aviso Warning: program compiled against libxml 212 using older 209, que se debe al empaquetado de Debian y no al programa; se ha omitido de las salidas.