Configuring an Enterprise Server for IMS

Open Enterprise Server Administration

1. In Server Explorer, right-click on Micro Focus Servers.
2. Select Administration from the context menu.

Create an MSS-enabled Enterprise Server

1. On the Home page of Enterprise Server Administration, click Add at the bottom of the table of servers.
2. On the first Add server page:
   1. Type IMSDEMO in Server Name.
   2. Make sure the Working Mode is set to 32-bit.
   3. Click Next.
3. On the second Add server page:
   1. Click Micro Focus Enterprise Server with Mainframe Subsystem Support.
   2. Click Next.
4. On the third Add server page:
   1. In the Creation Options group, make sure Create TN3270 listener is checked and specify a port number. Do not specify a port smaller than 1025. Use a greater number such as 5039 instead.
   2. In the Configuration Information field, enter the following two lines:

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

      Setting the environment variable IMSPROJ enables you to specify the paths to any subfolder in your project as $IMSPROJ\subfolder.

   3. Type Server for IMS in Description.
   4. Click Add.

      The Home page is redisplayed, and a row for the IMSDEMO enterprise server is shown in the table of servers.

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 Show Local Console.
3. Check Allow Dynamic Debugging.
4. Click Apply.
5. Click the MSS, IMS and General tabs.
6. Ensure that Mainframe Subsystem Support enabled is checked.
7. Check IMS enabled.

   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 Visual Studio. 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 IMSPROJ: $IMSPROJ\loadlib.
2. Click Apply.
3. Click the Server, Properties, MSS, IMS, TM and General tabs.
4. In the MFS path field, enter $IMSPROJ\loadlib.
5. In the Application Path field, enter $IMSPROJ\loadlib.
6. In the Transaction definition file directory field, enter $IMSPROJ\loadlib.
7. Click Apply.
8. Click the Server, Properties, MSS, IMS, and DB tabs.
9. In the Database path field, enter $IMSPROJ\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:

1. Click the Server, Properties, MSS, IMS, TM and MPR 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.

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 > your project.

Start the Enterprise Server

1. In Server Explorer, right-click IMSDEMO.
2. Choose Start from the context menu.

You can verify that MSS and IMS are enabled by watching the start-up messages in the Enterprise Server Console Daemon window. Messages should also appear indicating that the message processing region has started:

Deploy to Enterprise Server

You do not need to deploy the application to Enterprise Server as you configured IMSDEMO to search for the required files in your Visual Studio project directory. Enterprise Server finds the application files that it needs to run using the region IMS configuration entry, MSS|IMS|TM Application path: $IMSPROJ\loadlib.