Tutorials: IMS

Includes tutorials for basic IMS support features, and for using the IMS Segment Layout Editor and IMS Database Editor data tools.

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.
  • You are running the latest version of Micro Focus Enterprise Developer, which has been installed on your local machine using default installation settings.
  • You are using Host Access for the Cloud 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 started the HACloud session server. For instructions on how to do this, see Starting the HACloud Session Server.
  • Enterprise Developer is started on your local machine, and the appropriate Perspective and View are open..
  • Your parent project directory is the default Eclipse workspace, c:\users\username\workspace, where username is your operating system login ID. If you choose to use an alternative parent project directory, adjust the instructions accordingly.
  • Eclipse options are set to build projects automatically.
  • Eclipse Enterprise Server preferences have been set to automatically start and stop the associated enterprise server region when debugging, and dynamic debugging is enabled.
  • You have addressed all of the items in the Before you begin these tutorials section below.

Before you begin these tutorials

Before beginning, 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.
Start Enterprise Developer
Start Enterprise Developer using the default workspace, which is %USERPROFILE%\eclipse-workspace. If you need instructions to get Enterprise Developer started on your local machine, see To start Enterprise Developer.
Note: If Visual Studio prompts you on startup to select an initial action, click Continue without code.
Open the Team Developer Perspective and Application Explorer View in Eclipse
When you start Enterprise Developer for the first time, the Team Developer perspective starts automatically by default, and shows the Application Explorer view. If this is not the case, open the Team Developer perspective as follows:
  1. From the Eclipse IDE, click Open Perspective Open Perspective.
  2. On the Open Perspective dialog box, select Team Developer (default), and then click Open.

In addition, the Enterprise Development Projects system should be loaded in the Application Explorer view. To confirm this:

  • In the Application Explorer view, you should see the Enterprise Developer system. If the system is not shown, to load it:
    1. Right-click in the Application Explorer view, and then click Add System(s).
    2. In the Add System(s) dialog box, select ED System and click OK.
    3. Expand the top-level Enterprise Developer entry in the Application Explorer view.
    4. Right-click Enterprise Development Projects; then click Load Application.
  • Otherwise, expand the Enterprise Developer system. An entry titled Enterprise Development Projects should appear indicating that the system is loaded.
Set Eclipse to build automatically
By default, the Eclipse Build Automatically option is turned on, which means that Eclipse builds a project automatically each time a change is made. To ensure that this Build Automatically is turned on:
  1. From the Eclipse Main Menu, click Project.
  2. Do one of the following:
    • If the Build Automatically menu option has a check mark to its left, it is already turned on. No further action is required.
    • If the Build Automatically menu option does not have a check mark to its left, click the option to turn it on.
Set Host Access for the Cloud TN3270 options
  1. In Eclipse, click Window > Preferences; then expand Micro Focus > Enterprise Server, and click TN3270.
  2. In the right frame, ensure that Host Access for the Cloud is selected, and then click Apply.
  3. Close the Preferences page.
Set Enterprise Server debug options
  1. From the Eclipse main menu, click Window > Preferences.
  2. In the left pane, expand Micro Focus, and click Enterprise Server.
  3. Set the following options to Always, and then click Apply and Close:
    • Automatically start the associated server
    • Automatically stop servers started by Eclipse when closing Eclipse
    • Automatically enable dynamic debugging
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.
  3. Open a terminal and set up the COBOL environment in it.
  4. Run the following to start the session server:
    startsessionserver.sh

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

Sequence

These tutorials build on one another; therefore progress through them 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: