OpenTP1 Version 7 System Definition
LCK performance verification trace definition
Format
set format
[set prf_file_size=LCK-performance-verification-trace-information-file-size] [set prf_information_level=1|0] [set prf_file_count= number-of-generations-for-LCK-performance-verification-trace-information-files]
Command format
None
Function
The LCK performance verification trace definition defines the execution environment for acquiring LCK performance verification trace information.
Explanation
set format operands
prf_file_size=LCK-performance-verification-trace-information-file-size
~<unsigned integer>((1024-1048576))<<5120>> (units: kilobytes)
Specify the size of an LCK performance verification trace information file.
Normally, trace information is output to regular files in OpenTP1. The number of generations of this file is specified by the prf_file_count operand in the LCK performance verification trace definition. When all generations have been used, the oldest file is overwritten with new trace information. Accordingly, old trace information is lost as time passes. You can increase the interval at which the oldest file is overwritten by increasing the value of this operand.
You can use the following formula to calculate the size of one trace file acquired during the execution of a transaction (units: bytes):
Note that the file size calculated using the formula is merely an estimate. The actual file size may be greater than the calculated value, depending on the UAP configuration or the like.
~<<1>>
Specify the display level of messages related to the LCK performance verification trace.
The following table shows the message IDs for the LCK performance verification trace and their display levels.
Message | Display level |
---|---|
KFCA26700-W | 0 |
KFCA26705-W | 0 |
KFCA26710-I | 1 |
To suppress the output of messages whose display level is 0, set the DCSYSLOGOUT environment variable to 0 in the system common definition or the performance verification trace definition. If the DCSYSLOGOUT environment variable is specified in both the system common definition and the performance verification trace definition, the specification in the system common definition takes precedence.
For details about the DCSYSLOGOUT environment variable, see the description of the DCSYSLOGOUT environment variable in Log service definition.
prf_file_count=number-of-generations-for-LCK-performance-verification-trace-information-files
~<unsigned integer>((3-256)) <<3>>
Specify the number of generations for the LCK performance verification trace information file.
Command format
None
Note
Use this definition only when TP1/Extension 1 is installed. If TP1/Extension 1 is not installed, the definition might not work correctly.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.