Agilent Technologies 87130A Switch User Manual


 
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.