SCENARIOGROUP subcommand (TCM ANALYSIS command)

The SCENARIOGROUP subcommand defines a group of scenarios that are based on a single root field and multiple sets of dimension values for that root field. Each set of dimension values (one value per dimension field) defines a time series. An individual scenario is then generated for each such time series, whose values in the scenario period are then replaced by the scenario values. Scenario values are specified by an expression, which is applied to each time series in the group. The SCENARIOGROUP subcommand applies only to the case of multidimensional data. Multiple SCENARIOGROUP subcommands are allowed.

IDPREFIX
Specifies a prefix that is used to generate an identifier for each scenario in the scenario group. The identifier is displayed in output associated with each scenario. The value must be a quoted string. The identifier for a particular scenario contains the prefix and the set of dimension values that define the series for that scenario. Specifically, the identifier is the prefix, followed by an underscore, followed by the value of the first dimension field, followed by an underscore, followed by the value of the second dimension field, and so on. The IDPREFIX keyword is required.
EXPRESSION
Specifies the name of the variable, from the expressions file (specified on the EXPRESSIONS subcommand), that defines the expression that is used to compute the scenario values.
Note: Expressions are specified with COMPUTE statements in a BEGIN EXPR-END EXPR block. The variable that is specified on the EXPRESSION keyword is a target of one of those COMPUTE statements.
ROOTFIELD
Specifies the root field which, along with a set of dimension values, defines a root series.
DIMVALUES
Specifies optional lists of dimension field values that define the sets of dimension values that, together with the root field, define the set of root series for the scenario group. The form of the specification for a particular dimension field is dimField(VALUES=dimValueList), where dimField is the name of the field and dimValueList is the list of values for that field.
  • If a dimension field is not specified on DIMVALUES then all values in that dimension are included.
  • Fields that are specified on the DIMVALUES keyword do not support ALL and TO.
  • String values do not need to be quoted.
EFFECTS
Specifies how to determine the set of series that are affected by each root series in the scenario group.
AUTOMATIC
Specifies that the procedure automatically determines the series that are affected by the root series. This is the default. You can specify the breadth of the series that are affected by each scenario with settings on the OPTIONS subcommand.
TARGETLIST
Specifies that the effects of the root series are limited to a specified set of series. Each root series in the group has the same set of affected targets
  • If TARGETLIST is specified without listID, then the set of affected targets is given by the TARGETLIST subcommands that do not have a LISTID keyword.
  • If TARGETLIST is specified with a value for listID, then the set of affected targets is given by the TARGETLIST subcommands whose LISTID keyword equals the specified value. The listID value is not quoted.