Monitoring Server Activity

In this section:

x

You can monitor every server type and change its operation parameters through the Web Console. Those changes can affect the behavior and performance of the server.

This topic describes how to monitor the following:

It also describes how to perform certain administrative tasks on a server.


Top of page

x
Monitoring Data Services

In this section:

From the Web Console, you can:

As you monitor Data Service activity, you can also perform the following administrative tasks from the Web Console:



x
Displaying and Customizing a Performance Report for Data Service Agents

This topic describes how Server Administrators can display a Performance Report for the agents for all Data Services or for an individual Data Service. Server Administrators access the report from the Workspace on the Web Console menu bar, using the Agents menu option for Data Services.

If you are a user other than a Server Administrator, you can access the same report format and the same statistics from My Console on the Web Console menu bar. With the Manage My Agents option, you can monitor and manage your own agents, that is, the agents that match your user ID. If granted the applicable privileges, you can also monitor, or monitor and manage, the agents of the other users in your group.



x
Procedure: How to Display and Customize a Performance Report for All Data Service Agents
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder and select Agents.

    The Performance Report for Data Service Agents opens on the right.

    The table in Performance Report for Data Service Agents describes all the statistics that you can display on the report.

  3. To choose specific statistics that you want to display on the report, click Select Columns.

    The pane that opens lists the available statistics, grouped by category, such as General, Client Information, and FOCUS Information. A description of each statistic is provided in the right column of the pane, to help you tailor the report for your needs.

    Select the check box for each statistic that you want to display on the report, and de-select the check box for each statistic that you do not want to display.

    Optionally, you can:

    • Use the plus (+) or minus (-) button to the left of a category to open (expand) the category or close it.
    • Select the check box to the left of a category (for example, to the left of General), to select all the statistics in that category.
    • Use the Select All and Deselect All buttons to help you make and revise your choices. Click the Select All button to select all available statistics on the Performance Report, or click Deselect All to deselect all available statistics. You cannot deselect Tscomid, which is required on every report.

    Click OK when you have made your selections.

    The following image shows the General and Client Information sections.

    The following image shows the FOCUS Information, Adapter Information, and Change Data Capture Info sections.

    The following image shows the File Listener Info and System sections.

  4. To filter the values that you want to display on the Performance Report, click the Select Rows button on the report pane.

    The pane that opens lists the values for the State statistic. Select the check box for each value that you want to reflect on the Performance Report, and de-select the check box for each value that you do not want to reflect. For example, if you select the check box for in use and the check box for crashed, only the agents whose State is in use or crashed will be displayed on the report.

    Optionally, you can:

    • Use the plus (+) or minus (-) button to the left of State to open (expand) the statistic or close it.
    • Select the check box to the left of State to select all the values for that statistic.
    • Use the Select All and Deselect All buttons to help you make and revise your choices. Click the Select All button to select all values for State, or click Deselect All to de-select all values.

    The following image shows the pane from which you can filter the values for State on the Performance Report. In this example, the agents whose State is in use or crashed will be displayed on the report.

  5. Click OK when you have filtered the Performance Report as desired.

    You are returned to the Performance Report for Data Service Agents. The following image shows a sample customized report with selected statistics. In this example, the agents identified as Tscomid 1 through 6 were killed, as described in How to Kill One or More Data Service Agents.

  6. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.

    In the following image, the cursor is pointing to the Refresh Now button.



x
Procedure: How to Display and Customize a Performance Report for Data Service Agents Associated With a Selected Service

Since agents are associated with services, you may wish to display current service statistics.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Data Services folder.
  3. Right-click the name of the service on which you want to report, for example, WC_DEFAULT.
  4. From the menu, click Agents.

    The Performance Report for the Data Service Agents associated with the selected service is displayed on the right. The table in Performance Report for Data Service Agents describes all the statistics that are provided on the report.

  5. You can customize and filter the report, as described in How to Display and Customize a Performance Report for All Data Service Agents.


x
Reference: Performance Report for Data Service Agents
x

The following table describes all the statistics that can appear on the Performance Report for Data Service Agents. Each agent is represented as a separate row on the report.

Statistic

Description

General

Tscomid

Identification number associated with the Data Service Agent.

Service

Name of the data service for the agent.

State

Current state of the agent. Possible values are in use, DBMS call, idle, aborted, crashed, stopping, or starting.

A session connects and is in use until the moment that it disconnects. This includes all time spent between a session suspension and resumption when the process is not using the CPU but still has resources allocated for at least one session.

DBMS call indicates that the agent is waiting for a database to return data.

Idle means that the agent is not connected. It has no sessions at all, whether active or suspended.

Aborted and crashed are abnormal states resulting from a fatal software error detected by the program (aborted) or by the operating system (crashed). The agent process is no longer running, and these states are provided for diagnostic purposes. The Server Administrator can clear (using the kill option) such agents after the problem is investigated.

Stopping and starting are normal transitory states, which are self-explanatory.

Client Information

User

User ID associated with the server connection.

Group

Group ID associated with the server connection.

Client Session

Session ID uniquely identifying the client session.

Client Address

