Provides step-by-step instructions that guide you through the process of creating and configuring an
enterprise server region on which to run the MFDEMO IMS application.
Create the IMSDEMO
enterprise server region
In this section, you use a provided template to create an MSS- and IMS-enabled
enterprise server region configured with the most common features required to run an IMS application or service.
- In
Visual Studio, open the
Server Explorer.
If it is hidden, display it by choosing
View >
Server Explorer.
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.
- Expand
Micro Focus Servers.
- Right-click
localhost, and click
New Enterprise Server.
The
Create New Enterprise Server dialog box appears.
- Type
IMSDEMO into the
Name field.
- Check
64-bit.
- Click the
Browse button associated with the
Template field.
By default, this opens to the location of the
Enterprise Server template files.
Note: The default location for
Enterprise Server templates is
a subdirectory named
ServerTemplates located several levels under the Visual Studio installation directory. If necessary, browse to this location.
- Double-click
IMSTemplate.xml to select it.
- In the
Associate with projects field, check the entry that matches your project name.
- Click
OK.
The
Output window displays a notification that the server has been created.
- In the
Server Explorer, expand
localhost to check that the IMSDEMO server has been added to
localhost.
Start the
Enterprise Server Common Web Administration (ESCWA)
Configure IMSDEMO
An
enterprise server region created using the IMSTemplate template, as has been done for IMSDEMO, is pre-configured with the most common settings used
to run IMS applications. Most of the fields and controls cited in this section have been populated with default settings.
Most paths are represented by a variable that starts with a dollar sign ($). These are
Enterprise Server environment variables, each resolving to a path derived from your IMSSupport project properties. Because you set your project
properties to use the
loadlib project folder for all output, each of these variables that point to an output folder resolve to your project's
loadlib directory. Later in the tutorial, you can look at the configuration settings to see the actual value of each variable.
Tip: For a description of each field and control on any page of Enterprise Server Common Web Administration, click
![Help icon](GUID-599E153E-4D2F-4C7A-9745-F0B7D7A9FC80-low.png)
in right upper area of the UI.
- Edit the IMSDEMO
region
-
- Set general settings
-
- In the
STARTUP OPTIONS group, check
Allow Dynamic Debugging.
- In the
REGION FEATURES group, ensure that
MSS Enabled and
IMS Enabled are checked.
- In the
ADDITIONAL group, type
IMS Tutorial in the
Description field.
- Click
APPLY.
- Verify and set IMS general settings
-
- In the menu bar, click
This opens the
IMS CONFIGURATION page.
- Verify the following:
Codeset Bias
|
ASCII
|
ACB File Directory
|
$IDE_IMSGENPATH
|
- In the
GEN File Directory field, replace the value with
$IDE_LOADLIB.
- Click
APPLY.
- Verify general transaction manager settings
-
- On the
IMS CONFIGURATION page, click the
TM tab.
- Verify the following:
Application Path
|
$IDE_LOADLIB
|
MFS Path
|
$IDE_MODPATH
|
- Verify the automatic message processing
region
- To run an IMS application in an
enterprise server region, you need at least one specialized service execution process (SEP) called a message processing region (MPR). To specify that
a message processing region starts each time an enterprise server starts, it must be included in a resource group that is
specified by the startup list in the SIT used by the enterprise server.
- In the
MESSAGE PROCESSING REGIONS section, verify the following:
NAME
|
MPR01
|
CLASS(ES)
|
1
|
DESCRIPTION
|
MPR for class 1
|
- Verify the database path
-
- On the
IMS CONFIGURATION page, click the
DB tab.
- Verify that
Database Path is set to
$IDE_IMSDATA.
- Define resources
- The resource definition file that you registered previously in this tutorial enables you to switch back and forth between
CICS and IMS modes. The configuration settings for this and the system initialization table (SIT) used with IMS are on the
CICS tab associated with mainframe subsystem configuration.
- Click
.
This takes you to the
CICS CONFIGURATION page.
- Verify the following:
System Initialization Table
|
IMSSIT
|
Transaction Path
|
$IDE_LOADLIB
|
- In the
Resource Definition File Path field, type the full path to your project's
system directory.
- Click
APPLY.
- Configure the TN3270 listener
-
You need to specify a communications port to be used by the TN3270 listener to accept incoming client requests.
- Click
This takes you to the
COMMUNICATIONS PROCESSES page.
- Expand
Communications Process 1.
- Click
TN3270.
- Change the contents of the
Port field to
9004.
- Click
APPLY.
Start IMSDEMO
- On the
Server Explorer, expand
localhost under
Micro Focus Servers to see a list of available
enterprise server regions.
- Right-click
IMSDEMO; then click
Start from the context menu.
Note: The first time you start the
IMSDEMO
region, the
Enterprise Server Sign On dialog box prompts you to enter connection details. Because the server is not secured, just click
OK to continue.
The
Output
window
shows the progress of the
Start command.
View environment variable values
The
Enterprise Server Common Web Administration enables you to see the full configuration for your
enterprise server region. You can view the values for the environment variables specified in your configuration as follows:
- Once IMSDEMO has started, return to
ESCWA.
- In the navigation pane, click
.
- Click
.
- Scroll down the list of environment variables, and note the values for all variables that begin with
IDE.
- When you are finished, close
ESCWA.