@MATCH

Syntax

@MATCH (mbrName|genName|levName, "pattern")

Parameters

mbrName

The default or user-defined name of the member on which to base the search. Essbase searches the member names and alias names of the specified member and its descendants.

genName

The default or user-defined name of the generation to search. Essbase searches all member names and member alias names in the generation.

levName

The default or user-defined name of the level to search. Essbase searches all member names and member alias names in the level.

"pattern"

The character pattern to search for, including a wildcard character (* or ?).

? substitutes one occurrence of any character. You can use ? anywhere in the pattern.

* substitutes any number of characters. You can use * only at the end of the pattern.

To include spaces in the character pattern, enclose the pattern in double quotation marks ("").

Notes

This function performs a trailing-wildcard member selection. Essbase searches for member names and alias names that match the pattern you specify and returns the member and alias names it finds.

If the members names in the database you are searching are case-sensitive, the search is case-sensitive. Otherwise, the search is not case-sensitive.

You can call @MATCH more than once in a calculation script.

If Essbase does not find any members that match the chosen character pattern, it returns no member names and continues with the other calculation commands in the calculation script.

Example

In the Sample Basic database:

@MATCH(Product,"???-10")

Returns 100-10, 200-10, 300-10, and 400-10

@MATCH(Year,"J*")

Returns Jan, Jun, Jul

@MATCH(Product,"C*")

Returns 100 (Colas), 100-10 (Cola), 100-30 (Caffeine Free Cola), 300 (Cream Soda)