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.
Before you begin
The general insurance application requires a stand-alone CICS
region as a minimum, but can be extended to run in a CICS topology
and CICSplex. You must also have a supported version of DB2 and a
COBOL compiler installed.
About this task
The application is packaged in a .zip file.
You must extract the file, and use FTP to copy it to your z Systems® machine.
The files include a customization job so you can easily configure
the application for your environment.
Procedure
- Go to the IBM Support website at https://www.ibm.com/support/pages/cb12-general-insurance-application-genapp-ibm-cics-ts and download the .zip file to your workstation.
- 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 |
- 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.
- 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 dataset
where the logical record length size is 80. Enter the command
quote
site recfm=fb lrecl80 blksize=3120 for all the XMIT files.
- Set the file attributes for the KSDSCUST file
before transferring it. Enter the command quote site recfm=fb
lrecl82 blksize=8200.
- Transfer the KSDSCUST file in ASCII
mode. Enter ascii on the command line to change
to ASCII mode.
- 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.
- Transfer the KSDSPOLY file in ASCII
mode.
- Do not transfer the event binding to the z/OS server,
because this file is imported into CICS Explorer.
- 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.
- 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.
- 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.
Results
You have successfully installed and customized the general
insurance application jobs.
What to do next
The next step is to build the environment for the application.