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.

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 the Server Explorer view is not visible, click Window > Show View > Server Explorer.

    Attention: You might encounter an ESCWA Sign On dialog box as you perform the steps required to create, configure, start, or stop an enterprise server instance from the Server Explorer. If you do, ensure that the Server requires credentials, Use specific server credentials, or Server is secured , and the Store credentials boxes are unchecked, and then click OK. Also, if prompted to disable password recovery, click No.
  2. In the Server Explorer view, expand Local [localhost:10086] and right-click Default [127.0.0.1:86], then select New > Enterprise Server.

    This opens the New Enterprise Server dialog box.

  3. In the Name field, type ESAACT.
  4. Click Browse next to the Template field.

    This opens the Select template file dialog box. The default location of the Enterprise Server templates shipped with Enterprise Developer is in %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc\ServerTemplates.

  5. Click CICSTemplate.xml, and click Open.

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

  6. In the Associate with projects field, check AACT to associate the new enterprise server region with the AACT project.
  7. Click Finish to create the server.

    Server Explorer refreshes the Default [127.0.0.1:86] node to display the ESAACT server.

Configure the ESAACT enterprise server region in ESCWA

Start Enterprise Server Common Web Administration (ESCWA)

See To Start ESCWA for more information on starting ESCWA.

Set general properties
  1. In ESCWA, click Native.
  2. In the navigation pane, click Directory Servers > Default > ESAACT.

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

  3. In the Configuration Information field, type:
    [ES-Environment]
    ES_MFASM_SUPPORT=Y
    BASE=C:\Users\username\workspace\AACT
  4. Optionally, you can add a description for the ESAACT enterprise server region. To do this, in the Description field, type a description of the new enterprise server. For example, Assembler AACT Tutorial.
  5. To save the changes, click Apply.
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 General > Listeners.
  2. Expand Communications Process 1 and click TN3270.
  3. In the Hostname or IP Address field, type *.
  4. In the Port field, type 9004.
  5. Click Apply.
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. Click CICS > Configuration.
  2. In the System Initialization Table field, type ASMSIT.
  3. In the Resource Definition File Path field, specify the location of your dfhdrdat resource definition file:

    $BASE\SYSTEM

  4. In the Transaction Path field, type $BASE\loadlib
  5. In the File Path field, type $BASE\loadlib
  6. In the Map Path field, replace the existing path with $BASE\loadlib.
  7. Click Apply.