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

The LCK performance verification trace definition defines the execution environment for acquiring LCK performance verification trace information.

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):

Size of one file = 128 + ((1024 x (D + T + M) + R x 128) x number-of-transactions-executed)

D: Number of accesses (referencing or updating) to the DAM service per transaction branch

T: Number of accesses (referencing or updating) to the TAM service per transaction branch

M: Number of accesses (referencing or updating) to the MQA service per transaction branch

R: Number of times the locking function is executed per transaction branch

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.

prf_information_level=1|0

~<<1>>

Specify the display level of messages related to the LCK performance verification trace.

0

Messages related to the LCK performance verification trace whose display level is 0 (warning and error messages) are output to syslog.

1

Messages related to the LCK performance verification trace whose display level is 1 or lower are output to syslog.

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.

None

Use this definition only when TP1/Extension 1 is installed. If TP1/Extension 1 is not installed, the definition might not work correctly.