Saving Session Data
Message Analyzer enables you to save message data that is loaded from any Data Retrieval Session or captured in any Live Trace Session. If you start a new Data Retrieval Session and load data from one or more saved message files; and you have displayed, manipulated, and analyzed the historical data; you can save the modified data set in the Message Analyzer native parsed (.matp) file or .cap file formats only. The capture file (.cap) format is for other applications, such as Microsoft Network Monitor.
If you open a supported message file (see Locating Supported Input Data File Types) of non-native format, for example with the Quick Open feature, and you manipulate the data, you can save the resulting data set in one of the indicated file formats only. Also, if you load data from a saved file in parsed .matp format or any other supported format, and you need to resave it after manipulating the data, you can only save it again in the same .matp format, or you can export it as a .cap file. If you start a new Live Trace Session, you can save the session data that you capture in either of the indicated file formats.
Using the Save As/Export Session Dialog
When you are ready to save your data, click the Save As item in the Message Analyzer File menu to display the Save As/Export Session dialog. This dialog provides you with the option to save all messages, a message set that resulted from applying one or more filters or other operations, or a selected set of messages from the Data Retrieval Session or Live Trace Session results.
For example, the session results that you save might be one of the following:
Multiple log files imported from a Data Retrieval Session that you consolidated and processed for analysis purposes.
Analyzed data from a Data Retrieval Session or Live Trace Session, where you manipulated the data results, for example, by applying a View Filter or Viewpoint.
Loaded trace data to which you applied a Session Filter or Time Filter, to narrow down the focus to a specific set of messages or a window of time, respectively.
Live trace data to which you applied a Session Filter or Fast Filter, to reduce trace results to a focused set of messages with specific properties.
Data captured in scenarios that used ETW system providers, keyword and level filters, adapter filters, or other special filtering and modifiers.
After loading, capturing, manipulating, and analyzing data, you can save your results set to a single native file only for which you specify a new name, or you can overwrite an original file with the modified results set. The save process aggregates all message data in the selected session (or a filtered subset of the data) into this single file no matter how many files you originally included in the input file configuration. Moreover, if you attempt to reload data from this newly saved file, Message Analyzer will display the name of the new file in the files list and retrieve all the aggregated data contained in that file after you start the Data Retrieval Session.
Message Analyzer also enables you to save session results after manipulating data for either of the following:
Any file that you open from the Recent File list, which displays to the right of Quick Open item when you hover your mouse over it in the Message Analyzer File menu.
Any logs or files that you load into Message Analyzer through the Quick Open feature.
Message Analyzer enables you to save data for one session at a time only. Even if you have multiple viewer tabs open for a particular session, only one data set will be saved for that session. If you save the session data and then reload it through a Data Retrieval Session, it will display in the Analysis Grid viewer by default, even if you had a viewer tab open for the session other than the Analysis Grid viewer. If you want to save data from more than one session displayed on the Message Analyzer Home tab, you will need to select appropriate session tabs and save the data for each session separately.
Important When you save data from a Live Trace Session in the native .matp file format, Message Analyzer automatically stores the OPN parsers used in the trace so that .matp files become portable. This ensures that a different Message Analyzer installation will be able to parse the messages in ported files when they are reloaded through a Data Retrieval Session or the Quick Open feature.
Saving Session Data to the Default Location
When you are ready to save your session data and you click the Save As button in the Save As/Export Session dialog to display the Save As dialog, the latter opens to the following default location for saving Message Analyzer session data:
By saving session data in this location, you are assured that you will retain all historical trace data that you previously saved, should you need to perform an upgrade or reinstallation of Message Analyzer. Note that you can change the default location in which to save your session data; however, you should not save any session data (or assets) to the following location because it is overwritten during Message Analyzer upgrades or reinstallations:
Tip If for some reason you need to use this location for storing Message Analyzer data, you should back up any session data or assets that you have stored there, as they will be deleted during Message Analyzer installation.
For an example of how to save message data that was loaded with a Time Filter applied, see the procedure Apply a Time Filter to Data Loading and Save the Message Collection.