You can start and stop relationships from either System Monitor or the InterChange Server Component Management view of System Manager.
This section covers the following topics:
Starting and stopping relationships
You can view the state of a relationship either by logging on to System Monitor and opening a view that contains relationship status or by using the InterChange Server Component Management view of System Manager. To log on to System Monitor, follow the instructions in Steps for logging on to System Monitor. To use the InterChange Server Component Management view of System Manager, follow the instructions in Steps for connecting to an InterChange Server instance..
The state of a relationship is represented differently, depending on which tool you are using.
Steps for viewing relationship states in System Monitor
Perform the following steps to view the state of relationships using System Monitor:
The default view and monitor are set to System Overview. These defaults can be changed to suit your monitoring needs. See Setting up views to monitor the system for instructions.
Steps for viewing relationship states in System Manager
Perform the following steps to view the state of relationships using System Manager:
Table 17 lists the relationship states represented by the display
color and describes what actions can be performed during that state.
Relationship state/Display color | Description |
---|---|
Active (green) | Relationship is ready to run and available for use in the IBM WebSphere InterChange Server system. To use Relationship Manager on a relationship, the relationship must be in the active state. |
Inactive (red) | Relationship is not ready to run or available for use in the IBM WebSphere InterChange Server system. This state is entered when the relationship is stopped, where all current jobs in queue are completed and no new jobs are accepted. To modify a relationship definition, it must be in this state. |
Unknown (grey) | Relationship does not have a compatible run time schema. To create a compatible run time schema, from the Relationship Designer, save the relationship with the Create run time schema option selected. The state changes to Inactive, at which point the relationship can then be started. |
Relationships are used to establish associations between business object attributes that cannot easily be mapped. The tool used for creating relationships is Relationship Designer. For more information about Relationship Designer, see the Map Development Guide.
When you expand the Relationships folder in the InterChange Server Component Management view of System Manager, two subfolders appear: Dynamic and Static.
This section describes the following topics:
Steps for starting and stopping relationships
For a relationship to be executable, it must be activated. However, you cannot modify a relationship when it is active. Therefore, you must stop the relationship, make the change to the relationship, and then restart the relationship. See Appendix B, Requirements for restarting IBM WebSphere Business Integration system components to find out what changes require relationships to be restarted.
Depending on which tool you are using, you start and stop relationships in different ways.
Steps for starting and stopping relationships using System Monitor
Perform the following steps to start and stop relationships using System Monitor:
Steps for starting and stopping relationships using System Manager
Perform the following steps to start and stop relationships using System Manager:
From the expanded Dynamic or Static folder in the InterChange Server Component Management view of System Manager (see Figure 30), right-click the name of a relationship, then select Start <relationship_name> or Stop <relationship_name>.
As part of the design process of a static relationship, a developer can indicate whether the relationship's tables are to be cached in memory. A static relationship is one whose data does not change frequently. If the developer has indicated that the static relationship's tables can be cached, you can control whether to enable caching from System Manager. System Manager lists all static relationships in the folder labelled Static under the Relationships folder.
Perform the following steps to enable relationship table caching for a static relationship:
When the Cached option appears with a check mark to the left, InterChange Server reads the relationship tables into memory the next time the run time data is accessed.
Perform the following steps to disable relationship table caching for a static relationship:
When the Cached option appears with no check mark to the left, InterChange Server reads run time data from the tables in the relationship database.
Steps for reloading the cached tables
Perform the following steps to have InterChange Server reread the relationship's tables into memory with the Reload feature:
When you choose this option, InterChange Server reloads the cached relationship tables by rereading the tables from the relationship database into memory. This option is useful when the static relationship's tables are updated directly in the database through SQL statements. To get the more current version of the tables into cache, choose the Reload option.
Steps for tracing cached tables
Perform the following step to have InterChange Server log a trace message each time it loads and unloads relationship tables in memory:
RELATIONSHIP.CACHING=5
InterChange Server routes these messages to the trace file (if one is configured). By default, InterChange Server does not generate trace messages when it loads and unloads the relationship tables. Trace levels less than five (0-4) do not produce messages either.