User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-235
scan.create()
Remarks
Use this function to replace an existing list of channels and/or channel patterns to
scan. The existing scan list is lost after this command. These items purge the old list
and start a new scan list. The items in ch_list will be scanned in the order specified
in the parameter list.
If the optional dmm_config parameter is not specified, the configuration
(dmm.setconfig() (on page 13-168), dmm.getconfig() (on page 13-139)) associated
with that channel or channel pattern will be used. However, if a dmm_config is
specified, that configuration is used for each channel or channel pattern specified in a
temporary override mode. It does not modify the assigned configuration of a channel
or channel list.
An error will occur if:
A specified channel does not exist.
A specified channel pattern does not exist (slot empty or not on card).
A syntax error exists in parameter string.
An empty parameter string is specified for dmm_config parameter.
A specified DMM configuration does not exist.
An analog backplane relay is specified.
A forbidden channel is specified.
Even with an error, the scan list of channels or channel patterns will be cleared.
Therefore, if the scan list is queried after sending a scan.create command, it will be
empty if an error occurred or the specified new list if no error detected.
Factory default is an empty scan list of channels and DMM configurations. The
function scan.reset() (on page 13-242) clears the list.
To clear the list only, send an empty string for the ch_list parameter.
Also see
scan.add() (on page 13-230)