Restoring or changing the size of the Registry

While working with TOM, you might find that the size of the Registry is not sufficient, or, you might need to restore the Registry by using a previous backup. For different methods of backing up the TOM Registry, see Backing up the Registry.

You can restore the TOM Registry and change the size of the Registry by using one of these methods:

Related topic

TOM-Registry

Using an Automated or On-Demand Registry backup 

To restore your TOM Registry by using either an Automated Registry backup or an On-Demand Registry backup, perform the following steps: 

  1. Determine the name of the backup data set that you want to use for restoring the TOM Registry. 
  2. Stop all TOM PASs in the TOMPLEX that are using the Registry. 

  3. Delete and re-allocate the Registry VLDS by using the TOMALLOC BBSAMP member. If you are enlarging the Registry, be sure to specify a larger space parameter value.

    Important

    Alternatively, to allocate a new Registry under a new name without deleting the existing TOM Registry, just allocate the new Registry VLDS with a new name and specify the new name in the MAMPLXxx BBPARM REGISTRY_DSN= parameter. 

  4. Edit your TOM PAS JCL and specify the backup data set to be used to restore to a new DD name, such as REGDUMP. 
  5. Edit your MAMINIxx BBARM parmlib member and add the PRIMEDD=ddname statement, where ddname is the name of the DD added to your TOM PAS JCL specifying the backup data set. 
  6. Start one of the TOM PASs so that TOM reloads the newly allocated Registry with the records from the backup. See an example of the messages that appear when TOM restores the Registry:
MAMRY1002I New Registry has been initialized
RY1040I Records loaded:     5000
RY1040I Records loaded:    10000
RY1040I Records loaded:    15000
RY1040I Records loaded:    20000
RY1040I Records loaded:    25000
RY1040I Records loaded:    30000
RY1041I Registry primer upload completed
RY1040I Records loaded:    31358

Important

After restoring the Registry, immediately edit your TOM PAS JCL and remove the DD added pointing to the Registry backup, edit your MAMINIxx BBPARM member, and remove the PRIMEDD= parameter. If you leave these in place and restart TOM, TOM tries to restore the Registry again. 

Using the Registry export utility

If you used the Registry export utility to make a backup of one or more Definition Bases, you can use the EXECs created to restore your TOM Registry.

Important

Using this method restores only those Definition Bases that were exported by the utility. If you need to restore other Definition Bases that are not included in the EXEC, do not use this method. 

To restore the TOM Registry by using the EXEC created by the Registry export utility, perform the following steps:

  1. Locate and edit the REXX EXEC created by the Registry export utility and set the correct parameter, default.TOM or default.TOMID. 
  2. Stop all TOM PASs in the TOMPLEX that are using the Registry. 

  3. Delete and re-allocate the Registry VLDS by using the TOMALLOC BBSAMP member. If you are enlarging the Registry, be sure to specify a larger space parameter.

    Important

    Alternatively, to allocate a new Registry under a new name without deleting the existing TOM Registry, just allocate the new Registry VLDS with a new name and specify the new name in the MAMPLXxx BBPARM REGISTRY_DSN= parameter. 

  4. Start one TOM PAS with the newly allocated Registry. 
  5. Run the EXEC created by the Registry export utility to redefine the necessary Definition Bases. Verify the EXEC completes with no errors. 
  6. Start the remaining TOM PASs in the TOMPLEX. 

 

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