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

1

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 Comments

installDir Installation directory Directory where the R3load log files are located. If missing, then the current working directory is used.

dataDirs List of data directories with binary data files and TOC files

Separator on Windows: ‘;’ Separator on UNIX: ‘:’ TOC files relevant only for export analysis.

top Number of tables to be reported

Reports N tables with the longest runtime. Can be combined with h or m option.

h Time limit for tables in hours

Tables with an export/import time above this limit will be reported. Mutually exclusive with m option. Can be combined with top option.

m Time limit for tables in minutes

Tables with an export/import time above this limit will be reported. Mutually exclusive with h option. Can be combined with top option.

xml Create additional XML output file

XML output file contains all collected time information. Can be processed using XSLT. Used as input file for Time Join tool.

html Create additional HTML output file

HTML output file contains package time diagram. For output on printer enable ‘Print

2

background colours and images’ option in IE / Netscape.

timePoints Number of time stamps in HTML output file

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 XML output file contains all collected time information. Can be processed using XSLT.

html Create additional HTML output file

HTML output file contains package time diagram. For output on printer enable ‘Print background colours and images’ option in IE / Netscape.

timePoints Number of time stamps in HTML output file

Default is 5. Example: if your system copy 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.

Trace Option Name Description Comments trace Trace level Possible values:

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

3

Mandatory Options Export Time Analyzer: dataDirs Import Time Analyzer: none Time Join: exportFile, importFile

4

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

To s Exam./e Examimp Tim The

••

To s Exam./t Examtim

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 isnot 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.

pecify an option in the command line, enter ‘-optionName optionValue’.

ple of a command line for a UNIX terminal: xport_time.sh –installDir /sapinst_dir –dataDirs /export_dump/DATA –top 50

ple of a command line for Windows cmd.exe: ort_time.bat –installDir C:\sapinst_dir –h 1 –html

e Join

tool can be started using one of the following: The UNIX shell script time_join.sh The Windows batch file time_join.bat

pecify an option in the command line, enter ‘-optionName optionValue’.

ple of a command line for a UNIX terminal: ime_join.sh –exportFile ./export_time.xml –importFile ./import_time.xml

ple of a command line for Windows cmd.exe: e_join.bat –exportFile export_time.xml –importFile import_time.xml -html

5

5. Output Files

Export Time Analyzer • export_time.txt • export_time.html • export_time.xml • export_time.log • TimeAnalyzer.console.log

Import Time Analyzer • import_time.txt • import_time.html • import_time.xml • import_time.log • TimeAnalyzer.console.log

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

6

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.

7