Previous Topic: ISPF Customization Panel Primary OptionsNext Topic: Control and Cache Data Sets


ISPF Customization Steps

Perform the following steps to complete the ISPF Customization Process.

  1. Type the Following Command in ISPF option 6:
    EXEC 'HLQ.CCUUEXEC(INSTALL)'
    
  2. Enter d to Define a New CA Vtape System on the Option line as follows, and press Enter.

    The following is an example of the CA Vtape main menu.

    VTIP0000 ------------- CA Vtape Virtual Tape System -----------------                         JCL Customization Options                          Option ===>  d                                                                                                                                                                                                                                  CCCCCCCCCCCCCC                                                             CCC                                                                         CCC                                                                          CCC             AAAA   VV          VV TTTTTTTTTT   AA       PPPPPP  EEEEEEE   CCC           AAAAAA    VV        VV      TT      AAAA      PP   PP EE         CCC        AAA  AAA     VV      VV       TT     AA  AA     PP   PP EE           CCC    AAA    AAA      VV    VV        TT    AAAAAAAA    PPPPPP  EEEEE           CCCCCCCCCCCAAA       VV  VV         TT   AA      AA   PP      EE              AAA        AAA        VVVV          TT  AA        AA  PP      EE            AAA          AAA         VV           TT AA          AA PP      EEEEEEE     AAA            AAA                                                          AAA              AAA                                                                                                                                                                                                                         PF1 to View JCL Customization Tutorial                                        PF3 to Exit                                                                     V View CA Vtape Configuration Log                                  R Regenerate JCL For Existing CA Vtape System                      D Define New CA Vtape System                                  Enter END command to terminate session.

  3. Enter the PREFIX.SVTJCL library data set name allocated with the VTA08NON job. Enter c on the command line and press Enter to continue to the next panel.

    VTIP1000 --------------- CA Vtape Virtual Tape System ---------------- JCL Customization Options COMMAND ===> c C to Continue PF3 to Previous Specify The SVTJCL Data Set Name (Prefix.SVTJCL) SVTJCL Library: CAVTAPE1.SVTJCL_________________________ The CA Vtape SVTJCL data set is the repository for the generated customization JCL, the Configuration Log, and the Configuration Member SUTPARMS. ***

  4. Update as needed the generated jobcard which contains your user-id. Enter the Subsystem ID and APF authorized loadlib for CA Vtape. Enter c on the command line and press Enter to continue to the next panel.

    VTIP1200 --------------- CA Vtape Virtual Tape System ---------------- JCL Customization Options COMMAND ===> c C to Continue PF3 to Previous JCL Job Statement Definition: ==> //useridA JOB (ACCOUNT),'CA VTAPE UTILITY',CLASS=A,______________ ==> // MSGLEVEL=(1,1),MSGCLASS=X,REGION=4M,______________ ==> // NOTIFY=userid______________________________________ Define the SVTS Subsystem ID. You may define SVT1 through SVT8. SVTS Subsystem ID: ==> SVT1 APF Authorized Load Library (HLQ.CCUULOAD): ==> CASMPE.VTAPE.CCUULOAD_________________________________________ ***

  5. Enter the CA Vtape DSN Prefix. The default value is CAVTAPE1. Enter c on the command line and press Enter to continue to the next panel.

    VTIP130D  --------------- CA Vtape Virtual Tape System ----------------                            JCL Customization Options                    COMMAND ===>  c                                          C to Continue  Session Mode: Define                                   PF3 to Previous                                                                                                                                                   The Data Set Name Prefix is used to define CA Vtape          System Data Sets. A maximum of 23-characters can be entered.                                                                                                                                                                CA Vtape System DSN Prefix:  CAVTAPE1_________________                                                                                                                                                          CA Vtape System Data Sets:                                     * Prefix.GLOBAL.VCAT             Global Vcat Data Set                   * Prefix.BSDS1                   Bootstrap Data Set                     * Prefix.sysid.SVTnVCAT          Local Vcat Data Sets                   * Prefix.VVE.LDSnnnnn            Static DASD Buffer Data Sets           * Prefix.VVE.Vvolser.MM.CACHE    Dynamic DASD Buffer Data Sets          * Prefix.VVE.Vvolser.PRIMARY     Primary Backstore Data Sets            * Prefix.VVE.Vvolser.DUPLEX      Duplex Backstore Data Sets             * Prefix.SVTJCL                  System JCL Libary                      * Prefix.PARMLIB                 System Parameter Library                                                                                 ***                                                                    

  6. The Global VCAT and BSDS1 data set names are generated using the DSN Prefix entered on the previous panel. Enter the required allocation information. Enter c on the command line and press Enter to continue to the next panel.

    Note: If the Global VCAT and BSDS1 DSNs need to match a control data set naming standard at your site, they can be renamed in the JCL generated by the Customization Process before the JCL is submitted. CA Vtape only enforces the naming standard using the DSN Prefix during the Customization Process. The running product does not enforce this naming standard for these data sets. You will be reminded to rename these data sets if required during the appropriate step later in the Customization Process.

    VTIP1400  --------------- CA Vtape Virtual Tape System ----------------                            JCL Customization Options                     COMMAND ===>  c                                          C to Continue                                    P for Profile Values  PF3 to Previous                                                                                                                                                      DFSMS constructs and/or VOLSERs can be defined to control the            allocation of the Global VCAT and BSDS1 data sets. The Global            VCAT and BSDS1 should not be allocated on the same volume and            should not be allocated on the DASD Buffer Pool volumes.                                                                                          Global VCAT Data Set Name: CAVTAPE1.GLOBAL.VCAT                                                                                                                  Data Class:  ___________________________________________              Storage Class:  GVSTORCLAS_________________________________           Management Class:  ___________________________________________                                                                                              VOLSER:  ____________                                                                                                          BSDS1 Data Set Name: CAVTAPE1.BSDS1                                                                                                                              Data Class:  _________________________________________              Storage Class:  BSSTORCLAS_______________________________           Management Class:  _________________________________________                                                                                              VOLSER:  ____________                                                                                                           ***     

  7. On this panel you chose whether you are going to customize CA Vtape to use Dynamic or Static Cache Management.

    The panel defaults to Dynamic Cache Management. To take the recommended path of Dynamic Cache Management, enter c on the command line and press Enter to continue to the next panel. Proceed to step 10.

    To take the Static Cache Management path, overtype DYNAMIC with STATIC, enter a c on the command line and press Enter to continue to the next panel.

    VTIP145D --------------- CA Vtape Virtual Tape System ---------------- JCL Customization Options COMMAND ===> c C to Continue P for Profile Values PF3 to Previous Define CA Vtape CACHE Management - Specify "Dynamic" or "Static" - Dynamic Cache Management dynamically allocates DFSMS managed data sets using Media Manager I/O Services. - Static Cache Management pre-allocates and pre-initializes a fixed number of VSAM Linear data sets using Data-In-Virtual I/O services. In this mode DFSMS is not required. CA Vtape Cache Management: DYNAMIC ***

  8. This panel is only displayed for Static Cache Management. If you chose Dynamic Cache Management, proceed to step 10.

    Enter the required allocation information for the DASD buffer LDSs. Enter c on the command line and press Enter to continue to the next panel.

    VTIP1500  --------------  CA Vtape Virtual Tape System  --------------                            JCL Customization Options                      COMMAND ===>  c                  E to Edit Volumes Mbr   C to Continue                                     P for Profile Values  PF3 to Previous                                                                                                                                                         DFSMS constructs or a volume list can be used to control the              allocation of the DASD Buffer Pool Linear Data Sets. A Volume List       Member can be defined in the SVTJCL library from this panel by            specifying a member name that must start with VOL (e.g., VOLUMES,        VOLIST1). The DFSMS constructs and the Volume List Member are             mutually exclusive.                                                                                                                                            Data Class:  ________________________________                          Storage Class:  BPSTORCLAS______________________                        Management Class:  ________________________________                                                                                                DASD Buffer Pool Volume List Member Name: ___________                  ***                                          

  9. This panel is only displayed if you have chosen Static Cache Management. If you chose Dynamic Cache Management proceed to step 10.

    Enter the Virtual Volume Size, the total number of Virtual VOLSERs that will be needed in the CA Vtape Complex, and the DASD Buffer Pool size. The number of Virtual Volumes defaults to 1000. The number entered is used to size the control data sets. 1000 works well for a software trial. If a production complex is being defined, the value should be increased to at least 100,000. Enter g on the command line and press Enter to generate the customization JCL, the Configuration Log, and the Configuration Member SUTPARMS.

    Proceed to step 11.

    VTIP160D  --------------  CA Vtape Virtual Tape System  --------------                             JCL Customization Options   COMMAND ===>  g                                        G to Generate   Session Mode: Define                                   PF3 to Previous                                                                                                    Virtual Tape Volume Size (MBytes):  800_                                                 A Virtual Tape Volume Size of 400, 800 or 2000 MBytes can be entered.   The value entered is used to internally configure     CA Vtape and to determine the size of the DASD Buffer Pool Linear    Data Sets (LDS).                                                                    400 MByte Virtual Volumes = 40 MByte LDS            800 MByte Virtual Volumes = 80 MByte LDS           2000 MByte Virtual Volumes = 200 MByte LDS                                                       Define the maximum number of Virtual Volumes for the     CA Vtape System. Enter a value between 100 and 1,000,000                                                        Number of Virtual Volumes to Index:  100000___                                                       Enter the DASD Buffer Pool Size (MBytes) determined from the    analysis of your tape activity reports. The maximum value    for 400 MByte Virtual Volumes is 2,621,440 MBytes. The maximum    value for 800 MByte Virtual Volumes is 5,242,880 MBytes.  The   maximum value for 2000 MByte Virtual Volumes is 13,107,200 MBytes.                                                         DASD Buffer Pool Size (MBytes):      100000_____                                                        ***                                                

  10. This is the panel displayed for Dynamic Cache Management. If you chose Static Cache Management, proceed to step 11.

    The Virtual Volume Size defaults to 2000 MBs. This is the recommended value. Enter the total number of Virtual VOLSERs that will be needed in the CA Vtape Complex. The number entered is used to size the control data sets. 1,000 is the default and this works okay for a software trial. If a production complex is being defined, the value should be increased to at least 100,000. Enter g on the command line and press Enter to generate the customization JCL, the Configuration Log, and the Configuration Member SUTPARMS.

    VTIP170D  --------------- CA Vtape Virtual Tape System ----------------                            JCL Customization Options                    COMMAND ===>  g                                          G to Generate  Session Mode: Define                                   PF3 to Previous                                                                                                                                 Virtual Tape Volume Size (MBytes):  2000                                                                                   A Virtual Tape Volume Size of 400, 800 or 2000 MBytes can be entered.   The value entered is used to internally configure CA Vtape   and to determine the maximum DASD allocation allowed for a single       Virtual Tape Volume. If additional DASD space is needed, the Virtual    Tape Volume will be kept, a scratch mount will be requested, and the    application data set will go to multiple volumes.                                                                          Define the maximum number of Virtual Volumes for the          CA Vtape System. Enter a value between 100 and 1,000,000.                                                                       Number of Virtual Volumes to Index:  10000_                ***                                                             

  11. During the generation process the following screen will be displayed. The message block will change multiple times as different phases of the generation process are entered.

    When the generation process is complete, you will be placed in a browse session to review the Configuration Log.

    VTIP1000  --------------- CA Vtape Virtual Tape System ----------------                            JCL Customization Options COMMAND ===>                                             C to Continue                                                          PF3 to Previous          Specify The SVTJCL Data Set Name (Prefix.SVTJCL)         SVTJCL Library:  CAVTAPE1.SVTJCL                      ____________________________________________________                     |                                                    |    The CA Vtape Syst| Please wait ... Deleting Previously Defined SVTJCL |    generated custom | Library Members                                    |    Configuration ME |____________________________________________________|   ***

  12. After reviewing the Configuration Log press PF3 and you will be placed in an edit session for the PREFIX.SVTJCL(DELETE) member.
  13. The DELETE JCL member submits other jobs. As the member name implies, the other jobs contain delete statements.

    Important! If you enter the DSN Prefix of an existing CA Vtape Complex into the panels and submit the DELETE JCL member, you run the risk of deleting the control data sets and the cache and backstore copies of the Virtual Volumes of that existing CA Vtape Complex. That is, you run the risk of creating a data loss situation.

  14. Press PF3 to return to the Main Menu. Press PF3 again to leave the Customization Panels.