Monitor Tuxedo Application using TXRPT utility

The txrpt statistical tool is used to measure the services performance. Below a brief guide shows the use of the tool.

• txrpt tool works with trace service requests stored in files. In those files, Tuxedo stores the start and end date / time of every service request done.
• This trace generation is enabled using the -r option in the ubbconfig file for each server entry. Tuxedo, by default, writes the trace file in standard error, so it is recommended to redirect the trace log to a separate file for each server, using the -e option. The following entry is an example of a configuration server tracing:

"server1" SRVGRP = "servergroup" srvid = 1CLOPT = "-A -r

-E /tuxedo/traces/server1.trc"

 When using the-r option, ensure that the ULOGDEBUG variable is not initialized or is initialized to 'N', this is because if it is initialized as 'Y', Tuxedo also writes debug information on the standard error file.

• The txrpt tool is used to generate metrics and service average times. These times are presented in centiseconds. The semantics of this is:

txrpt [-t] [-n names] [-d mm / dd] [-s time] [-e time]

Where,

-T: Optional. If specified, indicates that services should be sorted by the total service time in descending way. If it is not specified, the services are ordered by the number of invocations in descending way.

-N: Optional. Restrict output to the services listed separated by comma.
-D mm / dd: Optional. If it is specified, the statistics are generated on the date mentioned, if it is not, statistics are generated for the current day. In any case, the utility generates statistics just for a day.
-S hr [: min [: sec]]: Optional. Restrict the generation of statistics to those entries starting after the appointed time.

The following is an example of use of the tool:

txrpt -d 01/12 -s8:00 -e9:00  < /tuxedo/traces/server1.trc

START AFTER:    Tue, Jan 12, 2012 08:00:00 AM

END BEFORE:     Tue, Nov 29, 2011 09:00:00 AM

      SERVICE SUMMARY REPORT

SVCNAME         8a-9a          TOTALS

                Num/Avg         Num/Avg

--------------- --------        -------

TOUPPER         5/0.5           5/0.5

--------------- -------         -------

TOTALS          5/0.5           5/0.5

As shown, the first lines indicate the range of dates / times used, then displays a list of services and a column for each rank of an hour, in that cell shows the number of service invocations and the average time response. The last column shows total number of invocations and average times.