For some protocols, the network address of the connected client.

Code Page

Character code page used by the client connected to the session.

Defer ID

Unique identifier assigned to the submitted deferred request.

Scheduler Job ID

Unique identifier assigned to the last submitted scheduled or CMASAP request.

FOCUS Information

Query Time

Last time that a request to the agent was made. This value is used to calculate the time that an agent is idle, in cases in which an idle agent limit was set.

Command

First eight characters of the last instruction executed by the data access agent.

Procedure

Displays the procedure currently being executed or completed by each agent. For example, when a procedure, which is a part of a job, executes another procedure, the name of this procedure is shown in a Procedure column.

Top Level Procedure

Displays calling procedures or calling flows executed or submitted by agents.

Note: This column is not shown by default on the Data Services Agents page. To display it, click Choose Columns, select its check box on the Select the columns that will appear on the Agents page, and click OK.

Master File

Name of the last Master File that was processed by the agent. The displayed name can be up to 64 characters.

Executed Class

Last Java class executed. This value includes explicitly called Java classes (such as CALLJAVA), and implicitly called classes (such as GRAPH FILE).

Response Time

Time from the moment that the server receives the request (regardless of the requesting tool, that is, Web Console, DataMigrator, or WebFOCUS) until the request completes and the response is sent to the requester.

Server Time

Response time minus DBMS processing time.

Error Number

Last &RETCODE that is set upon procedure (FOCEXEC) completion. Zero (0) is normal. Any other value indicates an abnormal completion.

Focus I/O

Number of FOCUS I/O operations performed by the agent.

Foccache Ticket

Unique identifier assigned to the last request that used the foccache directory.

Number of Transactions

Number of transactions or HLI commands performed by the agent.

Adapter Information

DBMS I/O

Number of external I/O operations performed by the agent.

DBMS Time

Amount of DBMS processing time in seconds.

Change Data Capture Information

Source DBMS Adapter

Suffix of the listening adapter.

Source Table Name

Data source that is listened on.

Status

Current status of the adapter.

Processed Transactions

Number of processed LUWs (files).

Polling Interval

Interval at which polling takes place.

Timeout Interval

Amount of time during which there is no activity, and after which a timeout occurs.

Transactions Processing Limit

Maximum number of LUWs (files) that are processed by the adapter in one request.

File Listener Information

Source File Type

Suffix of the listening adapter.

Source Directory (File)

Data source that is listened on.

File Extension

Extension of processed files.

Status

Current status of the adapter.

Processed Files

Number of processed LUWs (files).

Processed Bytes

Number of bytes processed by the file listener adapter.

Files in wait queue

Number of selected files waiting to be processed by the file listener adapter.

Processing time

Rounded number of seconds that the file listener adapter spent in processing files.

Wait for work time

Rounded number of seconds that the file listener adapter spent in waiting for files.

Average files per second

Average number of files per second that the file listener adapter processed.

Average bytes per second

Average number of bytes per second that the file listener adapter processed.

Average file wait time

Average time in seconds that the file listener adapter spent in waiting for files.

Polling Interval

Interval at which polling takes place.

Timeout Interval

Amount of time during which there is no activity, and after which a timeout occurs.

Files Processing Limit

Maximum number of LUWs (files) that are processed by the adapter in one request.

System

CPU Time

Total CPU time used by the process.

Memory Usage (KB)

Amount of memory, in kilobytes, used by the process.

Disk Usage (KB)

Disk space, in kilobytes, used by the process.

Process ID

Operating system specific process identification number that is associated with the agent.



x
Procedure: How to Display Statistics for an Individual Data Service Agent
  1. Customize and display the Performance Report for all Data Service Agents, as described in How to Display and Customize a Performance Report for All Data Service Agents.
  2. On the report, right-click the row for the individual Data Service Agent whose statistics you want to display. For example, right-click the row for the agent identified as Tscomid 11.
  3. From the menu, click Statistics.

    The Agent Statistics pane opens. On this pane, you will see the statistics described in Performance Report for Data Service Agents, followed by system-extended statistics for the selected agent process.



x
Reference: System-Extended Statistics for an Individual Data Service Agent
x

The following table describes the system-extended statistics for an individual Data Service Agent.

Statistic

Description

PageFaultCount
PeakWorkingSetSize (KB)
WorkingSetSize (KB)
QuotaPeakPagedPoolUsage
QuotaPagedPoolUsage
QuotaPeakNonPagedPoolUsage
QuotaNonPagedPoolUsage
PagefileUsage
PeakPagefileUsage

Standard Windows memory management statistics for the monitored process.

Total Execution Time

Cumulative execution time of transactions performed by the agent.



x
Displaying Status Statistics and Aggregated Statistics for Data Services

You can display and customize a status report for all Data Services, and display aggregated statistics for all Data Services or for a selected service.



x
Procedure: How to Display and Customize a Status Report for All Data Services
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder.
  3. From the menu, click Services.

    The Data Services Status report is displayed on the right, as shown in the following image.

    The table in Aggregated Statistics for Data Services describes all the statistics that you can display on the report.

  4. To choose specific statistics that you want to display on the report, click Select Columns, and proceed according to the instructions in How to Display and Customize a Performance Report for All Data Service Agents.
  5. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.


