Configure the ACCTCLNT Region

Now that you have created an enterprise server region for the CICS application, you need to start Enterprise Server Administration, define environment variables, start the region, and add resources.
Start Enterprise Server Administration
  • From Server Explorer, right-click Local [localhost:86]; then select Open Administration Page. This starts Enterprise Server Administration.
    Note: If a Secure Storage prompt appears, click No.

    On the Home page, you should see the ACCTCLNT enterprise server region listed.

Define environment variables
  1. On the Enterprise Server Administration Home page, click the Edit button that corresponds to the ACCTCLNT region.
  2. On the Server, Properties, General tab, 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=IDE_PROJECT_LOC=EclipseWorkspacePath\ACCTCLNT

    Where EclipseWorkspacePath is the fully qualified path to your Eclipse workspace.

    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 ACCTCLNT Enterprise Developer project. Therefore, IDE_LOADLIB is equal to the loadlib subdirectory of your project directory, or EclipseWorkSpacePath\ACCTCLNT\loadlib. 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 copied the resource definition file, dfhdrdat, from the Enterprise Developer installation area to your project area. Now you need to tell the ACCTCLNT region where to find that file.
  1. On the Server, Properties, General tab, click the MSS and then CICS tabs.
  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 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. From the Server, Properties, General, MSS, CICS tab, click the Listeners tab at the top of the page.
  2. Click the Edit button that corresponds to TN3270.
  3. In the Endpoint Address field, replace the second asterisk (*) with 5239 so that the entry reads *:5239.
  4. Click Apply.
Parent topic: Create and Configure an Enterprise Server Region