Viewing relationship instance results

Perform this task to view a list of instances that match the relationship instance query. The results display in table view and include the relationship instance ID and the property values associated with the instance.

Before you begin

Security role required: To perform this task, you must be logged in as a monitor, an operator, a configurator, or an administrator.

Steps for this task

  1. Ensure that the administrative console is running.
  2. In the navigation pane, click Integration Applications > Relationship Manager.
  3. Open the relationships page for the server you want to manage by clicking Relationships next to that relationship services MBean.
  4. In the Select column, select the relationship name; and click Query.
  5. Click one of the query option tabs (All, By ID, By property, or By role) and specify the search criteria. For descriptions of the query options, see Querying relationship instances
  6. Click OK to open the Relationship instance results page.

Result

The list of relationship instances that match your query appears in table view, with each relationship instance shown in its own row. The total page and returned instance counts are displayed at the bottom of the page.
Tip: You can customize the number of rows to display at one time. Click Preferences, modify the row field value, and click Apply The default is 25, with 1 being the minimum number of records to display at one time and all records being the maximum.
Restriction: Filtering or sorting on a large relationship instance count might result in performance problems as it requires getting the full query result set from the server in order to do the sorting. For example, sorting the relationship instance data on a query that would return 20,000 relationship instances needs to sort on those 20,000 instances. The total count (bottom of page) gives an estimate of how many relationship instances you can expect and whether sorting or filtering on a large set of data might lead to long wait times.

For information on setting the cache size hint parameter to allow for customization of how many instances are read from the server at one time, see the help topic on configuring the relationship service.


Last updated: Wed 06 Dec 2006 07:08:08

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