The Open Capture File command is sent to the analyzer to open the specified capture file. If there is a capture file open, any changes to that file will be discarded. The capture file path must represent a valid file that is not already open. This command does not require capture hardware to be connected. The command format is:
“Open Capture File;<capture file path>[;notify=<value>]”
The “notify” parameter is used to signal a desire to delay the command response until file processing has completed. Valid values are
-
0 – Do not wait to for open to complete before sending response.
-
1 – Wait until open is complete to send response.
Example – “Open Capture File;F:\My Capture Files\CaptureFile.cfa;notify=1”
Response: “OPEN CAPTURE FILE;<status>[;Reason=<reason>]” where a reason will only be supplied for FAILED status.
By default, the successful notification response is sent immediately after the capture file is opened successfully. The frame compiler may run for several minutes after a large capture file is opened. If an HTML Export command or Export command is sent before the frame compiler completes, the exported file will not contain all the frames.
If it is important to wait for the frame compiler to complete before proceeding the optional “Notify” parameter with a value of “1” can be used to delay sending the success notification.
If transitioning from a live-capture mode to file-view mode and the command fails, the datasource may be closed.