Perform this task to view a list of relationship instances that
match the relationship query. The results display in table view and include
the relationship instance ID and the property values associated with the instance.
Before you begin
Required security role for this task: When security and role-based
authorization are enabled, you must be logged in as a monitor, an operator,
a configurator, or an administrator to perform this task.
About this task
To view a list of relationship instances that match the relationship
query, perform the following steps.
Procedure
- Ensure that the administrative console is running.
- In the navigation pane, click Integration Applications
> Relationship Manager.
- Open the relationships page for the server you want to manage by
clicking Relationships next to that relationship services
MBean.
- Select the radio button next to the relationship name and click Query.
- 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 relationships
- Click OK to open the Relationship Instances
page.
Results
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.
You can navigate through the
pages, as follows:
- To view the next set of instances, click the forward arrow.
- To view the previous page of instances, click the back arrow.
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 query
block size 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.