Configuring an Enterprise Server for IMS

This section shows the steps to configure an enterprise server so that you can run the IMS TM application.

Create an MSS-enabled Enterprise Server

  1. Open Server Explorer.

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

  2. Right-click Local [localhost:86], and click New > Enterprise Server
  3. Type IMSDEMO in the Name field.
  4. Leave the 64-bit box unchecked.
  5. Click the browse button next to the Template field.

    This opens the location of the Enterprise Developer server templates.

  6. Select IMSTemplate.xml, and click Open.
  7. In the Associate with projects field, check IMS.
  8. Click Finish.

    The Console view displays a notification that the server has been created.

Open Enterprise Server Administration

  1. In Server Explorer, right-click the host server.
  2. Select Open Administration Page from the context menu.

Enable IMS for Your Enterprise Server

To enable IMS support for the IMSDEMO enterprise server:

  1. Click Edit next to the IMSDEMO row in the table of servers.

    The Edit page that appears contains a hierarchy of tabs and you should see open the following tabs: Server, Properties, General.

  2. Check Allow Dynamic Debugging.
  3. In the Configuration Information field, type:

    This creates an environment variable and sets it to point to the location of your project. Note that ES-Environment is case sensitive.

  4. Click Apply.
  5. Click the MSS, IMS and General tabs.
  6. Ensure that Mainframe Subsystem Support enabled is checked.
  7. Ensure IMS enabled is checked as well.

    This specifies that the IMSDEMO enterprise server can use the IMS support. Do not click Apply yet as there is more to do on this page.

Configure the Enterprise Server

For this demonstration you use the IMS Mainframe Subsystem Application that you created in the IDE. The build produced the required DBDGENs, IMSGENs, MFSGENs and PSBGENs as well as the .dll files in the loadlib subfolder of your project. You need to configure the IMSDEMO enterprise server to look for the .dll files and the IMS gen and database files in the loadlib subfolder of your project

Note: When you create an Enterprise Server using the IMSTemplate template, as you have for this tutorial, most of these fields are completed automatically; however, if any entries are missing or incorrect, complete the fields as specified here.

To specify the locations of the required files:

  1. In the GEN file directory field, specify the subfolder in which all gen files have been created using the environment variable IDE_LOADLIB: $IDE_LOADLIB.
  2. Type $IDE_LOADLIB in the Configuration directory and ACB file directory fields.
  3. Click Apply.
  4. Click the Server, Properties, MSS, IMS, TM and General tabs.
  5. In the MFS path field, enter $IDE_LOADLIB.
  6. In the Application path field, enter $IDE_LOADLIB.
  7. Click Apply.
  8. Click the Server, Properties, MSS, IMS, DB and General tabs.
  9. In the Database path field, enter $IDE_LOADLIB.
  10. Click Apply to save the changes.

Configure the MSS

To start IMS, an enterprise server needs to use the supplied CICS IMSSIT:

  1. Click the Server, Properties, MSS and CICS tabs.
  2. Specify IMSSIT in System Initialization Table.
  3. In the Resource Definition File Path field, enter the path to the Resource Definition File that you updated in the section Updating the Resource Definition File: $IMSPROJ\system.
  4. Leave the other fields blank.
  5. Click Apply to save the changes.

Define an Automatic Message Processing Region

You need at least one message processing region (MPR) to run an IMS application in an enterprise server.

To specify a message processing region for the IMSDEMO enterprise server, if it has not already been defined:

  1. Click the Server, Properties, MSS, IMS, TM and MPRs tabs.
  2. Click Add.
  3. In the Name field, enter: MPR01.
  4. In Transaction Class, enter: 001.
  5. In Description, enter: MPR for class 1.
  6. Click Add.
  7. Click Home at the upper left corner to return to the Home page of Enterprise Server Administration.
Note: You can specify a maximum of four classes in the Transaction Class field. You must separate each class by a comma. The classes you specify must be less than 32-bytes long. If you specify more than four classes only the first four are used. When you start the enterprise server instance you see a message (CASIP0013I) in the console.log that shows which classes have been registered for use.

Specify a Listener

  1. On the Home page of Enterprise Server Administration, click Edit on the row for IMSDEMO.
  2. Click the Listeners tab at the top, and then click Edit for the TN3270 listener.
  3. In the Endpoint Address field, type *.5239 which will be the port for this server.
  4. Click OK.

Associate Your Project with the IMS Configured Enterprise Server

You associated your project with the server when you created it, but if you missed doing that, you can associate the project as follows:

  1. In Server Explorer, right-click IMSDEMO.
  2. Choose Associate with project > ims.

Start the Enterprise Server

To start the IMSDEMO server:

  1. In Server Explorer, right-click IMSDEMO, and click Start.
  2. In the Enterprise Server Sign On dialog box, click OK without specifying any details.
  3. In Server Explorer, right-click IMSDEMO, and click Show Console log.

    This loads the server log in the Console view to enable you to monitor the start-up process of the IMSDEMO server and verify that MSS and IMS are enabled.