x
Procedure: How to Display Aggregated Statistics for All Data Services
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder.
  3. From the menu, click Statistics.

    The Data Service Statistics pane opens on the right. The following image shows a sample Data Service Statistics pane.

    The table in Aggregated Statistics for Data Services describes the statistics that are provided.



x
Procedure: How to Display Aggregated Statistics for a Selected Data Service
  1. From the menu bar, select Workspace.
  2. In the navigation pane, open the Data Services folder.
  3. Right-click the name of the service on which you want to report, for example, WC_DEFAULT.
  4. From the menu, click Statistics.

    The aggregated statistics for the selected service are displayed on the right. The table in Aggregated Statistics for Data Services describes the statistics that are provided.



x
Reference: Aggregated Statistics for Data Services

The following table describes the aggregated statistics that are provided for Data Services.

Statistic

Description

General

Service

If you are displaying aggregated statistics for all Data Services, this value is All Services.

If you are displaying aggregated statistics for a selected service, this value is the name of the service configured for Workspace Manager in the edaserve.cfg file.

Performance

Agents Now

Number of agents that are currently running.

Agents Peak

Maximum number of agents that were running at any given time.

Connections Total

Number of attempted connections to servers since they were started, or from the time that statistics were reset.

This value is different from the total number of sessions, since a persistent session can connect multiple times for different requests.

Connections Completed

Number of successfully completed connections to servers since they were started, or from the time that statistics were reset.

Avg. Response Time

Average number of seconds for server response. This value does not include data transfer time. See Calculating and Displaying Averages, for more information.

Running Avg. Response Time

Response time, averaged over the time interval defined by the edaserve.cfg parameter stats_runningavg. The default value is 600 seconds.

Avg. DBMS Time

Average DBMS processing time in seconds.

Running Avg. DBMS Time

Average DBMS processing access time in seconds.

Avg. Server Time

Average response time minus DBMS processing time in seconds.

Running Avg. Server Time

Average response time minus DBMS processing access time in seconds.

Queued Now

Number of currently queued connections. Not applicable when queuing is off.

Currently running jobs are included in the connection total, but not in connections completed or in resource failures.

Queue Timeout

Number of connections that went into the queue and timed out (not available when queuing is off).

Queued Peak

Maximum number of connections that are queued at any given time (not available when queuing is off).

Queue Time

Average number of seconds spent in queue by all connections (not available when queuing is off).

Errors

Resource Fails

Number of connections rejected for lack of available agents. This value includes timed-out queued connections.

Security Fails

Number of connections that failed due to invalid credentials. For details about errors and failures, see the edaprint.log file, which is saved where the server is installed.

Focus Errors

Number of completed connections with WebFOCUS errors during request execution. For example, the adapter was not properly configured, or the data description or procedure was not found.

System

CPU Time

Total CPU time used by the server.

Memory Usage (KB)

Amount of memory, in kilobytes, used by the server.

Disk Usage (KB)

Total disk space, in kilobytes, used by the server.



x
Reference: Calculating and Displaying Averages

Variables that are averages (avg) are fractional numbers of seconds rounded to the nearest millisecond for display purposes, but actually computed in higher precision, depending on the operating system:

  • Avg Rsp Time is a measure of waiting time - idle time + running (that is, agent processing) time for all connections, divided by number of connections. It is actually the average time from the moment that the user clicks to send a request to connect or resume, until the moment that the answer appears in the browser, when the user suspends or disconnects the session.
  • Agent processing time is the part of the connection duration spent only on running the request.
  • Running time proportion of a connection is the percentage of its running time compared to its duration.

The accuracy of the three corresponding averages is limited only by the precision of the operating system. In the rare case in which a machine is faster than the precision of its time-measuring, accuracy side effects may occur:

  • For an individual connection that has a duration shorter than the precision of the operating system, duration and running time cannot be measured and are both 0. The server considers it a 100% running time. A high occurrence of these instances produces an overestimated average proportion.
  • If the duration is longer than the precision because of waiting time, but the running time is still less than the precision, then a zero is counted toward the average running time and in calculating the proportion. A 0% running time proportion is recorded. A high occurrence of these instances produces an underestimated proportion.


x
Working With the Connection Queue

The Connection Queue displays the statistics for the current list of connections, enabling administrators to monitor, and if necessary, cancel individual connections.

A connection refers to a physical connection between Client and Server. There are two types of connections:

A queued connection waiting for an agent becomes active as soon as an agent is available. If the maximum time to wait in the queue is reached, the connection is automatically cancelled by the Workspace Manager.



x
Procedure: How to Display Statistics for All Connections
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder.
  3. From the menu, click Connection Queue, as shown in the following image.

    The Connection Queue report is displayed on the right.

    The table in Connection Statistics describes the statistics on the report.

    Each connection is represented as a separate row on the report.



x
Reference: Connection Statistics
x x

The following table describes the statistics that appear on the Connection Queue report.

Statistic

