Skip to Content
Information
Space announcement This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Registering new areas

The REGISTER subcommand registers with DBRC a new area that is inserted into the middle of an area list or appended to the end an area list.

  • If you are inserting the area into the middle of an area list, you must use the REGISTER subcommand to register the new area.
  • If you are appending the area to the end of an area list, you can use the REGISTER subcommand with the PREPARE command, or you can register the new areas with DBRC before executing the Prepare function.

The Restructure function issues INIT.DBDS and INIT.ADS commands to DBRC for new areas using the parameters provided on the REGISTER subcommand.

Warning

Note

Inserting an area into the middle of an area list changes the DSID of all of the subsequent areas in the list. The product records the DSID in IMS log records for recovery purposes. As a result, DBRC does not allow the DSID to be changed. The Restructure function automatically performs the following tasks for all areas that have changes to the DSID:

  • Saves registration information stored in DBRC
  • Issues a DELETE.DBDS command to DBRC
  • Reissues corrected INIT.DBDS and INIT.ADS commands to DBRC
  • Forces the areas to be restructured

The Prepare function writes the registration information to the Restructure Plan data set. The Restructure function reads the data set and performs the registration during post-processing. For examples of the REGISTER subcommand, see the following figures.

Specifying the REGISTER subcommand for one area

PREPARE DBD=dbdName,ACCESS=(ONLINE,imsid)                      
     PLAN DSNAME='yourname.PLAN.&DBD',DISP=(USE,CATLG)         
     REGISTER OAREA=areaName1,                                 
              ADDN=addName1,                                  
              ADSN='yourName1',                      
              GENMAX=4,REUSE=NO,ICJCL=member10,RECOVJCL=member11
     REGISTER OAREA=areaName2,                                 
              ADDN=addName2,                                  
              ADSN='yourName2',                      
              GENMAX=4,REUSE=NO, ICJCL=member10,RECOVJCL=member23

Specifying one REGISTER subcommand for multiple areas

PREPARE DBD=dbdName,ACCESS=(ONLINE,imsid)                      
     PLAN DSNAME='yourName.PLAN.&DBD',DISP=(USE,CATLG)         
     REGISTER OAREA=ALL,                                 
              ADSN='yourName.DB.&ADDN',                      
              ICJCL=member11,RECOVJCL=member33

For information about the subcommand syntax, seeFast Path/EP products reference documentation.

Related topic

Preparing-for-a-DEDB-restructure


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Fast Path Online Restructure/EP 4.0