Mode

Mnemonic

Syntax

1

EXTRACT

1

Argument

Meaning

DestHandle

The handle of a buffer in which the extracted log information will be placed. Type LONG.

ParamHandle

The handle of a buffer that contains parameters which will be used to filter the logs to be extracted. The parameters take the form of a comma-separated string. Type LONG.

EndVarName

The name of a bit variable that will be set to 1 when the extract has finished. Type STR.

StatusVarName

The name of a register variable that will hold the status of the instruction. This parameter is ignored if you use a null string. Type STR.

-1 - Extraction in progress.
0 - All required logs are extracted and are in the buffer.
2 - Incomplete extraction because the limitation of the destination buffer has been reached. Each line in the buffer will require approximately 300 characters.

LinesVarName

The name of a register variable into which will be written the number of lines returned. A negative number indicates an error. This parameter is ignored if you use a null string. Type STR.

StartTime

The name of a variable in which will be written the timestamp of the first record extracted. Type STR.

• If a register is used the value represents the number of milliseconds since 1980 (See instruction DATETIMEVALUE).
• If a text variable is used the format is #D/#M/###Y #h:#m:#s:###l.

This parameter is ignored if you use a null string.

EndTime

The name of a variable in which will be written the timestamp of the last record extracted. Type STR.

See StartTime for format information.

Mode

Mnemonic

Action

1

EXTRACT

Logs that meet the filter criteria are extracted and placed in the buffer defined by the parameter DestHandle.

Return: 0 if syntax of instruction is incorrect. The status variable must be used for operational status codes.