Using the installation verification procedure

When you have installed RUV and have performed post-installation tasks, and RUV is ready to use, consider performing the installation verification procedure (IVP) given in the following table:

Note

Perform the IVP only when all required installation and implementation steps have been completed.

Tip

If your site coded ISP control data sets (ISPCTL.xx) in the TSO logon procedure, use RUVISPFZ to launch the RUV online interface.

Step	Member	Task	Result
1	IVP$CHGS	Edit and modify the part of IVP$CHGS that is indicated in the listing, and save it. Warning Note To view user variable changes that are required for IVP$CHGS, see the figure after this table. IVP$CHGS is an EDIT macro that is invoked by the IVP$EDIT REXX EXEC which modifies IVP members in the CNTL library for the IVP jobs. The top half contains several ISPF CHANGE variables that you must modify to reflect your environment and site requirements.	IVP$CHGS is ready for step 2.
2	IVP$EDIT	Enter the following TSO command: TSO EX 'yourname.CNTL(IVP$EDIT) Warning Note After performing steps 1 and 2, you do not have to modify the remaining members; just submit them. Members IVP$JB04 (step 6), IVP$JB13 (step 15), and IVP$JB15 (step 17) are text members that contain instructions for more steps. Member IVP$EDIT invokes all required JCL changes, except for those noted. The remaining executable members must be submitted in order.	The remaining IVP members are modified.
3	IVP$JB01	Submit the member for processing.	BMCP and BCSS procedures are copied to your PROCLIB.
4	IVP$JB02	Submit the member for processing. Warning Note Before performing steps 5 and 6, see Setting-up-security.	IVP REGISET and REGISET2 files for the subsystem repository are defined. (ssid=RUV$)
5	IVP$JB03	Submit the member for processing.	VSAM files and sequential files for copies of VSAM files are defined.
6	IVP$JB04	Read the IVP$JB04 text, and follow the instructions.	The IVP$JB04 text instructs users how to start BMCP and BCSS subsystems for the IVP. The REINIT command is executed from the COMMANDS data set.
7	IVP$JB05	Submit the member for processing.	A rule set is created and is added to the RUV repository.
8	IVP$JB06	Submit the member for processing. Record the "Registration Time" of the VSAM file KSDS01, which may be obtained from the JES listing for this job or from the ISPF interface by using selection 5. Warning Note You will use this time in step 17.	RUV performs a backup of VSAM files (backup # 1).
9	IVP$JB07	Submit the member for processing.	RUV performs batch journaling # 1.
10	IVP$JB08	Submit the member for processing.	RUV performs VSAM file backup # 2.
11	IVP$JB09	Submit the member for processing.	RUV performs batch journaling # 2.
12	IVP$JB10	Submit the member for processing.	RUV performs batch journaling # 3. Step JNLSTEP4 forces an S0C4 abend, so a recovery job will be created and saved as member IVP$JB11. This recovery job will back out only the changes that are made in JNLSTEP4, but not the previous steps.
13	IVP$JB11	Review this jobstream. Submit the member to back out the changes that have been made in the abended step of the previous job.	IVP$JB11 is created when IVP$JB10 runs and abends.
14	IVP$JB12	Submit the member for processing.	RUV provides an output report for the following commands: REPORT ARCHIVE_FILE REPORT BACKUP_FILE REPORT VSAM_FILE REPORT RULE_SET
15	IVP$JB13	Invoke the RUV ISPF interface. Exercise the following options: Browse options 2, 4, and 5 to view the items that were registered during the previous IVP jobs. Select option 1 to perform a VSAM forward recovery. After recovery, compare the resulting reports with the printout of the file.	The RUV ISPF interface is invoked. These options result in job JCL that is generated for forward recovery. Warning Note For more information about these options, see member IVP$JB13 in the sample library HLQ.CNTL.
16	IVP$JB14	(Optional) Change the SET parameter to INACTIVE status in the repository records for backup # 2 (the three KSDS VSAM files). Warning Note This change is required if you ship a set of backup tapes offsite. Submit the member for processing.	RUV recoveries do not select these backups as being available for use.
17	IVP$JB15	Invoke the RUV ISPF interface. Exercise the following options: Select option 1 to generate backout recovery JCL. Select option 2 to perform a VSAM backout recovery. Type the registration time that was recorded in step 8 as the start time. After recovery, compare the resulting reports with the printout of the file.	The RUV ISPF interface is invoked. These options result in a backout of all updates that have been made to the VSAM files in this set of IVP jobs. The files should have all the original data records. Warning Note For more information about these options, see member IVP$JB15 in the sample library HLQ.CNTL.
18	IVP$JB16	Submit the member for processing.	RUV executes miscellaneous repository commands.
19	IVP$JB99	(Optional) Submit the member for processing.	IVP DASD data sets are deleted.

The IVP is a set of jobs with manual steps to guide you through several production scenarios. The IVP ensures a successful installation and introduces RUV features.

Complete the steps in the preceding table in order. All members are in the CNTL library that was installed from the RUV product distribution tape.

Note

For resolutions to common installation and configuration issues, see Resolutions-for-common-installation-and-configuration-issues.

The following figure shows user variable changes that are required for IVP$CHGS:

     /*-----------------------------------------------------------*/
     /*   * * * * * Change variables after this point * * * * *   */
     /*   * * * * * Change variables after this point * * * * *   */
     /*   * * * * * Change variables after this point * * * * *   */
     /*-----------------------------------------------------------*/
     /*--------------------------------*/
     /* JES job card related.          */
     /*--------------------------------*/
     'ISREDIT change "<acct>"       "nnnn"                 ALL'
     'ISREDIT change "<ssid>"       "RUV$"                 ALL'
     'ISREDIT change "<jobnm6>"     "RUVivp"               ALL'
     'ISREDIT change "<msgclass>"   "X"                    ALL'
     'ISREDIT change "<jobclass>"   "A"                    ALL'
     /*--------------------------------*/
     /* JES DD statement related.      */
     /* Max of 22 chars on IVPHLQ.     */
     /*--------------------------------*/
     'ISREDIT change "<sysout>"     "*"                    ALL'
     'ISREDIT change "<RUVhlq>"     "yourname"             ALL'
     'ISREDIT change "<ivphlq>"     "yourivp.name"         ALL'
     'ISREDIT change "<ivpvol>"     "vol001"               ALL'
     /*--------------------------------*/
     /* Regiset/REGISET2 DASD volumes,   */
     /* ** Can NOT be the same !! **   */
     /*--------------------------------*/
     'ISREDIT change "<regisetvol>" "ivp001"               ALL'
     'ISREDIT change "<regiset2vol>" "ivp002"             ALL'
     /*--------------------------------*/
     /* Miscellaneous items.           */
     /*--------------------------------*/
     'ISREDIT change "<proclib>"    "your.proclib.dsn"     ALL'
     /*------------------------------------------------------------*/
     /*   * * * * * Change variables before this point * * * * *   */
     /*   * * * * * Change variables before this point * * * * *   */
     /*   * * * * * Change variables before this point * * * * *   */
     /*------------------------------------------------------------*/

This section contains the following topics:

Using the installation verification procedure

BMC AMI Recovery for VSAM 4.1

On this page