The error severity level generated by the last command that returned an error severity level.
Syntax
$lasterrlevel
Value
A number (1 to 4). Can be reset by an application program.
Description
The error severity level of the most recently executed command that returned an error severity level other than 0 (success).
| Value | Meaning |
| 1 | Information message |
| 2 | Warning |
| 3 | User error |
| 4 | System error |
See Also
$ErrCode
$ErrLevel
$LastErrMessage
$MaxErrLevel
System Variables
Indicates the character set used by the application database.
Syntax
$dbcharset
Return Value
2 for ANSI or 3 for UTF-8, depending on the character set specified when the database was initialized. Cannot be reset by an application program.
Description
When you initialize a new application database, the database (ZIMBOOT) administrative utility requires you to specify the character set to be used. Once the database has been initialized, the character set cannot be changed.
During an application session, the $DBCharSet system variable contains the name of the character set used by the current application database.
Example
ANSI is a Zim constant with a value of 2, so you could use the following:
if $DBCharSet = ANSI
...
endif
See Also
SET DOCUMENT FORMAT
The name of a graphics software package.
Syntax
$graphics
Return Value
A character string. Can be reset by an application program.
Description
Set by the application program to the name of a graphics program.
$Graphics can be set to the name of a graphics program of your choosing. The name should include the full disk path. The special file path indicator characters can be used.
The GRAPH command automatically calls up the program named in the $Graphics system variable.
When running ZimTC, the following code will simply copy the “xxx.zzz” to the client side without executing any further actions:
let $graphics = ""
graph "xxx.zzz"
Example
let $graphics = "c:chartappchart.exe"
See Also
$ClipPath
$DBPath
$Editor
$ImagePath
$WorkPath
$ZimPath
About Character Literals
GRAPH
System Variables
Indicates the direction in which focus was moving when an event occurs.
Syntax
$direction
Return Value
A number (-1, 0, or +1.) Can be reset by an application program.
Description
The direction of travel of focus when an event occurred.
| Value | Meaning |
| -1 | “Backward” direction. The focus was moving backward (with respect to the current TABORDER) when an event occurred. |
| 0 | No direction. The focus is not moving. |
| +1 | “Forward” direction. The focus was moving forward (with respect to the current TABORDER) when an event occurred. |
See Also
FORM INPUT
MENU INPUT
System Variables
WINDOW SET
The number of records processed by the most recent set-processing command.
Syntax
$membercount
Return Value
A number. Can be reset by an application program.
Description
The number of records processed by the most recent set-processing command.
See Also
ADD
CHANGE
COMPUTE
DELETE
FIND
INSERT
LIST
REPORT FROM
SELECT
SORT
UPDATE
System Variables
Indicates if the application user has pressed the “break” key.
Syntax
$breakflag
Return Value
Binary. Can be reset by an application program.
Description
At the start of an application session, $BreakFlag is set to “0” ($False). Set to “1” ($True) if the application user presses the “break” key. The application program must reset the variable to “0” ($False) to be able to detect subsequent user interrupts.
See Also
About Conditional Expressions
SET BREAKABLE
System Variables
These system variables have been removed from the Zim syntax and are replaced by WINDOW STATUS.
The current date.
Syntax
$date
Return Value
A number in date format (YYYYMMDD). Cannot be reset by an application program.
Description
The current date, as set in the operating system.
Example
From the zim prompt:
out $date
This extracts the DATE from the TIMESTAMP and then prints the proper $DayName.
OUT $DayName($GetUTCDate($TimeSecs))
See Also
$adddays
$addmonths
$addweeks
$addyears
$day
$dayname
$month
$monthname
$Time
$TimeSecs
$weekday
$year
About Data Types
System Variables
A binary true value for comparison.
Syntax
$true
Return Value
Binary true (“1”). Cannot be reset by an application program.
Description
A “true” value for comparisons in logic expressions.
Example
if Event.ScrollingKey = $True
... commands ...
endif
See Also
$False
$Null
The elapsed number of seconds since 12:00 am, 1 January 1970.
Syntax
$timesecs
Return Value
A number. Cannot be reset by an application program.
Description
The number of seconds that have elapsed since 12:00 am on 1 January 1970.
This variable is useful for measuring the number of seconds between two events.
See Also
$Date
$Time