3.2.3 hwstraceinfo
The hwstraceinfo command collects the internal trace.
Synopsis
hwstraceinfo -i shared-memory-identifier -l file-name
Storage location
Application Server installation directory\httpsd\sbin
Function
When an application program is executed and a request is received, the events that occur in the system are collected as internal trace. The internal trace is output once to the shared memory, and then it is output to the file as per the specification in the directive or command.
- Collecting trace information
-
Internal traces are collected in the shared memory when various events occur in the Web server. The memory identifiers of shared memory are stored in the file specified in the HWSTraceIdFile directive.
- How to output to a file
-
The internal trace that is collected in the shared memory is output to a file when the server process terminates abnormally or when the hwstraceinfo command is executed. When the server process terminates abnormally, the trace is output to the file specified in the HWSTraceLogFile directive.
Specify the memory identifier and file name of output destination, in the hwstraceinfo command.
The internal trace information output file size is as follows:
7KB x ThreadPerChild value
Execution permission
Administrator account or the standard user account. However, if you use a standard user account to execute this command, use the standard user account specified as the Web server service logon account in "Operation by general user accounts". You cannot use a user account with Administrators authority to execute this command.
Arguments
- -i shared-memory-identifier
-
This parameter specifies the shared memory identifier that is output to the file specified in the HWSTraceIdFile directive.
- -l file-name
-
This parameter specifies the file that outputs the trace corresponding to the shared memory identifier specified with -i.
Examples
The following is an example to output the trace corresponding to the shared memory identifier 1800_1133780652_0, to the traceinfo.log file:
hwstraceinfo -i 1800_1133780652_0 -l traceinfo.log