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 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

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

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