_TRCOPT - set traceback options.
Usage:
#include <trcopt.h>
_trcopt(outfile,options);
Where:
- FILE *outfile;
- specifies an open file where you want the program to
write out a traceback if the program aborts. By default,
this is "stderr". If you specify a null pointer
for this argument, the program will not produce a
traceback.
- int options;
- specifies options for the traceback. Bits that are on (1)
in the "options" argument turn on options; bits
that are off (0) turn options off. Thus you normally
create an "options" argument by ORing together
the options you want to turn on. Options are specified
with manifests defined in <trcopt.h>. Manifests
currently defined are:
- _T_event
- tells the program that tracebacks should include
an interpreted display of the event blocks in the
root of the main co-routine. If this option is
off, the traceback will only display the number
of event blocks.
Description:
If an NS mode program aborts, it will attempt to produce a
traceback showing the state of the program at the time of the
abort. The "_trcopt" function tells the program what
information should be displayed as part of that traceback. In
addition, it tells where the traceback should be written. The
default setting is
_trcopt(stderr,0);
which displays a basic traceback on the standard error stream.
Copyright © 1996, Thinkage Ltd.