DISP es un parámetro de la instrucción DD (Data Definition) de los JCL. Sirve para indicarle al sistema el estado actual de un fichero y las acciones a realizar sobre el mismo si el paso termina correctamente y en caso de terminación anormal (abend). Su formato es:
DISP=(Estado, Acción normal, Acción anormal).
Valores para el subparámetro de estado
NEW
Crear nuevo dataset
OLD
El dataset ya existe y se require uso exclusivo (no compartido) del mismo.
SHR
El dataset ya existe y no se require su uso exclusivo. Otros jobs pueden utilizarlo al mismo tiempo.
MOD:
Si el dataset ya existe, indica que se quieren añadir registros al final del mismo (debe ser secuencial). Si el dataset no existe, indica que debe ser creado.
Valores para el subparámetro de acción normal
DELETE
Indica que el dataset dejará de ser necesario. Dependiendo de la configuración de seguridad y de si está almacenado en cinta o no, puede suponer que se eliminará físicamente o bien que su espacio quedará disponible para otros datasets.
KEEP
Mantener el dataset en el volumen en el que esté almacenado.
PASS
Pasar el dataset para su utilización en un paso posterior del job. Ahorra tiempo con respecto a KEEP, ya que el sistema retiene información sobre la ubicación y el volumen. De todas formas, es preferible evitar su su uso porque puede provocar pérdida de datos o incluso el borrado del fichero si no se codifica correctamente en ciertos casos.
CATLG
Incluir una entrada que apunte al dataset en el catálogo, lo que nos permitirá utilizar el dataset posteriormente.
UNCATLG
Si está activado el sistema de gestión automática de almacenamiento (SMS), que suele ser lo habitual, es ignorado y equivale a KEEP. Indica que se eliminará del catálogo la entrada correspondiente al dataset.
Valores para el subparámetro de acción anormal
DELETE
Liberar el espacio que ocupa el dataset, que quedará disponible para su uso por otros datasets.
KEEP
Mantener el dataset.
CATLG
Incluir una entrada que apunte al dataset en el catálogo, lo que nos permitirá utilizar el dataset posteriormente.
UNCATLG
Si está activado el sistema de gestión automática de almacenamiento (SMS), que suele ser lo habitual, es ignorado y equivale a KEEP. Indica que se eliminará del catálogo la entrada correspondiente al dataset.
Valores por defecto
Si se omite el suparámetro de estado, el valor por defecto es NEW.
Si se omite el subparámetro de ejecución normal, el valor por defecto es DELETE para un dataset nuevo y KEEP para un dataset existente.
Si se omite el suparámetro de ejecución anormal, el valor por defecto es el especificado para la ejecución normal, salvo que se trate de PASS. En ese caso el valor por defecto es DELETE para un dataset nuevo o KEEP para uno existente.
Para indicar la ausencia del primer y el segundo subparámetro se debe incluir la coma de separación.
Ejemplos:
DISP=(,CATLG,DELETE) – Equivale a DISP=(NEW,CATLG,DELETE)
DISP=(,KEEP) – Equivale a (NEW,KEEP,KEEP)
DISP=(OLD,,DELETE) – Equivale a (OLD,KEEP,DELETE)
Si se omite el parámetro DISP por completo, el valor por defecto es (NEW,DELETE,DELETE) Es decir, un fichero que se crea y se borra en el mismo paso.
Nota: Utilizamos el término inglés dataset para referirnos a los ficheros que se utilizan en el z/OS. Se trata de conjuntos de datos organizados en forma de registros y bloques que pueden ser almacenados en dispositivos de acceso directo (DASD) o en cinta.