Defining Field Filters

At the command line, specify an event filter condition using:

-filter category “operator” value

For example:

-filter feature “=~” toolbox

where:

Defining Field Filters

category

Filter category.

operator

Relational operator.

value

Value for comparison.

The following rules for filtering of data are applied:

Rules for filtering of data

Input filename specified?

Date range specified?

Data reported

no

no

everything (no filters)

no

yes

everything in the date range

yes

no

everything in the files

yes

no

data in files for the specified date range

FlexNet Manager for Engineering Applications supports values with spaces. You will need to double-quote the values. You do not need to substitute asterisks for spaces.

{Hyperlink}Table {Default ¹ Font} lists valid operators in FlexNet Manager for Engineering Applications Reporting filters.

Important:All special characters must be enclosed in quotes (“==“). For example, all paths with spaces, all filtering operators (== != =~ ><), all dates with commas and spaces, and all delimiters, should be surrounded with quotes.

Valid Operators in FlexNet Manager for Engineering Applications Reporting Filters

Operator

Description

==

Identical to

=~

Includes (with wildcards)

* Match any number of characters.

? Match any single character.

Asterisks are not required at the front or at the end of the operator, so if you have the filter user =~john, you could get results including “aajohn”, “johnbb” and “john”.

 

Not equal to

 

Excludes (with wildcards)

See discussion for =~.

>

Greater than

<

Less than

Time period filters set time periods during each week to include in a report. One or more time period filters can be set by specifying:

–filterperiod start end

where start and end time formats are [d.]HH:mm[:ss] and d is day 1-7 of the week (Sun-Sat).

You can select whether to include in your report output features that have no license usage by typing:

-showzero

You can select whether to eliminate “false” denials in your report output by typing:

-elim_false_denials [interval]

where interval is the time period in seconds in which to consider a series of “false” denials for elimination. If not specified, the default interval is 10 seconds.

You can select which event types to include in your report by typing:

-event_type type

where type is {used denied queued exception checkout}.

If no specific types are specified, all event types except Checkout are included in a report.

You can select dates to start and end the data in your report by typing:

-startdate date

-enddate date

At the command line, quotation marks around date strings containing spaces sometimes cause problems on particular operating systems. Windows users must always include quotation marks around a date string. On UNIX, FlexNet Manager for Engineering Applications Reporting accepts an underscore instead of a space in a date string, which makes quotation marks unnecessary. For example, "03/03/1999 02:00" is equivalent to 03/03/1999_02:00.