Restart process using the Restart Swap utility


Perform the following steps to complete the restart processing using the Restart Swap utility:

Note

The Restart Swap Utility is not a complete functional replacement to the manual steps previously outlined. At this time, the Restart Swap Utility does not perform the Image Copy process after REORG, nor does it AUTHORIZE and START the database. These additional steps should be executed after the completion of the Restart Swap utility. These steps equate to the last three steps outlined in the manual post-processing tasks, previously outlined in this section.

To restart processing using the Restart swap utility

  1. Execute FRFREST0. Specify the DBD name of the database being reorganized on the PARM parameter of the EXEC statement.If the database is a HALDB, the AMSOUT data set is a PDS, and selected partitions were specified. Specify the partition name provided in message BMC180221I following the DBD name, separated by a comma.
  2. Include the AMSOUT data set that was created during the reorganization job.
  3. Include the same IMS libraries (RECON, RESLIB, IMS, and so on) that were used in the reorganization job. If you made DBD changes, you must also specify the former IMS DBDLIB. If you do not, the restart step fails.
  4. Do not include any DD statements for the databases and image copy data sets.

    Warning

    The Online Reorg function and the Reorg function always require exclusive control during the data set name swapping process. If you attempt a multiple step JCL allocation, exclusive control is lost and the database becomes unavailable.

    The following figure shows sample JCL. This sample is also included in member RESTART of the sample library.

    Note

    If you are running restart for a job that included the GROUP subcommand, run only one restart job. You can include the name of any one of the databases from the GROUP subcommand for the PARM keyword, but only one restart job should be run. Restart automatically runs for all of the databases.

        //JOBCARD   JOB (acct),'RESTART POST',MSGCLASS=X,MSGLEVEL=(2,0),
    //          CLASS=A,NOTIFY=uid
    /*JOBPARM K=110
    //**********************************************************************
    //*            REORG FUNCTION RESTART SWAP UTILITY
    //*   - DOES THE IDCAMS ALTER(S) & DBRC NOTIFICATION
    //*     AND/OR THE IC/RESTORE THAT WAS NOT COMPLETED IN THE REORG
    //*
    //*   NOTE:  THE PREVIOUS REORG MUST HAVE BEEN IN THE POST-PROCESSING
    //*          PHASE FOR THIS STEP TO BE SUCCESSFUL.  IT ALSO MUST USE
    //*          THE AMSOUT DATASET CREATED IN THE REORG.
    //**********************************************************************
    //*
    //RESTART  EXEC PGM=FRFREST0,REGION=0M,
    //         PARM='DBDNAME[,partName]'
    //STEPLIB  DD  DISP=SHR,DSN=bmc.xxx.load
    //         DD  DISP=SHR,DSN=IMSVS.RESLIB
    //DFSRESLB DD  DISP=SHR,DSN=IMSVS.RESLIB
    //IMS      DD  DISP=SHR,DSN=IMSVS.DBDLIB
    //OLDIMS   DD  DISP=SHR,DSN-IMSVS.DBDOLD                 <===if DBD changes
    //PLUSIN   DD  *
     RESTART
    /*
    //AMSOUT   DD  DISP=SHR,DSN=your.restart.info.dataSet    <===required
    //BMCMSG   DD  SYSOUT=*
    //BMCPRINT DD  SYSOUT=*
    //BMCTRACE DD  SYSOUT=*
    //SYSOUT   DD  SYSOUT=*
    //SYSPRINT DD  SYSOUT=*
    //SYSUDUMP DD  SYSOUT=*
    //*

Related topic



 

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