Configuring the COBOL Component

This section describes which files to copy to the CICS program libraries and how to configure CICS to use the files. You may not have the authority to perform some if these steps, where this is the case please ask the appropriate person at your site for assistance.

Setting up the VSAM File

Using the following guidelines to set up the VSAM file:

  1. Edit the sample VSAM file in JCLLIB:

    1. Add a job card at the beginning.

    2. Enter the appropriate High Level Qualifiers for correct data file CICSADP.DATA.

    3. Enter the input file name for the repro job to load the VSAM DATA into ACCTFILE.

  2. Run the JCL; this creates three VSAM files of the form:

Setting Up and Installing the CICS Resource Definitions

The following guidelines will help you set up and install the CICS resource definitions:

  1. Edit the supplied CSD definitions file. If you followed our conventions, it is the data set in the PDS called CICSTS130.CICSADP.CSDDEFS. The CICS files in group CICS0ADP (ACCTFIL, ACCTNAM, and ACINUSE) need to be updated to point to the dataset names. For example:

  2. Update your CSD with the definitions contained in your file. This probably means asking someone at your site with the right authorization to run the DFHCSDUP job.

    Tip

    If you intend using the CORBA option later, add a further DD statement to your DFHCSDUP job using CICSJADP as input. You can run this at the same time.

  3. Enter ADD GROUP(CICS0ADP) LIST(YourGroupList) where YourGroupList is specified in your GRPLIST system initialization parameter (SIP) in your CICS startup job.

  4. If you do a warm start of your CICS region, this new definition will not be recognized.

  5. If you are cold starting CICS, the definitions that you have added to your CSDDEFS job are automatically installed. On the other hand, it is more likely that you will be warm starting CICS, in which case you should logon to your CICS region and install the CICS0ADP group (or your self-defined group) using:

    CEDA INSTALL GROUP(CICS0ADP)
CEDA INSTALL GROUP(CICSJADP)

You should see these resource definitions shown in Figure A-3.

CEDA EXPAND GROUP(CICS0ADP) screen

Figure A-3. CEDA EXPAND GROUP(CICS0ADP) screen

Running the Application

  1. Edit your CICS startup JCL to add the loadlibrary containing the load module into the DFHRPL concatenation. The statement looks like this:

    DFHRPL DD DISP=SHR,DSN=High.Level.qualifier.Loadlib
       DD DISP=SHR,DSN=High.Level.qualifier.Corlib

  2. Start CICS and logon to your CICS region from a 3270 emulation screen or a 3270 monitor.

  3. Issue the transaction NACT. You should now be running the application. Figure A-4 shows the screen that you see.

So far you have the main COBOL application running and you will be using this as the backend application to run the remaining parts of the sample application.

Warning

A check should be performed to ensure that the resource names associated with the NACT transaction do not conflict with the resources already in use. If so, you will have to change the CICS programs and resources to use another prefix and recompile the programs.

Accounts Menu from a 3270 screen

Figure A-4. Accounts Menu from a 3270 screen