Installing the Help Model › Install the Help Model

Install the Help Model

The Help Model is a CA Gen-generated application. Upload it to your Host Encyclopedia, generate it, and install it. As an installed application, the Help Model has its own help system, identical in functionality to the help systems you are creating for your CA Gen-generated applications.

Follow these steps:

1. To install the Help Model under IMS or CICS, configure these environments for generating CA Gen applications.

   Note: For more information about configuring the IMS and CICS environment, see the z/OS Installation Guide.

2. Verify that the Help Model is in the Encyclopedia. If you created an Encyclopedia, the CEJOB13 job uploaded the Help Model. If the Help Model is not in the Encyclopedia, load it by executing one of the following steps:
   • Execute CEJOB13, member HELPMODL. See the JCL for complete instructions on customizing and running CEJOB13.
   • Copy member HELPMODL from the TRAN library on the CA Gen installation media to: <tiupref>IEF.TRAN<tiusufx> and type %IEFUP at the Ready Prompt and press Enter.
3. Specify target environment parameters for the two business systems in the Help Model: Help Maintenance and Application Help.
4. Specify the internal libraries using the same set of names for both business systems.
5. Identify the trancodes and load module names to use for the Help Model. There are eight trancodes for the Help Maintenance business system and three for Application Help.
6. If necessary, repackage the business systems using the new trancodes and load module names. These trancodes and load modues names must match the names in the TIRHELP user exit.
7. Copy TIRHELP from the CA Gen CEHBSAMP library to a source library.
8. Make the following changes to TIRHELP:
   1. Leave the program ID as TIRHELP.
   2. Uncomment the following statements that pertain to working storage:

      SCREEN-HELP-TRANCODE

      FIELD-HELP-TRANCODE

      FIELD-PROMPT-TRANCODE

      SCREEN-HELP-LOADMOD

      FIELD-HELP-LOADMOD

      FIELD-PROMPT-LOADMOD

      MSG-AREA

      DEST-LOADMOD

   3. Update the load module names to those used in the Application Help business system of the Help Model.
   4. Update the trancode names to those used in the Application Help business system of the Help Model.
   5. Modify paragraphs A1000, B1000, and D1000. Comment out the two lines with default code and remove the comments from the remaining code.
   6. Modify X0000 and uncomment the entire paragraph.
9. Use the MKUEXITS procedure that is supplied in the CEHBSAMP to build the TIRHELP and replace the procedure in the relevant DLL. You do not have to install the applications invoking the TIRHELP again because TIRHELP is included in the DLL.
10. Generate and install the database in your DBMS environment:
    1. Choose a Creator ID for the Help Model that differs from the Creator ID used to install the Host Encyclopedia. The Help Model uses table names that are also used by the Public Interface.
    2. You can change the technical design for the model for compatibility with your DBMS system. You cannot change the TABLE and COLUMN names.
11. Run code generation for both business systems.
12. Install the load modules.
13. (Optional) Load the Help data for the Help Model itself. Use JCL member:
    • LAPPHELP (<dataset prefix>.JCL(LAPPHELP)) if using IBM DB2 LOAD utility or
    • CAPPHELP (<dataset prefix>.JCL(CAPPHELP)) if using CA DB2 Fast Load utility.