Set Up the ESACCTSV Enterprise Server Region

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

  1. In the Server Explorer, expand Micro Focus Servers.
  2. Right-click localhost, and then select New Enterprise Server.
  3. In the Name field, type ESACCTSV. This is the name for the new enterprise server region.
  4. Click the browse button that corresponds to the Template field.
  5. 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.
  6. On the list next to Associate with projects, check ACCTWEB.
  7. 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 Directory Server > Default to see the ESACCTSV enterprise server region in the list of servers.
Define environment variables
  1. 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 Edit.

    This action opens the General Properties page of the server's properties.

  2. 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.

  3. 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.

  4. 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.
  5. 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.
  1. Click CICS in the taskbar at the top of General Properties page to access the CICS Configuration page.
  2. In the Resource Definition File Path field, type:
    $IDE_PROJECT_LOC\system
  3. 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.
  1. In the taskbar at the top of the right pane, click the General drop-down arrow, and then select Listenersfrom the list.
  2. Click the TN3270 listener on the Communication Processes page.
  3. In the properties for the listener field, specify 5239 in the Port field.
  4. Click Apply.