Session Data Viewer Options
After you use the New Session dialog to configure either a Data Retrieval Session that points to the input files that contain the data you want to work with, or a Live Trace Session that you are ready to run, you can choose one of the data viewers previously described in the Data Viewers section to display your data. You can also simply allow Message Analyzer to present your session results in the default Analysis Grid viewer, unless you have already set another type of data viewer as the default in the Options dialog. If you want to choose a data viewer for a session, select one from the common Start With drop-down list in the New Session dialog prior to starting the session. After you click the Start button in the New Session dialog, Message Analyzer immediately begins to retrieve or capture data and display it in the chosen viewer.
Data Viewing Options
Note that the data viewer that appears in the text box portion of the Start With combo box when you open the New Session dialog, is the default viewer that is set in the global Options dialog; this dialog is accessible from the Message Analyzer global Tools menu. At any time, you can specify the default data viewer of your choice for all sessions, as described in Setting the Default Session Viewer, although you still have the option to choose a different one prior to starting a new session. However, the default data viewer setting will persist in each subsequent reopening of the New Session dialog, which provides you with the same option again to use the default viewer or choose another one. In addition, after session results display in the viewer you specified in session configuration, you have the option to display data in any of the other available data viewers to enhance data analysis by selecting them from the Session Explorer Tool Window or from the New Viewer drop-down list, as described in Data Viewer Selection Locations. The data viewers that are available in Message Analyzer are described in the Data Viewers section.
Note If you specify additional data viewers for the results of a particular Data Retrieval Session or Live Trace Session, Message Analyzer will automatically repopulate the original data set to the additional viewers in the same session.
Data Viewer Selection Locations
You can specify any of the available Message Analyzer data viewers from the common data viewer Library that is accessible in each of the following locations:
Data Retrieval Session configuration — provides data viewer selections from the common Start With drop-down list in the New Session dialog during session configuration.
Live Trace Session configuration — provides data viewer selections from the common Start With drop-down list in the New Session dialog during session configuration.
Tool Window — provides data viewer selection commands from a context menu that is accessible by right-clicking any session node or viewer node in the Session Explorer window.
New Viewer — a drop-down list that is accessible from the following locations:
Message Analyzer global Session menu.
Message Analyzer global toolbar.
- Message Analyzer global Session menu.
Specifying a different data viewer typically adds a separate viewer tab that contains an alternate data presentation format for the specific session that you choose, while retaining all other data viewers already in place for the chosen session. Note that the different data viewers that you specify for the results of a Live Trace Session or Data Retrieval Session create various data presentations, but do not modify the original contents of the trace or loaded message collection.
Setting the Default Session Viewer
You have the option to set a default data viewer for all sessions by selecting one from the Select Default Viewer drop-down list in the Session Viewer pane of the global Options dialog. You can access this dialog from the Message Analyzer global Tools menu. After you select a data viewer as the default, it displays in a label within the Session Viewer pane. Message Analyzer ships with the Analysis Grid as the default viewer for all sessions, but you can change to another viewer to customize your data analysis environment, as follows:
Global mode — you can change the default data viewer that will be used by all sessions, from the Analysis Grid factory setting to any viewer that you choose in the Select Default Viewer drop-down menu in the Session Viewer Defaults pane.
Session specific mode — you have the option to use a data viewer of choice whenever you start a session, regardless of what the default setting is, by clicking the Start With drop-down list in the New Session dialog and selecting a viewer.
Note Because the Details, Field Data, Message Data, Message Stack, Decryption, Diagnostics, and other tool windows — accessible from the Windows submenu of the Message Analyzer global Tools menu — are either message-specific windows (respond to message selection) or session-specific (snap-to data viewer selection) windows, they depend upon and interact with the data viewers. As a result, you cannot specify one of these windows to start a Live Trace Session or Data Retrieval Session.
Tip When you have session results data for which you have specified multiple data viewers, for example, the Protocol Dashboard and the Analysis Grid viewers, you can bring the message data contained in a particular viewer into focus by clicking its associated node in the Session Explorer window, or by selecting its associated viewer tab.
To learn more about Message Analyzer data windows that interact with data viewers, see the Tool Windows topic.
To learn more about how to configure and save custom Chart data viewers, see Configuring Chart Data Viewers.