Import and Configure the STAFF Enterprise Server Instance

Walks you through the process of importing the pre-configured STAFF enterprise server instance and reviewing its settings.

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.

Start Enterprise Server Common Web Administration (ESCWA)

  • On the Server Explorer, right-click Micro Focus Servers, and then click Administration.

    ESCWA starts in your default browser.

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.

Import CICS_SERVERS.xml

  1. In ESCWA, click Native.
  2. In the navigation pane, expand Directory Servers, and then click Default.
  3. On the Region and Server List page in the right pane, click Import.
  4. On the Choose Import Type page, click XML, and click Next.
  5. Open Windows Explorer, and navigate to %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\CICSDEMO.
  6. Drag the CICS_SERVERS.xml file and drop it on the Upload File page, and then click Next.
  7. On the Import Options page, click Next.
  8. On the Perform Import page, click Import, and then click Finish. The system returns to the Region and Server List page.

    The STAFF server is listed on the Region and Server List page.

Configure general properties

  1. On the Region and Server List page, hover over the row for the STAFF entry in the list of servers, and then click its Edit Edit button.

    This action opens the General Properties page for the server.

  2. On the General Properties page, in the Startup Options section, check Allow Dynamic Debugging.
  3. In the Configuration Information section, edit the value for the MQSDEMO variable to remove the quotes and specify PLI-VS so that it reads as in the following example:
    [ES-Environment]
    CICSDEMO=%PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\CICSDEMO
    ES_SSTM_CICS="$CICSDEMO\CICS\sstmcics.jcl"
    #MF_CHARSET=E
  4. Click Apply.

Review server settings

You need to review the settings and compare them with the ones described here. Ensure you click Apply on each page where you make any changes.

  1. Click the CICS drop-down menu, and select Configuration.
  2. Ensure that the following paths are set:
    Path Value
    Transaction Path $CICSDEMO\CICS\bin\debug
    File Path $CICSDEMO\staff_base
    Map Path $CICSDEMO\staff_base\
    Resource Definition File Path $CICSDEMO\staff_base
  3. Click Apply.
  4. Click the JES drop-down menu, and select Configuration.
  5. Ensure that 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.

  6. In the Initiators section, notice INIT1 that has been set for this application.
  7. Click Apply.
  8. Click the General drop-down menu, and select PL/I.
  9. 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\bin\Debug;$CICSDEMO\CICS-Subs\bin\Debug
    PL/I Configuration Directory $CICSDEMO
  10. Click Apply.
  11. Click the General drop-down menu, and select Listeners.
  12. Check the settings for the TN3270 listener. The port to which the terminal emulator connects is 5150.
  13. If you made any changes on this page, click Apply.