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. The Enterprise Server Administration page displays.
  2. On the Home page of the Enterprise Server Administration, under Actions at the left, click Import. The first Import server information screen appears.
  3. Enter the path where the predefined server data is stored. By default this is %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\MQSDemo\plimqs_def.
    Note: If you have created other enterprise servers that use the MF Directory Server Internal Security Manager (such as while going through other Enterprise Developer tutorials), you have receive a warning in the second page while importing the server information. If this happens, the security information will be replaced with the existing default Enterprise Server security configuration. This may the server to have different security characteristics once imported that the server that is being imported. Not importing the security data should not cause any issues. However you should stop all existing servers before continuing. To do this, click Back then Cancel to return to the and stop all existing servers on the Enterprise Server Home page, then restart this procedure to import the server instance.
  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 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. In the Enterprise Server Administration Home page, click Edit to the left of the row for the PLIMQS server to verify the server settings and make corrections in case the information differs from the one in this tutorial.

    Server details display in multi-tabbed dialog box for the PLIMQS server.

  2. 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.
  3. 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.
  4. Verify the following XA resource information. You can change the ID and Name values to something meaningful to your installation. 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 OK.

  5. Select Server > Properties > MSS > PL/I. This tab 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
  6. In the General tab, verify that the Configuration Information field shows the following:
    [ES-Environment]
    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.