Application Messages and Return Codes

The following table lists messages and return codes which are specific to the Kernel Trace control program (KTRACE.EXE).
 
KTRACE.EXE Return Code
Error Level
Message/Description
Action
0 Fatal One of:
"Tracing has been stopped externally."
"Kernel Trace has detected the output drive failure. Tracing has been stopped. All previously written trace records may be usable."
"Command line file size limit has been reached."
"Licensed record limit has been reached."
"Licensed trace time limit has been reached."
"Kernel Trace has detected that the output drive has run out of  free space. Tracing has been stopped. All previously written trace records are usable."
Displays stop cause.
Verify available space on output drive. 

Verify command line file size setting. 

Verify product license.

1 Fatal "Cannot contact the Kernel Trace device driver. Check your installation. "
Kernel Trace device driver could not be opened by KTRACE.EXE.
Verify that KTRACE.SYS is loaded as a BASEDEV in CONFIG.SYS
1 Fatal "Error code is %u DosOpen(driver) failed"
Kernel Trace device driver could not be opened by KTRACE.EXE.
Verify that KTRACE.SYS is loaded as a BASEDEV in CONFIG.SYS
10 Fatal "You are trying to activate tracing while another kernel trace session is active. Only one trace session is allowed at a time."
Self-explanatory.
Verify that another instance of KTRACE.EXE is not running.
10 Fatal "An Operating System error has occurred while initiating a new kernel trace session. Error code is %u."
Kernel Trace control program could not be started, because another instance is active.  Only one instance is permitted at a time.
Verify that another instance of KTRACE.EXE is not running.
11 Fatal KTRACE.EXE could not communicate to the device driver to begin tracing. Verify that KTRACE.SYS was correctly installed and was loaded during IPL.
12 Fatal "No kernel tracing is active"
KTRACE -k could not stop tracing, because there was no active KTRACE.EXE process which could be killed.
Ensure that there is a KTRACE.EXE process active.
12 Fatal "Cannot contact active trace session; error code is %u"
KTRACE -k could not stop tracing, because there was no active KTRACE.EXE process which could be killed.
Ensure that there is a KTRACE.EXE process active.
13 Fatal "All tracepoints are disabled."
Tracing cannot take place unless at least one tracepoint is enabled.
Enable at least one tracepoint via the command line or via KTRACE.CFG.
14 Fatal "An error has occurred while communicating to the Kernel Trace device driver."
Driver version information could not be determined.
Make sure driver version is supported.
15 Fatal "Error: This version of driver is not supported.  Please use control program supplied with driver."
Driver version is unsupported (KTRACE.SYS major version is not equal to KTRACE.EXE major version or KTRACE.SYS minor version is greater than KTRACE.EXE minor version).
Verify driver and control program version compatibility.
16 Fatal "An error has occurred while communicating to the Kernel Trace device driver."
Driver returned error for IOCTL with license information.
 
