This service alters the values of an existing listener. You must populate the input pipeline according to the table below before calling this service. To obtain a list of supported template and schedule properties, call the service wm.art.dev.listener:fetchListenerTemplateMetadata. You must disable a listener before updating its properties, using the disableListener service. For more information, see the webMethods Integration Server Built-In Services Reference for your release.

The value of the systemName metadata attribute is the internal name of a property. When constructing the input parameter listenerSettings, use this internal name as the key for setting a property's value. For an example of setting a connection property, see the Java code example in wm.art.dev.listener:createListenerNode.

You only need to supply values for the properties you want to change. This service will attempt to overlay these new values on the listener's current property values. The resulting set of merged property values will be used to reconfigure the listener.

You can change the connection resource that the listener uses by providing a new connectionAliasinput parameter. If you omit this parameter, the listener will continue to use its current connection resource. If you are changing only the connection resource, it is not necessary to provide the listenerSettingsinput parameter.

When providing explicit property values in listenerSettings, you must provide values that conform to the underlying data types of those properties.

Be aware of any resource domains registered by the listener, and set the listener's properties according to the interdependencies between resource domains. Knowledge of these interdependencies is adapter-specific, and beyond the scope of this service. This service does not interpret resource domains.

None.