Skip to Content

Using the RUVZCJC utility

RPCV currently requires you to assemble an ISIOPT and a VSAM DSN selection and ISIJCT. The ISIOPT is loaded into the common storage area (CSA) and used to provide a fast path reject of RPCV interest in a VSAM file. The ISIJCT is loaded into the address space when a VSAM file is opened. The ISIJCT provides job/step/program filters by DSN as well as journaling needs (before-images and/or after-images) and journal allocation specifications. The manual process is cumbersome and error prone.

RUVZCJC is a ISIJCT/ISIOPT migration utility that provides templates and models for converting your existing ISIJCT load module to RUV rule sets. RUVZCJC provides approximately 80 percent of your rule sets from the information in their existing ISIJCT load module.

Warning

Note

Because of fundamental differences between the way that RPCV and RUV view journaling (one journal per VSAM cluster and one journal per JOB step, respectively), RUVZCJC cannot provide 100 percent of the information you need for RUV from the information in the ISIJCT alone. After the migration is complete, the resulting rule set may require modification for accurate results.

The following figure shows sample JCL for executing RUVZCJC. The source for this sample is located in member CONVJCT of the RUV.CNTL library. The ISIJCT load module is located in the SYSLIB DD statement. The new RUV rule set is placed in the CARDS DD statement.

//   . . . jobcard . . .
//*
//CONVJCT  EXEC PGM=RUVZCJC
//STEPLIB  DD DISP=SHR,DSN=yourname.LOAD <== RUV loadlib
//SYSLIB   DD DISP=SHR,DSN=your.RPCV.load <== Loadlib with ISIJCT
//CARDS    DD DSN=your.output.ruleset.name,<== New Rule Set
//            SPACE=(TRK,(5,5),RLSE),
//            DISP=(NEW,CATLG),
//            UNIT=SYSDA
//SYSUT1   DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSUT2   DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSUT3   DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSUT4   DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSUT5   DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
ISIJCT
/*

Executing RUVZCJC

To use RUVZCJC, perform the following steps:

  1. Review the JCL to verify that the UNIT parameters match your system requirements.
  2. Modify the JOB statement to meet your system requirements.
  3. Point the STEPLIB DD to the load library where you installed RUV.
  4. Point the SYSLIB DD to the load library where your current ISIJCT load module is located.

  5. Modify the PARM statement to include PARM='!LMOD=ISIJCT', or specify the SYSIN DD statement as

    //SYSIN DD *
    ISIJCT
    /*

  6. Point the CARDS DD statement to a data set that is defined with RECFM=FB and LRECL=80.
    The data set is either a PDS member

    //CARDS DD DISP=SHR,DSN=<yourname>(RUVCARDS)

    or a sequential data set

    //CARDS DD DISP=SHR,DSN=<yourname>.<sequential>.<dataset>
  7. Submit the job to convert the existing CICS journal definitions to the new RUV rule set format.
  8. Review the CARDS output, and modify the rule set to meet your site standards.
  9. Check and complete building the entire rule set.
  10. Activate the rule set as described in Activating-a-rule-set.
  11. You can use the journals created by RPCV in RUV if you use the ARCHIVE RPCV_IN command to convert them to a format that RUV can use. For more information, see Archiving-RPCV-journals.


 

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

BMC AMI Recovery for VSAM master