User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-169
dmm.setconfig()
Remarks
This command will associate the specified DMM configuration (dmm_config) with
the items specified in the parameter channel list (ch_list). The configuration being
assigned determines whether analog backplane relay 1 or 2 get used, based on the
function associated with the configuration when being assigned to a channel. For
channel patterns, the pattern image must include the desired analog backplane relays
along with the desired channels. This command has no effect on the poles setting for a
channel (channel.setpole() (on page 13-79)) or analog backplane relays specified by
channel.setbackplane() (on page 13-70) function.
An error will be generated if:
A syntax error exists in either parameter.
An empty parameter string for either parameter is specified.
There is more than one DMM configuration is specified.
A specified channel does not exist for the card installed on the slot specified.
An empty slot is specified.
The desired DMM functionality is not supported.
A specified channel is forbidden to close.
Is an analog backplane relay.
The specified channel pattern does not exist.
A non-existing DMM configuration was specified.
A matrix channel is in channel list parameter (for example, the Model 3730 is 6 x
16 high density matrix card, so an error will be generated if a Model 3730 channel
is included in the channel list parameter).
Once an error is detected, the command stops processing and no channels or channel
patterns are modified. The DMM configuration for channels or channel patterns update
only if no syntax errors exist in parameter and all channels and channel patterns are
valid for having desired DMM configuration.
The factory-default setting is 'nofunction'. This setting must be changed to use a
channel with the dmm.close() (on page 13-123) function. The dmm.close function
generates an error if the associated function of the DMM configuration is
'nofunction'.
Also see
dmm.getconfig() (on page 13-139)
channel.setpole() (on page 13-79)
Example
To assign 'mydcv' to Channels 1 to 100 on Slots 1 to 3:
dmm.setconfig('1001:3100', 'mydcv')
To assign factory default settings for 'dcvolts' to channels on Slot 5:
dmm.setconfig('slot5', 'dcvolts')