API Expert Reports (CICS, Web server, MQSeries)

This product views the TCP/IP network performance from the enterprise level to the remote user connection. Performance indicators are available for workload, usage, and response time. The API Expert Reports become available when the Host Monitor is started.

The API Expert is structured to allow you to view both a global and detailed view of API activity. API includes all socket-attached application activity.. Clearly, if your installation is using any such application, for example, CICS sockets, Web server, MQSeries, or even this product, you will be interested in the historical performance statistics presented here.

The data provided is session-based. That is, the session counts are done based on a session initiation and termination record. If no session termination record exists for some reason, there will not be a record of the session. Remember also, that the session is recorded at the time that it finishes. The session may have lasted for 8 hours, but it is recorded at the time it terminates.

If you wish to view time slices of active sessions taken in a sampling mode, please review the Base History reports. You may also want to look at "near time" API activity by viewing the SessionLog API reports. The SessionLog API reports show sessions that are currently in progress or have recently completed.

The API Expert Reports provide two categories of reporting:

Activity (Address Based Reports)

Total API Usage

Total API session and byte activity for the time period chosen.

Top API Users –Sessions/Bytes

View the top API addresses performing the session and byte activity for the time period chosen (by sessions or bytes).

Selected API User

View the details of any API address for the time period chosen by sessions and bytes.

Selected API User –

Detail List

View the sessions or bytes for a specific API address for the time period chosen.

Application Based Reports

Top API Applications – Sessions/Bytes

View the top applications accessed via API.

Selected API Application

Statistics for any application accessed via API.

 

To view an API Expert Report, perform the following steps:

1.      Click on the History tab.

2.      Click the API Expert hyperlink under Expert Reports. The API Expert Reports screen appears.

3.      Choose Show Graph or Show Report.

4.      Select the report you wish to view.

5.      Select the type of report, that is, the time slice, you wish to view: Weekly by Day or Daily by Hour.

6.      Select if you want to view by DNS name or address. This only applies to the top API user reports.

7.      Select the starting time using the twenty-four clock if you are doing the daily by hour report and wish to start at an hour other than 0.

8.      Enter how many bytes, clients, applications, or specific name / address you would like to view:

·        For the Total report category, enter the minimum bytes, if desired.

·        For Top reports, enter between 1 to 250 data points if you are requesting a report or enter between 1-20 if you are requesting a graph.

·        For Selected User reports, enter the IP address.

·        For Selected Application reports, enter the API Application name to be viewed.

9.      Click Submit. The report screen appears.

10.  Use the Back Arrow on your browser to move between screens.

Note:   Each type of report has corresponding required fields. See each report type section for more information.

See also: