Command reference
R&S
®
ZNB/ZNBT
1184
User 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
;
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