Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

CMS UI2018.08

How to Configure Periodic Data Flow Task Updates

When a data flow job is activated, the input TQL of the adapter is calculated once and is sent to the Data Flow Probe. If trigger CI data changes (for example, a laptop acquires a different IP address) the Data Flow Probe needs to be updated with the modified trigger CI data. As long as the Data Flow Probe is not updated with any changes, the query continues to run with out-of-date information.

To ensure that the Data Flow Probe is always kept up-to-date with possible changes in trigger CI data, you can configure UCMDB to recalculate trigger CI data and send any changes to the Data Flow Probe.

There are rare situations where triggers appear as part of a Service Discovery activity, although they are not part of the discovered service or CIs related to the service. In this case, the periodic data flow task updates will dispatch and undispatch these triggers to return the activity to its valid state.

Global Configuration

Data flow tasks for all adapters are updated per the global setting configured in the Infrastructure Settings.

Note Where necessary, you can configure updates for a particular adapter to behave differently. For details, see Adapter Configuration below.

To configure global data flow task updates:

Select Administration > Infrastructure Settings Manager.
Select the General Settings category.
1. Locate Enable periodic update of data flow tasks parameter and set the value to true.
2. Locate Periodic data flow task update interval (in hour) and Periodic data flow task update start time and specify how often (in hours) to update the data flow tasks, and the time (01-24) at which to start the update.
By default, this option is enabled, and the data flow tasks are updated once a day, at midnight.

Adapter Configuration

This task describes how to configure a particular adapter so that updates to its data flow tasks are periodically sent to the Data Flow Probe.

Note

The setting in the adapter file overrides the global setting (Enable periodic update of data flow tasks) described above.

For example, if the setting in the adapter file is set to true, but the global setting is set to false, the adapter's tasks are still updated on the Data Flow Probe (and vice versa).
This setting should be configured for an adapter only in the case where updates for the adapter should behave differently to configuration in the global settings.

To configure data flow task updates for a particular adapter:

Open the adapter's xml file in an editor.
Locate the <dispatchMechanism> tag. If it does not exist, create it.

Add the following parameter:

<dispatchOnChanges isEnabled = "<true or false>" />

Example:

<pattern>
..
	<dispatchMechanism type = "IpAddress">
         		<dispatchOnChanges isEnabled = "true" />
       </dispatchMechanism>
..
</pattern>

Ad Hoc Updates

Log in to the UCMDB JMX console. (Launch the Web browser and enter the following address: https://localhost:/jmx-console. You may have to log in with a user name and password.)
Click UCMDB:service=Discovery Manager to open the JMX MBEAN View page.

Run one of the following methods, depending on which is relevant:

JMX Method	Description
recalculateAndUpdateDFMTasks	Updates data flow tasks for all the adapters for which data flow task update is enabled. Note Data flow task updates are enabled in the adapter's configuration file.
recalculateAndUpdateDFMTasksForAdapter	Updates data flow tasks for selected adapters without checking the adapter configurations. That is, even if the data flow task update is not enabled for a selected adapter, the updates are run.

Send Help Center feedback