Catalog the initialization procedure

DSQ3INIT is the QMF initialization procedure. It establishes installation criteria for the remainder of the installation, which is stored in DSQ3INIT.PROC. Because the information stored in DSQ3INIT is critical to the success of the installation, ensure your entries are correct before running the job. An incorrect entry in this job will cause errors in subsequent job steps.

You must edit DSQ3INIT before it can run:

  1. Delete the first line of the file, which begins with CATALOG.
  2. Change all instances of ..* to * with the following command: 
    ch /..*/*/ *
  3. Delete the two last lines of the file, leaving the end-of-job statement.
  4. Verify or change the name of the QMF library and sublibray, if necessary. If you are using anything other than the default library, PRD2.PROD, change the name to your library name: 
    // EXEC LIBR,PARM='MSHP'
   ACC S=PRD2.PROD
   CATALOG DSQ3INIT.PROC

// SETPARM QMFLIB=PRD2         *-- QMF for VSE LIBRARY
// SETPARM QMFSLIB=PROD        *-- QMF for VSE SUBLIBRARY
  5. Check the default library and sublibray for GDDM/VSE and DB2 for VSE. Compare, and change if necessary, the defaults to actual library and sublibrary names being used. The default values are: 
    // SETPARM ADMLIB=PRD2       *-- GDDM/VSE LIBRARY
// SETPARM ADMSLIB=PROD      *-- GDDM/VSE SUBLIBRARY
// SETPARM SQLLIB=PRD2       *-- DB2 LIBRARY
// SETPARM SQLSLIB=DB2720    *-- DB2 SUBLIBRARY
  6. Check the VSAM catalog name and ID. The catalog name and ID specify the target VSAM catalog for the QMF panel file and any NLF panel files. Compare the fields and change, if necessary: 
    // SETPARM UCAT=VSESPUC                *-- FILE NAME OF CATALOG
// SETPARM UCATID='VSEP.USER.CATALOG'
    *-- FILE ID OF CATALOG
  7. Determine whether you changed any of the defaults for GDDM/VSE. ADMF should have been defined in a VSAM catalog during the GDDM install. The QMF installation loads maps and forms to ADMF. QMF requires the file ID of ADMF (ADMFID), the catalog name (ACAT), and the catalog ID (ACATID).

    If you changed the defaults, change the following statements to match your naming convention: 

    // SETPARM ADMID='ADMF'            *-- FILE ID OF GDDM/VSE FILE ADMF
// SETPARM ACAT=VSESPUC            *-- CATALOG NAME AND CATALOG ID IN
// SETPARM ACATID='VSESP.USER.CATALOG'     *-- WHICH ADMF IS DEFINED
  8. File the job and run DSQ3INIT. Check the system console to ensure that the job ran with a return code of 0.

    If the job did not run with a return code of 0:

    1. Check for an error message on the system console.
    2. Check the list output to find the cause of the problem.
    3. Correct the problem.
    4. Return DSQ3INIT.
    5. Recheck the return code.

Run the QMF installation job

DSQ3EINS is the QMF installation job:

To successfully load and execute this job, these tasks must be accomplished during the initial installation:

  1. Edit DSQ3EINS to change or supply the required parameters
    1. Delete the first line of the file that starts with CATALOG.
    2. Change all instances of ..* to * with the following command: 
      ch /..*/*/ *
    3. Delete the two last lines of the file, leaving the end-of-job statement.
  2. Return to the top of the job and ensure the four job steps are set to YES. DSQ3EINS contains four job steps When a SETPARM is set to YES, it indicates that the step will be run; when set to NO, the step is skipped. Under most circumstances, these steps are run only once because VSE can share files with multiple CICS systems. For subsequent installations, or under error conditions, some of the job steps might need to be set to NO. 
    // SETPARM STEP1=YES      *-- DEFINE CLUSTER DSQPNLE
// SETPARM STEP2=YES      *-- LOAD DSQPNLE
// SETPARM STEP3=YES      *-- LOAD QMF CHARTS
// SETPARM STEP4=YES      *-- LOAD QMF MAPS
  3. Verify or change all instances of the library and sublibray names. If you installed QMF to a library other than PRD2.PROD, you must change the library and sublibrary names.
  4. Supply one or more volume IDs for the VSAM cluster that holds the QMF panel file. Locate this cluster definition under job step 1. 
    // EXEC IDCAMS,SIZE=AUTO
 DEFINE CLUSTER ( -
        NAME (QMF720.DSQPNLE ) -
        RECORDS (1200 50) -
        SHAREOPTIONS (3) -
        RECORDSIZE (1920  32756 ) -
        VOLUMES (--V001--) -

    Replace the variable -V001- with the volume IDs , such as DOSRES or SYSWK1. For example: 

    VOLUMES (DOSRES SYSWK1) -

    or 

    VOLUMES (DOSRES) -
  5. File and run the job. Check the system console to ensure that the job ran with a return code of 0.
[ Previous Page | Next Page | Contents | Index ]