Oracle® OLAP DML Reference 10g Release 2 (10.2) Part Number B14346-01 |
|
|
View PDF |
The OBJ function returns information about a workspace object.
Return Value
The return value depends on the choice keyword.
Syntax
OBJ(choice [object-name])
where choice is one of the following keywords that indicates the type of information you want:
Arguments
A TEXT
expression that is the name of the object that you want to retrieve information about.
Returns a TEXT
value which is the specification of the aggmap that you specify.
Returns a TEXT
value which is the aggmap objects in the formula that you specify.
Returns a TEXT
value which is the alias dimensions for the dimension that you specify.
Returns a TEXT
value which is the base dimension for the alias dimension that you specify.
Returns a TEXT
value which is the name of an attached workspace that contains an object with the specified name. When the specified object is in only one attached workspace, AW returns the name of the workspace. When the specified object is in more than one attached workspace, AW still returns only one workspace name. You must use the AWLIST keyword to get all the relevant workspace names. When the object is not in any attached workspace, AW returns NA
.
Returns a multiline TEXT
value each line of which is the name of an attached workspace that contains an object with the specified name. When you specify a qualified object name for the object, AWLIST returns only the relevant workspace name. When no workspace contains the specified object, AW returns NA
.
Returns a BOOLEAN value that indicates whether a conjoint dimension or a composite is using the BTREE index algorithm to load and access data. For other types of objects, it returns NA
.
Returns a BOOLEAN value that indicates whether a session cache has been emptied of data for the specified variable. A cache can be emptied by using a CLEAR statement with the CACHE keyword. When object-name is not a variable or when it has no session cache, then CACHEEMPTY returns NA
. (For more information on the session cache, see "What is an Oracle OLAP Session Cache?".)
Returns a LONG INTEGER value which is the number of non-NA
cells in the session cache for the specified variable. When object-name is not a variable or when it does not have a no session cache, then CACHECOUNT returns NA
. (For more information on the session cache, see "What is an Oracle OLAP Session Cache?".)
Returns a TEXT
value which is the storage class of an object. Possible return values are:
TEMPORARY — An object whose values are not saved in the workspace; applicable to valuesets, variables, relations, and worksheets.
null — A permanent object whose values, when modified, are stored in a new place in the workspace until you update and are then included in the update; applicable to all object types.
Returns a TEXT
value which is the data type of an object.
For dimensions, variables, and formulas, possible return values are INTEGER
, SHORTINTEGER
, LONGINTEGER
, DECIMAL
, NUMBER
, SHORT
(for SHORTDECIMAL), BOOLEAN
, ID
, TEXT
, NTEXT
, DATE
or DATETIME
.
Tip: To find out the type of time period represented by dimensions of type DAY, WEEK, MONTH, QUARTER, and YEAR, use the PERIOD choice. |
For a relation, DATA returns the name of the related dimension.
For a concat or conjoint dimension or a composite, it returns the names of the base dimensions of an object as a multiline text value.
For a program defined with a data type, it returns the name of the data type.
For a valueset, it returns the name of the dimension for which the valueset was defined.
For other types of objects, it returns NA
.
Returns a TEXT
value which that is a description of the specified object. The value is the same value that DESCRIBE would display for the object minus the words DEFINE and the name of the object.
Returns a TEXT
value which is a multiline text value that contains the names of the dimensions and composites in the dimension list that is used to define an object. An object defined with a dimension list could be a variable, relation, formula, valueset, concat or conjoint dimension, dimension surrogate, or composite:
For an unnamed composite , DFNDIMS returns the form used in the object definition: SPARSE<dim1 dim2 ...>
.
For a dimension surrogate, DFNDIMS returns the name of the dimension for which the surrogate was defined.
When no dimension list was used when an object was defined, DFNDIMS returns NA
.
Returns an INTEGER value which is the number of values in a dimension. For other object types, DIMMAX returns 0
(zero). When you use the DIMMAX choice with a dimension that has a read permission that restricts access to the dimension values, the result that OBJ returns depends on whether the dimension has previously been loaded. Permissions are evaluated when an object is loaded. Generally, the first time you refer to an object in your session, Oracle OLAP loads the object and evaluates its permissions. However, the OBJ function does not load objects, since it is just providing information about them. When you use DIMMAX with a dimension that has not yet been loaded, the result reflects the entire number of values in the dimension, regardless of whether the dimension has read permissions. When a dimension with permissions has already been loaded, then the DIMMAX choice reflects the permitted size. To ensure that the DIMMAX choice returns the permitted size, you can execute a LOAD statement before using the OBJ function.
Returns a multiline TEXT
value that contains the names of the dimensions of an object:
For dimensions, simple, concat, or conjoint, DIMS returns the name of the dimension itself. To find out the base dimensions of a concat or conjoint dimension, use the DATA choice.
For composites, it returns a multiline text value listing the base dimensions of the composite.
For a dimension surrogate, it returns the name of the dimension for which the surrogate was defined.
For other objects, it returns a multiline text value that contains the names of the dimensions of the object.
When an object has no dimensions, it returns NA
.
Returns one of the following TEXT
values:
For a concat dimension, returns CONCAT
.
For a conjoint dimension, returns, CONJOINT
.
For a composite, returns, COMPOSITE
.
For a simple dimension, returns the data type of the dimension.
For a partition template object, returns PARTITION TEMPLATE
.
For all other objects, returns NA
.
The total number of pages used to store an object. For a temporary object, OBJ(DISKSIZE) returns a value of 0 (zero), because the values of a temporary object are stored in temporary storage and not in the database file.
Returns a TEXT
value which is the expression in the definition of a formula. When the object is not a formula, FORMULA returns NA
.
Returns a BOOLEAN value that indicates whether the specified variable has an Aggcount object associate with it. When object-name is not a variable, HASCACHE returns NA
. (For more information on Aggcount variables, seesaw "Aggcount Variables".)
Returns a BOOLEAN value that indicates whether a session cache that is local to the session has been established to store data for the specified variable. When object-name is not a variable, HASCACHE returns NA
. (For more information on the session cache, see "What is an Oracle OLAP Session Cache?".)
Returns a BOOLEAN value that indicates whether a conjoint dimension or a composite is using the HASH index algorithm to load and access data. For other types of objects, it returns NA
.
Returns a BOOLEAN value that indicates whether the property specified by prop-name exists for an object. (Abbreviated HASPRP)
Returns a BOOLEAN value that indicates whether the text of the program specified by program-name has been hidden. (See the entries for the HIDE and UNHIDE commands.) For other types of objects, it returns NA
.
Returns a BOOLEAN
value that indicates whether the logical order of the values of the underlying dimensions of an object matches the physical order in the analytic workspace. INORDER is true when the dimension have not been maintained using the keywords ADD FIRST, ADD AFTER, ADD BEFORE, or MOVE.
When you supply both arguments returns a BOOLEAN value that answers the question: Is the specified object (object-name) dimensioned by, related to, or a surrogate for the specified dimension (dimension-name)? When you supply only dimension-name, returns a BOOLEAN that indicates whether an object is dimensioned by the dimension you specify in dimension-name; or when the object is an aggmap, whether the specified dimension is a dimension of any relations or models in the aggmap.
RECURSIVE specifies that Oracle OLAP should search for dimension-name in the base dimensions of the specified object, at any level. the. See Example 19-1, "OBJ With ISBY" .
dimension-name is a text expression that is the name of a dimension. (Oracle OLAP automatically converts the name to uppercase.) When dimension-name is a composite, the value returned by ISBY indicates whether or not an object was defined with the composite.
object-name is a text expression that is a dimension surrogate, variable, relation, or valueset name to learn if that object is dimensioned by or related to or a surrogate for the specified dimension. You can omit object-name when you are looping through the list of workspace objects to obtain information about more than one object, or when you are using OBJ to limit the NAME dimension.
Returns a BOOLEAN value that indicates information about the compilation status of a compilable object (such as a program, model, or formula). The value returned depends on the type of object and on whether a compilation error was found in that object. For example:
For programs, returns YES
when the program has been processed by the compiler since the last time it was modified. A return value of YES
does not necessarily indicate that all lines of the program are compiled. See COMPILE for more information.
For formulas, returns YES
only when the formula was compiled without finding a single error and when the formula can be saved. When the formula contains ampersand substitution, it cannot be saved. When the formula is empty, the ISCOMPILED choice returns NO
.
For models, returns YES
only when the model was compiled without a single error found or when the model is empty.
For programs, formulas, and models, returns NO
when you delete an object that the program, formula, or model references.
For non-compilable objects, ISCOMPILED returns NA
.
Returns an INTEGER value which is the number of pages currently allocated to hash and BTREE indexes.
Returns a TEXT
value which is LD (long description) of an object. When the object does not have an LD, it returns NA
.
Returns a TEXT
value which is the specification of a model. For other types of objects, it returns NA
.
The number of pages that contain only NA
values that contain only NA values and are not stored in the database.
Returns a BOOLEAN value that indicates whether a conjoint dimension uses the NOHASH index algorithm to load and access data. For other types of objects, it returns NA
.
Returns a DECIMAL
value that is the number of deleted cells for a dimensioned object.
Returns an INTEGER value which is the number of dimensions or composites in the dimension list used to define an object. For this count, each composite counts as one, and the dimensions within the dimension list of the composite are not counted. An object defined with a dimension list could be a variable, relation, formula, valueset, concat or conjoint dimension, dimension surrogate, or composite. When no dimension list was used when defining the object (as for single-cell variables, programs, and so on.), it returns 0
(zero).
Returns an INTEGER value which is one of the following depending on the type of object:
For a dimensioned object, the number of dimensions.
For all types of dimensions and dimension surrogates, NUMDIMS returns 1
.
For a composite, it returns the number of base dimensions.
For objects with no dimensions, it returns 0
(zero).
The number of segments associated with any object that has more than one dimension. Oracle OLAP uses segments internally to keep track of the physical storage of the object's values. Too many segments may slow the retrieval of information.
Returns an INTEGER
value that is the number of values or cells in the object. For a compressed composite or a variable dimensioned by a compressed composite, returns an INTEGER
value that is the number of logical values in the object (that is, the value that would be returned if the composite was a b-tree composite). To retrieve the number of physical cells, use the PHYSVALS keyword.
Returns a BOOLEAN value that indicates whether a conjoint dimension or a composite is using private page space to store BTREE nodes, when that object is using the BTREE index algorithm. In addition, whether the data that is associated with a composite, a conjoint dimension, a variable-width text dimension, a relation, or a variable-width text variable is stored in one or more private page spaces that are associated with that object.
Returns the size of the page, in bytes.
When name is the name of a partitioned variable or a partition template object, returns the names of the partition dimensions as a multiline text value (one line for each dimension). For all other object types, returns NA
.
When name is the name of a partition template or a partitioned variable, returns the names of the dimensions of the specified partitions as a multiline text value (one line for each dimension). For all other object types, returns NA
.
partitions is a multiline text value (one line for each partition name) that specifies which partitions you're asking about. When you specify a partition name that is not a valid partition in partitions, an error occurs.
When name is the name of a partitioned variable or a partition template object, returns a textual description of the specified partitions. When called on a partition template, the returned description is similar to the DEFINE PARTITION TEMPLATE statement. When called on a partitioned variable, the returned description is similar to the DEFINE VARIABLE statement. For all other object types, returns NA
.
partitions is a multiline text value (one line for partition name) that specifies which partitions you're asking about.When you specify a partition name that is not a valid partition in partitions, an error occurs.
When name is the name of a partition template or a partitioned variable, returns a text value that is the method (RANGE
, LIST
, or CONCAT
) by which it is partitioned. For all other object types, returns NA
.
When name is the name of a partition template, returns a multiline VARCHAR
containing the names of all the defined partitions. When name is the name of a partitioned variable, returns a multiline VARCHAR containing the names of all the partitions of the variable. For all other object types, returns NA
.
Note: Not all of the partitions defined by a partition template necessarily exist in each partitioned variable. CallingOBJ(PARTNAMES) on a partitioned variable returns only those partitions that actually exist. |
When name is the name of a a RANGE partition template or a RANGE partitioned variable, returns the values of the LESS THAN
clause for each of the specified partitions. The return value is a multiline text value (one line for each partition). For all other kinds of partition templates and partitioned variables and all other object types, returns NA
.
partitions is a multiline text value (one line for each partition name) that specifies which partitions you're asking about. When you specify a partition name that is not a valid partition in partitions, an error occurs.
For dimensions of type DAY, WEEK, MONTH, QUARTER, and YEAR, returns a TEXT
value which is the type of the dimension plus an indication of multiple periods or phasing, if any. For objects other than DAY, WEEK, MONTH, QUARTER, or YEAR dimensions, it returns NA
.
For a compressed composite or a variable dimensioned by a compressed composite, returns an INTEGER
value that is the number of physical cells in the object. To retrieve the number of logical values, use the NUMVALS keyword.
Returns a TEXT
value which is the permission condition for the maintain permission associated with a dimension. When there is no maintain permission for the dimension, it returns NA
.
Returns a TEXT
value which is the permission condition for the permit permission associated with an object. When there is no permit permission for the object, it returns NA
.
Returns a TEXT
value which is the permission condition for the read permission associated with an object. When there is no read permission for the object, it returns NA
.
Returns a TEXT
value which is the permission condition for the write permission associated with an object. When there is no write permission for the object, it returns NA
.
Returns an INTEGER
value which is the precision of a NUMBER
dimension or variable. The precision is the total number of digits. When the variable was defined without a precision specification, then OBJ returns NA
.
Returns a TEXT
value which is the text of a program. For other types of objects, it returns NA
.
The value of the property specified by prop-name which is a text expression that specifies the name of the property. The data type of the return value is determined at runtime. When the named property does not exist, it returns NA
. See the PROPERTYTYPE argument. (Abbreviated PRP)
Returns a TEXT
value which is a multiline text value that lists the properties associated with an object, one property on a line. The names are in uppercase letters and are stored in the collating sequence for ASCII characters. For objects without properties, it returns NA
. (Abbreviated PRPLIST)
The data type of prop-name which is a text expression that specifies the name of the property The type is derived from the expression used in the PROPERTY statement that created the property. Possible return values are BOOLEAN
, TEXT
, ID
, DATE
, DATETIME
, NUMBER
, INTEGER
, LONGINTEGER
, DECIMAL
, and SHORT
.When the named property does not exist or has a value of NA
, it returns NA
. (Abbreviated PRPTYPE)
Returns a multiline TEXT
value which is the words found in a compilable object (for example, a program) that match the ones you specify in text-expression. REFERS returns NA
when it does not find any of the specified words, when the specified object is not a compilable object, or when the workspace does not contain any compilable objects. When you supply both arguments, REFERS searches only the specified object for the listed words. When you omit object-name, REFERS searches all the compilable objects in the current workspace.
text-expression is a multiline TEXT
expression that is the words for which it should search. Each line in the text value is considered a separate word to be searched for.
Tip: When you omit object-name, use REPORT, rather than SHOW, to produce the output. Because the return value ofOBJ(REFERS) is dimensioned by the NAME dimension, the REPORT will return output for each object in the workspace. |
The search is not case-sensitive; REFERS treats TEXTVAR
and Textvar
as the same word. REFERS ignores all text that is included in a comment or enclosed in single quotes.
When, for text-expression, you specify a list of words that is the result of the OBJLIST function, you can produce a cross-reference for compilable objects in the current workspace.
Returns TEXT
values that represent the default relation for the specified object that has been specified using the RELATION command. The values that are returned vary depending on what you specify for relation-query. The syntax for relation-query is:
DEFINELIST | DIMLIST | ACTUAL rel-dimname | SPECIFIED rel-dimname
where:
DEFINELIST specifies that the function return all of the names of the dimensions and their associated default relations. As shown in the following example, the names are returned and it associated default relation are returned one per line, alternating between dimension name and its associated default relation.
dimname1 relname1 dimname2 relname2
DIMLIST specifies that the function return all of the names of the dimensions for which default relations have been specified. As shown in the following example, Oracle OLAP returns the values one dimension name per line.
dimname1 dimname2
ACTUAL dimname specifies that the function return the relation that Oracle OLAP uses as the default relation between object-name and its related dimension specified by rel-dimname.
SPECIFIED dimname specifies that the function return the name of the relation specified in the RELATION command as the default relation between object-name and its related dimension specified by rel-dimname. This is the value as actually entered in the RELATION command, even if an error occurred entering the data and there is no such relation in the analytic workspace.
Returns an INTEGER
value which is the scale of a NUMBER
dimension or variable. A positive scale indicates the number of digits to the right of the decimal point. A negative scale indicates the number of rounded digits to the left of the decimal point. When the variable was defined without a scale specification, then OBJ returns NA
.
Returns a single or multiline TEXT
value which is default or user-specified segment size of a variable that has more than one dimension and that is associated with either a particular dimension or all dimensions. Each line begins with a segment-size (up to 11 digits) followed by the name of the associated dimension or composite. The dimension name is not included in the line when you specify a dimension and its dimensioned object. In that case only the segment value is returned. When the segment size is reported as zero, it means the default segment size is in effect, and therefore you may need to use CHGDFN to set an appropriate size for the variable's segments. When applied to an object other than a variable, this choice returns NA
.
dimension-name is a text expression that is the name of a dimension.
ALL specifies all dimensions.
Returns a TEXT
value which is a multiline text value that lists the composites used in the definition of an object.
Returns a TEXT
value which is a multiline text value that lists the surrogates defined for a dimension. The object-name can be the name of a surrogate or a dimension. When no surrogates are defined for the dimension, then OBJ returns NA
.
Specify the triggering-event using one of the following keywords:
TRIGGER without a triggering-event keyword returns a TEXT
value which consists of all the triggering-event keywords and trigger programs names associated with the object; or NA
when the object does not have any trigger programs associated with it. TRIGGER with a triggering-event keyword returns a TEXT
value that is the names of the trigger programs associated with the object event.
Returns a TEXT
value which is the object type of an object. Possible values include AGGMAP
, COMPOSITE
, DIMENSION
, FORMULA
, MODEL
, OPTION
, PARTITION TEMPLATE
, PROGRAM
, RELATION
, SURROGATE
, VALUESET
, VARIABLE
and WORKSHEET
.
The number of pages used to store an object's values. For text dimensions and variables defined without the WIDTH keyword, OBJ(VALSIZE) counts only those pages that contain the four-byte pointers to the text, not the storage for the text itself. For a temporary variable, OBJ(VALSIZE) returns a value of 0 (zero) because the values of a temporary variable are stored in temporary storage and not in the analytic workspace.
Returns a TEXT
value which is the VNF (value name format) of a dimension of type DAY, WEEK, MONTH, QUARTER, or YEAR. For other types of objects, and for DAY, WEEK, MONTH, QUARTER, and YEAR dimensions with no VNF, it returns NA
.
Returns an INTEGER value which is the width, in bytes, of the storage area of each value of an object:
For dimensioned INTEGER and BOOLEAN variables that you defined with a width, it returns 1
.
For dimensioned text variables and text dimensions that you defined with a width, it returns an INTEGER
between 1
and 4000
, which identifies the defined width.
For all other objects, it returns NA
.
A text expression that contains the name of the object in which you are interested. The object can be in any attached workspace. When you specify object-name as a text literal, you must enclose it in single quotes. (Oracle OLAP automatically converts the name to uppercase.) When you specify the name of a program as the object-name and you omit the quotes, Oracle OLAP runs the program and uses its return value as the name of the object to be supplied as object-name.
You can omit object-name when you are using the OBJ function as part of a statement, such as the LIMIT command, that loops through the NAME dimension. In this case, the return value is dimensioned by the NAME dimension in the current workspace.
Examples
See also: For examples of using the OBJ function to retrieve default relation information, see Example 20-12, "Specifying a Default Relation Using the Relation Command" |
Example 19-1 OBJ With ISBY
For example, the following statement limits NAME to all the objects dimensioned by month
.
LIMIT NAME TO OBJ(ISBY 'month')
You can use ISBY to find out if a dimension is a base dimension of a concat or conjoint dimension or a composite. For example, assume that you had a conjoint dimension named proddist
whose base dimensions were product
and district
. In this case, the following statement returns YES
.
SHOW OBJ(ISBY 'district' 'proddist')
You can use ISBY to find out if a dimension is a dimension of a relation or a model used in an aggmap. For example, assume that you had an aggmap called myaggmap
and you wanted to find out if a dimension named mydimension
was used in any relations or models within myaggmap
. In this case, you could issue the following statement.
SHOW OBJ(ISBY 'mydimension' 'myaggmap')
To determine whether a specified dimension is a base dimension at any level, you must use ISBY with the RECURSIVE keyword. For example, assume that you had a conjoint dimension named proddist.mon
whose base dimensions were proddist
and month
and a variable proddist.sales
dimensioned by proddist
. In this case, each of the following statements would return NO
.
SHOW OBJ(ISBY 'district' 'proddist.mon') SHOW OBJ(ISBY 'district' 'proddist.sales')
However, when you use ISBY with the RECURSIVE keyword, each of the following statements would return YES
.
SHOW OBJ(ISBY RECURSIVE 'district' 'proddist.mon') SHOW OBJ(ISBY RECURSIVE 'district' 'proddist.sales')
Example 19-2 Getting Information about a Variable
This example illustrates the use of several choices of the OBJ function to obtain information about the variable sales
. The definition of sales
is as follows.
DEFINE sales VARIABLE DECIMAL <month product district> LD Sales Revenue
The statement
SHOW OBJ(TYPE 'sales')
produces the following output.
VARIABLE
The statement
SHOW OBJ(DATA 'sales')
produces the following output.
DECIMAL
The statement
SHOW OBJ(DIMS 'sales')
produces the following output.
MONTH PRODUCT DISTRICT
The statement
SHOW OBJ(ISBY 'product' 'sales')
produces the following output.
YES
The statement
SHOW OBJ(LD 'sales')
produces the following output.
Sales Revenue
Example 19-3 Returning the Name of the Object or the Type of the Object
Suppose textvar
is a variable whose value is geog
, which is the name of a dimension. Whether you enclose the word textvar
in quotation marks determines whether the following OBJ
function calls return the word VARIABLE
(the type of object textvar
is) or DIMENSION
(the type of object geog
is).
SHOW OBJ(TYPE 'textvar') VARIABLE SHOW OBJ(TYPE textvar) DIMENSION
Example 19-4 Using OBJ to Select Objects
This example uses OBJ and DESCRIBE to look at the definitions of all the relations in a workspace. The Oracle OLAP statements
LIMIT NAME TO OBJ(TYPE) EQ 'RELATION' DESCRIBE
produce the following output.
DEFINE REGION.DISTRICT RELATION REGION <DISTRICT> LD REGION for each DISTRICT DEFINE DIVISION.PRODUCT RELATION DIVISION <PRODUCT> LD DIVISION for each PRODUCT DEFINE MLV.MARKET RELATION MARKETLEVEL <MARKET> DEFINE MARKET.MARKET RELATION MARKET <MARKET> LD Self-relation for the Market Dimension
Example 19-5 Counting Compiled Objects
The following statements count how many compilable objects in your workspace are compiled and how many are not compiled. Each statement loops over the objects in the current workspace. The OBJ function returns YES
for each object that is compiled, NO
for each compilable object that is not compiled, and NA
for objects that are not compilable. When NASKIP is YES
(the default), the COUNT function in the first statement counts the number of YES
values that are returned by OBJ, and in the second statement it counts the number of NO
values that are returned.
SHOW COUNT(OBJ(ISCOMPILED)) SHOW COUNT(NOT OBJ(ISCOMPILED))
Example 19-6 OBJ with REFERS
The following statement searches the compilable objects in the current workspace for references to the objects in all the attached workspaces. The output lists the non-compilable objects in the current workspace too, but the return value for them is NA
.
REPORT OBJ(REFERS OBJLIST(AW(LIST)))
In the following example, OBJ(REFERS)
tells you whether var1
, var2
, or var3
appears in the myprog
program. The return value of OBJ(REFERS)
is a multiline text value that contains the references it finds. When only var1
and var3
appear in the program, then the return value contains those two names, each on a separate line. The statement
SHOW OBJ(REFERS 'var1\nvar2\nvar3' 'myprog')
produces the following output.
VAR1 VAR3
When you do not specify the name of a program or formula to be searched, OBJ(REFERS) returns a single-line or multiline text value for each object in the NAME dimension of the current workspace. For objects that are not programs or formulas, NA
is returned. The statement
REPORT OBJ(REFERS 'var1\nvar2\nvar3')
produces the following output.
OBJ(REFERS 'var1 var2 NAME var3' ) -------------- ---------- PRODUCT NA DISTRICT NA DIVISION NA LINE NA QUARTER NA REGION NA YEAR NA MONTH NA ... MYPROG VAR1 VAR3 VAR1 NA VAR2 NA VAR3 NA
Example 19-7 OBJ with PROPERTY
In the following example, OBJ(PROPERTY) returns information about the decplace
property of the actual
variable. (See PROPERTY.) The user created this property to store the number of decimal places and now wants to obtain that value to produce a report of the actual
variable.
The statements
CONSIDER actual PROPERTY 'decplace' 4 LIMIT month TO FIRST 1 LIMIT division TO 'Camping' REPORT ACROSS month W 20 DECIMAL OBJ(PROPERTY 'decplace' - 'actual') actual
produce the following output.
DIVISION: CAMPING -------ACTUAL------- -------MONTH-------- LINE JAN 95 -------------- -------------------- Revenue 533,362.8800 Cogs 360,810.6600 Gross.Margin 172,552.2200 Marketing 37,369.5000 Selling 89,007.3800 R.D 24,307.5000 Opr.Income 21,867.8400 Taxes 15,970.3900 Net.Income 5,897.4500
Example 19-8 OBJ with SEGWIDTH
The following statements show how to change and display segment size values for all of a variable's dimensions.
CHGDFN sales SEGWIDTH 150 5000 50 SHOW OBJ(SEGWIDTH ALL 'sales')
These statements produce the following output.
150 MONTH 5000 PRODUCT 50 DISTRICT
The following statement shows how to obtain the segment size value for a specific dimension.
SHOW OBJ(SEGWIDTH 'product' 'sales')
This statement produces the following output.
5000
The following statement shows how to obtain a list of segment sizes for every multidimensional variable or relation associated with the dimension.
When object-name is not specified, you need to use REPORT rather than SHOW to obtain a value for each object in the NAME dimension.
REPORT OBJ(SEGWIDTH 'product')
This statement produces the following output.
NAME OBJ(SEGWIDTH 'product') -------------- ----------------------- SALES 5000 SALES.FORECAST 5000 SALES.PLAN 5000 SHARE 5000 UNITS 5000 UNITS.M 0 ...
The following statement shows how to produce a list of segment sizes for all dimensions in the current workspace.
REPORT OBJ(SEGWIDTH ALL)
This statement produces the following output.
NAME OBJ(SEGWIDTH ALL) -------------- ----------------- SALES 150 MONTH 5000 PRODUCT 50 DISTRICT SALES.FORECAST 150 MONTH 5000 PRODUCT 50 DISTRICT ...