Description

Service

Name of the data service for the connection.

Type

Connection type, either connect or resume.

User

User ID that connected to the session.

Authentication

Type of authentication used to connect, either trusted, explicit, or IWA.

Requester ID

Unique identifier for the network connection created by a listener.

Time In

Time at which the connection was activated or queued. This value determines when a queued connection times out.

Client Address

Network address of the connecting client.

Foccache Ticket

Unique identifier assigned to the last request that used the foccache directory.



x
Procedure: How to Kill a Connection

To cancel a connection, click the row for the connection on the Connection Queue report, and from the menu, click Kill Connection, as shown in the following image.

  • For an active connection, its session is forcefully disconnected from its agent.
  • For a queued connection, it is simply cancelled and the client gets the same error that it would get if queuing was off and there were no available agents, or if the queue was full.


x
Performing Administrative Tasks for Data Services

You can perform certain administrative tasks as you monitor Data Service activity.



x
Procedure: How to Reset Aggregated Statistics for Data Services

You can clear aggregated Workspace Manager statistics for Data Services and start collecting them from the beginning.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder.
  3. From the menu, click Reset Statistics.


x
Procedure: How to Save the Last FOCUS Command

You can save the last FOCUS command executed by an agent as a new procedure and run it separately from the Web Console. This provides a great tool for debugging server issues.

  1. From the menu bar, select Workspace.
  2. Right-click an agent on the Data Services Agent page and select Save Last FOCUS Command.

    The Create New Procedure as Text page opens, as shown in the following image.

  3. Click the Save button.

    The Save Procedure page opens, as shown in the following image.

  4. Enter an application folder in the Application field, or click the ellipsis (...) and navigate to one.
  5. Enter a name in the Name field.
  6. Click Save.


x
Procedure: How to Kill One or More Data Service Agents
  • To stop an individual agent, right-click the row for the agent on the Performance Report for Data Service Agents, and click Kill Agent from the menu. When asked if you want to continue to kill the agent, click OK.

    The running agent is terminated, invalidating any current connection to that agent. If a request is then issued from such a connection, an error message is returned. Stopping an agent is therefore an emergency administrative measure, as it disrupts the application. After an agent is terminated, the Data Services Agents pane refreshes automatically. The corresponding row of the terminated agent remains, and the State is listed as stopping until the row eventually disappears. You can also click Refresh Now to update the pane and remove the row.

  • To stop an individual agent without permitting the DBMS to perform any cleanup tasks, choose Hard Kill Agent from the menu. A message informs you that a hard kill may leave resources inaccessible and should be used only as a last resort. Click OK to continue the hard kill.

    Important: Use this option only when Kill Agent fails.

  • To stop all agents belonging to the same user ID, look for a row for the agent in the Performance Report for Data Service Agents that is currently connected to the desired user ID. Right-click that row, and select Kill Agents With The Same User ID.

  • To stop all agents associated with a selected service, right-click the service beneath the Data Services folder, and select Kill All Agents from the menu, as shown in the following image. When asked to confirm your request, click OK.

  • For extreme situations in which you want to terminate all running agents, right-click the Data Services folder in the navigation pane. From the menu, select Kill All Agents. When asked to confirm your request, click OK.


x
Procedure: How to Kill Agents by Connected User ID

In the Web Console, look for a row for the agent in the Data Services Agents pane that is currently connected to the desired user ID, then right-click that row and select Kill Agents With The Same User ID, as shown in the following image.

To kill agents from the command line, the syntax is:

edastart -killuser <userid>

In addition, for the z/OS platform, a z/OS operator MODIFY command can also be used, as follows:

/F <server_jobname/started task>,-killuser <userid>


x
Procedure: How to Start One or More New Data Service Agents

Use this method to start additional agents, even when there are agents already running.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Data Services folder.
  3. Right-click the name of the service for which you want to start agents.
  4. From the menu, select Start New Agents.
  5. On the Start New Data Service Agents pane, type the number of new agents to start for the selected service, as shown in the following image. Then click Start.

    On the Data Services Agents pane, you will see that the new agents are listed, with the State of starting.



x
Procedure: How to Display an Error Message for a Data Service Agent

If a procedure generates an error, you can display the error message on the active agent.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Data Services folder.
  3. From the menu, select Agents. The Performance Report for the Data Service Agents opens on the right.
  4. In the Tscomid column, right-click the number associated with an agent, and select View Error from the menu, as shown in the following image.

    The latest error is displayed in a separate window.



Example: Displaying an Error Message for a Data Service Agent

The following error was generated on an agent when a procedure was run against a file that could not be found. Clicking the number of the agent that ran the procedure produced the following message:

(FOC205) THE DESCRIPTION CANNOT BE FOUND FOR FILE NAMED: XYZ
BYPASSING TO END OF COMMAND

Tip: The error message is also stored in the Session Log, which you can access by clicking the Show Session Log Window icon on the Web Console menu bar. In the Session Log, you can click the message to see expanded information, including troubleshooting suggestions. For example:

