Environment [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Environment ======

The following system variables ("at variables", or "@-variables") allow you to query (and set) the current OpenInsight environment.

 

^Variable^Description^
|@ADMIN|The level of the user currently logged on.  There are 3 possible values:\\ \\ 0 - User\\ 1 - Administrator\\ 2 - Systems Administrator|
|@APPID|The fully specified application inheritance chain (@FM-delimited) for the current application. The first name is always the current application, the last name is always SYSPROG, and any other applications inherited are in the middle.|
|@APPINFO|A field mark delimited array containing information about all applications in the system.  In the **SYSAPPS** file is one row for each defined application.  The information for the current application is copied into @APPINFO.  The following fields are defined:\\ \\ __Field Number__ - __Meaning__\\ 1 - Application title\\ 2 - Database ID\\ 3 - Application's inheritance chain (starting from SYSPROG)\\ 4 - Date and time created\\ 5 - Company name\\ 6 - Author\\ 7 - Create permissions (multivalue field)\\ 8 - Abstract\\ 9 - Document references (multivalue field)\\ 10 - Tool types for documents (multivalue field)\\ 11 - Application entry point id \\ 12 - Application entry point class id\\ 13 - Application entry point entity id\\ 14 - Flag for maintaining columns in repository\\ 15 - Logon banner name|
|@DBID|The name of the current database (same as @APPINFO<2>)|
|@ENVIRON_SET|Array of environmental settings for the current user.|
|@FILES.SYSTEM|Field mark delimited array of OpenInsight system files|
|@FILES_SYSDICT|The file variable for the SYSDICT file|
|@FILES_SYSENV|The file variable for the SYSENV file|
|@FILES_SYSOBJ|The file variable for the SYSOBJ file|
|@FILES_SYSPTRS|The file variable for the SYSPTRS file|
|@LOWER_CASE|An ordered string containing all lower-case letters. Corresponds to @UPPER_CASE.|
|@LPTRHIGH|Height of the printer page.|
|@LPTRWIDE|Width of the printer page.|
|@MDIACTIVE|The active child from which an event is invoked. An event is invoked from a frame and its active children. The value of @MDIACTIVE is dynamic.|
|@MDIFRAME|The frame of the window from which an event is called. The value of @MDIFRAME is dynamic.|
|@PRINTMODE|If this variable is set to false, the BASIC+ Print function will print the ASCII characters zero through 31 using their assigned graphics. If set to true, these characters are not printed, and are treated as control characters.|
|@STATION|The network station identifier (or null for non-networked versions).|
|@SYSTEM_TABLES|Contains a field mark delimited list of tables that cannot be detached.|
|@TABLES|Field mark delimited array of currently attached tables.|
|@UPPER_CASE|An ordered string containing all upper-case letters. Corresponds to @LOWER_CASE.|
|@USERNAME|The name under which the current user logged in. If no user name was specific at login, contains the current database identifier.|
|@VOLUMES|A dynamic array of attached volumes.  When assigned from a Basic+ program, a field mark delimited array of filing systems in the format:\\ \\ filing system*location\\ \\ is returned.  However, if viewed from the debugger System Variables window, @VOLUMES(n) contains the following:\\ \\ __Dimension (n)__ - __Meaning__\\ 0 - Dynamic array of attached volumes.  Returned when assigning a Basic+ variable to @VOLUMES\\ 1 - Field mark delimited array of volume labels\\ 2 - Field mark delimited array of volume names\\ 3 - Field mark delimited array of multivalued file names\\ 4 - Field mark delimited array of filing systems associated with the volume\\ 5 - Field mark delimited array of handles to the volume map\\ \\ **Note**:  In Basic+ you can assign a variable to one of these dimensioned arrays and return the result.  For example, vol_labels = @volumes(1) assigns the array of volume labels to vol_labels.|
|@WINDOW|The window an event is called from. The value of @WINDOW is dynamic.|