User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-30 3700S-901-01 Rev. C / July 2008
Return value
The return value is a string containing a list of comma-delimited individual return
items. The channel list argument of the ICL command determines the number
and order of these returned items.
When the channel list parameter for this function is 'slotX', the response first
lists the channels starting from lowest to highest. After the channels, backplane
relays are listed starting with the lowest bank first and increasing to the highest.
More specifically, the channels are returned in numerical order.
When the channel list parameter for this function is 'allslots', the response
starts with Slot 1 and increases to Slot 6. Each slot is processed completely
before going to the next. Therefore, all Slot 1 channels and backplane relays are
listed before Slot 2 channels.
When the response is numerical, but in string format, use the tonumber()
function to convert a number string to a variable. For example,
TSP> x = tonumber("34.3")
TSP> print(x)
3.43e+001
When the response is a comma-delimited string, the individual numbers can be
identified by iterating through the list using the comma delimiters. For example,
the Lua code below will start at the beginning of a string and use the comma as
a signal to break the string into small chunks. The tonumber() function is used
on each chunk to isolate and convert the individual number.
s1 = 1
s2 = 1
e = string.len(text)
while s2 ~= e do
s2 = string.find(text, ",", s1)
if not s2 then s2 = e end
print(tonumber(string.sub(text, s1, s2-1)))
s1 = s2 + 1
end
channel.calibration.adjustcount()
Function
Gets the number of times that a card has been calibrated.
Usage
<mycount> = channel.calibration.adjustcount([ch_list])
mycount: Return value representing the number of times unit has been adjusted.
ch_list: A string representing the slot holding the card to query.
Remarks
You can use this command with the instrument/channels either locked or unlocked. If
no channel list is provided, the currently unlocked channels are assumed.
There is only one adjustment count per card. Therefore, with no channel unlocked, the
only acceptable values for channel list are slot1, slot2, and so on. Otherwise, an
error is generated.