(FOC205) THE DESCRIPTION CANNOT BE FOUND FOR FILE NAMED:
No data description can be found for the file requested. Check the
Master File Descriptions allocated or available, or the spelling of
the file name.

For more information on the Session Log, see Showing the Session Log.


Top of page

x
Monitoring Java Services

In this section:

From the Web Console, you can:

As you monitor Java Service activity, you can also perform the following administrative tasks from the Web Console.



x
Displaying and Customizing a Performance Report for Java Service Agents

This topic describes how Server Administrators can display a Performance Report for the agents for all Java Services or statistics for an individual Java Service Agent.



x
Procedure: How to Display a Performance Report for All Java Service Agents
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Java Services folder.
  3. From the menu, click Agents.

    The Java Services Agents pane opens on the right.

    The following image shows a sample report.

    The table in Performance Report for Java Service Agents describes the statistics displayed on the report.

  4. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.

    In the following image, the cursor is pointing to the Refresh Now button.



x
Reference: Performance Report for Java Service Agents

The following table describes the statistics that appear on the Performance Report for Java Service Agents. Each agent is represented as a separate row on the report.

Statistic

Explanation

Jscomid

Unique identification number assigned to each Java Service Agent. You can start and kill JSCOM3 connections. Each started connection is issued a unique number. If you kill a connection, its number is retired. A new connection is assigned an entirely new Jscomid.

Port

Port number for each Java Service Agent. Numbering starts with a base number and increases by one for each active agent.

Status

Current status of the instance. Possible values are starting, active, stopping, or stopped.

Process ID

Operating system specific process identification number associated with each Java Service Agent.

Connections

Total number of clients connected to JSCOM3, both active and inactive.

Active Connections

Active client connections to JSCOM3.

Last User

Name of the user who executed the class.

Last Executed Class

Last executed Java class. This includes explicitly called Java classes (such as CALLJAVA), and implicitly called classes (such as GRAPH FILE).

Free Memory (KB)

Amount of memory, in kilobytes, available to the Java Virtual Machine (JVM).



x
Procedure: How to Display Statistics for an Individual Java Service Agent
  1. Display the Performance Report for all Java Service Agents, as described in How to Display a Performance Report for All Java Service Agents.
  2. Right-click the row for the individual Java Service Agent whose statistics you want to display.
  3. From the menu, click View Statistics.

    The Statistics pane opens, as shown in the following image. On this pane, you will see the statistics described in Statistics for an Individual Java Service Agent.

  4. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.


x
Reference: Statistics for an Individual Java Service Agent

The following table describes the statistics for an individual Java Service Agent.

Statistic

Description

General

Name

Name of the Listener that is serving the Java Service.

Remark

Additional property of the Service or Listener, where available.

State

Current state of the connection. Possible values are starting, active, stopping, or stopped.

Process ID

Operating system specific process identification number associated with the Java Service.

Port Number

Port number for the Java Service. Numbering starts with a base number and increases by one.

System

PageFaultCount
PeakWorkingSetSize (KB)
WorkingSetSize (KB)
QuotaPeakPagedPoolUsage
QuotaPagedPoolUsage
QuotaPeakNonPagedPoolUsage
QuotaNonPagedPoolUsage
PagefileUsage
PeakPagefileUsage

Standard Windows memory management statistics for the monitored process.

Total Execution Time

Cumulative execution time of transactions performed by the agent.

Connections

Jscomid

Unique identification number assigned to the Java Service Agent. You can start and kill JSCOM3 connections. Each started connection is issued a unique number. If you kill a connection, its number is retired. A new connection is assigned an entirely new Jscomid.

Number of Connections

Total number of clients connected to JSCOM3, both active and inactive.

Number of Active Connections

Total number of active client connections to JSCOM3.

Last User

Name of the user who executed the class.

Last Executed Class

Last executed Java class. This includes explicitly called Java classes (such as CALLJAVA), and implicitly called classes (such as GRAPH FILE).



x
Displaying Aggregated Statistics for Java Services

You can display aggregated statistics for all Java Services.



x
Procedure: How to Display Aggregated Statistics for All Java Services
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Java Services folder.
  3. From the menu, click Statistics.

    The Java Services Statistics pane opens on the right, as shown in the following image.

    The table in Aggregated Statistics for Java Services describes the statistics that are provided.

  4. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.


x
Reference: Aggregated Statistics for Java Services

The following table describes the aggregated statistics that are provided for Java Services.

Statistic

Description

Total Connections

Total number of clients connected to JSCOM3, both active and inactive.

Total Active Connections

Total number of active client connections to JSCOM3.



x
Performing Administrative Tasks for Java Services

You can perform certain administrative tasks as you monitor Java Service activity.



x
Procedure: How to Reset Aggregated Statistics for Java Services

You can clear aggregated Workspace Manager statistics for Java Services and start collecting them from the beginning.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Java Services folder.
  3. From the menu, click Reset Statistics.


