NAME

mrcallrm - remove calls from a trace file

SYNOPSIS

  $ 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

DESCRIPTION

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

OPTIONS

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

--eula

Display the license information and exit.

--help

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.

--man

Print the mrcallrm manual page and exit.

--rc=file

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").

--version

Display the program version number and exit.

RC FILES

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.

EXAMPLES

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

DIAGNOSTICS

Exit status is 0 on successful completion, and >0 if an error occurs.

ENVIRONMENT

.mrcallrm.rc

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:

  ~/.mrcallrm.rc
  ./.mrcallrm.rc

If you do not wish to execute the options in these files, then specify --norc on the command line.

MRTOOLS_RCPATH

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.

AUTHORS

Cary Millsap, Jeff Holt

SUPPORT

mrcallrm version 3.1.0.4.

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.