IOU080E: How to enlarge a Librarian BDAM master?

Products

• Librarian

Issue/Introduction

When Librarian generates 'IOU080E INSUFFICIENT SPACE ON MASTER FILE' message it is time to increase the size of the Librarian master file.

This procedure is for BDAM files only.

Environment

 

Resolution

The expansion is a multi-step process. 

1. Run the Librarian Master Statistical report for the Master file that needs to be increased to verify the current space allocations.     

   //INDEX EXEC PGM=AFOLIBR,PARM='NRJS,NJTA' 

   //SYSPRINT DD SYSOUT=* 

   //INDEX DD SYSOUT=* 

   //MASTER DD DISP=SHR,DSN=your.librarian.master.file 

   //OSJOB DD DUMMY 

   //SYSIN DD * 

   -OPT INDEX(S) 

   -END 

   //* 

2. Run the BKUPDISK utility from the current Master file to a larger Master file.: 

     //MSTRBKUP EXEC PGM=AFOLIBR,PARM='NRJS,NJTA' 

   //SYSPRINT DD SYSOUT=* 

   //INDEX DD SYSOUT=* 

   //MASTER DD DISP=SHR,DSN=your.librarian.master.file

   //BACKUP DD DSN=your.librarian.master.file.BACKUP, 

   // DISP=(NEW,CATLG,DELETE), 

   // SPACE=(CYL,(700,0),RLSE), 

   // DCB=DSORG=DA, 

   // STORCLAS=(xxxxxxx) 

   //OSJOB DD DUMMY 

   //SYSIN DD * 

   -OPT BKUPDISK,INDEX 
   -END

   // 

3. Rename the original Master file.

For example 'your.librarian.master.file' to 'your.librarian.master.file.OLD'

4. Run the BKUPDISK again.

This run will copy from the BACKUP file to the original Master file with the same DCB and size as the expanded Master file backup.: 

     //MSTRBKUP EXEC PGM=AFOLIBR,PARM='NRJS,NJTA' 

   //SYSPRINT DD SYSOUT=* 

   //INDEX DD SYSOUT=* 

   //MASTER DD DISP=SHR,DSN=your.librarian.master.file.BACKUP

   //BACKUP DD DSN=your.librarian.master.file,  

   // DISP=(NEW,CATLG,DELETE), 

   // SPACE=(CYL,(700,0),RLSE), 

   // DCB=DSORG=DA, 

   // STORCLAS=(xxxxxxx) 

   //OSJOB DD DUMMY 

   //SYSIN DD * 

   -OPT BKUPDISK,INDEX 
   -END

   //   

Note:

The reason to run the two BKUPDISK jobs is because the name of the Master file is stored internally and some Librarian processing (security, for example) uses the internal name.

When the backup is done, the internally stored name is set to the name of the "TO" masterfile.
In case of rename, this internal name is not changed. So, a BKUPDISK needs be done from the original.mf to a larger.mf, rename the original.mf, and then a second BKUPDISK from the larger.mf to original.mf (where original.mf is created in the BKUPDISK job with space and DCB matching that of larger.mf. 

Once the file master has been successfully increased, the original master file (the one renamed to your.librarian.master.file.OLD for example) can be deleted.

Additional Information

For more information see the CA Librarian TechDocs article Disk Master File Copy