SubDimRootMake

The SubDimRootMake verb creates a subdimension or updates the category at the root of an existing subdimension.

The user interface equivalent, if the subdimension exists, is to modify the Category property sheet of the category that is at the root of the subdimension. For a new dimension, click the Create/Delete Subdimension option on the Diagram menu when a category is selected.

The category acting as the root category of the subdimension is a regular category, and has the attributes of a regular category.

If you create a subdimension in the user interface and save the model as an .mdl file, when the MDL is generated for the subdimension, the following changes occur:

  • A new SubDimRootMake statement replaces the CatMake statement for the category.
  • New DrillCatMake and LevelMake statements are created and placed immediately after the SubDimRootMake statement.
  • All of the categories in the subdimension remain but have new parents, drills, and levels.
Note: Category object names differ between MDL and the user interface. MDL uses the category code as the object name. For more information, see Locating objects uniquely.

The syntax is as follows:

SubDimRootMake objCat [Dimension objDim] [Parent objLevel] [Drill
 objDrillCat] [Levels objLevel][catopts]

Argument

Description

SubDimRootMake objCat

Specifies the category that is to be at the root of the subdimension. objCat can be the object name, object identifier, or both.

Dimension objDim

When creating a subdimension or updating the root category of a subdimension, this argument is used if necessary, to uniquely identify it. objDim can be the object name, object identifier, or both.

Parent objLevel

When creating a subdimension, this specifies the parent and must be included. objLevel can be object name or object identifier.

Drill objDrillCat

When creating a subdimension, this specifies the drill category and is optional. objDrillCat can be the drill category object name, object identifier, or both.

Levels objLevel

When creating a subdimension, this specifies its level and must be included. objLevel can be the object name or object identifier.

catopts

Optional parameters that describe objCat in greater detail. Some options are set by default if you do not set them. For the complete list of options, see catopts. If the category exists, previously set options are retained unless you change them with this command.

Example

This example defines the root category 2006 for the subdimension Years. 

SubDimRootMake "2006" Dimension "Years" Parent "By Time" Drill "By Time" 
Levels "Year" Label "2006"