Tutorial: Compiling, Linking, and Debugging a CICS-based Open PL/I Application

Shows you how to compile, link, and debug a CICS-based Open PL/I application using the Open PL/I CICS preprocessor.

Prerequisites

Review the Assumptions and Before you begin a tutorial sections in the Tutorials: Interface Mapping Toolkit topic to ensure your Enterprise Developer environment is set up properly. In addition, you need to configure options for the Rumba+ Desktop, which is the integrated TN3270 emulator used with this tutorial:

  1. In Visual Studio, click Tools > Options; then expand Micro Focus Tools and click TN3270 Display.
  2. Note that Rumba (Desktop) is selected. The IDE uses the standalone Rumba+ Desktop to run applications.

    The Rumba (Embedded) option is disabled as the embedded view is not available in Visual Studio 2022. It is available in Enterprise Developer for Visual Studio 2017 and 2019.

  3. Close the Options page.

Demonstration Application

The files for this demonstration are supplied with the product samples installed by default in the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\CICSDemo folder.

The CICS solution contains the three projects - CICS, CICS-Includes, and Subroutines.

Sequence

To complete this tutorial, progress through these topics in the order presented here. The bottom of each topic provides Next topic and Previous topic navigational links to help you proceed in the proper sequence:

  1. Import and Configure the STAFF Enterprise Server Instance
    Walks you through the process of importing the pre-configured STAFF enterprise server instance and reviewing its settings.
  2. Prepare the CICS Solution
    Walks you through the process of opening the existing CICS solution in Visual Studio, and reviewing its configuration.
  3. Prepare to Debug the CICS Application
    Guides you through the process of associating the STAFF enterprise server instance with the CICS project, and building the application for debugging.
  4. Debug the CICS Project
    Shows how to use the debugger to walk through an employee directory PL/I sample application. It explains pertinent parts of the application and debugger functionality.
Parent topic: Tutorials: Open PL/I