TEMPSTAT

The TEMPSTAT command limits the dimension you are looping over, inside a FOR loop or inside a loop that is generated by the REPORTcommand. Status is restored after the statement following TEMPSTAT. When a DO ... DOEND phrase follows TEMPSTAT, status is restored when the matched DOEND or a BREAK or GOTO command is encountered. You can use TEMPSTAT only within programs.

Syntax

TEMPSTAT dimension...

     statement block

Arguments

dimension(s)

One or more dimensions whose status you would like to temporarily change inside a FOR loop or an automatic loop that is generated by the REPORTstatement.

statement block

One or more statements that change the status of the dimension. To execute more than one statement under the temporary status, enclose them between DO ... DOEND brackets.

Notes

Nesting

You can nest TEMPSTAT commands, one within another, and you can repeat the same dimension within the nested TEMPSTAT commands.

Placement of TEMPSTAT

When you want to be able to change the status of a dimension while REPORT is looping over it, you must place the TEMPSTAT command inside that REPORT loop rather than before the REPORT command. For example, suppose you have written a user-defined function called monthly_sales, which changes the status of month, and monthly_sales is part of a REPORT command that is looping over month. In this case the TEMPSTAT command must be inside the monthly_sales function in order for a status change to take place. This is true even when the REPORT command is given within TEMPSTAT DO/DOEND brackets within a FOR loop over MONTH.

POP and POPLEVEL Commands

Within the DO/DOEND brackets of a TEMPSTAT statement block, you cannot use the POP command to pop a dimension that is protected by TEMPSTAT on the block -- unless the matching PUSH command is also within the block.

Similarly, within the DO/DOEND brackets of a TEMPSTAT statement block, you cannot use the POPLEVEL command to pop a dimension that is protected by TEMPSTAT on the block -- unless one of two conditions is met: the matching PUSHLEVEL command is also within the block, or the only pushes on the dimension since the PUSHLEVEL command was given are also within the block.

Use Only LIMIT and CONTEXT Commands

Within the DO/DOEND brackets of a TEMPSTAT command, the only way to change the status of a dimension within a loop over that dimension is with the LIMIT or CONTEXT APPLY commands. (See LIMIT command and CONTEXT command for details.) You cannot change the status of the dimension using POP or POPLEVEL. You also cannot perform any operations that would add values to the dimension, because adding values also changes the status of the dimension to ALL. For example, MAINTAIN ADD, FILEREAD APPEND, and IMPORT (with new values in the EIF file) add values to a dimension.

Examples

TEMPSTAT in a FOR Loop

The following program excerpt uses the TEMPSTAT command to limit the market dimension within the FOR market loop.

FOR market
DO
 TEMPSTAT market
  DO
   LIMIT market TO CHILDREN USING market.market
   REPORT market
  DOEND
DOEND