A messaging engine persists both volatile and durable data in its
data store, including messages, transaction states, and communication channel
states. You can use the database tools to view data in the data store for
a messaging engine.
Before you begin
Before you can use the CloudView tool to view data in a Cloudscape
data store for a messaging engine, you must have stopped the messaging engine.
Why and when to perform this task
Volatile data is lost when a messaging engine stops, in either
a controlled or an uncontrolled manner. Durable data is available after the
server restarts.
In some cases, you might want to view the data in a
data store; for example, to examine the messages being processed by the messaging
engine.
You can use the database tools for the data store to view data
in the data store for a messaging engine. For example, if the messaging engine
uses the default Cloudscape database, you can use the CloudView tool to view
request messages.
Steps for this task
- Start the CloudView tool. For example, on Windows
complete the following sub-steps:
- Open a command window
- Change directory to install_root/cloudscape/bin/embedded
- Type cview
- Open the data store for the messaging engine. Use the
CloudView tool to complete the following sub-steps:
- Click
- Browse to, then select, the database file.
For
a messaging engine, the database is stored in the directory install_root/profiles/profile_name/databases/com.ibm.ws.sib and has the name of the messaging engine; for example, for the default standalone
profile on Windows, the database file for the messaging engine localhostNode01.server1-SCA.SYSTEM.localhostNode01Cell.Bus
(for server1 on the SCA.SYSTEM bus) is:
install_root/profiles/default/databases/com.ibm.ws.sib/localhostNode01.server1-SCA.SYSTEM.localhostNode01Cell.Bus
- Click Open
- Use the CloudView controls to view data.
- Expand Tables in the navigation pane.
- Click a table name.
- In the content pane, click the Data tab.
- Optional: Display more help about using the CloudView
tool.
To view help about using CloudView, click the Help button
or the menubar option .