Configure IMSDEMO for an IMS Web Service

Walks you through the process of configuring the IMSDEMO enterprise server region to prepare it for running the IMSScreenWS Web service that is deployed to it later in this tutorial.

Configure the Web Services and J2EE listener

You need to specify a communications port to be used by the Web Services and J2EE listener that accepts incoming client requests.

  1. If the IMSDEMO region is started, stop it from the Server Explorer in Visual Studio.
    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 region 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.
  2. Right-click Micro Focus Servers, and click Administration.

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

  3. In ESCWA, click Native.
  4. In the navigation pane, expand Directory Servers > Default, and double-click your enterprise server instance.
  5. Click the downwards arrow next to General, and click Listeners in the drop-down list.
  6. Under Communications Process 1, and click Web Services and J2EE.
  7. Change the contents of the Port field to 9003.
  8. Scroll up to the Status section, and set the status of the listener to Started.
  9. Click Apply.
  10. Click the Web listener.
  11. Change the value of the Status field to Stopped. This enables the listener used to deploy the service interface to the IMSDEMO server.
  12. Click Apply.
  13. Return to the list of default directory servers in ESCWA.

Create and configure an alternative deploy directory

Important: Complete this section only if you do not have Administrator privileges for the Enterprise Developer installation directory and subdirectories. If you do have Administrator privileges, skip directly to Create a Service Interface.

Without Administrator privileges to the default deploy directory, you cannot deploy to Enterprise Server from Visual Studio. To ensure successful deployment, complete these tasks:

Create a deploy folder in your IMSSupport project
  1. In the Solution Explorer, right-click the project, and then select Add > New Folder from the context menu.
  2. Type deploy, and then press Enter.
Add the .mfdeploy file
The new deploy folder must contain a copy of the .mfdeploy configuration file. Use the Solution Explorer to add this file.
  1. From the Solution Explorer, right-click the deploy folder; then select Add > Existing Item.
  2. Browse to the %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\deploy folder.
  3. Set the filter drop-down list to All Files (*.*).
  4. Double-click the .mfdeploy file.
Define the deployment folder
Now you need to configure the IMSDEMO enterprise server region by defining the new deploy project folder as the deployment folder.
  1. In ESCWA ensure that your enterprise server region is selected in the navigation pane, and the Communications Processes page is open in the right pane.
  2. Under Communications Process 1, select Web.
  3. In the Listener Properties pane, scroll down to the Custom Configuration field.
  4. Within the Custom Configuration field, scroll down until you find the relevant code, then change:
    uploads=<ES>/deploy

    to:

    uploads=c:/tutorials/IMTK/project-name/deploy

    where project-name is the name of the project.

  5. Click Apply.