Chapter 2: Configure Enterprise Server/MTO

You need to do the tutorials in this book in the order shown in the section Order of the Tutorials in the chapter Introduction to the CICS Extension Tutorials earlier in this book.

Overview

In this tutorial, we create an enterprise server with the Mainframe Transaction Option (MTO), configure it for our ACCT application, and run the application under Enterprise Server/MTO.

Preparation

Be sure you have installed and configured all of the prerequisite software listed in the section Prerequisites in the chapter Introduction to the CICS Extension Tutorials.

Create an Enterprise Server

Enterprise Server comes with a server named ESDEMO. It is not configured for Mainframe Transaction Option. Therefore, we must create a new Enterprise Server instance configured for MTO for our CICS application.

1. To start Enterprise Server, from your desktop, click Start > Programs > Micro Focus Net Express > Configuration > Enterprise Server Administration. Alternatively, start Enterprise Server from a browser using the http://localhost:86 address.
2. On the Enterprise Server Administration home page, click Add.
3. In the Server Name field, type CICSEXT.
4. In the Server Type group, click Micro Focus Enterprise Server with Mainframe Transaction Option.
5. Click Next.
6. In the Service Execution Processes (SEP) field, change the number to 3. Because our service interface is a screen-based CICS service, we need at least 3 SEPs for it to run smoothly.
7. In the Creation Options group, uncheck Create ISC listener. We will be using a TN3270 listener exclusively.
8. In the using port field to the right of the Create TN3270 listener radio button, type 9004.
9. In the Description field, type a description of the new Enterprise Server, for example, CICS Extension Tutorial.
10. Click Add.

The following shows the Enterprise Server Administration home page with your new CICSEXT Enterprise Server on the list of available Enterprise Servers.

Figure 2-1: CICSEXT Enterprise Server

Configure the Enterprise Server

Now that we have created an enterprise server instance for our CICS application, we need to configure the Mainframe Transaction Option that drives CICS applications. The ACCT application is already compiled, so configuration is minimal.

1. On the Enterprise Server Administration home page, click the Edit button that corresponds to the CICSEXT Enterprise Server.
2. Click MTO.
3. Be sure that Mainframe Transaction Option enabled is checked.
4. In the System Initialization Table field, type IMTKCICS.
5. Click Apply.
6. On the list that appears on the left-hand side of the page, click Home to return to the Enterprise Server Administration Home page.
7. In the row that corresponds to the CICSEXT Enterprise Server, click the Details button that corresponds to 3 Listeners. The listeners represent the three types of services we can run using this Enterprise Server.
8. In the Process drop-down list, click All. This enables you to see a list of listeners and edit them as necessary.
9. Click the Edit button that corresponds to Web Services.
10. Change the contents of the Endpoint Address field to *:9003.
11. Click OK.
12. On the list that appears on the left-hand side of the page, click Home to return to the Enterprise Server home page.

Start the Enterprise Server

To run the application, we need to start the enterprise server instance that we just created and configured.

1. On the Enterprise Server Administration home page in the row that corresponds to the CICSEXT Enterprise Server, click the Start button that appears in the column labeled Current Status. This displays a daemon and starts your CICS region.
2. Minimize the daemon.

The following shows the Enterprise Server Administration home page after the Enterprise Server for CICSEXT has been started.

Figure 2-2: Enterprise Server Administration Home Page

Before Continuing...

If you want to take a break, you can stop the CICSEXT enterprise server and close the Enterprise Server Home page. If you do, you will need to re-start the CICSEXT enterprise server in the next tutorial.

Copyright © 2007 Micro Focus (IP) Ltd. All rights reserved.