The name of the text editor software for editing programs.
Syntax
$editor
Return Value
A character string. Can be reset by an application program.
Description
The name of a text editor.
Each time you start a new application session, $Editor is set, by default, to the name of an editor commonly used on the current operating system, or to the value of the editor in the registry. The variable is often reset by the application program to the name of the preferred text editing package.
Since Zim-X 9.50, the default editor is set to “IDE”.
The name should include the full disk path, if necessary. The special file path indicator characters can be used.
The value of this variable is used by the EDIT command.
Example
let $editor = "c:dosedit.com"
See Also
EDIT
The current user’s operating system user ID.
Syntax
$userid
Return Value
A number, or $Null. Can be reset by an application program.
Description
The current user’s operating system user ID; otherwise, $Null.
You can use the $UserID and $GroupID system variables to build levels of security into your applications.
During any Zim session, you can LOGIN under any defined UserName (in EntitySet Users). $ZUserID and $ZGroupID are then set to the UserID and GroupID associated with UserName; $UserID and $GroupID (containing values taken from the operating system) are still available for use.
See Also
$GroupID
$ZGroupID
$ZUserID
The error message generated by the last command that returned an error code.
Syntax
$lasterrmessage
Value
A character string. Can be reset by an application program.
Description
$Null at the beginning of each application session. The value changes only if an error occurs, or if the application program explicitly assigns a value.
When non-$Null, the variable represents, for the current session, the software message generated for the most recently executed command that returned an error code.
See Also
$ErrCode
$ErrLevel
$LastErrLevel
$MaxErrLevel
System Variables
The error code generated by the last command executed.
Syntax
$errcode
Return Value
A number (0 to 9999.) Can be reset by an application program.
Description
Indicator of success (0) or a reason (1 to 9999) for the failure of the most recently executed command.
Explanations for many error codes are contained in the ErrorHelp entity set, which you can access from your database application using the DESCERR or EXPLERR utility program.
See Also
$ErrLevel
$LastErrLevel
$LastErrMessage
$MaxErrLevel
System Variables
The current time.
Syntax
$time
Return Value
A number. Cannot be reset by an application program.
Description
The current time (format: HHMMSSTT, 24-hour notation), as set in the operating system.
Some operating systems provide time only to the nearest second. In such cases, the TT (ticks) portion of the time is always set to 00.
See Also
$addhours
$addminutes
$addseconds
$addticks
$Date
$hours
$minutes
$seconds
$ticks
$TimeSecs
System Variables
The location of focus on the screen when an event occurs.
Syntax
$cursorscreenrow
Return Value
The number of the character row where focus is located on the terminal screen at the time of an event. Can be reset by an application program.
Description
The number of the character row where focus was located on the terminal screen at the time of an event.
The location of focus on the screen when an event occurs.
Syntax
$cursorscreencol
Return Value
The number of the character column where focus is located on the terminal screen at the time of an event. Can be reset by an application program.
Description
The number of the character column where focus was located on the terminal screen at the time of an event.
The highest error severity level generated during the application session.
Syntax
$maxerrlevel
Value
A number (0 to 4). Can be reset by an application program.
| Value | Meaning |
| 0 | No error. |
| 1 | Information message. |
| 2 | Warning. |
| 3 | User error. |
| 4 | System error. |
Description
The highest error severity level encountered to the current point in the application session.
See Also
$ErrCode
$ErrLevel
$LastErrLevel
$LastErrMessage
System Variables
The location of focus in a window when an event occurs.
Syntax
$cursorrow
Return Value
A number which is the row location for focus of the current window at the time of an event. Can be reset by an application program.
Description
The number of the character row where focus was located within the current window at the time of an event . If focus is on an entry field, $CursorRow gives the position of the text cursor.
Example
To output the row and column position of focus in window wMain when an event occurs:
window open wMain
form open Form1
form display input
output $cursorrow $cursorcol
See Also
$CursorCol
$CursorScreenCol
$CursorScreenRow
CURSOR
FORM INPUT
System Variables
The application user’s Zim group identifier.
Syntax
$zgroupid
Return Value
The group identifier of the user specified in the last successfully executed LOGIN command. Cannot be reset by an application program.
Description
Upon successful execution of a LOGIN command, $ZGroupID is set to the specified user’s group identifier.
Although you can change the value of this variable, you cannot change the effect of the LOGIN command. The current user continues to be treated according to the GroupID and UserID associated with the UserName given in the last LOGIN command.
When you call up any Zim system (full, Runtime, etc.), the software automatically attempts to log you in as a user called ZIM.
See Also
$GroupID
$UserID
$ZUserID
English 
Portuguese