Skip to end of metadata
Go to start of metadata

For parameters "Selected Time Frame" and "End of Time Frame" it is possible to provide placeholders which enable you to monitor dynamic time ranges. During runtime of the data collector these placeholders are evaluated, and the data collection is restricted to the corresponding time frame. The syntax for this kind of parameter configuration is as follows:
Syntax = {Placeholder}{Operator}{Offset}

The {Placeholder} has to be prefixed by a "$" sign. The optional {Offset } is entered as an integer value after the {Operator}. For {Operator} you can choose the following signs:
"-": decrements the offset
"+": increments the offset

For the placeholder, the following keywords are available:
$TIMEM = timestamp now (offset in minutes )
$TIMEH = timestamp now (offset in hours )
$TIMED = timestamp now (offset in days )
$TODAY = Current day (offset in days )
$FDOCW = first day of current week (offset in days )
$LDOCW = last day of current week (offset in days )
$FDOPW = first day of previous week (offset in days )
$LDOPW = last day of previous week (offset in days )
$DELTA = delta read (only IDocs created since last data collection)

Examples:
* $TIMEM-45 = last 45 minutes (as of now)
* $TIMEH-10 = last 10 hours (as of now)
* $TIMED-3 = last 3 days (as of now)
* $TODAY-2 = last 2 days (full calendar days)
* $FDOPW+1 = Tuesday of last week

By specifying the (mandatory) parameter "Selected Time Frame" you can set the start timestamp of data collection dynamically. If you leave the (optional) parameter "End of Time Frame" empty, the data is then always evaluated up to the current time. However, by filling the "End of time frame" parameter you can set a deviating end timestamp for data collection. This way you are able to define dynamic time ranges for data collection.

Example:
* Selected Time Frame = $TIMEH-10
* End of Time Frame = $TIMEH-2
=> Only IDocs are considered which were created in the time ran ge between 10 hours ago and 2 hours ago.
Take care that the entries for the two parameters make sense. For example, a configuration like ($TIMEH-10) -> ($TIMEH-20) is not feasible, hence the data collector won't find any IDocs.

Note that for placeholder $DELTA any offset is ignored. It is also not valid to use this placeholder together with any entry in the "End of Time Frame" parameter. In delta mode, the data collector always gets all IDocs which were created since the last data collection, up to the current point in time.

 

Performance Warning

Using the dynamic time frame logic it's technically possible to select an extensive time frame (like last 180 days). Be aware that such selection conditions may impose a severe performance impact on the managed system, even causing the data collector to dump. Thus the relevant time frame should be selected with care. It's rather recommended to run the data collector regularly (like once per day for the previous day) than selecting data for a large time frame in a whole. Longer time frames can be viewed via the BW reporting tools BPMon offers.

 

 

  • No labels