The third-party application must be modified to call the sm_ems command. The documentation for third-party applications provides more information about configuring the application to call the command line interface.

The basic format to call the command line interface is:

sm_ems --server=<server_name> [options ...] <command>

Command line interface options describes the options.

Table 1. Command line interface options




The name of the Adapter Platform Server. This parameter is required.


The name of the broker, if you override the broker set by the SM_BROKER environment variable.


Specifies the name or IP address of the existing system (Unitary Computer System) you want to associate with this event.

The event will automatically be associated with this system in the Adapter Platform topology.

The system name is converted to its canonical name using hostname lookups. For example, Host1 or might be converted to

If the system does not exist in the topology, it may be created automatically if the --create-system option is specified.


Determines that the unitary computer system should automatically be created if it does not exist in the topology. The Class defaults to Node, however you can optionally use --element-class to specify the class name. This option is deprecated, but retained for backwards compatibility.

The --create-element option can be used instead of this option to create any infrastructure element.


Determines the ClassName of the entity being created in the topology, if the element does not already exist.

Issue this option with --create-element and also --element-name.


Determines the InstanceName to be used with the --element-class option. Options provided with --element-class and --element-name will be used to create the object.


Do not use the --system option if you are also issuing the --element-class and --element-name options.


Determines that the element-class and element-name you specify should automatically be created if it does not exist in the topology.

Use this option to create any infrastructure element, including business elements, application-related elements, and unitary computer systems.


Determines the ClassName for the Aggregate Notification, if one is being created.


Determines the InstanceName for the Aggregate Notification, if an aggregate notification is being created (using the --aggregate-event option). Also creates an OccurredOn relationship between the Instance and the Aggregate Event.


Determines the EventName of an Aggregate Notification. This is a required option if you are creating an Aggregate.


Optional text to include in the description field of the audit log entry created for this action.


This option is ignored for the add-audit-log command.


Enables tracing of server communications.