This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Unified Service Modeling plug-in troubleshooting

The primary purpose of the Unified Service Modeling (USM) plug-in is to provide an interface that offers convenience for working with business services. This plug-in provides an interface for BMC Remedy AR System applications like BMC Service Request Management and BMC Cloud Lifecycle Management to access USM related features through the vendor form. The plug-in name is BMC.ARDBC.ATRIUM.API.


The USM plugin is used for specific purposes in BMC products and it cannot be used for any other purpose in this release.

Plug-in type

The Unified Service Modeling plug-in is a Java-based ARDBC plug-in available in BMC Atrium Core versions 7.6.04 and above. This plug-in is for internal BMC usage.

Communication with back office applications

The USM plug-in invokes the USM functionality through the getListEntryWithFields and getEntry queries that are performed against the vendor form CMDB:USMAPIInterface. Queries are passed as a series of parameters and values, where the first parameter indicates the USM API function to perform. For example: "function" = "cmdbROCreate".

The general syntax for the query is:
"parameter1" = "value1" AND "parameter2" = "value2" AND ...

AR System server connectivity

AR Server invokes this plug-in when you issue queries against the vendor form CMDB:USMAPIInterface. The USM plug-in makes CMDB/AR APIs using the plug-in context that is passed through the ARDBC interface (getListEntryWithField, getEntry, and so on).

Configuration information

The USM plug-in receives its configuration from the AR System Administration:Plugin Server Configuration form.

The following table lists the supported configuration parameters:

User Defined Elements

Default Value






BMC Sample - Identification and Merge









To configure BMC.ARDBC.ATRIUM.API.userDefined.private_rpc_socket parameter

Perform the following procedure for manually adding the BMC.ARDBC.ATRUIN.API.userDefined.private_rpc parameter:

  1. Log in to the AR System server.
  2. Open AR System Administration > Server Information > Plug-in Server Configuration.
  3. Select BMC.RDBC.ATRIUM.API plug-in.
  4. Click Modify.
  5. Click  button in User Defined Elements section and manually add the parameter.
  6. Click OK.

BMC Atrium Core version 9.1.03 and later, you can specify values serially between 300867 to 300886, and 390698 or 390699 for RPC.

The AR System Administration:AR System Configuration Generic UI form should have the configuration information as follows:

Server-Plugin-Alias: BMC.ARDBC.ATRIUM.API BMC.ARDBC.ATRIUM.API <host name>:port number

See Updating plug-in configuration settings and see AR System Configuration Generic UI form  in BMC Remedy Action Request System documentation.

Troubleshooting tips

The logs related to USM plug-in can be found in the following locations:

  • Atrium shared plugin server log — <cmdb install>\Logs\AtriumPluginsvr.log
  • USM plugin log — <cmdb install>\Logs\atrium-ar-kit-USM.log

How to turn on logging for debugging

  1. Open the AR System Administration: Plugin Server Configuration form.
  2. On the Plugin Server Configuration tab change the logging level from INFO to DEBUG. See  Logging Configurations in  Setting plug-in server options in BMC Remedy Action Request System documentation.
  3. Click Apply.

Related topic

Enabling plug-ins

Was this page helpful? Yes No Submitting... Thank you