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
- In the
Enterprise Developer
Server Explorer, expand
Micro Focus Servers.
- Right-click the
localhost server, and click
New Enterprise Server.
- In the
Name field, type
ESAACT.
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.
- 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
VSInstallDir\IDE\Extensions\nnnnnnnn.nnn\Etc\ServerTemplates\.
- Click
CICSTemplate.xml, and click
Open.
This template creates an enterprise server with Mainframe Subsystem Support configured for CICS.
- In the
Associate with projects field, check
AACT to associate the new
enterprise server region with the AACT project.
- Click
OK to create the server.
Server Explorer refreshes the
localhost 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
-
- In
ESCWA, click
NATIVE.
- In the navigation pane, click
.
- Click
Edit on the row for
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.
- In the
Configuration Information field, type:
[ES-Environment]
ES_MFASM_SUPPORT=Y
BASE=C:\tutorials\ASM\AACT
- 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.
- 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.
- Click
.
- Expand
Communications Process 1 and click
TN3270.
- In the
Hostname or IP Address field, type
*.
- In the
Port field, type
9004.
- 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.
- Click
.
- In the
System Initialization Table field, type
ASMSIT.
- In the
Resource Definition File Path field, specify the location of your
dfhdrdat resource definition file:
$BASE\SYSTEM
- In the
Transaction Path field, type
$BASE\loadlib
- In the
File Path field, type
$BASE\loadlib
- In the
Map Path field, replace the existing path with
$BASE\loadlib.
- Click
APPLY.