Provides step-by-step instructions to complete the creation and configuration of the ESACCTSV
enterprise server region on which to run the ACCT Web-enabled application.
Start the Server Explorer
The
Server Explorer expandable ribbon is visible in Visual Studio on the top left side of the IDE by default when using
Enterprise Developer. However, if it is not visible:
- In Visual Studio, click
View > Server Explorer.
Attention: You might encounter an
Enterprise Server 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
box is
unchecked, and then click
OK.
Also, if prompted to disable password recovery, click
No.
Create the ESACCTSV
enterprise server region
- In the
Server Explorer, expand
Micro Focus Servers.
- Right-click
localhost, and then select
New Enterprise Server.
- In the
Name field, type
ESACCTSV. This is the name for the new
enterprise server region.
- Click the
browse button that corresponds to the
Template field.
- Double-click
CICSTemplate.xml. This populates the
Template field.
Note: If
CICSTemplate.xml is not on the list, browse to the
Common7\IDE\Extensions\Micro Focus\Enterprise Developer\1.0\Etc\ServerTemplates subdirectory of your Visual Studio installation
to locate the file.
- On the list next to
Associate with projects, check
ACCTWEB.
- Click
OK.
After refreshing, the
Server Explorer shows the
ESACCTSV
enterprise server region listed under
localhost.
Configure the ESACCTSV
enterprise server region
- Start
Enterprise Server Common Web Administration (ESCWA)
-
- From the
Server Explorer, right-click
Micro Focus Servers; then select
Administration. This starts the
ESCWA UI in a browser outside of the IDE.
- Click
Native.
- In the navigation pane, expand
to see the
ESACCTSV
enterprise server region in the list of servers.
- Define environment variables
-
- On the
Region and Server List page in the right pane, hover the row for the
ESACCTSV entry in the list of servers, and click
Edit
.
This action opens the
General Properties page of the server's properties.
- Type the following into the
Configuration Information field:
[ES-Environment]
This indicates that the information that follows defines environment variables that are specific to the region. Next, you
define an environment variable to represent your project directory.
- On the next line down, type:
IDE_PROJECT_LOC=c:\tutorials\CICS\ACCTWEB
To use a defined environment variable in the value definition of another environment variable or as the value in other
Enterprise Server Administration fields, you precede the name of the variable with a dollar sign ($). You can use the IDE_PROJECT_LOC environment
variable to help define the next variable.
- On the next line down, type:
ES_DOCTEMPLATE_PATH=$IDE_PROJECT_LOC\html
This variable is used in the template definition for the DOCUMENT created in this tutorial: ACCTMP1, defined in the DFHWEB
resource group.
Note: When you create your
enterprise server region using the CICS template as you have done in this tutorial,
Enterprise Server generates and stores several environment variables based on the information in the associated project. For example, in this
region, the IDE_LOADLIB environment variable has been generated and is set to the directory you defined as the output directory
in the ACCTWEB
Enterprise Developer project. Therefore, IDE_LOADLIB is equal to the
loadlib subdirectory of your project directory, or
c:\tutorials\CICS\. The definitions for generated environment variables do not show in the
Configuration Information field, however.
- Click
Apply.
- Set the location of your resource definition file
- Earlier in this tutorial, you imported the resource definition file,
dfhdrdat, as you imported the demonstration application. Now you need to tell the ESACCTSV region where to find that file.
- Click
CICS in the taskbar at the top of
General Properties page to access the
CICS Configuration page.
- In the
Resource Definition File Path field, type:
$IDE_PROJECT_LOC\system
- Click
Apply.
- Set the TN3270 listener port
- In this tutorial, you use the embedded
Rumba+ Desktop TN3270 emulator to access the CICS application. To enable communication with your
enterprise server region, you need to set a port number where
Enterprise Server listens for TN3270 messages.
- In the taskbar at the top of the right pane, click the
General drop-down arrow, and then select
Listenersfrom the list.
- Click the
TN3270 listener on the
Communication Processes page.
- In the properties for the listener field, specify
5239 in the
Port field.
- Click
Apply.