97 Informational KTRACE -k successfully sent kill command and exited. No action necessary.
98 Informational This is returned when KTRACE -v showed license information and exited. No action necessary.
100 Informational KTRACE ? showed help screen and exited. No action necessary.
996 Fatal "The product license has expired; please contact vendor for renewal."
The license file (LICENSE.KTO) was created for evaluation purposes.  It has timed out and is no longer valid.
Obtain and properly deploy a valid license file which has not expired or which is permanent.
998 Fatal "The product license file %s is corrupt; please reinstall original license file."
The license file (LICENSE.KTO) has been modified since creation.  This file is digitally signed and any changes will invalidate its use.
Obtain and properly deploy a valid license file.
998 Fatal "License is for a different version of Kernel Trace."
The license file (LICENSE.KTO) is meant for use with an earlier version of Kernel Trace and is not valid for use with the current version.
Obtain and properly deploy a valid license file.
999 Fatal "The product license file LICENSE.KTO is missing; please reinstall original license file."
The license file (LICENSE.KTO) cannot be found.
Place a valid LICENSE.KTO in the right search path.
N/A Warning "Warning: Wrong reference to tracepoint %s was ignored".
Indicates that KTRACE.CFG includes a reference to a tracepoint which could be circular.  See Configuration - Tracepoints section.
Verify that tracepoints used are called in the order that they are defined in KTRACE.CFG.  This avoids indefinite recursion.
N/A Warning "Warning: You must specify File name. %s ignored"
-f option does not have accompanying value.
Verify -f command line parameter.
N/A Warning "Warning: File name is too long and will be cropped"
File name supplied with -f option is longer than maximum allowed by OS/2;  name will be truncated.
Verify -f command line parameter.
N/A Warning "Warning: You must specify flags value. %s ignored"
-t option does not have accompanying value.
Verify -t command line parameter.
N/A Warning "Warning: Alias %s is unknown and was ignored". Unknown tracepoint alias was encountered with -t option and was ignored. Verify -t command line parameter.
N/A Warning "Warning: You must specify file name pattern. Parameter ignored"
-l option does not have accompanying value.
Verify -l command line parameter.
N/A Warning "Warning: File name pattern is too long. Parameter will be cropped"
File name pattern supplied with -l option is longer than maximum allowed by OS/2;  name will be truncated.
Verify -l command line parameter.
N/A Warning "Warning: You must specify Comment. %s ignored"
-c option does not have accompanying value.
Verify -c command line parameter.
N/A Warning "Warning: Comment is too long. %s will be cropped"
Comment provided with -c option is  longer than 127 chars. Only the first 127 will be used.
Verify -c command line parameter.
N/A Warning "Warning: You must specify PIDs list. %s ignored"
-i option does not have accompanying value.
Verify -i command line parameter.
N/A Warning Warning: You must specify pattern value. %s ignored"
-p option does not have accompanying value.
Verify -p command line parameter.
N/A Warning "Warning: Process Name pattern is too long and will be cropped"  Process name pattern supplied with -p option is longer than maximum allowed by OS/2;  name will be truncated. Verify -p command line parameter.
N/A Warning "Warning: You must specify MaxSize value. %s ignored"
-m option does not have accompanying value.
Verify -m command line parameter.
N/A Warning "Warning: You must specify MaxBufSize value. %s ignored"
-b option does not have accompanying value.
Verify -b command line parameter.
N/A Warning "Warning: Unknown option %c ignored"
Unknown option was encountered and will be ignored.
Verify command line parameters.
N/A Warning "Warning: Configuration file %s could not be read" Self-explanatory. No action necessary - defaults assumed.
N/A Warning "Warning: Configuration file could not be found"
Self-explanatory.
No action necessary - defaults assumed.
N/A Warning "Warning: Trace file extension must be '.KTR'."
Self-explanatory.
Verify that filename issued with -f directive uses the ".ktr" extension.
N/A Warning "Warning: This version of control program is obsolete.  Please consider using newer control program to use new functions driver with version higher than 1.1 is installed." Verify driver and control program version compatibility.
N/A Warning "Warning: Can not set CTRL-BREAK handler, error=%u"
Internal error;  execution should continue.
No action necessary.
N/A Warning "Warning: No automatic termination timer; error code is %u DosAsyncTimer failed."
Internal error;  execution should continue.
No action necessary.
N/A Informational
"Mode: File" 
"File name is %s" 
"Enabled tracepoints are: %s" 
"Program Name pattern is %s" * 
"PID numbers are limited" * 
"Trace size limit is: %u" 
Reports tracing options. Lines marked with (*) may not be shown if respective options are not used
No action necessary.
N/A Informational License restrictions: 
"- Dump maximum %u records"
"- Stop output after %u seconds"
"- Force  %s  tracepoints enabled"
"- Force  %s  tracepoints disabled "
If no restrictions:
"Non-restrictive license"
Verify terms of current license.
N/A Informational "Stop command was sent"
Control program sent stop command to driver.
No action necessary

© 2001 Golden Code Development Corporation.  ALL RIGHTS RESERVED