Unified Service Modeling plug-in

This plug-in provides an interface for Action Request 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.

Important

The USM plug-in 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 Helix CMDB 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 System server invokes this plug-in when you issue queries against the vendor form CMDB:USMAPIInterface. The USM plug-in generates 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.

Unified Service Modeling plug-in.png

The following table lists the supported configuration parameters:

User Defined Elements	Default Value
BMC.ARDBC.ATRIUM.API.userDefined.perform_reconcile	false
BMC.ARDBC.ATRIUM.API.userDefined.golden_dataset	BMC.ASSET
BMC.ARDBC.ATRIUM.API.userDefined.reconcile_jobname	BMC Sample - Identification and Merge
BMC.ARDBC.ATRIUM.API.userDefined.reconcile_dataset_source	BMC.SAMPLE
BMC.ARDBC.ATRIUM.API.userDefined.reconcile_dataset_target	BMC.ASSET
BMC.ARDBC.ATRIUM.API.userDefined.reconcile_wait_interval	1
BMC.ARDBC.ATRIUM.API.userDefined.reconcile_wait_in_secs	20

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

Perform the following steps to manually add the BMC.ARDBC.ATRUIN.API.userDefined.private_rpc parameter:

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

In BMC Helix CMDB 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