Stopping a local mapping service by using the command line

Stop a started local mapping service to stop the interception of requests between a service client and a service provider.

Before you begin

You must have created a local mapping service, and started it. See Creating a local mapping service by using the command line. and Starting a local mapping service by using the command line

About this task

You can stop a local mapping service by using wsadmin commands, or by using the administrative console as described in Stopping a local mapping service by using the administrative console. You can stop one or more local mapping services at a time.

When you create a local mapping service, the default state of that local mapping service is started. When a local mapping service is stopped it can no longer intercept requests that are intended for the target endpoint of that local mapping service. If a request is sent to the target endpoint of a local mapping service, and that local mapping service is stopped, then an error message is displayed, stating that the local mapping service is not available.
Note: When you stop a local mapping service that has an attached service map, the business-level application (BLA) associated with that service map is also stopped.

Procedure

  1. Launch wsadmin by starting the wsadmin scripting tool.
  2. Use the stoplmservice command to stop the local mapping service, as the following example shows:
    AdminTask.stopLMService('Route') 
    The system stops the local mapping service and the command returns a message that the local mapping service was stopped successfully.
  3. Save your configuration changes by using the following command:
    AdminConfig.save()
  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 stopped the local mapping service and requests are no longer intercepted.


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_stoppingalocalmappingservice
File name: tsm_stoppingalocalmappingservice.html