This documentation supports the 20.02 version of BMC CMDB.To view an earlier version, select the version from the Product version menu.

Publishing, unpublishing, and finding custom web services


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

  • 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. 

To prepare the environment to run the scripts

  1. Open a command window.
  2. 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)
  3. In registryserver.properties, modify the server name and port number of the UDDI server.
  4. 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
  5. 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 serviceFor 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


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*