Including IBM Developer for z Systems COBOL compiler error lists in dependency build results views

You can include IBM® Developer for z Systems® COBOL compiler error lists in dependency build results views by setting up some system definitions.

Before you begin

Before you set up the system definitions, you must already have the z/OS® dependency build set up.

To include this feedback in the build results, you must create an Enterprise Extensions data set definition to access the programs that provide the error feedback. Those programs are included in both IBM Developer for z Systems and the Engineering Workflow Management Build System Toolkit on z/OS. To complete this task, you must have one of those products installed.

In addition, you must enable the program compilation options for COBOL that support this extended feedback.

About this task

You can set up system definitions to show COBOL compilation error feedback from IBM Developer for z Systems in the build results for z/OS dependency builds. The error feedback supplements other build results.

Procedure

The following steps describe how to create a new data set definition from the Data Set Definitions node in the Team Artifacts view to support the compilation feedback results.

  1. From the Team Artifacts view, select your repository connection and log in.
  2. Expand your team project node.
  3. Expand Enterprise Extensions > System Definitions > z/OS . Right-click the Data Set Definitions node and select New Data Set Definition. The Data Set Definition editor opens.
  4. In the Name field, type one of the following names for the data set:
    • If you have IBM Developer for z Systems installed, type IDZ.SFEKLOAD.
    • If you plan to use the library that is provided by the Engineering Workflow Management Build System Toolkit on z/OS, type BLZ.SBLZLOAD.
  5. In the Usage section, select Existing data set used for build. The Data Set Characteristics section is disabled except for the Volume serial and Generic unit fields.
  6. In the Data set name field, type the actual name of the z/OS data set that is installed on the z/OS build system machine; for example, IDZ.SFEKLOAD. Then, click Save
  7. Edit any of the COBOL translators in the translator editor, append ,ADATA,EXIT(ADEXIT(ELAXMGUX)) to the Default Options field, and then do these steps:
    1. Ensure that TASKLIB is included in the DD concatenations.
      1. If TASKLIB is not in the DD concatenations, click Add to add it.
      2. If TASKLIB is in the DD concatenations, double-click TASKLIB.
    2. On the Edit DD concatenation wizard page, ensure that the DD name is specified as TASKLIB, and that the data set definitions section includes both your data set definition that references the COBOL compiler and the data set definition that you created in steps 3-7. If those data set definitions are not in the data set definitions list, add them to the list.

      DD name is specified as TASKLIB; data set definitions are included

    3. In the DD allocation section, if allocations for SYSXMLSD and SYSADATA are not already included in the list, add them. SYSXMLSD and SYSADATA must point to data set definitions that represent temporary files on your system.
    4. If you need to create a data set definition to represent temporary files, follow these steps:
      1. Create a data set definition called Temporary File.
      2. In the Usage section, select Temporary data set used for build.
      3. Set the Data Set Characteristics to be appropriate for your system.
    5. Save the translator definition. Repeat step 9 for all other COBOL compilation translators.
  8. Run the z/OS dependency build, and then open the build result.
  9. Click the Compilation tab. All errors and warnings for the compiled COBOL files are shown in the Compile output listing.

Example

Example of warnings in output listing

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki