Rational Developer for System z

Building a local COBOL CICS transaction with TXSeries

Before you begin

You need to have installed IBM® TXSeries for Multiplatforms on your workstation. The instructions in this topic assume that you have installed it in the default location C:\opt\cics. If you have installed it in a different location, you need to adjust the instructions accordingly.

Linux icon Rational® Developer for System z® does not support local COBOL or PL/I builds or TXSeries on the Linux platform.

Creating the project

Procedure

  1. In the z/OS Projects or Enterprise Projects view, select New > Project. The New Project window opens.
  2. Click + to expand the Examples section.
  3. Click + to expand the Workstation COBOL section and then select COBOL Sample with CICS and click Next.
  4. Specify a name for the new project, select a property group, and click Finish. The new project is added to the z/OS Projects or Enterprise Projects view. This project contains a BuildOutput folder and a cobol folder containing source file TIMEZONE.cbl.
    Important: The TIMEZONE sample program is written to be built and run in a Windows environment. If you copy the TIMEZONE source to the 390 environment, and you are using CICS® 4.1 or higher, READ DATASET is no longer valid, and the EXEC CICS statement should be changed to READ FILE.

Setting build options

Procedure

  1. Right-click the new project you created and click Property Group > Edit Associated Property Group.
  2. In the property group editor, click the COBOL tab and then select the Local COBOL Options property page.
  3. Set the build options to the following values:
    Option Value
    Compile Options TEST,ADATA,EXIT(ADEXIT(FTTFDBKW))
    SYSLIB c:\opt\cics\include
    CICS Options CICSNT -lIBMCOB -adesvp
    Note: If you did not install TXSeries to its default install location, change the c:\opt\cics part of the SYSLIB value to the directory where you installed TXSeries.
  4. Click the Link tab to open the Local Link Options property page and set the Link Options to the following values:
    /de c:\opt\cics\lib\cicsprIBMCOB.lib
    Note: If you did not install TXSeries to its default installation location, change the c:\opt\cics part of the second link options value to the directory where you installed TXSeries.
  5. Close and save changes to the property group.

Building the executable

Procedure

  1. Select the project you created for this scenario.
  2. Right-click and select Rebuild Project. A file named TIMEZONE.IBMCOB is added to the BuildOutput folder. This file is the executable you will use with TXSeries.

Feedback