USE OF AND ACCESS TO PRODUCTS AND FEATURES ARE IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE USERS SOFTWARE LICENSE. THE PRESENTATION OF MATERIAL HEREIN DOES NOT, IN ANY MANNER, MODIFY SUCH TERMS AND CONDITIONS.
The RERUNRB Option and the RESTART Command By James Damon
The RESTART command initiates recovery of a Model 204 system that may have been damaged by an abnormal termination such as a power failure or an operating system crash. This command is usually the only command in a single user run of Model 204 that is always executed prior to bringing up an Online. This way, a decision as to whether or not to run recovery is not required; recovery is always run prior to bringing up the Online. If recovery has no work to do, because the previous Online terminated normally and took a checkpoint (which is the case most of the time), the process is short and the messages shown in Figure 1 are issued:
Figure 1.
RESTART ROLL BACK ERROR CONTINUE ROLL FORWARDM204.0143: NO FILES CHANGED AFTER LAST CP, RESTART BYPASSED M204.0844: RECOVERY IS NOW COMPLETE
However, this article is not about running recovery on an ordinary day, but instead on the odd day that recovery is required.
Running Recovery
When recovery is required and completes successfully, you might see messages similar to those in Figure 2.
Figure 2.
M204.2512: ROLL BACK WILL USE THE FOLLOWING DATASET: RESTART M204.1523: EOF REACHED IN FIRST PASS OF RESTART STREAM AFTER SEQ# 2745 OF 07.135 16:43:27.22 M204.0145: THE FOLLOWING FILES CAN NOT BE RECOVERED: M204.0146: JUDGMNTS – MISSING M204.0148: THE FOLLOWING FILES WILL BE ROLLED BACK: M204.0149: LAWYERS M204.0149: CLIENTS M204.0157: ROLLED BACK TO TRANSACTION CHECKPOINT 07.135 16:42:54.41 M204.0158: END OF ROLLBACK M204.0843: CHECKPOINT COMPLETED ON 07.135 16:42:54.41 M204.2627: FAST RECOVERY: BEGINNING JOURNAL BLOCK 486 M204.1992: RECOVERY: PROCESSING ROLL FORWARD BLOCK# 486 07.135 16:42:54.30 M204.1846: MEMBER +2 OF GDG STREAM CCARF NOW ACTIVE CCAJRNL.G8282V00 M204.0118: EOF FOR CCARF STREAM AFTER SEQ# 2030 OF 07.135 16:43:27.29 M204.1200: ROLL FORWARD BACKED OUT TRANSACTION 2 FOR THE FOLLOWING FILES: M204.1214: CLIENTS M204.0844: RECOVERY IS NOW COMPLETE M204.0843: CHECKPOINT COMPLETED ON 07.135 17:02:08.40
In Figure 2, both roll back and roll forward recovery completed successfully, although the JUDGMNTS file was not recovered, because it was missing. Perhaps a DD card had been removed. The missing file could be recovered separately, in a subsequent recovery run using the same RESTART and CCARF datasets. However, none of the other files can be recovered again since they have already been recovered. An attempt to rerun recovery exactly as before would result in the messages shown in Figure 3.
Figure 3.
M204.2564: FILE LAWYERS ALREADY RECOVERED USING THIS RECOVERY DATA M204.2564: FILE CLIENTS ALREADY RECOVERED USING THIS RECOVERY DATA
Introducing RESTART RERUNRB
The RERUNRB option to the RESTART command can be used to recover all files, even the ones previously recovered, in a new recovery run using the same RESTART, CCARF and, if sub-transaction checkpoints were enabled, RESTARTS dataset and a new CHKPOINT dataset. The syntax of the RESTART command with the RERUNRB option is shown in Figure 4.
Figure 4.
RESTART RERUNRB or RESTART RERUNRB ROLL FORWARD
Making Recovery More Flexible
The RERUNRB option causes roll back recovery to be rerun even though some or all of the files participating have already been successfully recovered. The same recovery datasets used previously are required in the run using RERUNRB. With this option, it is now possible to completely rerun a previously successful recovery for reasons such as:
Limitations Associated with RERUNRB
The RERUNRB option works only if no updates, other than those being applied by recovery, have been made to the files involved. In other words, if any new updates are made to a file before recovery completes successfully, the messages shown in Figure 5 are issued.
Figure 5.
M204.0145: THE FOLLOWING FILES CAN NOT BE RECOVERED: M204.0146: HISTORY - ROLL BACK INFORMATION IS OBSOLETE M204.2565: HISTORY=07.137 18:29:25.73, RESTART=07.137 18:20:58.12
These messages indicate that the date/time stamp of the last recorded update in file HISTORY is later in time than the last recorded update to that file in the RESTART dataset. Therefore, the file has been updated following the Online failure and before recovery has completed successfully. This file will not participate in recovery. Also, if sub-transaction checkpoints were enabled in the run being recovered, RERUNRB can only be used after a successful recovery run. Otherwise, the message shown in Figure 6 is issued:
Figure 6.
M204.2737: ROLLBACK/ROLLFORWARD MUST BE RUN PRIOR TO RERUNRB – RESTART CANCELLED
In Summary
The requirement to use RERUNRB should be rare. However, if you find that recovery needs to be rerun for any reason following a previously successful recovery, and you have not yet brought up the next updating job, RERUNRB can be used to provide that capability.
Copyright © 2008 Computer Corporation of America. All right reserved. Published in the United States of America.