37 test_errlog@ function, 38 readvar% function – Rockwell Automation 57C610 Enhanced Basic Language, AutoMax User Manual

Page 105

Advertising
background image

7Ć17

actual physical address of the first location on the Interface

module from or to which data is to be read or written.

This function is usually used in conjunction with the

GATEWAY_CMD_ OK@ function. It returns the actual address (in

hexadecimal format) of the bit, integer, or double integer which

represents the first location on the Interface module to which or from

which data is to be transferred.

7.37

TEST_ERRLOG@ Function

The function TEST_ERRLOG@ tests the state of the error log

maintained for the application task by the Programming Executive

software. This error log can be accessed through the OnĆLine menu

of the software. The function TEST_ERRLOG@ provides a method

of checking the error log while the application task is running. This

function is cleared with CLR_ERRLOG (see 6.9.3). Note that for

Version 3.3A and later of the Programming Executive software, this

function can be entered as TESTăERRLOG@ or TSTăERRLOG@.
Format:

TEST_ERRLOG@(variable)

where:

variable is an integer variable only; used to store the number of

errors logged (1 to 3) for the task

If there are no errors logged, the result of the boolean function is

FALSE and the number parameter is indeterminant. If there are

errors, then the function is true and the variable specified is loaded

with the current number of logged errors (1 to 3). This variable must

be an integer variable.

7.38

READVAR% Function

This function requires the AutoMax operating system with the

Ethernet option.
Format:

READVAR%( vn$, value )

where:

vn$

is a string expression for the name of the variable to

read. It can be a boolean, integer, double integer,

real, or an array of these types. Only single

dimension arrays are allowed.

value

is the variable where the value read is written.

This function accepts a variable name as a string expression and

returns the value in variable VALUE. The string that defines the

variable name must have a suffix as follows:
@

Booleans

%

Integers

!

Double integer

No suffix

Reals

If specifying an array element, the subscript must be after the data

type character if there is one. Only common variables can be

accessed.

Advertising
This manual is related to the following products: