Set Up the IMSDEMO Enterprise Server Region

Provides step-by-step instructions that guide you through the process of creating and configuring an enterprise server region on which to run the MFDEMO IMS application.

Create the IMSDEMO enterprise server region

In this section, you use a provided template to create an MSS- and IMS-enabled enterprise server region configured with the most common features required to run an IMS application or service.

  1. In Eclipse, open the Server Explorer.

    If it is hidden, display it by choosing Window > Show View > Server Explorer.

    Attention: You might encounter an ESCWA Sign On dialog box as you perform the steps required to create, configure, start, or stop an enterprise server region from the Server Explorer. If you do, ensure that the Server requires credentials, Use specific server credentials, or Server is secured , and the Store credentials boxes are unchecked, and then click OK. If asked to provide a password, enter your UNIX logon password.
  2. Expand Local [localhost:10086], right-click Default [127.0.0.1:86], and click New > Enterprise Server
  3. Type IMSDEMO into the Name field.
  4. Click the Browse button associated with the Template field.

    By default, this opens to the location of the Enterprise Server template files.

    Note: The default location for Enterprise Server templates is $COBDIR/etc/ServerTemplates. If necessary, browse to this location.
  5. Double-click IMSTemplate.xml to select it.
  6. In the Associate with projects field, check the entry that matches your project name.
  7. Click Finish.

Start the Enterprise Server Common Web Administration (ESCWA)

  • In the Server Explorer, right-click Local [localhost:10086]; then click Open Administration Page.

    This opens the Enterprise Server Common Web Administration (ESCWA) in a browser outside of the IDE.

Configure IMSDEMO

An enterprise server region created using the IMSTemplate template, as has been done for IMSDEMO, is pre-configured with the most common settings used to run IMS applications. Most of the fields and controls cited in this section have been populated with default settings. Most paths are represented by a variable that starts with a dollar sign ($). These are Enterprise Server environment variables, each resolving to a path derived from your IMSSupport project properties. Because you set your project properties to use the loadlib project folder for all output, each of these variables that point to an output folder resolve to your project's loadlib directory. Later in the tutorial, you can look at the configuration settings to see the actual value of each variable.

Tip: For a description of each field and control on any page of Enterprise Server Common Web Administration, click Help icon in right upper area of the UI.
Edit the IMSDEMO region
  1. In ESCWA, click Native.
  2. In the navigation pane, click Directory Servers > Default
  3. Click IMSDEMO.

    This opens the General Properties page.

Set general settings
  1. In the Startup Options group, check Allow Dynamic Debugging.
  2. In the Region Features group, ensure that MSS Enabled and IMS Enabled are checked.
  3. In the Additional group, type IMS Tutorial in the Description field.
  4. Click Apply.
Verify and set IMS general settings
  1. In the menu bar, click IMS > Configuration This opens the IMS Configuration page.
  2. Verify the following:
    Codeset Bias ASCII
    ACB File Directory $IDE_IMSGENPATH
  3. In the GEN File Directory field, replace the value with $IDE_LOADLIB.
  4. Click Apply.
Verify general transaction manager settings
  1. On the IMS Configuration page, click the TM tab.
  2. Verify the following:
    Application Path $IDE_LOADLIB
    MFS Path $IDE_MODPATH
Verify the automatic message processing region
To run an IMS application in an enterprise server region, you need at least one specialized service execution process (SEP) called a message processing region (MPR). To specify that a message processing region starts each time an enterprise server starts, it must be included in a resource group that is specified by the startup list in the SIT used by the enterprise server.
Note: If you do not see your MPR listed, try refreshing your browser.
  1. In the Message Processing Regions section, verify the following:
    Name MPR01
    Class(es) 1
    Description MPR for class 1
Verify the database path
  1. On the IMS Configuration page, click the DB tab.
  2. Verify that Database Path is set to $IDE_IMSDATA.
Define resources
The resource definition file that you registered previously in this tutorial enables you to switch back and forth between CICS and IMS modes. The configuration settings for this and the system initialization table (SIT) used with IMS are on the CICS tab associated with mainframe subsystem configuration.
  1. Click CICS > Configuration.

    This takes you to the CICS Configuration page.

  2. Verify the following:
    System Initialization Table IMSSIT
    Transaction Path $IDE_LOADLIB
  3. In the Resource Definition File Path field, type the full path to your project's system directory.
  4. Click Apply.
Configure the TN3270 listener

You need to specify a communications port to be used by the TN3270 listener to accept incoming client requests.

  1. Click General > Listeners

    This takes you to the Communications Server Properties page.

  2. Scroll down to the Listeners section.
  3. Click Edit (Edit) on the row of the TN3270 listener.
  4. Change the contents of the Port field to 9004.
  5. Click Apply.

Start IMSDEMO

  1. On the Server Explorer inside the IDE, expand Local [localhost:10086] > Default [127.0.0.1:86] to see a list of available enterprise server regions.
  2. Right-click IMSDEMO; then click Start from the context menu.
    Note: The first time you start the IMSDEMO region, the Enterprise Server Sign On dialog box prompts you to enter connection details. Because the server is not secured, just click OK to continue.

    The Console view shows the progress of the Start command.

View environment variable values

The Enterprise Server Common Web Administration enables you to see the full configuration for your enterprise server region. You can view the values for the environment variables specified in your configuration as follows:

  1. Once IMSDEMO has started, return to ESCWA.
  2. In the navigation pane, click Directory Servers > Default > IMSDEMO.
  3. Click Monitor > Environment Variables.
  4. Scroll down the list of environment variables, and note the values for all variables that begin with IDE.
  5. When you are finished, close ESCWA.