IDENTIFICATION DIVISION en COBOL: PROGRAM-ID y párrafos
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-IDy 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"
- Compila el ejemplo completo con
-Wally comprueba los cinco avisos. - Quita
PROGRAM-IDy lee el error. - Mueve el valor de
AUTHORa 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-COMPILEDen el listado). - IBM Enterprise COBOL for z/OS 6.5, Programming Guide: opción PGMNAME (
COMPATpor 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.confycobol2014.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.