Configure Enterprise Server/MSS

Overview

In this tutorial, you create an enterprise server with the Mainframe Subsystem Support (MSS), configure it for the ACCT application, and run the application under Enterprise Server/MSS.

Create an Enterprise Server

Server Enterprise Edition comes with a pre-configured enterprise server named ESDEMO. However, it is not configured for Mainframe Subsystem Support (MSS). Therefore, you must create a new enterprise server instance configured for MSS for the CICS application.

1. Open the Server Explorer window in the IDE.

   If it is hidden, click View > Server Explorer.

2. In Server Explorer, right-click Micro Focus Servers and choose Administration from the context menu.

   This opens the home page of Enterprise Server Administration (also called MFDS) in the IDE.

   Alternatively, you can open the Enterprise Server Administration from the Start menu - click Start > All Programs > Micro Focus Studio Enterprise Edition x.x > Configuration > Enterprise Server Administration. This opens Enterprise Server Administration in a browser outside of the IDE.

3. Click Add.
4. In the Server Name field, type ACCT and click Next.
5. Choose 32-bit for the Working mode option.
6. Click Next.
7. In the Server Type group, select Micro Focus Enterprise Server with Mainframe Subsystem Support.
8. Click Next.
9. In the Creation Options group, enter 5239 in the Using port field. This will be the port number to be used to customize the 3270 emulator.
10. In the Description field, type a description of the new Enterprise Server, for example ACCT demo.
11. Click Add.

    This displays the Enterprise Server Administration home page with your new ACCT server in the list of the available enterprise servers.

Configure the Enterprise Server

Now that you have created an enterprise server instance for our CICS application, you need to configure the Mainframe Subsystem Support 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 ACCT enterprise server.
2. Click the General tab.
3. Type the following in the Configuration Information text box:

   [ES-Environment]
   ESPROJ=c:\tutorials\ACCT
   

   You are going to reuse this environment variable to configure your enterprise server further.

4. Click Apply.
5. Click the MSS tab.
6. Ensure that Mainframe Subsystem Support enabled is checked.
7. Enter the following details in the fields on the CICS tab:

   System Initialization Table	DEMOSIT
   Transaction Path	$ESPROJ\loadlib
   File Path	$ESPROJ\data
   Map Path	$ESPROJ\loadlib
   Resource Definition File Path	$ESPROJ\system

8. Click Apply.
9. On the list at the left of the page, click Home to return to the Enterprise Server Administration Home page.

Create and Upgrade the CICS Resource Definition File

1. Open the Net Express command prompt by choosing Start > Programs > Micro Focus Studio Enterprise Edition > Compatibility Tools > Net Express 32-bit Command Prompt.
2. Create a CICS resource definition file using following command:

   caspcrd /c /dp=c:\tutorials\acct\system

3. Upgrade the resource definition file by running the following command:

   caspcupg /dp=c:\tutorials\acct\system

Start the ACCT Enterprise Server

You need to start the enterprise server instance that you have created and configured.

1. Ensure ESDEMO and any other servers that use the TN3270 port are not running. If any of them is running, stop it before starting the ACCT server.

   This is because they use the same port the ACCT server uses for one of their listeners.

2. In Server Explorer, right-click ACCT in the list of servers and then click Start.