Command reference
R&S
®
ZNB/ZNBT
1184User Manual 1173.9163.02 ─ 62
Example:
PROGram:SELected:NAME PROG
Select general program execution.
PROGram:SELected:EXECute 'Exit42.bat'
Run batch script Exit42.bat.
PROGram:SELected:WAIT?
Lock command execution and manual control of the analyzer
until the batch job has finished. This is required for
PROGram:SELected:RETVal?
Get the return value. The answer is ... 42.
Usage: Setting only
PROGram[:SELected]:INIMessage
<IniFile>[, <SendValue>]
Writes a message <SendValue> into the preferences (*.ini) file specified by
<IniFile>. The message is entered into the [MESSAGE] section using the fixed key
Send; the value for the fixed key Receive is set to an empty string.
The query reads the value associated with the fixed key Receive from the
[MESSAGE] section of the preferences file specified by <IniFile>. If no value exists
for that key, the query returns an empty string.
Both commands can be used to establish a simple file-based two-way communication
mechanism to an external application launched by PROGram[:SELected]:EXECute;
see example.
Parameters:
<IniFile> Name and path of the *.ini file. The *.ini extension may be
omitted as it is created automatically by the command. The
specified path/directory must exist. If the *.ini file does not
exist, it is created.
<SendValue> Value for the fixed key Send.
Example:
PROG:INIM 'c:\preferences\myapp', 'this is a
message'
Write the string this is a message into the file
c:\preferences\myapp.ini. The contents of the file look
like:
[MESSAGE] Send="this is a message" Receive=
Suppose the external program writes the string
this is a response to the Receive key (and possibly dele-
tes the contents of the Send key.
PROG:INIM? 'c:\preferences\myapp'
Query the value of the key Receive in the *.ini file. The
response is "this is a response".
PROGram[:SELected]:INIParameter <IniFile>{ , <Key>,<Value> | '<Value>'}
Defines and writes one or several key/value pairs into the preferences file (*.ini)
specified by <file_path>. The information is entered into the [PARAMETER] section.
SCPI command reference