Starting a local mapping service by using the command line

You must start a local mapping service so that it can intercept requests that are destined for the target endpoint of that local mapping service.

Before you begin

Ensure you have created a local mapping service and installed a service map. The local mapping service you are starting must have a service map attached to it for a service mapping to work. See Creating a local mapping service by using the command line, Installing a service map by using the command line and Attaching a service map to a local mapping service by using the command line.

About this task

You can start a stopped local mapping service by using wsadmin commands as described in this topic, or by using the administrative console as described in Starting a local mapping service by using the administrative console.

When you create a local mapping service the default state of that local mapping service is started.
Note: When you start a local mapping service that has an attached service map, the business-level application (BLA) associated with that service map is also started.

Procedure

  1. Launch wsadmin by starting the wsadmin scripting tool.
  2. Use the startLMService command to start the local mapping service, as the following example shows:
    AdminTask.startLMService('Route')
    The system starts the local mapping service and the command returns a message that confirms the local mapping service was started successfully.
  3. Save your configuration changes by using the following command:
    AdminConfig.save()
    Requests are now intercepted, and can be rerouted, transformed, or both.
  4. If you are in a clustered environment, you must synchronize the nodes. Use the syncActiveNodes script in the AdminNodeManagement script library to synchronize each active node in your environment, as the following example demonstrates:
    AdminNodeManagement.syncActiveNodes()

Results

You have started the local mapping service.

What to do next

Optional: stop the local mapping service to stop intercepting requests; see Stopping a local mapping service by using the command line.


Icon that indicates the type of topic Task topic

Terms and conditions for information centers | Feedback


Timestamp icon Last updated: Tuesday, 22 April 2014
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=tsm_startingalocalmappingservice
File name: tsm_startingalocalmappingservice.html