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

Document ID : KB000038976
Last Modified Date : 04/10/2018
Show Technical Document Details
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:
Librarian 4.4 z/OS BDAM 
Instructions:

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 Disk Master File Copy section in Chapter 3: Disk Master Files of the CA Librarian System Services Reference Guide