Internal commands

The following sections describe the available internal commands. These internal commands
are divided into four categories:

Data processing: These commands are used to define and manipulate data (Assignments,
Operations).

Control interpretation: When inserted in the source text, these commands control its
progress.

Functions: Functions are commands that apply directly to the operating system, such
as allocating a file. The syntax of a function expression, while respecting the general
rules, is based on a single model. See
Functions.

Utilities: The utility commands are high-level commands that use an internal sequence
of functions, for example, displaying the contents of a file.

When describing a command in the following sections, the mandatory parameters appear
in bold, and parameters in normal font are optional.

Data processing

A data item is a form of coded information. It is referenced by a keyword, which must
be unique for all of the data. To improve the readability of the source text, the
characters _ (underscore) and $ (dollar) can be used in the keyword.

Variables are globally visible. Once a variable is defined, it is available even if
it nested in command files.

Declaring variables

INT

INT NAME = NAME,

INIT = VALUE,

LONG

LONG NAME = NAME,

INIT = VALUE

CHAR

CHAR NAME = NAME,

SIZE = SIZE,

INIT = VALUE

Parameters

NAME: This parameter specifies the name assigned to the data.

VALUE: This setting provided the initial value of the data. If the variable is numeric
it is a number, if the variable is a CHAR is a string that can be in quotes.

SIZE: This parameter indicates the size only for the data type CHAR.

Features

Variable names are not case sensitive, and you cannot the characters . (dot) and
[ (left bracket) in a name. This restriction comes from redefined data notation (see
REDEFINE command) or the principle of substitution data.

The initial default values ​​(in the absence of parameter INIT) types INT and LONG
are 0.

For the data type CHAR, the size must be less than or equal to 256 to be initialized.
This limitation comes from the size of the INIT parameter .

The size of the NAME parameter is limited to 26 characters.

Examples

Declaration of a string data type, named CHR1. This data is initialized, and its size
is 15 characters.

CHAR name =CHR 1, init = 'INITIAL VALUE'

Declaration of a string data type, named CHR2 that has a size of 4096. The data is
not initialized.

CHAR name =CHR2 , size = 4096

Declaration of a given integer named INT1, which is initialized to the value 3425.

INT name =INT1, init = 3425

Declaration of a data type long integer named LONG1, which is initialized to the value
0.

LONG name = LONG1

Predefined variables

A predefined variable is a variable whose value is defined when loaded. These variables
can be used without prior notification,and begin with the "_" character. The following
variable is predefined:

_CMDRET: This variable stores the return code from the last command.

Using data

There are two ways to use data, either by:

Substitution

Setting the data

Parameter

Some commands can accept a parameter takes as a value the name of a variable in order
to update during the execution phase, the content of this variable. An example is
the function _TIME, which updates a variable with the current time.

Substitution

To substitute data use the variable name enclosed by the '%' character. The interpreter
then replaces the variable name with the contents.