Command reference
R&S
®
ZNL/ZNLE
878User Manual 1178.5966.02 ─ 20
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.
This command can be used to supply information to an external application launched
by :PROGram[:SELected]:EXECute.
The query must be sent with a single <Key> value. It reads the value associated with
the 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.
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.
VNA command reference