Start of change

Prerequisites for running the IVP

Before you being to run the IVP, perform the following steps.
  1. If you are running the IVP for the FEPI adapter, check that the parameter HLSYSID has been specified in DFHMAINJ. This parameter is optional for the installation of the product, but required when running the IVP on a FEPI adapter. The adapter has also been modeled to work in a CICS region where the following conditions are met:
    • SEC=YES, GMTRAN=CESN system initialization parameters are specified.
    • RACF pass tickets are enabled for the CICS APPLID and the user ID that runs the IVP transaction

    You cannot run the IVP for FEPI adapters that use FEPI transactions, such as CZUU. These transactions are unsupported in the runtime environment.

  2. Run DFHMASIM. The job is located in the runtime library SCIZSAMP and was customized with the appropriate values by DFHMAINJ. The job executes these steps:
    • Assembles and links the mapset for the sample back end programs.
    • Compiles programs DFHMABP1 through to DFHMABP5.
    • Creates WMQ programs DFHMABP6 and DFHMABP7 for the simulator. This only occurs if you specified MQ YES in DFHMAINJ.
    • Compiles program DFHMABP8.
    • Creates and initializes files for the back end sample program
    • Compiles simulator programs DFHMAIP1 through to DFHMAIP6.
    • Assembles and links the mapset for the simulator.
    • Creates and initializes simulator files.
    • Creates alternate indexes for the simulator files.
    • Executes DFHMASMI. This only occurs if you specified MQ YES in DFHMAINJ.
    • Updates the CICS CSD with the simulator definitions.
    • Updates the properties file DFHMAMPF.
  3. Check the job output. If you specified MQ YES, check the output from the MQDEFS step. CSQUTIL can return RC=0, even if errors occurred. All other steps should complete successfully. Start of change

    If you get a return code of 4 and error messages IGYDS0001-W or IGYPG3112-W for certain steps, this is acceptable. If you have specified compiler options OPTIMIZE(STD) or OPTIMIZE(FULL), you might also get a return code of 4 and error messages IGYOP3091-W, IGYPG3013-W, IGYPG3045-W, IGYPG3068-W, and IGYPG3173-W for certain steps. This is also acceptable.

    End of change
The following programs are compiled: When DFHMASIM completes successfully, the necessary programs, files and resources have been set up and configured for you to run the IVP.
Perform a cold restart of the CICS region. This brings the changes that were made to include the runtime libraries into effect.
End of change