x
Procedure: How to Stop an Individual Java Service Agent
  1. Display the Performance Report for all Java Service Agents, as described in How to Display a Performance Report for All Java Service Agents.
  2. Right-click the row for the individual Java Service Agent that you want to stop.
  3. From the menu, click Stop, as shown in the following image.

  4. When asked if you want to continue to stop this JSCOM3 instance, click OK.

    On the Performance Report, you will see the status stopping. If you click Refresh Now, you will see the status stopped.

    Tip: You can restart the agent by right-clicking the applicable row on the Performance Report and clicking Start from the menu.



x
Procedure: How to Stop All Agents for a Selected Java Service
  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Java Services folder.
  3. Right-click the service whose agents you want to stop, for example, DEFAULT.
  4. From the menu, click Stop All.
  5. When asked if you want to continue to stop all Java Service Agents, click OK.

    Tip: You can restart the agents by right-clicking the service in the navigation pane, and clicking Start All from the menu.



x
Procedure: How to Kill One or More Java Service Agents
  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Java Services folder.
  3. Right-click the name of the service for which you want to kill agents.
  4. From the menu, click Kill Agents.
  5. On the Kill Java Service Agents pane, type the number of agents that you want to kill, and click Kill.

    On the Performance Report for all Java Service Agents, you will see that the number of agents that you specified is removed from the list.



x
Procedure: How to Start One or More New Java Service Agents

Use this method to start one or more additional agents, even when there are agents already running.

  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Java Services folder.
  3. Right-click the name of the service for which you want to start agents.
  4. From the menu, click Start New Agents.
  5. On the Start New Java Service Agents pane, type the number of new agents to start for the selected service, and click Start.

    On the Performance Report for all Java Service Agents, you will see that the new agents are listed, with the Status of starting, as shown in the following image.


Top of page

x
Monitoring Special Services and Listeners

In this section:

How to:

Reference:

From the Web Console, you can:

As you monitor Special Service and Listener activity, you can also perform the following administrative tasks from the Web Console.



x
Procedure: How to Display a Performance Report for All Special Services and Listeners
  1. From the menu bar, select Workspace.
  2. In the navigation pane, right-click the Special Services and Listeners folder, and select Processes.

    The Performance Report for all Special Services and Listeners opens on the right, as shown in the following image.

    The table in Performance Report for All Special Services and Listeners describes the statistics displayed on the report.

  3. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.


x
Reference: Performance Report for All Special Services and Listeners

The statistics that appear on the Performance Report for all Special Services and Listeners are described in the following table.

Statistic

Description

Name

Type of Special Service (for example, FDS, DFM, or SCHEDULER), or type of Listener (for example, HTTP or TCP).

Status

Status of the Special Service or Listener. Possible values include active, not active, or stopped.

Process ID

Operating system specific process identification number associated with each Special Service or Listener running in a Workspace Manager address space.

Port Number / Directory

Port number or directory associated with the Special Service if applicable (for example, FDS port or DFM directory), or the port number associated with the Listener.

Number of Requests

Total number of requests processed by the Special Service or Listener.

CPU Time

Total CPU time used by the process, displayed as hours:minutes:seconds.milliseconds (for example, 0:00:05.625).

Memory Usage (KB)

Amount of memory, in kilobytes, used by the process.



x
Procedure: How to Display Statistics for an Individual Special Service or Listener
  1. Display the Performance Report for all Special Services and Listeners, as described in How to Display a Performance Report for All Special Services and Listeners.
  2. Right-click the row for the individual Special Service or Listener whose statistics you want to display and select Statistics, as shown in the following image.

    The Statistics pane opens. On this pane, you will see the statistics described in Statistics for an Individual Special Service or Statistics for an Individual Listener.

    Tip: You can also display the Statistics pane for FDS, HTTP, TCP or SOAP by expanding the Special Services and Listeners folder, right-clicking one of these Special Services or Listeners, and clicking Statistics from the menu.



x
Reference: Statistics for an Individual Special Service

The following table describes the statistics that appear for an individual Special Service.

Statistic

Description

General

Name

Type of Special Service (for example, FDS, DFM, or SCHEDULER).

Remark

Additional property of the Special Service, where available.

State

Current state of the Special Service connection. Possible values are starting, active, stopping, or stopped.

Process ID

Operating system specific process identification number associated with the Special Service.

Port Number

Applies to the Special Service FDS.

Port number for the FDS. Numbering starts with a base number and increases by one.

System (Applies to the Special Services FDS and SCHEDULER)

PageFaultCount
PeakWorkingSetSize (KB)
WorkingSetSize (KB)
QuotaPeakPagedPoolUsage
QuotaPagedPoolUsage
QuotaPeakNonPagedPoolUsage
QuotaNonPagedPoolUsage
PagefileUsage
PeakPagefileUsage

Standard Windows memory management statistics for the monitored process.

Total Execution Time

Cumulative execution time of transactions performed by the agent.

Connections for FDS

Number of Connections

Total number of active connections.

Maximum Number of Connections

Hard-coded limit for the number of connections (512).

Number of FCB Blocks

Total number of opened File Control Blocks (FCB) by all users.

Maximum Number of FCB Blocks

Hard-coded limit for the number of opened FCBs at the sink side (4096).

Last User

User ID of the last connection to the FDS Service.

Last Executed HLI Commands

