OpenTP1 Version 7 Operation
mcftstptr (End acquiring an MCF trace)
Format
mcftstptr -s MCF-communication-process-identifier
|
Function
The mcftstptr command ends the acquisition of an MCF trace and outputs the acquired trace data to the MCF trace file.
Options
-s MCF-communication-process-identifier~<numerals (0-9), a-f> ((01-ef))
Specify the identifier of the MCF communication process for which you want to end acquiring an MCF trace.
Output messages
Message ID |
Description |
Output destination |
KFCA10261-I |
Acquisition of trace data is ended. |
Message log file |
KFCA10264-W |
The command is ignored since trace data is being output. |
Message log file |
KFCA10265-E |
Command processing is canceled since the output to the trace file failed. |
Message log file |
KFCA10266-W |
Acquisition of trace data is not started. |
Message log file |
Notes
- You must execute the mcftstrtr command (command for starting the acquisition of an MCF trace) before you execute the mcftstptr command. If you do not execute the mcftstrtr command, an error occurs and an error message is output. However, if you have specified the use of the disk output feature for MCF traces in the MCF communication configuration definition (mcfttrc -t "disk=yes"), you do not need to execute the mcftstrtr command before you execute the mcftstptr command. In this case, the disk output feature stops after trace data is output to the MCF trace file. To enable the disk output feature again, execute mcftstrtr.
- If you repeatedly execute the mcftstptr command with the same MCF communication process identifier in the -s option, an error occurs and an error message is output.
- If a trace buffer swap occurs during acquisition of trace data after you execute this command and an MCF trace end request is generated, the MCF trace data is not output to the trace file. To output the MCF trace data, use the command for starting the acquisition of an MCF trace (mcftstrtr).
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.