Publishing, unpublishing, and finding custom web services

You can use the following Web Service Registry API sample scripts to register, unregister, and find your

Unable to render {include} The included page could not be found.

:

publish (register)
unpublish (unregister)
find

These scripts can be modified to meet the needs of your company using the WSRegistry Java API.

Script parameters

The script parameters are described in the following table.

Parameter name	Description
`ServiceName`	Name of the service
`ServiceVersion`	Version of the service
`BusinessName`	Name of the BusinessEntity
`ServiceDescription`	Description of the service
`AccessPointUrl`	URL of the service access point. For example: http://goldserver:9090/atriumversions_porttype
`WSDLUrl`	URL of the service WSDL if this is a WSDL service. For example: http://goldserver:9090/atriumversions_porttype?wsdl
`ApproximateMatch`	Whether to do approximate matching. Y — calls `findServices()` N — calls `findService()`

To prepare the environment to run the scripts

Open a command window.

Navigate to the Atrium Core Installation directory.
For example, in a Windows environment, the default location is:

<ATRIUMCORE_INSTALL_DIRECTORY>\wsc\wsregistryapi\conf
 
ATRIUMCORE_INSTALL_DIRECTORY example, C:\Program Files\BMC Software\AtriumCore\<ARserverHostname>.  
(The <ARserverHostname> is optional depending, on the installation directory and server group option)

In registryserver.properties, modify the server name and port number of the UDDI server.
Verify that the following values are defined correctly in env.cmd (located in <ATRIUMCORE_INSTALL_DIRECTORY>\wsc\wsregistryapi\scripts\):
- JAVA_HOME ( example, <ATRIUMCORE_INSTALL_DIRECTORY>/jdk1.6.0_29/jre)
- CLIENT_HOME (example, (i.e. <<ATRIUMCORE_INSTALL_DIRECTORY>/wsc/wsregistryapi)
- UDDI username
- UDDI password
Edit the following scripts to provide the required parameters:

publish  {ServiceName} {ServiceVersion} {BusinessName} {ServiceDescription} {AccessPointUrl} {WSDLUrl}
unpublish  {ServiceName} {ServiceVersion} {BusinessName}
findsvc  {ServiceName} {ServiceVersion} {BusinessName} {ApproximateMatch}

To register a web service

You can execute the following command to register a service. For example, to register the IIWS 1.0 service.

ServicePublisher publish IIWS 1.0 BMC MyIIWS http://myhost:6070/imapi http://myhost:6070/imapi?WSDL

To publish a custom web service

You can execute the following command to publish a custom web service. For example,

publish IIWS 1.0 BMC MyIIWS http://myhost:6070/imapi http://myhost:6070/imapi?WSDL

To unpublish a web service

You can execute the following command to unpublish a custom web service. For example,

unpublish IIWS 1.0 BMC MyIIWS http://myhost:6070/imapi http://myhost:6070/imapi?WSDL

To find a web service

You can run the following command to find the IIWS Web Service:

TestUDDIRegistry findsvc IIWS 1.0 BMC Y

Specifying versions for web services

Best practices for backward compatibility of web services

Modifying the AR System server used as a web services userstore