Last command executed by the FDS Service.

Connections for SCHEDULER

Status

Current status of the Scheduler. For example, scanning means that the Scheduler is in the process of scanning the application path for scheduled jobs, and ready means that the Scheduler is ready to process a job.

Last Full Scan

Timestamp for the last full scan of the application path. A full scan is performed on the Scheduler Start and Force Rescan options, which are available on the Scheduler menu.

Last Incremental Scan

Timestamp for the last incremental scan. An incremental scan looks for files that have changed since the last scan. The last scan can be full or incremental, depending on which one happened last.

Next Incremental Scan

Timestamp for the next incremental scan. An incremental scan is based on the value specified by the Scheduler property sched_interval, which is in seconds.

Number of Scheduled Events

Number of jobs currently scheduled to run.

Number of Scheduled Runs

Number of all runs since the startup of the Scheduler.

Number of CMASAP Runs

Number of all jobs submitted through CMASAP since the startup of the Scheduler.

DFM for SCHEDULER

DFM_DIR Available Disk Space (KB)

Disk space, in kilobytes, in the directory dfm_dir that is available for the DFM Service write results of deferred requests.

Number of Requests Done Since Startup

Number of requests processed by the DFM Service since server startup.

Number of Responses Ready

Number of responses in the directory dfm_dir that are ready for a user to view (get).



x
Reference: Statistics for an Individual Listener

The following table describes the statistics that appear for an individual Listener.

Statistic

Description

General

Name

Type of Listener, based on its network protocol (for example, HTTP or TCP).

Remark

Additional property of the Listener, where available. For example, an HTTP Listener can be CLM-enabled.

State

Current state of the Listener. Possible values include active, not active, and stopped.

Process ID

Operating system specific process identification number associated with the Listener.

Port Number

Port number for the Listener. Numbering starts with a base number and increases by one.

Total number of requests

Total number of requests processed by the Listener.

System

PageFaultCount
PeakWorkingSetSize (KB)
WorkingSetSize (KB)
QuotaPeakPagedPoolUsage
QuotaPagedPoolUsage
QuotaPeakNonPagedPoolUsage
QuotaNonPagedPoolUsage
PagefileUsage
PeakPagefileUsage

Standard Windows memory management statistics for the monitored process.

Total Execution Time

Cumulative execution time of transactions performed by the agent.



x
Deferred Lists

The Deferred List displays the current status of all deferred requests. You can stop the queuing or execution of deferred requests, and remove requests from the queue.



x
Procedure: How to Display the Deferred List
  1. From the menu bar, select Workspace.
  2. In the navigation pane, expand the Special Services and Listeners folder.
  3. Right-click SCHEDULER, and select Deferred List.

    The Deferred List is displayed on the right, as shown in the following image. In the image, the Get and Delete menu options for an individual row are shown.

    Each row displays statistics for a procedure that has been submitted for deferred execution. For details about these statistics, see Deferred List Statistics.

  4. All deferred requests are displayed by default. However, you can select the check box next to one or more deferred requests, then click Delete Selected, to remove those requests from the report.

    Optionally, you can:

    • Click Select All to select the check boxes for all deferred requests.
    • Click Refresh Selected to refresh the status of the deferred request or requests whose check boxes are selected.


x
Reference: Deferred List Statistics

The following table describes the statistics that appear on the Deferred List.

Statistic

Description

Defer ID

Unique identifier that the server assigns to each deferred request submitted.

User ID

ID of the user who requested deferred execution of the named procedure.

Status

Can be one of the following: Ready, Queuing, Executing, Agent crashed, Connect failed, Exceed limit, or Unknown.

App

Name of the application that contains the procedure being run in deferred mode.

Procedure

Name of the procedure being run in deferred mode.

Submitted Time

Time at which the request for deferred execution was submitted.

Scheduled Time

Time at which the deferred request is scheduled to run.

Days Left

Number of days that the generated report will be kept on the server.



x
Procedure: How to Retrieve the Answer Set for a Deferred Request
  1. On the Deferred List, right-click a row for a deferred request whose status is Ready.
  2. From the menu, click Get to retrieve the answer set for the deferred request in that row.

    The output is displayed on the right.



x
Procedure: How to Delete a Deferred Request From the Queue

Click anywhere in a row for a deferred request, and from the menu, click Delete.

Tip: To delete multiple rows, click the check box next to the rows that you wish to delete. Then click the Delete Selected button.



x
Web Sessions

You can display a Performance Report for all Web Sessions and statistics for a single Web Session.



x
Procedure: How to Display a Performance Report for All Web Sessions
  1. From the menu bar, select Workspace. In the navigation pane, expand the Special Services and Listeners folder.
  2. From the tree, right-click HTTP.
  3. From the menu, click Web Sessions, as shown in the following image.

    The Performance Report for all Web Sessions opens on the right.

    The table in Performance Report for All Web Sessions describes the statistics displayed on the report.

  4. At the upper-right of the report pane, optionally click Refresh Now to refresh the statistics, or click the Refresh interval check box and type the number of seconds between automatic refreshes.


