Configuring an Enterprise Server for IMS

Create an MSS-enabled Enterprise Server

1. Open Server Explorer.

   If it is hidden, display it by choosing View > (Other Windows >) Server Explorer.

2. Expand Micro Focus Servers.
3. Right-click localhost, and click New Enterprise Server.

   The Create New Enterprise Server dialog box appears.

4. Type IMSDEMO in the Name field.
5. Leave the 64-bit box unchecked.
6. Click the browse button next to the Template field.

   This opens the location of the Enterprise Developer server templates.

7. Select IMSTemplate.xml, and click Open.
8. Click OK.

   The Output window displays a notification that the server has been created.

9. In Server Explorer, expand localhost to check that the IMSDEMO server has been added to localhost.

Open Enterprise Server Administration

1. In Server Explorer, right-click Micro Focus Servers.
2. Select Administration 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:

   [ES-Environment]
   IMSPROJ=c:\tutorials\ims

   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

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.

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

To associate your project with the IMS configured server that you created, IMSDEMO:

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.