- RC FILES
- COPYRIGHT AND LICENSE
mrcallrm - remove calls from a trace file
$ mrcallrm [options] file Options: --comment or -c display original line as a comment --eula print End User License Agreement and exit --help print help text and exit --lines=list or -l list eliminate calls on the specified lines --man print manual page and exit --rc=file use named rc file; --norc prevents rc file usage --version print version number and exit
mrcallrm reads Oracle extended SQL trace data from the named file and sets the call duration to zero on each of the line numbers specified with the --lines option. It also subtracts the proper duration from tim values on the call's line and subsequent lines, as well as on timestamp lines. mrcallrm converts datestamps from an Oracle format like "2008-04-01 08:09:10.123" to the ISO 8601 format "2008-04-01T08:09:10.123000+0000".
The tool can automatically uncompress files compressed properly with:
Compression tool ---------------- gzip bzip2 zip
- --comment or -c
Display the original line with a comment prefix ("# ") on the line prior to each updated line in the output. Default is --nocomment.
Display the license information and exit.
Display usage information and exit.
- --lines=range_list or -l range_list
Reset call durations to 0 on lines specified in range_list. The list must consist of non-negative integers (like "42"), closed ranges of non-negative integers (like "42..52"), or open ranges of non-negative integers (like "..42" or "42.."), separated by commas. For example, --lines=..5,8,10..12,1000.. is a valid line range specification. You may use either ".." or "-" interchangeably as a range operator. Ranges may be listed in any order. Specifying an invalid range_list (like --lines=a,1- 5) will cause mrcallrm to die.
Print the mrcallrm manual page and exit.
Process command line options listed in file. Use --norc to prevent mrcallrm from opening the default rc files in your home directory or current working directory (see "ENVIRONMENT").
Display the program version number and exit.
With .rc files, you can conveniently change the default behavior of any mrcallrm option. For example:
$ cat ~/.mrcallrm.rc --comment
You can also construct .rc files that allow you to customize mrcallrm queries without having to type a complex command line each time.
This command will remove the call on line 7 of the input trace file and write the content to another file:
mrcallrm --lines=7 ora_1492.trc > ora_1492-1.trc
This command will remove the calls on lines 1 through 42:
mrcallrm --lines=..42 ora_1492.trc > ora_1492-2.trc
This command will remove the calls on lines 1 through 42, 1000, and 2000 through the end of the file:
mrcallrm --lines=..42,1000,2000.. ora_1492.trc > ora_1492-3.trc
Exit status is 0 on successful completion, and >0 if an error occurs.
By default, mrcallrm will execute the options listed in the following files, in the following order, before the options you actually list on your command line:
If you do not wish to execute the options in these files, then specify --norc on the command line.
The MRTOOLS_RCPATH environment variable contains a list of directories that each --rc=file option will search for file. Value syntax is identical to the PATH environment value syntax (e.g., ".:a:a/b" in Unix, ".;c:a;c:a\b" in DOS). If file begins with '/', '.', or '~', then --rc looks for the file in the location you have specified. Otherwise, --rc will search each directory named in the MRTOOLS_RCPATH list for file, using only the first readable file that it finds.
Cary Millsap, Jeff Holt
mrcallrm version 126.96.36.199.
Contact <> at Method R Corporation for support, or visit method-r.com for more information.
COPYRIGHT AND LICENSE
Copyright (c) 2011, 2014 by Method R Corporation. All rights reserved.
This is commercially licensed software. You may not redistribute copies of it. Please confirm with your software license administrator that you are licensed to use this Method R software product. Write <> for information.
There is NO WARRANTY, to the extent permitted by law.