Viewing data in a data store

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

  1. Start the CloudView tool. For example, on Windows complete the following sub-steps:
    1. Open a command window
    2. Change directory to install_root/cloudscape/bin/embedded
    3. Type cview
  2. Open the data store for the messaging engine. Use the CloudView tool to complete the following sub-steps:
    1. Click File > Open
    2. 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
    3. Click Open
  3. Use the CloudView controls to view data.
    1. Expand Tables in the navigation pane.
    2. Click a table name.
    3. In the content pane, click the Data tab.
  4. Optional: Display more help about using the CloudView tool.

    To view help about using CloudView, click the Help button or the menubar option Help > Cview help....


Terms of use |

Last updated: Tue Feb 21 17:19:19 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)