x
Reference: Performance Report for All Web Sessions

The following table describes the statistics on a Performance Report for all Web Sessions.

Statistic

Description

Web Session Number

Unique number assigned to every Web Session at the time of login to the server, to the end of the session. The session ends by logging off the server, or by closing the browser.

Web Session ID

A unique number that the server assigns to a specific user for the duration of the user session. Every time you connect to the Web Console, a new session number is assigned.

User

ID of the connected user.

Remote Address

IP address or machine on which the Web browser running the Web Console resides.

Login Time

Time at which the Web Session originated.

Last Access Time

Last time at which the user was active in this Web Session.

Authentication

Mechanism that performs user authentication at the time the Web Session is created.

Console Message Count

Number of messages that a user received in this session.



x
Procedure: How to Display Statistics for an Individual Web Session
  1. Display the Performance Report for all Web Sessions, as described in How to Display a Performance Report for All Web Sessions.
  2. Right-click the row for the individual Web Session whose statistics you want to display.
  3. From the menu, click View Statistics.

    The Web Session Statistics pane opens.

    The table in Statistics for an Individual Web Session describes the statistics displayed on the pane.



x
Reference: Statistics for an Individual Web Session

The following table describes the statistics for an individual Web Session.

Statistic

Description

Web Session Number

Unique number assigned to every Web Session at the time of login to the server, to the end of the session. The session ends by logging off the server, or by closing the browser.

User ID

ID of the connected user.

Number of Requests

Number of HTTP requests processed during the current Web Session.

User Login Time

Time at which the Web Session originated.

Last Access Time

Last time at which the user was active in this Web Session.

Login Type

Type of user login, for example, explicit or cookie.

HTTP User Agent

Standard HTTP client that is used for connection to the HTTP Listener.

URI

Uniform Resource Identifier (URI) of the last Web Console page that was processed by the current Web Session.

Remote Address

IP address or machine on which the Web browser running the Web Console resides.

Web Session ID

A unique number that the server assigns to a specific user for the duration of the user session. Every time that you connect to the Web Console, a new session number is assigned.



x
Performing Administrative Tasks for Special Services and Listeners

You can perform several administrative tasks for Special Services and Listeners.



x
Procedure: How to Enable/Quiesce or Start/Stop a Special Service or Listener
  1. Expand the Special Services and Listeners folder in the navigation tree.
  2. Right-click a Special Service or Listener.
  3. Select one of the following options from the menu if the option is available for the selected Special Service or Listener:
    • Quiesce/Enable
    • Start/Stop

    In the following image, the Quiesce menu option is selected for the TCP listener.

The Performance Report or statistics pane reflects the changed status:

  • For Enable or Quiesce: active or not active.
  • For Start or Stop: started or stopped.


x
Procedure: How to Kill All Web Sessions
  1. Display the Performance Report for all Web Sessions, as described in How to Display a Performance Report for All Web Sessions.
  2. Near the top-left of the report, click Kill All Web Sessions, as shown in the following image.



x
Procedure: How to View the Log for a Web Session
  1. Display the Performance Report for all Web Sessions, as described in How to Display a Performance Report for All Web Sessions.
  2. Right-click the row for the Web Session whose log you want to view.
  3. From the menu, click View Session Log.

For more information, see Showing the Session Log.


Top of page

x
Custom Monitor Pages

How to:

Custom Monitor Pages let you create pages that monitor the various services available from the Workspace folder. These pages are represented by icons on the navigation pane of the Applications page.

Custom Monitor Pages allow you to include multiple monitoring pages on a single page, creating a combination of Data Agents, Java Services, Listener and Special Services, Cluster Manager, and Resource Management pages. These pages can be arranged horizontally, vertically, or in a cascade. Refresh and autorefresh will update all sections of a Custom Monitor Page. Custom Monitor Pages can be saved in a server application for future use.

Note: Custom Monitor Pages are only supported when the appearance of the Web Console is set to an RIA option.



x
Procedure: How to Create Custom Monitor Pages

Custom Monitor Pages are created in Application directory folders.

  1. From the Application page, select New and Custom Monitor Page, as shown in the following image.

    The Select pages to add dialog box opens.

  2. Open the Monitor Pages folders, and right-click an item, and select a monitoring page to add, as shown in the following image.

    The page is added and can be seen in the background of the Custom Monitor Page, as shown in the following image.

  3. You can continue adding pages from the dialog box. When you are finished adding pages, click OK.

    The dialog box closes and the Custom Monitor Page is displayed.

  4. Use the Arrange Windows button to position the pages. The windows can be arranged Horizontally, Vertically, In a Cascade, or Automatically, as shown in the following image.

    The page in the following image are arranged vertically.

  5. Click the Save this page into a file button.

    The Save Custom Page opens.

  6. Enter an Application folder and a name in the corresponding fields, and click Save.

    Optionally, you can replace an existing page by selecting the Overwrite existing file check box.

You can add other pages at any time using the Add new windows (+) button next to the Arrange WIndows drop-down menu.

The Custom Monitor Page is added to the Application folder. Right-click it, and select Open to open the page.


iWay Software