Function Parameters

The following table provides a brief description of some of the common parameters used in various functions.

Note:

Member names that are also keywords, such as IF, THEN, ELSE, and RETURN, must be enclosed in quotation marks. Best practice is to always enclose member names in quotation marks.

Table 2-1 Function Parameters

Parameter Description
attDimName A single attribute dimension name specification.
@WITHATTR(Ounces,"<",16)
attMbrName A single attribute member name specification.
@ATTRIBUTE(Can)
@ATTRIBUTEVAL(Ounces)
@WITHATTR("Pkg Type","= =",Can)
dimName A single dimension name specification.
@CURLEV(Accounts)
@CURGEN(Year)
@PARENT(Measures,Sales)
expList A comma-delimited list of member names, variable names, functions, and numeric expressions, all of which return numeric values.
@MAX(Jan,Feb,100,Apr-May)
@MIN(Oct:Dec)
@COUNT(SKIPNONE,@RANGE(Sales,@CHILDREN(Product)))
expression Any mathematical or numeric expression that is valid within Essbase and that, when calculated, returns a numeric value. This definition of expression also includes parameters such as numDigits, generation, and level, and other similar parameters for the financial group of functions, such as rateMbrConst and lifeMbrConst.
@ABS(Actual-Budget)
@ROUND(Sales / 10.0 + 100)
genLevName Generation or level name specification.
@DESCENDANTS(Market,Regions)
@RELATIVE(Qtr1,Month)
genLevNum An integer value that defines the number of a generation or level. A positive integer defines a generation number. A value of 0 or a negative integer defines a level number.
@ANCESTORS(Sales,-2)
@SANCESTVAL(Product,2,Sales)
mbrList A comma-delimited list of members.
@ISMBR(New_York,Boston,Chicago)
mbrName Any valid single member name or member combination, or a function that returns a single member or member combination. This definition also includes similar parameters, such as balanceMbrName, costMbr, and cashflowMbr, for the financial group of functions.
@GEN(Actual)
@CHILDREN(Product)
@MAXRANGE(@ANCESTORS(Qtr4),Jan:Dec)
For functions that expect a single member name (for example, @DESCENDANTS and @CHILDREN), if a member combination is provided, Essbase uses the first member in the combination. For example, if mbrName is Utah->Sales, Essbase uses Utah.
n A positive or negative integer value.
@NEXT(2,Jan:Dec)
@SHIFT(3)
propertyName Dimension property name.
@PROPERTY(Market,Size)
@ISPROPERTY([Market].[New York],Size,Medium)
propertyValue Optional. Member property value. The value must match the data type of the dimension property specified in propertyName.
@PROPERTY(Market,Size,Medium)
@PROPERTYBVAL(“New York”,Color)
rangeList A valid member name, a comma-delimited list of member names, member set functions, and range functions from the same dimension. If rangeList is optional and is not specified, Essbase uses the level 0 members from the dimension tagged as Time. If no dimension is tagged as Time and this parameter is omitted, Essbase reports a syntax error. This definition of rangeList also includes mbrList.
@ACCUM(Q189:Q491)
@MAXRANGE(Sales,@CHILDREN(Qtr1))
tag Any valid account tag defined in the current database including First, Last, Average, Expense, and Two-Pass.
@ISACCTYPE("EXPENSE")

To ensure that the tag is resolved as a string rather than a member name, enclose the tag in quotation marks.

XrangeList

Similar to rangeList, but supports cross dimensional members.

A valid member name, a comma-delimited list of member names, cross dimension members, or a member set function or range function (including @XRANGE) that returns a list of members from the same dimension. If XrangeList is not specified, Essbase uses the level 0 members from the dimension tagged as Time.

See also Range List Parameters.