Appearance

EXEC_VOLUME_ANALYSIS_DLG ​

EXEC_VOLUME_ANALYSIS_DLG shows the start dialog of the Volume Analysis (2nd simulation algorithm, aka Static Assignment).

Syntax ​

leo-grammar
CC "Simulation" EXEC_VOLUME_ANALYSIS_DLG
										[ runs:intValue ]
										[ dpy:intValue ]
										[ hpd:intValue ]
										[ simoption:intValue ]
										[ auto-volume:boolValue ]
										[ auto-read-only:boolValue ]
										[ auto-close:boolValue ]
										[ auto-component:boolValue ]
										[ auto-loop:boolValue ]
										[ setLoopDetectionCount:intValue ]
										[ randseed:intValue ] 
										[ programcalls:boolValue ]
										[ path-analysis:boolValue ]
										[ calculation:boolValue ]
										[ ProtocolSettings ]
										[ appmodelname:strValue ]
										[ no-error-messages:boolValue ]

ProtocolSettings: protocol:none | short-format | long-format 
				[ protfile:strValue ]

#--> RESULT ecode:intValue errmsg:strValue canceled:boolValue

Parameters ​

  • runs (intValue) - number of simulation runs
  • dpy (realValue) - default days per year
  • hpd (realValue) - default hours per day
  • simoption (intValue) - number of the SimMapping option to be used [1 .. n]. If not given, the default (e.g. from the last simulation) will be used. If a too small value (<= 0) is passed, 1 is assumed.
  • auto-volume (boolValue) - sets an automated answer to the query about no volume being specified in a process model. The query will not be displayed to the user.
  • auto-read-only (boolValue) - sets an automated answer to the query about models being loaded in read-only mode. The query will not be displayed to the user.
  • auto-close (boolValue) - sets an automated answer to the query about models being closed after the simulation. The query will not be displayed to the user.
  • auto-component (boolValue) - sets an automated answer to the query about passive simulation components being disabled. The query will not be displayed to the user.
  • auto-loop (boolValue) - sets an automated answer to the query about continuing simulation although a probably endless loop was detected. The query will not be displayed to the user. (Note: If the simulation is unable to continue because of an endless loop exhausting the available system resources, a Windows system error message will still be displayed. Afterwards ADOxx may crash because of missing system resources.)
  • setLoopDetectionCount (intValue) - sets the number of subsequent objects within one process instance which indicate that an endless loop has to be assumed. If no count is given, the standard value 5000 ist used. Note that loop detection is only performed during path analysis and volume analysis, not during workload analysis.
  • randseed (intValue) - default randseed-value for the deterministic simulation.
  • programcalls (boolValue) - sets a default value for the passive simulation component "program calls". If this parameter is not given, the last value (from previous simulatio runs) will be used. If no simulation was performed previously, then the default value is 0 ("off").
  • path-analysis (boolValue) - sets a default value for the passive simulation component "path analysis". (Default = on.)
  • calculation (boolValue) - sets a default value for the passive simulation component "calculation". (Default = on.)
  • appmodelname (strValue) - default application model name.
  • no-error-messages (boolValue) - if set to 1 then no simulation error messages will be displayed. If an error occurs, the simulation is simply aborted and the error message is returned in the return value errmsg.
  • protocol|none | short-format | long-format, sets a default value for the passive simulation component "simulation protocol". Allowed values are none (no protocol is generated), short-format (short format protocol) and long-format (long format protocol). Default = none.
  • protfile (strValue) - path to the protocol file.

Returns ​

  • ecode (intValue) - 0 for success or 1 if the dialog was canceled or an error occured
  • errmsg (strValue) - holds the error message of the last (if any) simulation-error that occured. This message is the same text that is usually displayed to the user in an ErrorBox.
  • canceled (boolValue) - reports whether the start dialog of the simulation has been canceled. It does not report whether the user did cancel at any other point of the simulation.

Details ​

See Also ​

Versions and Changes ​

Available since ADOxx 1.3