CONVERT example: Converting a database when the IMS management of ACBs is enabled

This example shows JCL statements to convert a database in an IMS managed ACBs environment.

Figure 1. Sample JCL stream to convert a database in an IMS managed ACBs environment
//S2     EXEC PGM=IHCHALDB,DYNAMNBR=999,REGION=80M                             
//STEPLIB  DD DISP=SHR,DSN=IMSTOOLS.SIHCLOAD <=== hcma loadlib
//         DD DISP=SHR,DSN=IMSTOOLS.SHPSLMD0 <=== ims tools loadlib
//         DD DISP=SHR,DSN=IMSTOOLS.SGLXLOAD <=== ims tools base loadlib
//         DD DISP=SHR,DSN=IMS.SDFSRESL      <=== ims reslib                   
//         DD DISP=SHR,DSN=IMS.MDALIB        <=== ims mdalib
//DFSRESLB DD DISP=SHR,DSN=IMS.SDFSRESL      <=== ims reslib                   
//PROCLIB  DD DISP=SHR,DSN=IMS.PROCLIB       <=== ims proclib
//MACLIB   DD DISP=SHR,DSN=IMS.SDFSMAC       <=== ims maclib                   
//SYSPRINT DD SYSOUT=*                                                         
//MSGPRINT DD SYSOUT=*                                                         
//DBDPRINT DD SYSOUT=*                                                         
//LNKPRINT DD SYSOUT=*                                                         
//AMSPRINT DD SYSOUT=*                                                         
//SYSUDUMP DD SYSOUT=*                                                         
//IHCLIST  DD SYSOUT=*                                                         
//IHCSYSIN DD *                                                                
  CONVERT  ONLINE(N) -                                                         
           PARTNUM(2) -                                                        
           DBDPATT(*****...) DSNPREF(DBSMS.DB) -                               
           DBD(xxxx) -                                                         
           ICMID(3) -                                                          
           ICHLQ(DBSMS.DB.IC) -                                                
           ICTRLR(2) -                                                         
           IC.COMP(Y) -                                                        
           IC.COMPRTN(FABJCMP2) -    
           PTRCHECK(Y) -
           DFSDF(CAT)
  • The DFSDF(CAT) parameter in IHCSYSIN and the PROCLIB DD statement specify the DFSDFCAT PROCLIB member that contains the IMS catalog definition.
  • If you include the IMS Catalog Definition exit routine (DFS3CDX0) in the STEPLIB concatenation, you do not need to specify the DFSDF parameter and the PROCLIB DD statement.
  • The SGLXLOAD library of IBM® IMS Tools Base must be in the STEPLIB concatenation.
  • The library containing the DFSMDA member with TYPE=CATDSHLQ statement must be in the STEPLIB concatenation if the DFSMDA member is used to specify the high-level qualifier of the IMS catalog system data sets.
  • The IMS DD statement is not needed.