Configure an Enterprise Server

This tutorial uses a preconfigured enterprise server rather than a manually-created enterprise server.

To import the preconfigured enterprise server:

  1. In the IDE, from Server Explorer, right-click Micro Focus Servers, and click Administration. The Enterprise Server Administration page is displayed within the IDE.
  2. On the Home page of the Enterprise Server Administration, under Actions at the left, click Import. The first Import server information screen appears.
    Note: These settings are only valid if you have installed Enterprise Developer to the default directory. Do the following if you have installed to a different location or a drive other than the default:
    • Click the General tab and ensure that the CICSDEMO variable specified in the Configuration Information field points to the location of the CICSDEMO sample in the PLI-VS subfolder in the location of the samples.
  3. Enter the path where the predefined server data is stored. By default, this is %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\CICSDemo\CICS\staff_def.
    Important: This tutorial shows how to compile the sample application for 32-bit. If you want to compile it for 64-bit, you must import the 64-bit version of the STAFF server which is supplied in the \PLI-VS\CICSDemo\CICS\staff64_def subfolder. That server is also configured to look for the output files in the \bin\x64\Debug subfolders of the sample's projects.
  4. Click Next.
  5. Continue to click Next through the Import server information screens. On the final Import server information screen, click OK.

The selected server appears in the Enterprise Server Administration Home page server table. The server is named STAFF (or STAFF64 for the 64-bit application).

  1. Click Edit to the left of the row for the STAFF server to review the server settings and make corrections in case the information differs from the one in this tutorial. Ensure you click Apply on each page where you make any changes.
  2. In the General tab, edit the supplied details in the Configuration Information field to provide the correct path for the CICSDEMO environment variable:
    [ES-Environment]
    CICSDEMO=%PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\CICSDEMO
    ES_SSTM_CICS="$CICSDEMO\CICS\sstmcics.jcl"
    CODEWATCH_NOTIF=Y
  3. On the MSS tab, click CICS, ensure that CICS is enabled and the following paths are set:
    Path Value
    Transaction Path $CICSDEMO\CICS\bin\debug
    File Path $CICSDEMO\CICS\staff_base
    Map Path $CICSDEMO\CICS\staff_base\
    Resource Definition File Path $CICSDEMO\CICS\staff_base
  4. On the MSS tab, click JES and then on the General tab, ensure Job Entry Subsystem enabled is checked and the following paths are set:
    Path Value
    JES Program Path $CICSDEMO\CICS\bin\debug
    System Catalog $CICSDEMO\CICS\staff_base\catalog.dat
    Default Allocated Dataset Location $CICSDEMO\CICS\staff_base\

    The other fields should be left blank.

  5. On the JES tab, click Initiators and notice the initiator that has been set for this application.
  6. Click the MSS tab, then click the PL/I tab. Ensure that the PL/I enabled check box is selected and the following paths are set:
    Path Value
    Codewatch source path(s) $CICSDEMO\CICS;$CICSDEMO\CICS-Subs
    Codewatch STB path(s) $CICSDEMO\CICS\staff_base;$CICSDEMO\CICS\bin\Debug;$CICSDEMO\CICS-Subs\bin\Debug
    PL/I Configuration directory $CICSDEMO\CICS
  7. Click the Listeners tab and check the settings for the TN3270 listener. The port to which the terminal emulator connects is 5150.