Create an Enterprise Server

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

  1. In Enterprise Developer Server Explorer, expand Micro Focus Servers.
  2. Right-click the localhost server, and click New Enterprise Server.
  3. In the New Enterprise Server dialog box, specify AACT 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 VSInstallDir\Common7\IDE\Extensions\Micro Focus\Visual COBOL SOA\1.0\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 OK to create the server.

    Server Explorer refreshes the localhost node to show the AACT server. You now need to configure the server.

  8. In Server Explorer, right-click Micro Focus Servers and click Administration.

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

  9. Click Edit on the row for AACT.
  10. You need to set these two environment variables:
    BASE=c:\tutorials\AACT Provides your enterprise server with the path to your project files
    ES_MFASM_SUPPORT=Y Enables Assembler for CICS regions
    To do this, type the following into the Configuration Information field on the General page:
    [ES-Environment]
    BASE=c:\tutorials\AACT
    ES_MFASM_SUPPORT=Y
  11. Click Apply.
  12. Click the Listeners tab.
  13. Click Edit on the row for the TN3270 listener.
  14. Change the Endpoint Address field to *:9004 and click OK.

    This is the port number used when you connect to the enterprise server with your TN3270 emulator.

  15. Click the Server tab.
  16. In the Description field, type a description of the new enterprise server, for example Assembler AACT Tutorial.
  17. Click OK at the bottom of the page, and then click Home in the upper left corner.

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