Start of change

Running the product definition procedure DFHMASET

The JCL program DFHMASET completes the installation for CICS® SFR. It compiles programs, creates and initializes all of the necessary files, as well as creating the required CICS and WMQ resources.

The member DFHMASET is in the runtime library .SCIZSAMP and was copied there and customized when you ran DFHMAINJ.
  1. Start of changeOptional: If you intend to run the IVP for the FEPI adapter, you might need to change the FEPI pool and target name parameters. The value of the HLAPPLID parameter in DFHMAINJ is used to configure the pool and target name. If you have configured FEPI to use different values in your CICS region, edit the TYPE=3 entries in member DFHMASPS of the .SCIZSAMP library to reflect your pool and target name. End of change
  2. Run DFHMASET. The job executes these steps:
    • Compiles the file initialization program and the record delete program
    • Creates the following files:
      DFHMAERF Error file
      DFHMAMPF Properties file
      DFHMALRF Link Bridge repository file
      DFHMALVA Link Bridge vector log file
      DFHMALVB Link Bridge vector log file
      DFHMAL2F Link Bridge state file
      DFHMACOF FEPI SLU connection file
      DFHMATIF FEPI target interaction file
      BTS BTS file
      DFHMALSF Link3270 Bridge state file for MQIAC
    • Initializes DFHMACOF and creates an alternate index DFHMAC1F for it.
    • Optional: Executes DFHMASMQ to create the MQ resources. This only occurs if you specified MQ YES in the DFHMAINJ job.
    • Updates the CSD to create the CICS resources.
  3. Check the job output. Start of changeAll steps should have a return code of 0, except for the compiling of DFHMADCD, DFHMADCI, DFHMADUP, DFHMAEUP and DFHMAVUP. A return code of 4, accompanied by error message IGYDS0001-W, is acceptable for these steps.

    If you have specified compiler options OPTIMIZE(STD) or OPTIMIZE(FULL), a return code of 4, accompanied by error message IGYOP3091-W, is also acceptable for these steps.

    End of change
  4. Optional: If you specified MQ YES, then check the output from the MQDEFS step. CSQUTIL can have a return code of 0, even if errors occurred.
  5. Update CICS JCL to specify the runtime library SCIZLOAD in the DFHRPL concatenation.
  6. Include the name of the CICS RDO list that contains the CICS SFR group in the GRPLIST system initialization parameter. This is the name that you used for the RDOLIST parameter in DFHMAINJ.
You can optionally run further steps to enable data conversion, configure the autostart procedure for the Link3270 Facility State Cleanup programs and enable support for BIDI transformation.

It is recommended that you run the IVP to check that your setup is configured correctly and that all the necessary resources are available for each of the supported adapters. If you are not running the IVP, restart CICS to complete the set up of CICS SFR.

End of change