Set Up the ESAACT Enterprise Server Region

Provides step-by-step instructions that guide you through the creation and configuration of the ESAACT enterprise server region on which to run the AACT application.
Restriction: This topic applies to Windows environments only.

To successfully run your new AACT application, you must first create a new enterprise server region configured for Mainframe Subsystem Support, and with Assembler enabled.

Create the ESAACT enterprise server region

  1. In Eclipse, open the Server Explorer view.

    If it is not visible, to display it click Window > Show View > Other, type Server Explorer, select the view and click OK.

  2. Right-click Local [localhost:86] in Server Explorer and click New > Enterprise Server.
  3. In the New Enterprise Server dialog box, specify ESAACT in the Name field.
    Note: At some point in the process of creating a new enterprise server region, you might be prompted to provide connection details by an Enterprise Server Sign On dialog box. This is a standard security dialog box. Click OK without specifying any sign-on details. Also, if prompted to disable password recovery, click No.
  4. Click the browse button on the row of the Template field.

    This opens the location of the Enterprise Server templates shipped with Enterprise Developer - by default, these are in %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc\ServerTemplates.

  5. Select the CICSTemplate.xml file, and click Open.

    This template creates an enterprise server with Mainframe Subsystem Support configured for CICS.

  6. Check the AACT box to associate the new enterprise server region with the AACT project.
  7. Click Finish to create the server.

    Server Explorer refreshes the localhost node to show the ESAACT server.

Configure the ESAACT enterprise server region

Start Enterprise Server Administration
  • In the Server Explorer, right-click Local [localhost:86] and click Open Administration Page.

    This opens the home page of Enterprise Server Administration in the IDE.

Set general properties
  1. Click Edit on the row for ESAACT.

    This opens the Server > Properties > General page for the ESAACT server where you can set the ES_MFASM_SUPPORT environment variable, which enables Assembler for CICS regions.

  2. In the Configuration Information field, type: 
    [ES-Environment]
ES_MFASM_SUPPORT=Y

    On this same page, you can add a description for the ESAACT enterprise server region.

  3. In the Description field, type a description of the new enterprise server, for example Assembler AACT Tutorial.
  4. Click Apply at the bottom of the page.
Configure the TN3270 listener
The endpoint address for the TN3270 listener defines the port number used when you connect to the enterprise server region using the Rumba+ TN3270 emulator.
  1. Click the Listeners tab.
  2. Click Edit on the row for the TN3270 listener.
  3. Change the Endpoint Address field to *:9004 and click OK.
Set Assembler properties
The template you used to create the ESAACT enterprise server region sets properties for CICS applications. You need to reset these properties for Assembler applications.
  1. Go to the Server > Properties > MSS > CICS tab.
  2. Type ASMSIT into the System Initialization Table field.
  3. In the Map Path field, replace the existing path with $IDE_LOADLIB.
  4. In the Resource Definition File Path field, specify the location of your dfhdrdat resource definition file:

    c:\tutorial\ASM\AACT\system

  5. Click Apply.
Close Enterprise Server Administration
  • In Eclipse, close the Micro Focus Enterprise Server Administration tab.
Parent topic: Tutorial: Assembler Support
Previous topic: Set Up the AACT Project
Next topic: Run the AACT Transaction