Figure 11-1: ESMAC Server information page
This chapter describes how you can administer an enterprise server, using Enterprise Server Monitor and Control.
Enterprise Server Monitor and Control (ESMAC) enables you to view and control enterprise servers, and the services, packages, and handlers that run on those servers.
ESMAC works in conjunction with Enterprise Server Administration. However, ESMAC provides facilities not available in Enterprise Server Administration. With ESMAC you can:
ESMAC enables you to define who can use ESMAC, and the permissions they have to view and update resources. For more information on setting up ESMAC users, see the section Security.
The ESMAC interface is displayed using a browser. You can, therefore, monitor and control enterprise servers across the Internet, or your intranet, from a computer that has any of the following browsers installed:
When you first view ESMAC, the Server Information page is displayed, as shown in Figure 11-1:
Figure 11-1: ESMAC Server information page
ESMAC enables you to:
The ESMAC interface is split into two areas:
The ESMAC menu appears in a sidebar on the left side of the page. You see only the menu options that are appropriate to your permission level.
Control and monitor information is presented in the body of the page.
The body of the page changes when you click a button in the menu. The body of the page usually contains one or more controls, which you can use to enter and modify information required by the enterprise server.
The status line appears at the top of the page. This line tells you:
Many pages contain a Refresh button. Click this after you have performed an action that should be reflected in the contents of that page's table. For example, if you have just added a server, click Refresh on the Server Information page, and the details of the activity are updated.
You can also configure the ESMAC pages to automatically refresh. To do this:
You should, as soon as possible, set up the users who can access ESMAC, and set the appropriate permissions for those users.
The default security depends on how your system is set up. A system can be set up with or without the special user mfuser defined:
For an enterprise server used for development, we recommend that you do not configure an mfuser. For an enterprise server used for production, we recommend that you do configure an mfuser, and give mfuser only minimum privileges.
You create user names, passwords, and set permissions using the Users page.
You can see which administrators are currently set up by clicking Users. This displays the Users page, which lists all users. Click Details on the Users page to get detailed information on a user's permissions.
If you do not have the required read or update permissions, the options available to you in ESMAC are limited. You can only:
You can start ESMAC, and connect to the server you want to monitor, from Enterprise Server Administration.
You can return to Enterprise Server Administration by clicking Home in the ESMAC menu.
ESMAC provides various information about the enterprise server you are currently viewing. Server information can be viewed by clicking Server in the menu, which displays the Server Information page.
The Server Information page provides information that enables you to monitor the operation of the enterprise server, providing details on:
The information provided enables you to quickly determine the state of the server. For example:
The information presented on this page might prompt you to make changes to the enterprise server. You can make changes using other ESMAC pages. This is described in the following sections.
When you are running services on an enterprise server, you need to ensure that services are starting and stopping as expected, and that no service is using more resources than expected.
The Monitor page enables you to view the performance of services, providing information about:
For example, if the average time taken to complete a task is large, this would indicate that a service is a long running or stateful service. If the number of tasks completed per second suddenly rises beyond what you expect, this might indicate that a task is repeatedly calling another task in error.
You can manage various parameters of an enterprise server using ESMAC. You do this using the Control page, which can be displayed by clicking Control on the ESMAC menu.
For example, as you saw in the section Server Information, you can view various information about an enterprise server, including the dump state. If you wanted to change the dump state, you would use the Control page.
The Control page enables you to control:
You can also shut down the enterprise server from this page, and you can obtain a dump of the server on shutdown.
Service execution processes are provided within an enterprise server. COBOL applications are executed within these service execution processes. For more information on service execution processes, see the section Service Execution Processes in the chapter Configuration in your Enterprise Server Configuration and Administration Guide.
You can view information on the SEPs running on an enterprise server by displaying the SEPs (Service Execution Processes) page. To do this, click SEPs in the menu.
The SEPs (Service Execution Processes) page displays details for all SEPs on the current enterprise server, including:
You can also terminate SEPs and create and view traces for SEPs.
Programs running as services in an enterprise server can include ACCEPT FROM CONSOLE and DISPLAY UPON CONSOLE statements. When execution reaches a DISPLAY UPON CONSOLE statement, the display text is displayed in the console log, and the service continues. When execution reaches an ACCEPT FROM CONSOLE statement, the service pauses and asks for input using pages in ESMAC. You must provide the input in order for the service to continue executing.
You can use ESMAC to create and view dump and trace information, and to examine the server console log.
The server console log provides information about the region. This includes such details as when the server was started or stopped, the SEPs that were created, and so on.
You can display the console log by clicking Log in the Diagnostics group of the menu, and then clicking Display.
To return to ESMAC, click Back in your browser.
You can specify whether system dumps, transaction dumps and system traces are created. You do this using the Control page. You can also use the Control page to specify the dataset in which dumps and traces are to be stored. To view dumps and traces, you use options in the Diagnostics group in the menu.
You can also obtain traces on SEPS and some client processes, using options on the SEPs and Client pages.
For more information about system dumps and traces see the section Using a Diagnostics Server in the chapter Troubleshooting
Information about services, packages and request handlers is given in the Resources group.
If you click Services, the Services page is displayed, which lists each service running on the enterprise server. Clicking Details next to one of the services displays the Service page, which gives detailed information for that service. The Service page gives information about the service you selected. You can find information about the associated package and request handler by clicking Packages Status, Details and Handler Status, Details respectively. A link to the package and request handler information is provided with the service, as a problem with these can affect the service.
You can, if required, view information about the package and request handler separately, by clicking Package and Handler, respectively.
To set up new services, packages and request handlers, use Enterprise Server Administration. For information on how to do this, see the chapter Services, Packages and Request Handlers in your Enterprise Server Configuration and Administration Guide.
You can specify that input and output to a service is recorded in a dump dataset. By default, it is not.
Various environment variables are set when an enterprise server is initiated. An error in these environment variables can affect the running of applications on the server.
ESMAC enables you to view a complete list of all environment variables set for an enterprise server. To do this, click Env. Vars. on the menu. The Environment Space page is displayed.
You can set environment variables for an enterprise server using Enterprise Server Administration. See the section Environment Variables in the chapter Configuration in your Enterprise Server Configuration and Administration Guide.
Copyright © 2008 Micro Focus (IP) Ltd. All rights reserved.
How to