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 variables 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 value 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 the specified string variable
cannot hold all of the quoted strings an
IBASIC Error: -108 Parameter
not allowed
is generated.