installServiceMap command

Use the installServiceMap command to install a service map in preparation for attaching that service map to one or more local mapping services.

Purpose

The installServiceMap command installs a service map to the service map repository. After you install a service map, you can attach that service map to one or more local mapping services.

Target object

None

Required parameters

-sourceLibrary
Specifies the name of the service map library compressed file with extension .zip or .slibzip that contains the service map that you want to install.

Optional parameters

-sourceServiceMap
Specifies the name of the service map file that you want to install as a service map. If the service map library has multiple service map files, this parameter is required.
-name
Specifies a human readable name for the service map. A service map must have a name. If you do not specify a name, the name is derived from the ID value of the service map that is to be installed.
Names must be unique within a cell, cannot begin with a number, dot or minus character, and cannot contain unsupported characters. The following characters are not supported:
\/,.#$@:;"*?<>()|=+&%'![]{}
(space)
the character combination ]]> 
-description
A description for the service map.
-deploymentTargets
The names of the clusters or servers on which to install this service map. Use one of the following formats:
  • For a cluster of application servers: WebSphere:cluster=myClusterName.
  • For an application server that is not a cluster member: WebSphere:node=myNodeName,server=myServerName.

To specify multiple targets, precede each additional target with the plus sign (+). For example: WebSphere:cluster=myCluster1+WebSphere:cluster=myCluster2.

-targetServiceEndpoints
Specifies target service endpoints to be passed to the install command. These endpoints are set as the overriding endpoint address for each target service that is specified in the source service map.
Each target service endpoint is specified by name and endpointURL table step parameters. Because they are table steps, the order of the two parameters is fixed, and you must always specify the name first and the endpointURL second:
  • In Jython:[name endpointURL]
  • In Jacl: {name endpointURL}

Example usage

The following example shows how you install a service map named MyServiceMap.

Using Jython:

Input message:
AdminTask.installServiceMap('-sourceLibrary serviceMapLib.slibzip -sourceServiceMap myMap.srvcmap -name MyServiceMap -description "My simple service map" -targetServiceEndpoints[[MyServiceService http://localhost:9080/MyServiceService][MyEnhancedServiceService http://localhost:9080/MyEnhancedServiceService]]') 
Output message:
MyServiceMap

Using Jacl:

Input message:
$AdminTask installServiceMap {-sourceLibrary serviceMapLib.slibzip -sourceServiceMap myMap.srvcmap -name MyServiceMap -description "My simple service map" -targetServiceEndpoints {{MyServiceService http://localhost:9080/MyServiceService} {MyEnhancedServiceService http://localhost:9080/MyEnhancedServiceService}}} 
Output message:
MyServiceMap

Icon that indicates the type of topic Reference 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-base-iseries&topic=rsm_installservicemapcmd
File name: rsm_installservicemapcmd.html