Agilent Technologies A.18.00 - page 408

408
S:\agilent\8920\8920b\PRGGUIDE\BOOK\CHAPTERS\ibasic.fb
Chapter 7, IBASIC Controller
PROGram Subsystem
:STRing <varname>{,<svalues>} The :STRing command is used to set, from an
external controller, the value of string variabl es or string arrays in an IBASIC
program in the Test Set. <varname> is the name of an existing string variable or
string array in the IBASIC program. <svalues> is a list of comma-separated
quoted strings which are used to set the value of <varname>.
NOTE: If the variable name <var_name> is longer than 12 characters it must be sent as string data
(<var_name> enclosed in quotes). For example, OUTPUT 714;"PROG:STR
’Var_name’,’data’".
Attempting to send a <var_name> longer than 12 characters as character data
(<var_name> not enclosed in quotes) will generate the following error:
HP-IB Error: -112 Program mnemonic too long.
NOTE: If the programmer wishes to append the IBASIC “$” string identifier onto the string
variable name, the string variable name must be sent as string data, that is enclosed in
quotes. For example,
OUTPUT 714;"PROG:STR 'Var_name$','data'"
Appending the IBASIC “$” string identifier onto the string variable name
without enclosing the string variable name in quotes will generate
HP-IB Error: -101 Invalid character.
If an attempt is made to set the value of a string variable or array and no IBASIC
program is in the Test Set an IBASIC Error: -282 Illegal program name
is generated. If an attempt is made to set the va lue of a string variable or array and
the string variable specified in <varname> does not exist in the program an
IBASIC Error: -283 Illegal variable name is generated. If a quoted
string value is too long to fit into the string variable then it is silently truncated
when stored into the IBASIC string variable. If th e specified string variable
cannot hold all of the quoted strings an IBASIC Error: -108 Parameter
not allowed is generated.