You can start and stop relationships from the Web-based System Monitor.
This section covers the following topics:
Starting and stopping relationships
You can view the state of a relationship by logging on to the Web-based System Monitor and opening a view that contains relationship status. To log on to the Web-based System Monitor, follow the instructions in Logging on to the Web-based System Monitor.
Table 8 lists the relationship states represented by the System View
traffic light display color and describes what actions can be performed during
that state.
Relationship State/Traffic Light | Description |
---|---|
Active (green) | Relationship is ready to run and available for use in the Business Integration Express for Item Sync 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 Business Integration Express for Item Sync 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 runtime schema. To create a compatible runtime schema, from the Relationship Designer, save the relationship with the Create runtime 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 System Manager, two subfolders appear: Dynamic and Static.
This section describes the following topics:
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.
To start and stop relationships, do this:
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.
To enable relationship table caching for a static relationship:
When the Cached option appears with a check mark to the left, InterChange Server Express reads the relationship tables into memory the next time the runtime data is accessed.
To disable relationship table caching for a static relationship:
When the Cached option appears with no check mark to the left, InterChange Server Express reads runtime data from the tables in the relationship database.
You can tell InterChange Server Express to reread the relationship's tables into memory with the Reload feature, as follows:
When you choose this option, InterChange Server Express 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.
To tell InterChange Server Express to log a trace message each time it loads and unloads relationship tables in memory, set the RELATIONSHIP.CACHING configuration parameter to five (5) in the TRACING section of the InterchangeSystem.cfg file:
RELATIONSHIP.CACHING=5
ICS routes these messages to the trace file (if one is configured). By default, ICS 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.