Restartable snapshot utility jobs

When running restartable snapshot utility jobs, you should promptly restart jobs in restart pending status.

Related topic

Running-the-utility-job

XBM continues to cache preimages for targeted data while in restart pending status. XBM does not flush the preimages from cache until the job completes or is manually terminated. If the job waits in restart pending status for an extended period of time, the cache can fill and the job might not complete successfully.

Important

You must restart a restartable snapshot utility job on the XBM subsystem and LPAR upon which it failed. You cannot start it on another system.

If you decide that terminating the utility job is a better alternative to restarting it, use the same utility ID and the TERM parameter via the utility JCL. Doing so cleans up the utility ID for that run. This process also signals XBM to terminate all the active registered data sets in XBM for that utility run. If you do not use this process, XBM cannot re-register and process any 'restart pending' objects from the failed attempt in a new utility job run unless you manually terminate the objects.

If you terminate the utility job by any other process and must manually terminate the objects that have been left in restart pending status, perform one of the following actions:

  • Stop and restart all XBM subsystems that were involved in processing the objects.
  • Use the Term Snapshot option on the Snapshot data sets panel as shown in the figure Snapshot data set panel to terminate each data set object that remained in restart pending status.

Important

You cannot terminate snapshots if you are displaying a remote XBM subsystem. You must connect to the XBM subsystem locally to terminate snapshots through the XBM ISPF interface.

For more information about accessing the Snapshot data set panel, see Displaying-data-set-statistics-for-snapshot-utilities.

Snapshot data set panel

Select actions on the following data sets, then press enter.                   
 1=Zoom 2=Term Snapshot                                                         
 S   A  Data set name                                 RRate  CBlocks  Cmpl%     
 _      DBAHCAT.DSNDBD.KCT.T1.I0001.A001                  2        0  100 %     
 _      DBAHCAT.DSNDBD.RYCARU01.RYCARU01.I0001.A001       1        0  100 %     
 _      DBAHCAT.DSNDBD.RYCARU01.RYCARU01.I0001.A002       1        0  100 %     
 _      DBAHCAT.DSNDBD.RYCARU01.RYCARU01.I0001.A003       1        0  100 %     

 Command ===> ______________________________________________________________

Restartable jobs that fail might not be restartable due to an unrecoverable error. You can identify the data sets for these jobs by an exclamation point (!) in the Active column on the Data Set Statistics panel. To clear these jobs, you have three options:

  • Attempt to restart the job.
  • This action causes the job to fail and subsequently be cleaned up.
  • Terminate the job through XBM by using the TERM SNAPSHOT option.
  • Terminate the job by using the termination function of the utility.


 

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