Time Analyzer Users Guide

The Time Analyzer tool is used to analyze unload/load times for packages and individual tables. The Time Join tool is used to merge export and import data created by the Time Analyzer. Both tools generate output files in text and HTML format.

1.

Prerequisites
JRE version 1.4.1 or higher JAVA_HOME environment variable must point to the JRE directory.

2.

Tool

The tool is located in the MIGTIME.SAR SAPCAR archive. Content of the archive file:
migtime.jar export_time.sh / export_time.bat import_time.sh / import_time.bat time_join.sh / time_join.bat TimeAnalyzer.pdf

3.

Configuration

Help The tool will display the available parameters, if you call it with one of the following command line options:
-help -?

Version The tool will display the version information (release branch and build date), if you call it with the following command line option:
-version

Time Analyzer Options Option Description installDir Installation directory

dataDirs

top

List of data directories with binary data files and TOC files Number of tables to be reported Time limit for tables in hours

Time limit for tables in minutes

xml

Create additional XML output file

html

Create additional HTML output file

Comments Directory where the R3load log files are located. If missing, then the current working directory is used. Separator on Windows: ; Separator on UNIX: : TOC files relevant only for export analysis. Reports N tables with the longest runtime. Can be combined with h or m option. Tables with an export/import time above this limit will be reported. Mutually exclusive with m option. Can be combined with top option. Tables with an export/import time above this limit will be reported. Mutually exclusive with h option. Can be combined with top option. XML output file contains all collected time information. Can be processed using XSLT. Used as input file for Time Join tool. HTML output file contains package time diagram. For output on printer enable Print

timePoints

Number of time stamps in HTML output file

background colours and images option in IE / Netscape. Default is 5. Example: if your export is started at 1pm and finished at 5pm you will find the following time stamps in the title bar: 01:00, 02:00, 03:00, 04:00, 05:00. You can increase the number of time stamps if you print using landscape format.

Time Join Options Name Description Comments exportFile Export XML time file Export XML time file created beforehand by Time Analyzer. importFile Import XML time file Import XML time file created beforehand by Time Analyzer. xml Create additional XML output file contains all collected XML output file time information. Can be processed using XSLT. html Create additional HTML output file contains package HTML output file time diagram. For output on printer enable Print background colours and images option in IE / Netscape. timePoints Number of time Default is 5. stamps in HTML Example: if your system copy is output file started at 1pm and finished at 5pm you will find the following time stamps in the title bar: 01:00, 02:00, 03:00, 04:00, 05:00. You can increase the number of time stamps if you print using landscape format. Trace Option Name
trace

Description Trace level

Comments Possible values: all, off, 1 (error), 2 (warning), 3 (info), 4 (config, default), 5, 6, 7 (trace)

Mandatory Options Export Time Analyzer: Import Time Analyzer: Time Join:

dataDirs

none
exportFile, importFile

4.

Starting Tools

Time Analyzer The tool can be started using one of the following: The UNIX shell script export_time.sh / import_time.sh The Windows batch file export_time.bat / import_time.bat

Note An R3load version that supports table timestamps is required to produce table times during import time analyses (check the R3load log files). Starting with release 640 R3load writes time stamps per object. This feature is not available for all databases. If your database does not support table time stamps then you will get a warning in the Time Analyzer log file like:
No table timestamps found for import package 'SAPUSER' in the package LOG file 'SAPUSER.log'.

The options top, h, m will have no effect. To specify an option in the command line, enter -optionName optionValue. Example of a command line for a UNIX terminal:
./export_time.sh installDir /sapinst_dir dataDirs /export_dump/DATA top 50

Example of a command line for Windows cmd.exe:

Time Join The tool can be started using one of the following: The UNIX shell script time_join.sh The Windows batch file time_join.bat To specify an option in the command line, enter -optionName optionValue. Example of a command line for a UNIX terminal:
./time_join.sh exportFile ./export_time.xml importFile ./import_time.xml

Example of a command line for Windows cmd.exe:

5.

Output Files

Export Time Analyzer

Import Time Analyzer

Time Join
time_join.txt time_join.html time_join.xml time_join.log TimeJoin.console.log

6.

Procedure

Time Analyzer 1. Extract the MIGTIME.SAR archive into your working directory. 2. Start the Time Analyzer tool. If any errors occur, increase the trace level (in the command line enter trace all), restart the tool and analyze the log files. 3. Export / import times can be found in the text files export_time.txt / import_time.txt. 4. HTML output file with package time diagram can be viewed using IE / Netscape. Tooltips on the diagram time bars display load start / end dates.

Time Join 1. Extract the MIGTIME.SAR archive into your working directory. 2. Start the Time Join tool using the export and import XML files generated beforehand by Time Analyzer tool. 3. Joined export / import times can be found in the text file time_join.txt. 4. HTML output file with package time diagram can be viewed using IE / Netscape. Tooltips on the diagram time bars display load start / end dates.

7.

Release Notes

New Features in NW2004s SR2 Time Join tool supports text output format. New Features in NW2004s SR1 Time Join tool is added to merge export and import data on one HTML diagram.