STRACE Arguments

One of the following arguments is required. The first valid command is used. All others will be ignored and a warning is issued to the user.

ON

Turns STRACE ON. If STRACE is off, this command causes the buffers to be allocated if needed and turns tracing on. If STRACE is currently on, this command has no effect. The default buffer size per processor is 3 MB which can be changed by using the /S option described below. Note that if buffers exist at the time of this command, no new buffers will be allocated. Tracing is simply turned on using the existing buffers, whatever size they may be. Tracing will be automatically turned off when any buffer on any processor is full.
OFF
Turns STRACE OFF. If STRACE is on, this command turns tracing off. The buffers are not freed. If STRACE is currently off, this command has no effect.
INIT
Initializes STRACE. This command causes the buffers to be allocated if necessary, but does not turn tracing on. If STRACE is currently on, this command has no effect. The default buffer size per processor is 3 MB, which can be changed using the /S option. Note that if buffers exist at the time of this command, no new buffers will be allocated.
RESET
Resets STRACE. If STRACE is on, this command turns tracing off. Whether STRACE was on or off, any allocated trace buffers will be freed and the contents discarded.
FLUSH
Flushes STRACE buffers. This command causes all data in the trace buffers to be discarded. The buffers remain allocated if they exist. This command does not alter the state of tracing. If STRACE is on, it will remain on and tracing continues into an empty buffer. If STRACE is off, it remains off.
INFO
Returns the status of STRACE. Indicates whether STRACE is active or not, the current buffer allocation, and data collection statistics, such as number of bytes collected. This command does not alter the state of tracing.
GET
Returns a copy of the trace buffers. This command returns all trace data to the user in a binary file in the current directory called STRACE.RAW. Use the /R option to direct the output to a different file and path. This file is processed using the POST option of STRACE, to convert it to a readable format. This command does not alter the state of tracing. Trace major codes should be disabled prior to issuing STRACE GET.
POST
Processes the binary file returned from the GET option and produces two files: an integrated ASCII dump of the trace and an MTE (module table entry) loader dump output file. The default input file is STRACE.RAW, the default ASCII dump output file is STRACE.OUT, and the default MTE dump output file is STRACE.MTE Use the /R, /O, and /M options respectively to specify a different file name, or fully-qualified path and file name, for each. This command does not alter the state of tracing.
MAJOR
Displays the active STRACE major codes being traced. This command does not alter the state of tracing.
VERSION
Displays the current version of STRACE. This command does not alter the state of tracing.
MTE
Captures Module Table Entry data and writes it to the MTE loader dump file. Use the /M option to direct the output to a file other than STRACE.MTE. Module Table entry data provides information about loaded memory objects, their sizes, addresses and process affiliations.
INSERT
Dynamically inserts trace hooks into the kernel. The user can insert a major code group. For example for major code 19, strace insert 19. The user can insert a particular major/minor code. For example, 19/1, strace insert 19 1. Very few software trace hooks are dynamic; most are already inserted, and the strace insert and strace remove commands have no affect. At present, only hooks associated with major code 0x0013 (19) can be inserted with this capability.
REMOVE
Dynamically remove trace hooks from the kernel. The user can remove a major code group. For example for major code 19, strace remove 19. The user can remove a particular major/minor code. For example, 19/1, strace remove 19 1. At present, only hooks associated with major code 0x0013 (19) can be removed with this capability.
NRM
For IBM Use Only.

---

[Back: STRACE Syntax]
[Next: STRACE Options]