R&S ZVB - Page 822

R&S
®
ZVA / R&S
®
ZVB / R&S
®
ZVT Command Reference
SCPI Command Reference
Operating Manual 1145.1084.12 – 30 807
PROGram[:SELected]:INIMessage '<file_path>', '<message>'
PROGram[:SELected]:INIMessage? '<file_path>'
Writes a <message> into the preferences file (*.ini) specified by <file_path>. 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 <file_path>. 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.
'<file_path>'
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.
<message>
Value for the fixed key Send
*RST value
–
SCPI,
Command
Types
Device-specific, command or query.
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 deletes 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 '<file_path>'{, '<key>', '<value>' | <value>}
PROGram[:SELected]:INIParameter? '<file_path>', '<key>'
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.
This command can be used to supply information to an external application launched by
:PROGram[:SELected]:EXECute.
The query reads a value associated with a key from the [PARAMETER] section of the preferences file
specified by <file_path>. If the key/value pair does not exist, the query returns an empty string.