SYSTEMVAR$ reads or sets Quaestor system variables

Syntax

1. SYSTEMVAR$(VarName$)
2. 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$

Remarks

1. 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;
2. 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 aSolution 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

1. The following Quaestor system variable can be read only:
   1. "qi_username", returns the user name. Either provided from Windows or from another source such as eGroupWare;
   2. "qi_headless", return whether Quaestor is running as client or as server:
      1. "qi_headless" = "y", Quaestor is running as server;
      2. "qi_headless" = "n", Quaestor is running as client;
      3. "objectname", provides "NullString" when not in an object or the name of the object it is part of;
      4. "qi_delimiter", give the type of delimiter used to provide ranges (either , or ;)
      5. "reportpath", returns the string of the total report path in Windows format (as set under Tools>Options);
      6. "htmlfilereportpath", returns the string of the total report path in proper HTML browser format;
      7. "unixreportpath", returns the string of the total report path in unix format (with forward slashes);
      8. "kbspath", returns the string of the knowledge base path in Windows format (as set under Tools>Options);
      9. "apppath", returns the string of the general application path in Windows format (as set under Tools>Options);
      10. "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

will return

"E:\My Documents\My Knowledge\Projects\_KnowledgeBaseName\Solutions\" 

will return

So tell the outside World that a solution is not judged as succesful:

Example knowledgebases

Download 

An example knowledgebase of this function can be donwloaded here 

Quick links: Function overview | Attribute overview | Constants overview | Dimensions overview