search cancel

Guidelines for migrating Librarian Master files from z/VSE to z/OS

book

Article ID: 256407

calendar_today

Updated On:

Products

Librarian

Issue/Introduction

Migrating from z/VM  z/VSE to z/OS and would like to have some overall guidelines for converting Librarian Master files.

 

Environment

Release : 4.4

Resolution

Option 1 - Tape Backup and Restore

For each Master file, create a tape backup on the z/VSE system and Restore it on the z/OS system:

1)  Backup the Librarian Master file on the z/VSE system:

* $$ JOB                                      
// JOB                                        
/*                                            
// ASSGN  SYS004,DISK,VOL=volser,SHR        
// DLBL   MASTER,'vse.LIBRAIAN.MASTER.FILE',,DA  
// EXTENT SYS004,volser,1,0,reltrk,ntrks    
// ASSGN  SYS010,CUU                          
// TLBL   BACKUP,'LIBR.BACKUP.TAPE'              
// EXEC   LIBRPROG,SIZE=AUTO                  
-OPT BKUPTAPE,INDEX,BLKSIZE=xxxxx                       
-END                                          
/*                                            
/&                                            
* $$ EOJ                                      
BLKSIZE=     
    Specify the block size for a backup tape through the BLKSIZE subparameter of the DCB. You can specify any block size but, for maximum efficiency, specify a block size of 8000 to 9000 for a backup tape with a density of 1600 bpi and 12,000 to 13,000 for a backup tape with a density of 6250 bpi. For 3480 devices, specify a block size between 16,000 and 24,000.

 

2)  Initialize and Restore the Librarian Master file on the z/OS system:

//********************************************************************
//*      THIS JOB WILL RESTORE ALL MEMBERS ON A TAPE BACKUP          *
//*      FILE TO A NEW MASTER FILE.                            *
//********************************************************************
//INITMAST EXEC PGM=AFOLIBR,PARM='NRJS,NJTA'    
//MASTER   DD  DSN=zOS.LIBRAIAN.MASTER.FILE,
//        DISP=(,CATLG,DELETE),  
//        DCB=(DSORG=DA,BLKSIZE=nnnn),
//        SPACE=(CYL,nnn),
//        UNIT=unit,VOL=SER=zosvolser  
//SYSPRINT DD SYSOUT=*                                     
//INDEX    DD SYSOUT=*                                     
//OSJOB    DD DUMMY                                        
//SYSIN   DD *                                             
-OPT INIT,DISK                                
-END                                                       
/*                                                         
//RESTORE  EXEC PGM=AFOLIBR,PARM='NRJS,NJTA'                
//SYSPRINT DD  SYSOUT=*                                              
//LIST     DD  SYSOUT=*                                    
//INDEX    DD  SYSOUT=*            
//OSJOB    DD  DUMMY                              
//MASTER DD DISP=SHR,DSN=zOS.LIBRAIAN.MASTER.FILE          
//BACKUP   DD DSN=LIBR.BACKUP.TAPE,                          
//         DISP=(OLD,KEEP),                                  
//         VOL=SER=volser                                     
//SYSIN    DD *                                            
-OPT RESTORE,INDEX                                                    
-END                                                                  
/*                                                                    

 

Note1:   DSORG=DA Master files should not be put under SMS control

Note2:   If the backup file spans tapes, the JCL must reflect both volumes if the data set is not cataloged.
            //    VOL=SER=(volser1,volser2)

 

Option 2 - Shared DASD Disk-to-Disk Copy

If DASD is shared between the z/VSE and z/OS system, the BKUPDISK utility can be used. 

If the VSE Master file is a VSAM file, need to back it up to a DA file so it can be read on the z/OS system.

1)  Verify that the ACCMETH parm in the LIBGEN is set to (BDAM,VSAM):

// JOB
// LIBDEF *,SEARCH=lib.sublib,CATALOG=lib.sublib
// OPTION CATAL
// EXEC ASSEMBLY
   LIBGEN  ACCMETH=(BDAM,VSAM),....
     END
/*
// EXEC LNKEDT

 

 

2)  Copy the Master file from the VSE volume to the Shared DASD volume by running the following job on the z/VSE system:

// OPTION LOG    
// LIBDEF PHASE,SEARCH=lib.sublib
// ASSGN SYS008,UA          ASSIGN FOR JOBSTR
/*   this is the input Master file
// DLBL IJSYSUC,'USER.CATALOG',,VSAM  
// ASSGN SYS004,247  
// DLBL MASTER,'VSE.LIBR.MASTER',,VSAM,CAT=IJSYSUC
// EXTENT SYS004,volser
/*   this is the output Master file on a volume shared with z/OS    
// ASSGN SYS010,DISK,VOL=volser,SHR      
// DLBL BACKUP,'VSE.BACKUP.MASTER',,DA
// EXTENT SYS010,volser,1,0,sssss,llllll
// EXEC LIBRPROG,SIZE=512K  
-OPT BKUPDISK,INDEX,BLKSIZE=2048  
/*          
/&          

 

3)  Copy the Master file to the z/OS system by running the following job on the z/OS system to copy the Master file from the Shared volume to a z/OS DASD volume:

 
//LIBRBKUP EXEC PGM=AFOLIBR,PARM='NRJS,NJTA'
//* this is the input Master file from VSE
//MASTER DD DISP=SHR,DSN=VSE.BACKUP.MASTER
//* this is the output Master file
//BACKUP DD UNIT=DISK,DSN=zOS.LIBRAIAN.MASTER.FILE,
// SPACE=(CYL,nnn),DISP=(,CATLG),
// VOL=SER=zosvolser
//SYSPRINT DD SYSOUT=*
//INDEX DD SYSOUT=*
//LIST DD SYSOUT=*
//OSJOB DD DUMMY
//SYSIN DD *
-OPT BKUPDISK,INDEX
-END
/*
//