SYSTEMVAR$ reads or sets Quaestor system variables
Syntax
- SYSTEMVAR$(VarName$)
- SYSTEMVAR$(VarName$, Setting$)
Arguments
- VarName$ is the name of the Quaestor system variable. The string value should be between quotes and is not case sensetive. Every Quaestor system variable can be read. Of some variables also a value can be set (see remarks below for all variables).
- Setting$ is the additional set value for VarName$. The type of value (string or integer) will depend on the type of VarName$
- SYSTEMVAR$ is mainly used in combination with knowledge bases to be used on the server functionality of Quaestor. However, some of the read only variables are also useful for any knowledge base;
- The following Quaestor system variable can be set and read:
- "qi_ranges", set the maximum number of parameter variations (give a value), default is unlimitted;
- "qi_acceptall", set the Workbase to accept all proposed values and relations (same as the right mouse menu option in the Workbase), default value is "N":
- "qi_acceptall"="y" do accept all
- "qi_acceptall" = "n" do not accept all
- "qi_succes", can be set in order to communicate to the outside World (when working as server) that no succes is achieved. The value is by default "0" at the start of a Solution and "1" when the top goal is achieved. You can set this value to your own judgement using the SYSTEMVAR$ function:
- "qi_succes"="0" no succes
- "qi_succes" = "1" succes
- The following Quaestor system variables can be read only
- "qi_username", returns the user name. Either provided from Windows or from another source such as eGroupWare;
- "qi_headless", return whether Quaestor is running as client or as server:
- "qi_headless" = "y", Quaestor is running as server;
- "qi_headless" = "n", Quaestor is running as client;
- "objectname", provides "NullString" when not in an object or the name of the object it is part of;
- "qi_delimiter", give the type of delimiter used to provide ranges (either , or ;)
- "reportpath", returns the string of the total report path in Windows format (as set under Tools>Options);
- "htmlfilereportpath", returns the string of the total report path in proper HTML browser format;
- "unixreportpath", returns the string of the total report path in unix format (with forward slashes);
- "kbspath", returns the string of the knowledge base path in Windows format (as set under Tools>Options);
- "apppath", returns the string of the general application path in Windows format (as set under Tools>Options);
- "appkbspath", returns the string of the knowledge base application path in Windows format
Examples
See Directory structure for the Quaestor standards concerning the directories. Assume a knowledge base with the name KnowledgeBaseName
ReportPath$ = SYSTEMVAR$("ReportPath")
will return
"E:\My Documents\My Knowledge\Projects\_KnowledgeBaseName\Solutions\"
HTMLFileReportPath$ = SYSTEMVAR$("htmlfileReportPath")
will return
"file://E:/My Documents/My Knowledge/Projects/_KnowledgeBaseName/Solutions/"
So tell the outside World that a solution is not judged as succesful:
CALC_success$ = SYSTEMVAR$("QI_success","0")
Example knowledgebases
Download
An example knowledgebase of this function can be donwloaded here
Quick links: Functions overview | Attribute overview | Constants overview | Dimensions overview