This topic describes how to use CICSVR to recover your VSAM data. For more information, see the IBM® CICS VSAM Recovery MVS/ESA User’s Guide and Reference.
The panels and secondary windows shown here are in the sequence that they appear for a CICSVR run if you accept the CICSVR default values:
For information about other CICSVR functions, see the IBM CICS VSAM Recovery MVS/ESA User’s Guide and Reference, and the IBM CICS VSAM Recovery MVS/ESA Implementation Guide.
When you start CICSVR, the main menu appears. If this is the first time you have run CICSVR, select option 5 to customize the JCL skeleton.
To begin recovery, select option 1 and press Enter.
Help ----------------------------------------------------------------------------- CICSVR main menu Select one and press Enter. __ 1. List of VSAM spheres 2. List of archived logs 3. List of copied log streams 4. List of registered log of logs 5. JCL skeleton (C) Copyright IBM Corp. 1987, 1996. All rights reserved. Command ===> __________________________________________________________________ F1=Help F3=Exit F10=Menu bar F12=Cancel
From the panel in Figure 17 you can choose from these objects:
To continue the recovery:
When the action is completed, the letter S appears in the select column beside each selected sphere on the CICSVR VSAM sphere list panel:
Administrate Utilities Tools List View Help ------------------------------------------------------------------------------ CICSVR VSAM sphere list Row 1 to 12 of 33 Select one or more VSAM spheres, then select an action. Last time RLS RR S VSAM sphere referenced flag on _ CICS10.ACCOUNT1.BASE 96.159 12:34.56 Yes _ CICS10.ACCOUNT2.BASE 96.159 12:43.56 Yes _ CICS10.ACCOUNT3.BASE 96.159 12:34.56 Yes _ PAYROLL.PROD1.BASE 96.159 12:34.56 No _ PAYROLL.PROD2.BASE 96.159 12:34.56 No _ PAYROLL.PROD3.BASE 96.159 12:34.56 No _ CICS10.PROD1.BASE 96.159 12:34.56 No _ CICS10.PROD2.BASE 96.159 12:34.56 No _ CICS10.PROD3.BNSE 96.159 12:34.56 No _ CICS10.PROD4.BASE 96.159 12:34.56 No _ CICS10.PROD5.BASE 96.159 12:34.56 No _ TEST.STMERRY.RLS 96.159 12:34.56 Yes Command ===> __________________________________________________________________ F1=Help F3=Exit F4=CompRec F5=FwdRec F6=Backout F7=Bkwd F8=Fwd F10=Menu bar F11=Dereg F12=Cancel
From the CICSVR VSAM sphere list panel, you can select an action by using one of the shortcut function keys, or select one of these pull-downs from the menu bar:
Figure 19 shows a section of the CICSVR VSAM sphere list panel with the "Utilities" pull-down:
Administrate Utilities Tools List View Help ----------------+----------------------------------+--------------------------- | 1 1. Complete recovery... F4 | Row 1 to 12 of 33 | 2. Forward recovery only...F5 | Select one or mo| 3. Backout only... F6 | ion +----------------------------------+ Last time RLS RR S VSAM sphere referenced flag on _ CICS10.ACCOUNT1.BASE 96.159 12:34.56 Yes _ CICS10.ACCOUNT2.BASE 96.159 12:43.56 Yes _ CICS10.ACCOUNT3.BASE 96.159 12:34.56 Yes _ PAYROLL.PROD1.BASE 96.159 12:34.56 No _ PAYROLL.PROD2.BASE 96.159 12:34.56 No _ PAYROLL.PROD3.BASE 96.159 12:34.56 No _ CICS10.PROD1.BASE 96.159 12:34.56 No _ CICS10.PROD2.BASE 96.159 12:34.56 No _ CICS10.PROD3.BNSE 96.159 12:34.56 No _ CICS10.PROD4.BASE 96.159 12:34.56 No _ CICS10.PROD5.BASE 96.159 12:34.56 No _ TEST.STMERRY.RLS 96.159 12:34.56 Yes Command ===> __________________________________________________________________ F1=Help F3=Exit F4=CompRec F5=FwdRec F6=Backout F7=Bkwd F8=Fwd F10=Menu bar F11=Dereg F12=Cancel
From this pull-down, you can select "Complete recovery" for the VSAM spheres that you selected by using one of these methods:
To get information about an item in the pull-down menu, move the cursor to the item and press the Help key (F1).
If you have the log of logs registered in the RCDS, CICSVR scans the logs and presents the results as an ISPF browse of the DWWMSG and DWWPRINT data sets. For an example of these reports, see Report of log of logs scan.
When you have selected "Complete recovery" from the Utilities pull-down, and if you are using DFSMShsm, you get the secondary window shown in Figure 20:
CICSVR VSAM sphere parameters Press F4 when the cursor is in the Backup time field to get a list of backup times from DFSMShsm. Press Enter to continue. VSAM sphere . . . . . . : CICS10.ACCOUNT1.BASE New VSAM sphere name . . ____________________________________________ Forward-recovery start time . . ___________ (YY.DDD HH:MM:SS) Forward-recovery stop time . . ___________ (YY.DDD HH:MM:SS) Backup time . . . . . . . . . . . . . . ___________ (YY.DDD HH:MM:SS) Time format Backup type __ 1. Local __ 1. None 2. GMT 2. Logical 3. Full volume dump Volume for restore ______ Unit for restore . . . . . ________ Command ===> __________________________________________________________________ F1=Help F4=Prompt F5=GetDef F6=SaveDef F7=prevVSAM F12=Cancel
Here you can specify VSAM sphere parameters for inclusion in the recovery run. These parameters are:
When you first see this secondary window, the CICSVR default values are displayed. Press:
While CICSVR is constructing the recovery job, the wait secondary window shown in Figure 21 appears.
During a recovery run, CICSVR restores the VSAM sphere from a DFSMShsm backup, if one exists for the VSAM sphere that you are recovering. The latest DFSMShsm backup will appear as the default in the VSAM sphere parameters secondary window. If you provide a new VSAM sphere name in this secondary window, the recovered data set will have this name.
If you are using a DFSMShsm full volume dump, these dumps do not appear in the backup list. Enter 3 in the Backup time field, and enter the date of the full volume dump for the recovery in the backup time field in the VSAM sphere parameters secondary window. If a new VSAM sphere name appears in the secondary window, the recovered data set will have this name.
For more information about using DFSMShsm with CICSVR, see the CICSVR Implementation Guide.
While CICSVR is constructing the recovery job, the secondary window shown in Figure 21 appears:
CICSVR wait CICSVR is constructing your recovery job. This might take a few minutes.
If CICSVR detects errors while constructing the recovery job, the CICSVR recovery job error list (Figure 22) appears.
Use this secondary window to list errors found during the construction of the recovery job.
CICSVR recovery job error list Row 1 to 3 of 3 Select one or more errors, then press Enter to get more information about the error. S Error Data set _ Overlapping recover CICS10.ACCOUNT1.BASE _ Unknown ddname LOG01.CICS10.D96159.T203000 _ Log sequence error LOG05.CICS10.D96159.T224559 ****************************BOTTOM OF DATA************************** Command ===> __________________________________________________________________ F1=Help F7=Bkwd F8=Fwd F12=Cancel
Select an error to get a secondary window that contains a detailed description of the error.
For general help information, press the Help key (F1).
When you have selected Complete recovery from the Utilities pull-down, if you have QSAM copies of MVS log streams, you get this secondary window:
CICSVR log stream type Specify log stream type. Press Enter to continue the job creation. Log stream type . . __ 1. MVS logger log stream 2. QSAM copy Command ===> ___________________________________________________________ F1=Help F5=GetDef F6=SaveDef F12=Cancel
Use this secondary window to specify the type of MVS log stream for this recovery job.
When you first see this secondary window, the CICSVR default values are displayed. Press F5 to get the default values from the recovery control data set (RCDS). Press F6 to save the currently displayed values, and display the default update verification secondary window (Figure 27).
For detailed help information about a particular field, move the cursor to the field and press the Help key (F1).
Figure 24 shows the secondary window that appears if you press the Prompt key (F4) on a CICSVR VSAM sphere parameters panel for a sphere you selected for recovery:
CICSVR backup prompt list Row 1 to 4 of 4 Select one backup time, then press Enter. VSAM sphere . . . : PAYROLL.BASE ------------------ DFSMShsm backup information --------------------- Backup Gen Ver BWO RLS Recovery point S Date Time no. no. Date Time Type _ 96.159 14:56:09 00 006 YES NO 96.159 14:51:10 GMT _ 96.158 14:55:32 01 005 YES YES 96.158 14:51:47 LOCAL _ 96.157 14:56:09 02 004 YES YES 96.157 14:50:43 GMT _ 96.158 14:36:09 03 005 NO NO LOCAL ****************************BOTTOM OF DATA************************** Command ===> _____________________________________________________________ F1=Help F7=Bkwd F8=Fwd F12=Cancel
This secondary window appears once for every VSAM sphere that you select, and shows a list of DFSMShsm backups for that sphere. Select the backup that you need from this list.
For general help information, press the Help key (F1).
When you select one or more CICSVR parameters to change, the secondary windows for these parameters appear in the order in which the parameters appear in the list.
After you press Enter in the secondary window (Figure 20), you can enter the CICSVR recovery parameters here:
CICSVR complete recovery Press Enter to create a job with default values. Or, select one or more choices below, and press Enter to override current values. S Recovery and backout parameters related to: _ Sequence checking _ VSAM buffer pools _ CICSVR exits Command ===> __________________________________________________________________ F1=Help F12=Cancel
From this secondary window (Figure 25), you can create a recovery job for the VSAM sphere you selected. You can accept the CICSVR default values, or change the forward recovery parameters before continuing the recovery.
When you select "Complete recovery" from the Utilities pull-down, you can define these recovery parameters for your run:
For detailed help information about any of these choices, move the cursor to the field and press the Help key (F1).
Use the secondary window shown in Figure 26 to set sequence checking parameters for your CICSVR run:
CICSVR sequence checking Specify sequence checking parameters. Press Enter to use the displayed values in the recovery. LOG DATA SETS ! LOG RECORDS Gap in sequence 1 1. STOP ! Gap in sequence 1 1.STOP 2. WARNING ! 2.WARNING 3. IGNORE ! 3.IGNORE ! Out of sequence 1 1. STOP ! Out of sequence 1 1.STOP 2. WARNING ! 2.WARNING 3. IGNORE ! 3.IGNORE ! Reset sequence 1 1. STOP ! Reset sequence 1 1.STOP 2. WARNING ! 2.WARNING 3. IGNORE ! 3.IGNORE Command ===> __________________________________________________________________ F1=Help F5=GetDef F6=SaveDef F12=Cancel
When you first see this secondary window, the CICSVR default values are displayed. Press F5 to get the default values from the recovery control data set (RCDS). Press F6 to save the currently displayed values, and display the default update verification secondary window (Figure 27).
For detailed help information about a particular field, move the cursor to the field and press the Help key (F1).
Use this secondary window to confirm an update to the CICSVR command default values:
CICSVR default update verification Press Enter to update stored defaults, or press F12 to cancel the request. Command ===> __________________________________________________________________ F1=Help F12=Cancel
For help information press the Help key (F1).
Use this secondary window to tune your CICSVR run by changing the number of VSAM buffers:
CICSVR VSAM buffer pools Row 1 to 11 of 11 Specify the number of buffers needed for each buffer pool. Press Enter to use the displayed values in the recovery. Number of buffers Pool size ________ B512 ________ B1K ________ B2K ________ B4K ________ B8K ________ B12K ________ B16K ________ B20K ________ B24K ________ B28K ________ B32K ***************************** BOTTOM OF DATA ****************************** Command ===> __________________________________________________________________ F1=Help F5=Getdef F6=SaveDef F12=Cancel
When you first see this secondary window, the CICSVR default values are displayed. Press F5 to get the default values from the RCDS. Press F6 to save the currently displayed values, and display the default update verification secondary window (Figure 27).
For detailed help information about a particular field, move the cursor to the field and press the Help key (F1).
Use this secondary window to define which CICSVR exits to use in this CICSVR run:
CICSVR exits Specify member names for the CICSVR exits. Press Enter to use the displayed member names in the recovery. Preapply . . . ________ Error . . . . . ________ ESDS delete . . ________ Termination . . ________ Command ===> __________________________________________________________________ F1=Help F5=Getdef F6=SaveDef F12=Cancel
When you first see this secondary window, the CICSVR default values are displayed. Press F5 to get the default values from the RCDS. Press F6 to save the currently displayed values, and display the default update verification secondary window (Figure 27).
For detailed help information about a particular field, move the cursor to the field and press the Help key (F1).
When you have entered the CICSVR parameters that you need, press Enter to get the job submission secondary window (Figure 30). Use this secondary window to submit the job, or browse, or edit, if required. Select option 4 to save the JCL that CICSVR generated for you. Select option 5 to return to the V
CICSVR job submission Select one and press Enter. __ 1. Submit the job 2. Browse the job 3. Edit the job 4. Save generated JCL 5. Return to VSAM sphere list Command ===> __________________________________________________________________ F1=Help F12=Cancel
SAM sphere list:
For detailed help information about any of these options, move the cursor to the option description and press the Help key (F1).
This secondary window appears if you selected option 4 from the CICSVR job submission secondary window (Figure 30):
CICSVR save JCL Type a member name for the CICSVR generated JCL. Press Enter to save the generated JCL as this member name. Member name . . ________ Command ===> __________________________________________________________ F1=Help F12=Cancel
Here you can give a member name for the saved CICSVR JCL. The member will be saved in the data set you allocated to the ddname ISPFILE.
[[ Contents Previous Page | Next Page Index ]]