Tutorials: CICS

Includes tutorials that cover basic CICS support, Web-enabled CICS support, and CICS Web services.

Assumptions

These tutorials are written from the perspective that all of the following is true. Specific instructions for setting up your environment to adhere to these assumptions is found in the Before you begin these tutorials section that follows:

  • Windows File Explorer is set to show file names and extensions.
  • Micro Focus Enterprise Developer has been installed on your local machine using default installation settings.
  • Enterprise Developer is started on your local machine.
  • Your parent project directory is c:\tutorials\CICS. If you choose to use an alternative parent project directory, adjust the instructions accordingly.
  • You are using the Micro Focus Host Access for the Cloud (HACloud) TN3270 emulator when instructed to run an application or transaction in TN3270 mode. If you choose to use an alternative emulator, adjust the instructions to accommodate your software.
  • You have addressed all of the items in the Before you begin a tutorial section below.

Before you begin a tutorial

Before beginning a CICS tutorial, be sure you have addressed each of the following items:

Set Windows File Explorer options
These tutorials assume that your Windows File Explorer options are set to use the Details layout, and to show file name extensions. See your Windows documentation for more information.
Create a parent project directory
Create a directory in which to store the project files imported or created while completing this tutorial, which cites a parent project directory of c:\tutorials\CICS.
Start Visual Studio
If you need instructions to get Visual Studio started on your local machine, see To start Visual Studio.
Note: If Visual Studio prompts you on startup to select an initial action, click Continue without code.
Set Host Access for the Cloud TN3270 options
  1. In Visual Studio, click Tools > Options; then expand Micro Focus Tools and click TN3270 Display.
  2. In the right frame, ensure that Host Access for the Cloud is selected, and then click OK.
  3. Close the Options page.
Start the HACloud Session Server

Ensure that you have updated the Micro Focus HACloud service property to start up automatically. For instructions on how to do so, see Starting the HACloud Session Server.

To start the HACloud session server on Windows:

  1. Ensure that the installed Java is added to the PATH environment variable.
  2. Start the Enterprise Server region that runs the application you want to connect to.
  3. Start either the 32-bit or 64-bit Enterprise Developer command prompt or Enterprise Server command prompt - this must match the working mode, 32 or 64-bit, of the JRE you have installed.
  4. Type startsessionserver at the command prompt, and press Enter.

    Check the console for the messages that the Micro Focus HACloud Session Server has started.

To start the HACloud session server on UNIX:

  1. Ensure that the installed Java is added to the PATH environment variable.
  2. Start the Enterprise Server region that runs the application you want to connect to.

Sequence

These CICS tutorials are not interdependent and may be done in any order: