Installing the general insurance application

The general insurance application is freely available to download from the IBM® Beta website and contains the jobs you need to set up the application.

1. Go to the IBM Support website at CB12: General insurance application (GENAPP) for IBM CICS TS and download the .zip file to your workstation.
2. Extract the files to a suitable directory.
   The following files are extracted:

   Table 1. List of extracted files

   File	Description
   CNTL.XMIT	JCL to build the environment for the application
   EXEC.XMIT	REXX code that customizes the JCL
   KSDSCUST	Sample customer information for the application
   KSDSPOLY	Sample policy information for the application
   SOURCE.XMIT	Source programs for the general insurance application
   Transaction_Counters.evbind	Event binding for the general insurance application
   WSIM.XMIT	Sample workload simulator scripts

3. Use FTP to transfer the files to the z Systems machine and put them in MVS™ data sets.
   Call the data sets CB12.filename, where filename is the name of the extracted file; for example, CB12.SOURCE.XMIT.
   1. Transfer the files with the suffix XMIT in binary mode. Enter bin on the command line to change to binary mode.
      Note: Any file with an .XMIT extension must be put in a sequential fixed block data set where the logical record length size is 80. Enter the command quote site recfm=fb lrecl80 blksize=3120 for all the XMIT files.
   2. Set the file attributes for the KSDSCUST file before transferring it. Enter the command quote site recfm=fb lrecl82 blksize=8200.
   3. Transfer the KSDSCUST file in ASCII mode. Enter ascii on the command line to change to ASCII mode.
   4. Set the record length of the data set for the KSDSPOLY file before transferring it.
      Enter the command quote site recfm=fb lrecl=64 blksize=6400 to set the record length.
   5. Transfer the KSDSPOLY file in ASCII mode.
   6. Do not transfer the event binding to the z/OS® server, because this file is imported into CICS Explorer®.
4. Extract the SOURCE, WSIM, CNTL, and EXEC files into partitioned data sets by using the RECEIVE command:

   RECEIVE INDSN('userid.CB12.SOURCE.XMIT')

   This command identifies the input data set. You must enter a response to the RECEIVE command to identify the name of the destination partitioned data set, as shown in the following example:

   DA('userid.CB12.SOURCE')

   You do not have to perform this step for the KSDS files because they are already in a readable format.
5. Customize the member CUST1 in the CB12.EXEC data set.
   The values in this member include settings for a CICS topology and CICSPlex® SM, which you can ignore. Replace the following values with your own:

   PDSMEMin  = 'userid.CB12.CNTL'      
   CICSHLQ   = 'CTS420.CICS670'        
   CPSMHLQ   = 'CTS420.CPSM420'        
   CSDNAME   = 'userid.GENAPP.DFHCSD' 
   USRHLQ    = 'userid'               
   COBOLHLQ  = 'PP.COBOL390.V420'      
   DB2HLQ    = 'SYS2.DB2.V910'         
   CEEHLQ    = 'CEE'                   
   DB2RUN    = 'DSN910PM'              
   SQLID     = 'userid'              
   DB2SSID   = 'DHM1'                  
   DB2DBID   = 'GENASA1'               
   WSIMHLQ   = 'WSIM.V110'
   

   PDSMEMin

   Enter the location of the CNTL library, userid.CB12.CNTL. Replace userid with your user ID.

   CICSHLQ

   Enter the CICS high-level qualifier to customize the CICS data sets.

   CPSMHLQ

   Enter the CICSPlex SM high-level qualifier to customize the CICS data sets.

   CSDNAME

   Enter the fully qualified name of the CSD for the CICS regions that will run the general insurance application.

   USRHLQ

   Enter a high-level qualifier for the application data sets.

   COBOLHLQ

   Enter the high-level qualifier for the COBOL compiler.

   DB2HLQ

   Enter the high-level qualifier for Db2 libraries.

   CEEHLQ

   Enter the high-level qualifier for Language Environment®.

   DB2RUN

   Enter the high-level qualifier for the Db2 runtime library.

   SQLID

   Enter the RACF® user ID that is authorized to create objects in Db2.

   DB2SSID

   Enter the subsystem ID of the Db2 instance that you want to use.

   DB2DBID

   Enter a name for the database that is going to contain the general insurance application data. You can use any value.

   WSIMHLQ

   Enter the high-level qualifier for the Workload Simulator for z/OS libraries. If you do not use this product, you can ignore this parameter.

6. Run the EXEC job to customize the JCL in the CNTL data set.
   The job copies the members and updates them with your values. Each member name is prefixed with @ to indicate that it has been customized. You can run the customization step as many times as you want.