Catalog Datasets
Catalog Datasets (for Experienced)
Summary
For basic information, go through the IEFBR14 Utility (for Beginners)
- Catalog makes the dataset entry in the Catalog table with the volume serial number. So that if you search the dataset from the Data Set List Utility (ISPF 3.4), you can find the dataset.
- Catalog performs on uncataloged data sets to make them available for search and access the data in them.
- IEFBR14 can be used to catalog the uncataloged sequential file (PS) or partitioned dataset (PDS).
- The disposition to catalog the dataset is DISP=(OLD,CATLG,..).
CATLG option performs below two tasks -
- Creates/Updates an entry in the system or user catalog directory for the dataset with all volume serials numbers.
- Creates all the required indexes that are required to access the dataset.
Syntax -
//Job-Card
//*
//STEP1 EXEC PGM=IEFBR14
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSDUMP DD SYSOUT=*
//DD1 DD DSN=datset.name, DISP=(OLD,CATLG,..),
// VOLUME=SER=volume-name,UNIT=sys-name
- volume-name - It is a volume name. It should be the same volume used to create the dataset for the first time.
- sys-name - It is a storage system name. It should be the system name used to create the dataset for the first time.
Example -
Scenario - Catalog the PS and PDS using IEFBR14 utility that are uncataloged earlier.
Input PS File - MATEPK.IEFBR14.PSFILE
Input PDS File - MATEPK.IEFBR14.PDSFILE
JCL -
----+----1----+----2---+---3----+---4---+---5---+---6----+---7--
***************************** Top of Data ******************************
//MATEPKC JOB (123),'MTH',CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1),
// NOTIFY=&SYSUID
//*************************************************************
//* CATALOG DATA SET USING IEFBR14 UTILITY
//*************************************************************
//STEP01 EXEC PGM=IEFBR14
//DD1 DD DSN=MATEPK.IEFBR14.PSFILE,
// VOLUME=SER=DEVHD4,UNIT=SYSDA,
// DISP=(OLD,CATLG,DELETE)
//DD2 DD DSN=MATEPK.IEFBR14.PDSFILE,
// VOLUME=SER=DEVHD4,UNIT=SYSDA,
// DISP=(OLD,CATLG,DELETE)
**************************** Bottom of Data ****************************
Output -
Go to Spool (SDSF -> ST) and verify the status in the JESYSMSG DDname of the corresponding job.
********************************* TOP OF DATA **********************************
ICH70001I MATEPK LAST ACCESS AT 11:19:52 ON SATURDAY, AUGUST 20, 2022
IEF236I ALLOC. FOR MATEPKC STEP01
IEF237I 0ABB ALLOCATED TO DD1
IEF237I 0ABB ALLOCATED TO DD2
IEF142I MATEPKC STEP01 - STEP WAS EXECUTED - COND CODE 0000
IEF285I MATEPK.IEFBR14.PSFILE CATALOGED
IEF285I VOL SER NOS= DEVHD4.
IEF285I MATEPK.IEFBR14.PDSFILE CATALOGED
IEF285I VOL SER NOS= DEVHD4.
IEF373I STEP/STEP01 /START 2022232.1122
IEF032I STEP/STEP01 /STOP 2022232.1122
CPU: 0 HR 00 MIN 00.01 SEC SRB: 0 HR 00 MIN 00.00 SEC
VIRT: 4K SYS: 228K EXT: 0K SYS: 13476K
IEF375I JOB/MATEPKC /START 2022232.1122
IEF033I JOB/MATEPKC /STOP 2022232.1122
CPU: 0 HR 00 MIN 00.01 SEC SRB: 0 HR 00 MIN 00.00 SEC
******************************** BOTTOM OF DATA ********************************
Explaining Example -
- DD1 DD * - Specifies PS dataset with DISP for catalog (DISP=(OLD,CATLG,DELETE)).
- DD2 DD * - Specifies PDS dataset with DISP for catalog (DISP=(OLD,CATLG,DELETE)).
- IEF142I MATEPKC STEP01 - STEP WAS EXECUTED - COND CODE 0000 - Specifies the step01 completed successfully.
- MATEPK.IEFBR14.PSFILE CATALOGED - Specifies the MATEPK.IEFBR14.PSFILE cataloged successfully on DEVHD4 volume.
- MATEPK.IEFBR14.PDSFILE CATALOGED - Specifies the MATEPK.IEFBR14.PDSFILE cataloged successfully on DEVHD4 volume.