Import and Configure the Enterprise Server instance

Importing the Enterprise Server instance

To import the preconfigured enterprise server:

  1. In the Visual Studio Server Explorer, right-click Micro Focus Servers, and click Administration.

    This opens the Enterprise Server Common Web Administration Web (ESCWA) UI in a browser outside of the IDE.

  2. On the Default page under Directory Servers, click IMPORT as you are going to import the supplied definition of the PLIMQS server.
  3. On the Step 1: Import Type page, click Legacy, and click Next.
  4. Enter the following path in the Repository Location field: %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\MQSDemo\plimqs_def.
  5. Click SUMMARY to load the summary information about the BANKDEMO server, then click Next.
  6. Click Next on the Regions page.
  7. Click Next on the Region Options page.
  8. Click IMPORT on the Import page, then click FINISH.
  9. The system returns to the main ESCWA page.

    The selected server appears in the list of Directory Servers. The server is named PLIMQS.

Verifying Configuration information for the Enterprise Server instance

Before starting the MQSDemo server, verify the Enterprise Server connection to MQS by examining the XA Resource and MSS PL/I connection information, and the General configuration information.

  1. Hover the row for the PLIMQS entry in the list of servers, and click its Edit (EDIT) button.

    This action opens the GENERAL PROPERTIES page of the server's properties. 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.

  2. Click the downwards arrow next to GENERAL in the taskbar at the top of the properties pane, and click XA Resources in the drop-down list.
  3. In the Enterprise Server page for the server named PLIMQS, select Server > Properties XA Resources to display XA Resource connection information in the XA Resources tab.
  4. If multiple XA resources exist, click the Edit button in the row for the resource whose ID is MQS. Server tab > Properties tab > XA Resources tab to display XA general server information.
  5. Verify the following XA resource information. You can change the ID and Name values to something meaningful to your installation. Use the Displayed Columns button to show the files that are hidden. The QMNAME (in open string) should be modified to match the name of your Queue Manager. For example:
    • ID: MQS
    • NAME: MQS
    • Module: ESMQXA
    • OPEN STRING:QMNAME=WSTEST.QM,tpm-=cics,AXLIB=casaxlib
    • CLOSE STRING: <blank>
    • DESCRIPTION: <blank>
    • ENABLED: <selected>

    Change or add values as needed and click APPLY.

  6. Click the downwards arrow next to GENERAL in the taskbar at the top of the properties pane, and click PL/I in the drop-down list.
  7. This page shows the locations for debugging source, STB files and PL/I configuration. Verify the following and change as needed:
    PL/I Enabled: <selected>
    Prompt for PLITEST attachment: <not selected>
    Codewatch source path(s): $MQSDEMO
    Codewatch STB path(s): $MQSDEMO\bin\debug
    PL/I Configuration directory: $MQSDEMO
  8. Click GENERAL in the taskbar at the top of the properties pane and verify that the Configuration Information field shows the following:
    MQSDEMO=C:\Users\Public\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\MQSDEMO

    If necessary, edit this information to ensure the path points to the correct location of the MQSDEMO folder, and click APPLY.