mcfttrc [-t "[size=trace-buffer-size] [disk=yes|no] [bufcnt=trace-buffer-count] [trccnt=trace-file-count] [msgsize=maximum-size-of-a-message-that-can-be-acquired- as-trace-data]"] [-m del|off]

This command defines the environment related to an MCF trace. An MCF trace collects information related to MCF, and uses it for troubleshooting.

-t

(Operands)

size=trace-buffer-size~<unsigned integer> ((multiple of 4 between 4096-15728640)) <<204800>> (Unit: bytes)

Specify the size of the buffer for storage of an MCF trace. Normally, use the default value. MCF will check and revise the specified value as follows:

1. if the specified value is smaller than the minimum value determined by MCF, it is revised upward to the said minimum value.
2. if the specified value is larger than the maximum value determined by MCF, it is revised downward to the said maximum value.
3. if the specified value is not a multiple of 4, it is rounded up to the nearest multiple of 4.

disk=yes|no~<<yes>>

Specify whether the MCF trace disk output function is to be used.

yes

Disk output function is used. The contents of the buffer are output (swapped) to disk when the memory buffer becomes full of trace information.

An MCF trace file is output under the $DCDIR/spool/ directory, with the file name mcftXXXnn (XXX: MCF identifier, nn: serial number).

When an MCF communication process and application startup process terminated abnormally, the latest trace information may be output to the file mcftXXX0 which is not included in the number of trace files specified with the trccnt operand.

no

Disk output function is not used. The trace is output to memory only.

If this disk operand is not specified, an MCF trace file is not created; two buffers in memory are used interchangeably. As well, specifications of the following bufcnt operand, trccnt operand, and -m option are invalid.

bufcnt=trace-buffer-count~<unsigned integer> ((10-2147483647)) <<100>>

Specify the number of trace buffers to be stored in the MCF trace file. To compute, divide the trace file size by the trace buffer size.

trccnt=trace-file-count~<unsigned integer> ((3-99)) <<3>>

Specify the number of MCF trace files. Specify the sum of the swapped trace files (trace files for which swapping terminated the number of times specified in the bufcnt operand) and the swap files.

msgsize=maximum-size-of-a-message-that-can-be-acquired-as-trace-data~<unsigned integer> ((0-1073741824)) <<128>> (Units: bytes)

The MCF acquires part or all of a sent or received message as trace data. Use this operand to specify the maximum number of bytes that can be acquired as trace data from the beginning of a sent or received message.

When you specify 0, messages are not acquired as trace data. If the size of a message is smaller than the specified value, the entire message is acquired as trace data.

This operand is valid for the MCF communication services using TP1/NET/TCP/IP.

-m del|off~<<del>>

Specify the relationship between the number of swapped trace files and the value specified with the trccnt operand.

del

When the number of swapped trace files reaches the value specified with the trccnt operand, the oldest swapped trace file is deleted and a swap trace file is created with the name of the deleted file.

off

The value specified with the trccnt operand is ignored. When the number of swapped trace files reaches 99, the oldest swapped trace file is deleted and a swap trace file is created with the name of the deleted file.

It is the operator's responsibility to delete the swapped trace files, which are taxing the disk free space.