Submitting a job JCL record with the ISPF interface


To use the ISPF interface to submit a job JCL record, perform the following steps:

  1. Access the ISPF interface as described in Using the RUV ISPF interface.
    RUV displays the RUV Options panel.
  2. Select option 10 (External Backup / Restore JCL Generation).
    RUV displays the VSAM Sphere External Backup / Restore panel as shown in the following figure. Use this panel to specify the required information for submitting the external backup or restore job JCL for variable substitution, JCL generation, and execution.

      File  View  Tools  Help
    ------------------------------------------------------------------------------
    RUVUA00              BMC AMI Recovery for VSAM
    Command ===>

                      VSAM Sphere External Backup / Restore        2020.327 16:35

    System level rule set  . . . $EXCLUDE_ALL
    Job level rule set . . . . .

    Select VSAM files or groups to use.        (Required)
    VSAM file mask . . . . . . .
    VSAM group mask . . . . . .
    Preselect all files or
    groups . . . . . . . . . . .

    Select the JOB_JCL you wish to work with.  (Required)
    Job JCL mask . . . . . . . .
  3. If the job JCL record contains user variables to be resolved, specify a rule set name in the System level rule set or Job level rule set field.
    The name of the active system-level rule set is displayed by default. You can blank out the value in the field and type another value. If the value contains one or more masking characters (* or ?), RUV displays the VSAM Sphere Backup / Restore - Rule_Set Names panel as shown in the following figure, which lists the existing rule sets that match the mask.

      File  View  Help
    ------------------------------------------------------------------------------
                          BMC AMI Recovery for VSAM                 Row 1 from 8
    Command ===>

                    VSAM Sphere Backup / Restore - Rule_Set Names  2020.328 16:27

    Select one Rule_Set name from the list below

      Rule_Set Name                     Status
      --------------------------------  ------------
    . BONY Not Selected
    . JM_RULE_SET Not Selected
    . JNL003_RULES Not Selected
    . JNL100_RULES Not Selected
    . JNL101_RULES Not Selected
    . JNL102_RULES Not Selected
    . MXN1 Not Selected
    . RUVIVP20_RULES Not Selected
    ******************************* Bottom of data ********************************
  4. Select the rule set that you want to use by typing any character to the left of the rule set name and pressing Enter, and then enter the END command to return to the VSAM Sphere Backup / Restore panel.
  5. In the VSAM file mask or VSAM group mask field, enter the fully qualified name of the VSAM file or VSAM group that you want to select, or enter a value with masking characters (* and ?) to view a list of existing VSAM files or VSAM groups.
    If you entered a masked value, RUV displays the VSAM Sphere Backup / Restore - VSAM File Name panel as shown in the following figure or the VSAM Sphere Backup / Restore - VSAM Group Name panel (not shown).

       File  View  Help
    -----------------------------------------------------------------------------
                           BMC AMI Recovery for VSAM               Row 1 from 8
    Command ===>

                     VSAM Sphere Backup / Restore - VSAM File Name 2020.328 16:3

    Select VSAM File Name(s) from the list below

       VSAM File Name                                  Status       Type
       --------------------------------------------    ------------ -----
       --REPOSITORY_JOURNAL                            Not selected File
       RUVRCM.DEVC.CICSTS13.DFHCSD                     Not selected File
       RUVRCM.DEVC.CICSTS22.DFHCSD                     Not selected File
       RUVRCM.DEVC.CICSTS23.DFHCSD                     Not selected File
       RUVRCM.DEVC.RALL.RUVK0011                       Not selected File
       RUVRCM.DEVC.RUVK0001                            Not selected File
       RUVRCM.DEVC.RUVK0020                            Not selected File
       RUVRCM.DEVC.RUVK0030                            Not selected File
       RUVRUV.BONYSNAP.RUVK010.COPY                    Not selected File
       RUVRUV.DEMO.CICSTS13.DFHCMACD                   Not selected File
       RUVRUV.DEVC.AUTO.RUVK0010                       Not selected File
       RUVRUV.DEVC.BOTH.RUVK0013                       Not selected File

    If you want RUV to display the VSAM Sphere Backup / Restore - VSAM File Name panel or the VSAM Sphere Backup / Restore - VSAM Group Name panel with all files or groups already selected, enter any character in the Preselect all files or groups field. You can then remove the selection for the files or groups that you do not want to include in the command by entering any character to the left of the file or group name.

  6. Select one or more files or groups by entering any character to the left of the file of group name. Then enter the END command to return to the VSAM Sphere Backup/Restore panel.
  7. In the Job JCL mask field, enter the name of the existing job JCL record that you want to use.
    If you enter a masked value that contains one or more masking characters (* or ?), RUV displays the VSAM Sphere Backup / Restore - Job_JCL Names panel as shown in the following figure, which lists the existing job JCL records that match the mask.

       File  View  Help
    ------------------------------------------------------------------------------
                           BMC AMI Recovery for VSAM               Row 1 from 11
    Command ===>

                     VSAM Sphere Backup / Restore - Job_JCL Names 2020.328 16:39

    Select one Job_JCL name from the list below

      Job_JCL Name                      Status
      --------------------------------  ------------
    . $DEFAULT                         Not Selected
    . DFDSS_BACKUP_JOB_JCL             Not Selected
    . DFDSS_RESTORE_JOB_JCL            Not Selected
    . IDCAMS_REPO                      Not Selected
    . MCGREGOR_TRASH                   Not Selected
    . MXN_TEST1_LOOP                   Not Selected
    . PAG_TEST_JOB_JCL                 Not Selected
    . PAG_TEST_JOB_JCL_2               Not Selected
    . PAG_TEST_JOB_JCL_3               Not Selected
    . PAG_TEST_JOB_JCL_4               Not Selected
    . REPRO_VS                         Not Selected
    ******************************* Bottom of data ********************************
  8. Select the job JCL record that you want to use by typing any character to the left of the job JCL record name and pressing Enter, and then enter the END command.
    An ISPF Edit panel is displayed as shown in the following figure. It displays a temporary data set that contains the skeleton JCL from the selected job JCL record.

      File  Edit  Confirm  Menu  Utilities  Compilers  Test  Help
    -------------------------------------------------------------------------------
    EDIT       PAG.SYSP.SPFTEMP1.CNTL                          Columns 00001 00072
    Command ===>                                                  Scroll ===> CSR
    ****** ***************************** Top of Data ******************************
    000001 //MXNREPO  JOB (4540),'NGO LOGR PRINT',REGION=0M,NOTIFY=&SYSUID,
    000002 //       class="A",MSGCLASS=X,MSGLEVEL=(1,1)
    000003 //********************************************************************
    000004 //*
    000005 //*   REPRO KSDS FILES
    000006 //*
    000007 //***********************************************************
    000008 //STEP001   EXEC PGM=IDCAMS
    000009 //SYSPRINT DD SYSOUT=*
    000010 <:BEGIN_LOOP>
    000011 //B<SYSNDX>  DD DISP=(NEW,CATLG,DELETE),
    000012 //       UNIT=SYSDA,
    000013 //       SPACE=(CYL,(5,20),RLSE),
    000014 //    DCB=(RECFM=FB,LRECL=100,BLKSIZE=10000),
    000015 //       DSN=<VSAM_DSN>.BACKUP.<+1>
    000016 <:END .-------------------------------------------------.
    000017 //SYS | Use PERSUB command to perform RUV substitutions |
    000018 <:BEG '-------------------------------------------------'
  9. You can change the displayed skeleton JCL. When you are ready for RUV to perform variable substitution, enter the PERSUB command.
    RUV performs variable substitution and displays the generated JCL as shown in the following figure.

    File  Edit  Confirm  Menu  Utilities  Compilers  Test  Help
    -------------------------------------------------------------------------------
    EDIT       PAG.SYSP.SPFTEMP1.CNTL                          Columns 00001 00072
    Command ===>                                                  Scroll ===> CSR
    ****** ***************************** Top of Data ******************************
    000001 //MXNREPO  JOB (4540),'NGO LOGR PRINT',REGION=0M,NOTIFY=&SYSUID,
    000002 //       class="A",MSGCLASS=X,MSGLEVEL=(1,1)
    000003 //********************************************************************
    000004 //*
    000005 //*   REPRO KSDS FILES
    000006 //*
    000007 //***********************************************************
    000008 //STEP001   EXEC PGM=IDCAMS
    000009 //SYSPRINT DD SYSOUT=*
    000010 //B0000001  DD DISP=(NEW,CATLG,DELETE),
    000011 //       UNIT=SYSDA,
    000012 //       SPACE=(CYL,(5,20),RLSE),
    000013 //    DCB=(RECFM=FB,LRECL=100,BLKSIZE=10000),
    000014 //       DSN=RUVRUV.SP.KSDS01.BACKUP.V0001351
    000015 //B0000002  DD DISP=(NEW,CATLG,DELETE),
    000016 //       UNIT=SYSDA,
    000017 //       SPACE=(CYL,(5,20),RLSE),
    000018 //    DCB=(RECFM=FB,LRECL=100,BLKSIZE=10000),
     F1=Help      F3=Exit     F10=Actions  F12=Cancel
  10. Review the generated JCL. To make changes to the generated JCL, you can edit the generated JCL directly, but the job JCL record will not be affected. To change the job JCL record, enter the END command, and the temporary data set that contains the skeleton JCL is redisplayed so that you can change it.
    You can repeat the process of entering the PERSUB command, reviewing the generated JCL, entering the END command, and changing the skeleton JCL until it produces the results you want. To save the changes that you made to the skeleton JCL and update the job JCL record in the repository, enter the END command.

    Warning

    Note

    You must enter the END command (when the skeleton JCL is displayed) if you want to save the updated job JCL record to the repository. Entering the SAVE command does not cause the updated job JCL record to be written to the repository, and the generated JCL is never saved to the repository.

    You can save the generated JCL in a permanent data set, submit the JCL for execution (with the SUBMIT command), enter the END command to return to editing the job JCL record, or enter the CANCEL command to discard the generated JCL and all changes to the job JCL record.


 

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

BMC AMI Recovery for VSAM 4.1