This document covers the following topics:
The HTML Monitor Client is a monitor interface that supports any web browser as a user interface for monitoring the various types of servers that are provided in a mainframe Natural environment. Each of these servers has its own set of monitor details which are described in the corresponding server documentation. The HTML Monitor Client enables you to list all existing servers and to select a server for monitoring.
To run the HTML Monitor Client, any server must host an HTTP Monitor
Server. The HTTP Monitor Server is a subtask that can run in any Natural
Development Server address space and is configured with the NDV configuration
parameter HTPMON_PORT and
HTPMON_ADMIN_PSW. An HTTP Monitor Server is accessible
through a TCP/IP port number and can monitor all servers running on the current
node (for SMARTS: running within the current SMARTS). Although it is not
necessary, you can run multiple HTTP Monitor Servers on one node. But each one
needs an exclusive port number.
Open your web browser and connect the HTTP Monitor Server using the
following URL:
http://nodename:port,
where nodename is the name of the host
on which the Natural Development Server hosting the monitor is running. And
port is the port number the
administrator has assigned as the monitor port in the NDV configuration file.
The server list consists of green and red entries. The red ones represent potentially dead server entries which can be deleted from the server directory by choosing the attached button. The button appears only for the red entries. "Potentially dead" means, that the HTTP Monitor Server "pinged" the server while assembling the server list, but the server did not answer within a 10 seconds timeout. Thus, even if you find a server entry marked red, it still might be active but could not respond to the ping. Choosing the button does not terminate such a server but removes its reference in the monitor directory. Hence, it cannot be reached by the monitor anymore.
Choosing the button opens a window for monitoring the selected server.
Example:
With the buttons, you can perform the labeled monitor commands.
The selection box allows you to modify the server configuration parameters. If you select a parameter for modification, it has a predefined value. This predefined value does not reflect the setting of the server. It is just a sample value.
If you choose the button, a list of all Natural sessions appears in the window, for example:
You can cancel sessions by selecting the session ID in the SessionId column and choosing the button.
shows currently connected sessions. Connected sessions are either permanent connections to Natural Studio or temporary connections to NaturalONE. In case of NaturalONE, a connected session is a session that currently executes a Natural session (for example using Run As/Debug As), waits on an I/O screen or uses the Natural Command Console for Mainframes.
In conjunction with Security Caching the following buttons are available:
ListClients - to display the clients that
are logged in
CancelClient - to delete a client and
force a new password prompt
ListClients displays the following information (from left to right):
Number of client entry
UserId - UserId of the client
Host - IP Address of the client
LogonTime - Time of first login of the client
LastActivity - Time of last access of the client
St - Status of the client:
A - Client successfully validated by RACF
N - Client not validated by RACF
To delete a client from the list select the number assigned to the client and choose CancelClient. Alternatively you can enter the number of the client after choosing CancelClient.
The button provides basic filter functions for the trace output of a server. The trace output is loaded completely into a HTML page. In case of very large trace files, this may lead to a delay in loading. To refresh the content of the trace, for example if new lines were written, the button must be pressed again.
Each trace line consists of day number, time, thread ID, and message text. The thread ID is an increasing number starting with 0 or 1 (main thread). Each new thread gets a new ID. The main thread starts several new threads like HTTP Monitor, Console Interface, or Main Listener. Each request from a client (like NaturalOne) creates a new thread. Therefore, it is possible to filter particular client sessions.
It is of course also possible to use well known browser functions, such as cut and paste or find, to navigate inside a trace.
Filter
Enter a text to filter the trace. Only lines containing the filter text are displayed.
Reset
Filter value is being reset. The entire loaded trace is displayed again.
Hosts
Predefined filter that shows the IP address and, if known, the name of all hosts that had logged into the Server. You can now, for example, display the progress of a particular session by selecting a thread ID and clicking the button.
Clients
Predefined filter that shows the name of clients that had logged into the Server. As in the previous function, you can now, for example, display the progress of a particular session by selecting a thread ID and clicking the button.
Errors
Predefined filter that shows errors that occur on the Server. You can now, for example, display the progress of a particular session by selecting a thread ID and clicking the button.
Example:
Filter trace for clients, select the thread ID of a particular client session, and click . You will see all trace lines of this particular client session.