renameEndpoint

Use the renameEndpint command to change the specified endpoint's friendly name in the sphere.

When multiple endpoints at the same URL are given the same name in their respective WSDL definitions, giving them unique friendly names can make it easier to distinguish between them in future commands and in command output. You must provide the endpoint URL and a new friendly name. All other parameters are optional and are included only to help you distinguish the desired endpoint from others with the same URL.

See Resolving Discovery Issues, for a discussion of the use of this command in resolving discovery issues.

Command Syntax

btmcli renameEndpoint -e endpointUrl -fn friendlyName [-bn bindingName]
                      [-w wsdlUrl] [-n name] [-service serviceName] 
                      [-qname qname] [-V version] [-interfaceQName interfaceQName]
                      -s sphereUrl -l username:password

Name	Long Name	Description
-e	--	The endpoint URL of a web service.
-bn	-bindingName	The binding for the endpoint. Used to disambiguate endpoint URLs with multiple bindings. For example: SOAP and HTTP
-w	-wsdlUrl	The URL of the WSDL file.
-n	-name	The existing friendly name of the endpoint to be renamed.
-service	--	The friendly name of the service to which the renamed endpoint belongs.
-qname	--	The qualified name of the service to which the renamed endpoint belongs.
-V	-version	The version of the service to which the renamed endpoint belongs. Use with the -service or -qname flags if needed. Use the "-" string to represent the default, unnamed version.
--	-interfaceQName	The qualified name of the interface the renamed endpoint implements.
-fn	-friendlyName	The new friendly name for the endpoint to be renamed.
-s	-sphereUrl	The URL of the sphere. http://hostname:port/btmcentral/sphere/ This flag is not required if you have set the AP_SPHERE_URL environment variable for your sphere.
-l	-userLogin	The username and password associated with the sphere, in the format: username:password. This set of credentials must belong to a user in the btmadmin role. See Security Options in Accessing CLI Commands for information on furnishing login credentials. You can encrypt passwords using the encryptPassword command.

Example

The following example shows the renameEndpoint command used to rename CreditService to MyCreditService.

btmcli renameEndpoint -e http://jbujes:7001/bookmart/credit/CreditService
                      -fn MyCreditService
                      -s http://localhost:8080/btmcentral/sphere
                      -l admin:abracadabra