Building the application environment

Run the customized jobs to create the Db2® database, application files, and CICS® resources.

About this task

To set up the general insurance application, run each of the customized jobs in the CB12.CNTL data set. Some jobs are optional and depend on whether you want to use a coupling facility to share application data across CICS regions. If you want to run the application in a single CICS region, you do not have to run the jobs related to the coupling facility.

Procedure

  1. Submit the job @ADEF121 to create the VSAM application files for customer details and policy details. This job also populates the KSDSCUST and KSDSPOLY files with data.
  2. Submit the job @ASMMAP to build the BMS maps for the 3270 interface.
    This job has a return code of 4.
  3. Submit the job @CDEF121 to add all of the required resource definitions to the CSD. The group list is called GENALIST.
  4. Submit the job @COBOL to compile the COBOL application programs. The compiled programs are put in the USERHLQ.CB12.LOAD library.
  5. Submit the job @DB2CRE to create the Db2 database for the application. It creates a storage group, database, tables, and indexes. This job also populates the database with data.
  6. Submit the job @DB2BIND to bind the application to the Db2 objects.
  7. Optional: If you want to use a named counter server with the application, create a structure in the coupling facility. The pool name is GENA and the structure name is DFHNCLS_GENA.
    For details on how to define a list structure for a named counter server, see Setting up and running a named counter server.
  8. Optional: If you want to use a shared temporary storage queue, create a structure in the coupling facility. The shared temporary storage queue is also called GENA and the structure name is DFHXQLS_GENA.
    For details on how to define a list structure for a temporary storage server, see Setting up and running a temporary storage server.
  9. Optional: Submit the job @SAMPNCS to create a named counter server called GENA.
    You can customize this sample to change the pooled name if appropriate.
    The job is long-running and might take a while to complete. You can check that the job completed successfully by looking in the system log for the CICS message DFHNC0102I Named counter server for pool GENA is now active.
  10. Optional: Submit the job @SAMPTSQ to create a temporary storage queue server called GENA.
    Again you can customize the sample to change the pooled name if appropriate.
    This job is also long-running and might take a while to complete. You can check that the job completed successfully by looking in the system log for the CICS message DFHXQ0102I Shared TS queue server for pool GENA is now active.
  11. Edit the startup JCL for the CICS region:
    1. Update the system initialization parameters to provide the following nondefault values:
      GRPLIST=(DFHLIST,GENALIST)       
      DB2CONN=YES
      NCPLDFT=GENA    
    2. Add the load library name USERHLQ.CB12.LOAD library to the RPL.
  12. Submit the job to start the CICS region.

Results

The CICS region starts up successfully. If you want to rebuild the environment, submit the job @DB2DEL to delete the Db2 database.

What to do next

Validate that the general insurance application works and can connect to Db2.