4-34 Agilent 87130A Operating and Service Manual
Remote Operation
:DEFine
:DEFine
Syntax
ROUTe:PATH:DEFine <path name>,<channel list> [,<channel list>]
ROUTe:GROUP:DEFine? <group name>
ROUTe:PATH:DEFine? <path name>
Description
Under the PATH subsystem, this command is used to define or redefine the
switch settings that make up a path.
• This command effectively “creates” a path by assigning the path name to
one of the 256 internal path registers (if no register is available, a
memory error will be declared). No other command referencing that
path name may be sent before the
DEFine command is sent.
• A path name is any collection of up to 12 uppercase letters (lowercase
letters are automatically uppercased), numbers, or underscore
characters, starting with a letter.
• If the path name already exists, the old settings (both CLOSE and OPEN)
will be erased and the new settings established from the new channel
list.
• The channel lists used by PATH:DEF follow all the normal rules for
channel lists, and may contain any combination of switches from one or
more driver cards. The second channel list is optional; if not sent it will
be treated as empty. The empty channel list (@) may be sent for either
parameter.
• If a channel is included in both of the channel lists in a path, no error is
declared, but the channel will be removed from the first list and only
retained in the second.
• The interpretation of the data in a path depends on how it is used. If sent
using
ROUTE:CLOSE <path name> or by the manual interface, the first
channel list is a CLOSE list and the second an OPEN list. If sent using
ROUTE:OPEN <path name>, the first channel list is an OPEN list and the
second a
CLOSE list.