Administering maps

You can start and stop maps from either System Monitor or the InterChange Server Component Management view of System Manager.

This section covers the following topics:

Viewing map states

"Starting and stopping maps"

Viewing map states

You can view the state of a map either by logging on to System Monitor and opening a view that contains map 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 map is represented differently, depending on which tool you are using.

Steps for viewing map states in System Monitor

Perform the following steps to view the state of map using System Monitor:

  1. With the System Overview view displayed, click the Maps and Relationships link under Views in the left pane of the Web page. The Map Status and Relationship Status monitors appear (see Figure 11) in the body of the Web page.
  2. The default view and default 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.

Note:
You may also view map states using the Maps and Relationships view.

Steps for viewing map states in System Manager

Perform the following steps to view the state of map using System Manager:

  1. Connect to the InterChange Server instance that contains the map you want to view. See Steps for connecting to an InterChange Server instance for instructions on connecting to an InterChange Server instance.
  2. Expand the InterChange Server instance, then expand the Maps folder. The maps appear under the expanded Maps folder with different colored lights to indicate their different states (see Figure 29).

    Figure 29. Maps folder in the InterChange Server Component Management view of System Manager

    The figure shows a view of the maps listing on the InterChange Server Component management screen. This lists the available maps in a tree heirarchical display.

Table 16 lists the map states represented by the display color on the map icon and describes what actions can be performed during that state. For more information about maps, refer to the Map Development Guide.

Table 16. Map States

Map State/Traffic Light Description
Active (green) Map is ready to run and available for use in the IBM WebSphere InterChange Server system.
Inactive (red) Map is not ready to run or available for use in the IBM WebSphere InterChange Server system.
Unknown (do not display) Map has not been compiled or the map class is missing. The map is not ready to run or available for use in the IBM WebSphere InterChange Server system. Compiling the map in Map Designer puts the map in active state, while saving the map puts the map in unknown state. Maps with unknown state display in the object browser map tree.

Starting and stopping maps

Maps define the transfer (or transformation) of data between the source and destination business objects. In the IBM WebSphere InterChange Server environment, data is mapped from an application-specific business object to a generic business object or from a generic business object to an application-specific business object. For detailed information about how maps are used in the IBM WebSphere InterChange Server system, refer to the Map Development Guide.

This section describes the how to start and stop maps. For information about additional tasks in using maps, including map compilation, map properties, data validation levels, explicit and implicit transaction bracketing, and map instance reuse, see the System Implementation Guide.

Map activation

For a map to be executable, it must first be activated. Map Designer automatically starts a map when it successfully compiles the map. However, other changes to the map might require that you explicitly stop and restart the map for the change to take effect. See Appendix B, Requirements for restarting IBM WebSphere Business Integration system components to find out what changes require maps to be stopped and restarted.

Steps for starting and stopping maps

Depending on which tool you are using, you start and stop maps in different ways.

Steps for starting and stopping maps in System Monitor

Perform the following steps to start or stop a map using System Monitor:

  1. If the System Overview view is displayed, click the Maps and Relationships link under Views in the left pane of the Web page. The Map Status and Relationship Status monitors appear (see Figure 11) in the body of the Web page.
  2. Select the Start or Stop icon from the icon group in the upper-left corner of the view (see Figure 24).

Note:
You may also start and stop map using the Maps and Relationships view.

Steps for starting and stopping maps in System Manager

Perform the following steps to start or stop a map using System Manager:

  1. From the expanded Maps folder in the InterChange Server Component Management view (see Figure 29), right.-click a map.
  2. Select either the Start <name_of_map> or Stop <name_of_map> option.

Copyright IBM Corp. 1997, 2004