NextPlanningEngine macro

The NextPlanningEngine macro is used to create the next planning engine for the planning engine cycle. This macro command is executed at system level.

For executing the macro, the value in the Command field must be specified in this format:

NextPlanningEngine(Cycle,[Planning Engine Name],[Next Planning Engine Name],[Next Period],[Refresh],[Stop on end Status],[Next Planning Engine Display Name])
Note: The optional parameters are specified in [ ].

This table lists the parameters that are used to determine the NextPlanningEngine command:

Parameter Name Description
Cycle The cycle in which the next planning engine is to be created.
Note: Application variables can be used in this parameter.
Planning Engine Name The name of the current planning engine used to create the next planning engine.
Note: 
  • If this value is not specified, the master planning engine for the current cycle is considered.
  • Application variables can be used in this parameter.
Next Planning Engine Name The name of the next planning engine.
Note: 
  • If this value is not specified, the name is created as Cycle.Next Period.
  • Application and parameter variables can be used in this parameter.
Next Period The period for which the new planning engine period is to be created.
Note: If this value is not specified, the next period is determined based on the current period, calendar, and level of the planning engine.
Refresh Planning Engine Definition This parameter refreshes the planning engine definition used within the Planning Engine. Possible values:
  • True: The planning engine definition is refreshed from the master planning engine definition. The status of the planning engine definition must be set to Ready.
  • False: The Next Planning Engine uses the planning definition that is saved in the Source Planning Engine for the specified cycle.
Note: The default value is set to True.
Stop on End Status Indicates the status of the macro that causes the macro to stop. Possible values:
  • None: Macro step is skipped if validation fails.
  • Warning: Macro stops if the validation returns a Warning or Error.
  • Error: Macro stops if the validation returns an Error.
    Note: If this parameter is not populated or Null, the default value is set to Error.
Next Planning Engine Display Name The display name of the next planning engine.
Note: 
  • If this value is not specified, the display name of the previous planning engine is considered.
  • Application and parameter variables can be used in this parameter.