User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 75
Dialogic Corporation
-f <file>
Enable logging to file, optional
Note: A space is used after the -f option but not after -a, -b, -d, -m or -s options.
-m<n>
Max log file size (express in bytes; for example, 500,000 bytes is specified as
-m500000), optional
Min=100 Kilobytes, max=100 Megabytes
Default=unlimited if log file array size=1, else 100 Megabytes
-s
Disable logging to STDOUT, optional
Details about these command line options follow:
-a<n>
This command line option allows the user to specify the maximum number of log files
to maintain.
The user can specify a log file array size between 1 and 10. By default, the number of
log files to be archived is 1. If the user specifies the -f command line option but does
not specify this option (or specifies it with an array size of 1), then ISDNtrace creates a
single log file that grows without bound (that is, no limit to the log file size).
If the user specifies this option with an array size greater than 1 (but less than or equal
to 10), then ISDNtrace creates an initial log file at startup. When the log file reaches
the maximum file size (either the default maximum log file size or the value specified
via the -m command line option), the log file is closed and a new log file is created.
Whenever ISDNtrace attempts to open a new log file, it first checks to see if the
current number of log files created is equal to the number of files specified for the log
file array. If not, then the new log file is created. Otherwise, the oldest log file is deleted
and a new log file is created to replace it.
It should be noted that any ISDNtrace log files that exist prior to running the
ISDNtrace tool are not deleted or modified in any way. Due to the new log file naming
convention (see -f option), all ISDNtrace log files have unique timestamps in their log
file names and are not overwritten when ISDNtrace starts up.
-f <file>
This option existed in the previous versions of ISDNtrace. However, the processing
associated with this option has been modified to include date and time information.
This command line option specifies the log file name of the log file into which the trace
can be captured. If this option is not specified on the command line, then no trace
output will be saved to a log file.
The naming of ISDNtrace log files has been modified to fit the following format:
<File>-MMDDYYYY-xxhyymzzs.log
where:
• MM - current month (01=Jan, 02=Feb, 03=Mar, … 12=Dec)
• DD - current day of the month
• YYYY - current year (e.g. 2006)
• xx - current hour in day (24 Hour Format, 00-23)