SAPDB_IFR_TRACEOPTIONS
.ifr_cons
utility.SAPDB_IFR_TRACEOPTIONS
before the application is running. The individual options are separated by double-colons. The following options are provided:
Option | Description |
o<filename> | The output file name. An output file name of '-' means standard output. A %p in the file name is replaced by the process id, so different processes can use the settings without overwriting each other's trace. If the file name shall contain a double-colon, you have to repeat it (e.g. oc::\trace.txt ). |
c<limit> | Enable the call trace, with a recursion limit of <limit> . Calls more nested than <limit> are not traced, as default the recursion limit is not limited, if it is not specified. |
p<limit> | Enable the packet trace. The size of individual packet content that is dumped is limited by <limit> , which is 1000 bytes as default. |
g | Enable the profiling trace. |
d | Enable the debug trace. |
T | Enable the timestamp prefix in front of each output line |
s<size> | Limit the size of the trace file to <size> bytes. As default, the size of the trace file is not limited. If the trace exceeds <size> , the file is overwritten starting at the beginning. |
ifr_cons
can be used to enable or disable trace options.
The tool ifr_cons
is called as follows:
ifr_cons [options] [command]where
[options]
are:
Option | Description |
-f <filename> | Use <filename> as the name of the shared memory lock file. If no file is supplied, the file specified in the environment variable SAPDB_IFR_SHAREDMEM is used. If that environment variable is not set, the file irtrace.shm in the independent protocol path will be used. |
-h | Help. Shows usage information, and ignore all commands. |
-p <pid> | Execute the command only for the specified process id <pid> . |
-v | Verbose operation. |
and [commands]
are:
Command | Description |
TRACE CALL|SHORT ON|OFF|<limit> | Switches the call trace on or off or sets the call trace nesting level |
TRACE DEBUG ON|OFF | Switches the debug trace on or off |
TRACE LONG ON|OFF | Switches the long trace (call plus debug trace) on or off |
TRACE PROFILE ON|OFF | Switches the profile trace on or off |
TRACE PACKET ON|OFF|<limit> | Switches the packet trace on or off or sets the packet trace size. |
TRACE TIMESTAMP ON|OFF | Switches the time stamp prefix on or off |
SHOW TRACESETTINGS | Shows the current trace settings done by this tool. |
All command names are case insensitive. Also commands can be abbreviate to a length where they can uniquely identified (e.g. 'S T' is same as 'SHOW TRACESETTINGS').