Do you have a procedure for increasing the size of a Librarian BDAM master file?

book

Article ID: 38976

calendar_today

Updated On:

Products

CA 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
   //   

The reason we do 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. 


If we do a 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. 

After you have successfully increased the master file then you can deleted the original master file you renamed to your.librarian.master.file.OLD for example.

Additional Information

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