VXI VT1422A - Manual (Page 240)

238 VT1422A Command Reference Chapter 7
ALGorithm
Parameters
Comments •
To send values to a Global array, set the <alg_name> parameter to "GLOBALS."
To define a global array see the ALGorithm:DEFine command.
•
An error is generated if <alg_name> or <array_name> is not defined.
•
When an array is defined (in an algorithm or in 'GLOBALS'), the VT1422A
allocates twice the memory required to store the array. When the ALG:ARRAY
command is sent, the new values for the array are loaded into the second space
for this array. When the ALG:UPDATE or ALG:UPDATE:CHANNEL
commands are sent, the VT1422A switches a pointer to the space containing the
new array values. This is how even large arrays can be "updated" as if they were
a single update request. If the array is again updated, the new values are loaded
into the original space and the pointer is again switched.
•
When this command is sent textually to an Agilent/HP E1406A command
module, the Definite Length Arbitrary Block <array_block> parameter must
always use "Big Endian" (Motorola) byte ordering for the packed 64-bit float
values.
•
The <alg_name> paragraph is not case sensitive. However, <array_name> is
case sensitive.
•
Related Commands: ALG:DEFINE, ALG:ARRAY?
•
*RST Condition: No algorithms or variables are defined.
•
Use VXIplug&play function: hpe1422_algArray(...)
Usage
send array values to my_array in ALG4
ALG:ARR 'ALG4','my_array',<block_array_data>
send array values to the global array glob_array
ALG:ARR 'GLOBALS','glob_array',<block_array_data>
ALG:UPD
force update of variables
Parameter
Name
Parameter
Type
Range of
Values
Default
Units
alg_name string ALG1 - ALG32 | GLOBALS none
array_name string valid 'C' variable name none
array_block block data block of IEEE-754 64-bit floating point
numbers
none