intro_acl_intrinsic_functions


	ACL Intrinsic functions (grouped by topic):

	Arithmetic functions:

	log            - base 10 log
	ln             - natural log
	sqrt           - square root
	sin            - sine
	sind           - sine (argument in degrees)
	cos            - cosine
	cosd           - cosine (argument in degrees)
	tan            - tangent
	tand           - tangent (argument in degrees)
	asin           - arc sine
	asind          - arc sine (result in degrees)
	acos           - arc cosine
	acosd          - arc cosine (result in degrees)
	atan           - arc tangent
	atand          - arc tangent (result in degrees)
	atan2          - arc tangent of the quotient of the arguments
	atan2d         - arc tangent of the quotient of the arguments
                        (result in degrees)
	sinh           - hyperbolic sine
	cosh           - hyperbolic cosine
	tanh           - hyperbolic tangent
	asinh          - arc hyperbolic sine
	acosh          - arc hyperbolic cosine
	atanh          - arc hyperbolic tangent
	secant         - secant
	cosecant       - cosecant
	cotan          - cotangent
	cotand         - cotangent (argument in degrees)
	hypot          - square root of the sum of the squares of the arguments
	round          - round (to a specified number of digits)
	ceil           - smallest integer greater than or equal to its argument
	floor          - largest integer less than or equal to its argument
	trunc          - truncate
	fmod           - remainder of the arguments
	fract          - fractional component
	abs            - absolute value
	min            - minimum of two values
	max            - maximum of two values
	exp            - base e exponentiation (e^n)
	isInfinity     - tests to see if a value is infinite
	isNaN          - tests to see if a value is a NaN

	Bitwise functions:

	or               - bitwise or
	and              - bitwise and
	xor              - bitwise exclusive or
	lshft            - circular left shift
	rshft            - circular right shift
	bit              - bit test
	setBit           - set a bit in a value
	clearBit         - clear a bit in a value
	bitComplement    - complement (invert) bits in a value
	bitField         - extracts a bit field value
	deviceBitField   - extracts a bit field value from a device reading
	setBitField      - sets a bit field value
	circularShift    - bit field circular shift
	bitFieldCircularShift - circularly shifts a bit field
	bitCount         - returns the number of bits set in a value
	lowestBit        - returns the lowest bit set in a value (or -1)
	highestBit       - returns the highest bit set in a value (or -1)
	valueToLogicalArray - converts bit values into a logical array

	Array value functions:

	sum              - calculates the sum of an array of values
	sum2             - calculates the sum of an array of values
	mean             - calculates the mean of an array of values
	mean2            - calculates the mean of an array of values
	median           - calculates the median of an array of values
	median2          - calculates the median of an array of values
	minimum          - determines the minimum of an array of values
	minimum2         - determines the minimum of an array of values
	maximum          - determines the maximum of an array of values
	maximum2         - determines the maximum of an array of values
	range            - determines the range of an array of values
	range2           - determines the range of an array of values
	stddev           - calculates the standard deviation of an array of values
	stddev2          - calculates the standard deviation of an array of values
	rms              - calculates the RMS of an array of values
	rms2             - calculates the RMS of an array of values
	variance         - calculates the variance of an array of values
	variance2        - calculates the variance of an array of values
	mode             - returns the most commonly occurring value in an array
                          (If there are multiple mode values, the smallest
                           value is returned.)
	mode2            - returns the most commonly occurring value in an array
                          (If there are multiple mode values, the smallest
                           value is returned.)
	identical        - checks to see if all values in an array are identical
	identical2       - checks to see if all values in an array are identical
	histogram        - divides an array of values into buckets
	integrateDataPoints - calculates the area under a set of data points
	chiSquare        - calculates the chi-squared value for a set of
                          data points

	String functions:

	head              - returns the beginning of a string
	tail              - returns the end of a string
	substring         - returns a substring of a string
	strncmp           - compares the first n characters of two strings
	trim              - removes leading and trailing blanks from a string
	leftTrim          - removes leading blanks from a string
	rightTrim         - removes trailing blanks from a string
	case              - changes the case of a string
	toUpper           - converts a string to upper case
	toLower           - converts a string to lower case
	capitalize        - capitalizes the first character in each word of
                           a string
	toString          - converts a value to its corresponding string
	toTrimmedString   - converts a value to a string with no spaces
	stringCopy        - copies one string to another
	stringSetChar     - overwrite a substring of one string with another
                           (similar to stringCopy)
	stringGetChar     - retrieve a substring from a string   
			    (similar to substring but with different defaults)
	stringConcatenate - concatenate two strings
	stringCompare     - compares one string to another (case sensitive)
	stringCompareNocase - compares one string to another (case insensitive)
	regexpCompareString - compares a string to a pattern (case sensitive)
	regexpCompareStringNocase - compares a string to a pattern
	sprintf           - formats output strings like sprintf with the
                           additional functionality of toString
	formatDateString  - format a date string using the format specifiers
                           in strftime
	sscanf            - functions like sscanf with the additional
                           functionality of toNumeric
	toNumeric         - converts a string to its numeric value
	stringToDouble    - converts a string to a double precision
                           floating point value
	stringToInteger   - converts a string to an integer
	stringLength      - returns the length of a string
	delimitedStringLength - returns the length of a string using delimiters
	nonblankLength    - returns the nonblank length of a string
	findChar          - returns the first location of one of a set
                           of characters in a string
	findNotChar       - returns the first location of a character which is
                           not a member of a set of characters in a string
	getFirstChar      - retrieve the first or last nonblank character
	getLastChar       - retrieve the last nonblank character in a string
	firstCharPos      - find the first or last nonblank character position
	lastCharPos       - find the last nonblank character position in a string
	characterCount    - returns the number of characters in a string
	wordCount         - returns the number of words in a string
	findString        - returns the position of one string within another
	strstr            - searches for a substring
	regexpFindString  - returns the position of one string within another
                           using regular expressions for the search
	stringStartsWith  - determines if a string starts/ends with a substring
	stringEndsWith    - determines if a string ends with a substring
	stringStartsWithCharType - determines if the first character of a
                                  string has a given type
	stringEndsWithCharType - determines if the last character of a
                                string has a given type
	characterType     - returns the type of a character
	insertString      - inserts a string within another string
	removeString      - removes a substring from another string
	regexpInsertString - inserts a substring before or after a substring
                            matching a regular expression
	regexpRemoveString - removes a substring matching a regular expression
                            from another string
	replaceString     - replaces one string with another string in a string
	regexpReplaceString - replaces one string with another string in a
                             string using regular expressions for the search
	replaceBracketedString - replace a bracketed substring
	replaceChar       - replaces any of a set of characers wih another
                           character
	replaceCharactersWithString - replaces any of a set of characters
                                     with a string
	replaceCharactersWithStrings - replaces any of a set of characters
                                      with a corresponding string
	split             - splits up a string based upon finding a delimiter
                           string
	regexpSplit       - splits up a string based upon finding a delimiter
                           string which is a regular expression
	splitByCharSet    - splits up a string based upon finding any of a
                           set of delimiter characters
	stringToken       - returns the next token from a string and removes
                           it from the original string
	stringGetValue    - returns the next token of the specified type from
                           a string and removes it from the original string
	regexpGetValue    - returns the next token specified by a regular
                           expression from a string and removes it
	stringType        - returns a string describing the argument string's
			    type
	pos               - pads with spaces/truncates a string to a specified
                           length
	pad               - pads a string with a specified character to a
                           specified length
	justify           - left justify, right justify, or center a string
	center            - center a string
	leftJustify       - left justify a string
	rightJustify      - right justify a string
	strShift          - left or right shift a string
	leftShift         - left shift a string
	rightShift        - right shift a string
	reverse           - reverses a string
	repeatString      - repeats a substring a number of times
	decimal           - returns a value as a decimal string
	hex               - returns a value as a hexadecimal string
	binary            - returns a value as a binary string
	octal             - returns a value as an octal string
	radix             - returns a value as an arbitrary radix (2-36) string
	stripSpaces       - strips any whitespace from a string
	stripCharacters   - strips a requested set of characters from a string
	stripEolCharacters - strips end of line characters from a string
	stripNonprintables - strips nonprintable characters from a string
	stripHtml         - strips HTML tags from a string
	stripBrackets     - strips beginning and ending brackets from a string
	stripQuotes       - strips beginning and ending quotes from a string
	quoteString       - adds beginning and ending quotes to a string
	unescapeString    - replaces escape characters in a string with
                           their original characters
	escapeString      - replaces characters in a string with their
                           corresponding escape characters
	escapeQuotesInSqlString - escapes quote characters in a SQL string
	findTagString     - finds and extracts delimited tags from a string
	getTaggedValue    - extracts a tag/value pair from a string
	makePrintable     - expand any tabs and remove or replace any
                           nonprintable characters in a string
	isLowerCase       - determines whether or not a string is in all
                           lower case characters
	isUpperCase       - determines whether or not a string is in all
                           upper case characters
	isQuotedString    - determines whether or not a string is quoted
	isBracketedString - determines whether or not a string is bracketed
	isAlphabeticString - determines whether or not a string is composed
                            entirely of alphabetic characters (plus optional
                            white space)
	isAlphanumericString - determines whether or not a string is composed
                              entirely of alphanumeric characters
                              (plus optional white space)
	isBlankString     - determines whether or not a string is composed
                           entirely of white space
	isFloatString     - determines whether or not a string represents
                           a floating point number
	isIntegerString   - determines whether or not a string represents
                           an integer number
	isHexString       - determines whether or not a string represents
                           a hexadecimal number
	isPrintableString - determines whether or not a string is composed
                           entirely of printable characters
	isStringFilledWithChar - determines whether or not a string is
                                composed entirely of a single character
	isDeviceString    - determines whether or not a string represents
                           a device specification
	isPropertyString  - determines whether or not a string is a
                           device property name
	isNodeString      - determines whether or not a string is a
                           node name
	isErrorString     - determines whether or not a string is
                           an error name
	isEventString     - determines whether or not a string
                           represents a clock event
	isDateString      - determines whether or not a string
                           represents a date
	isRad50String     - determines whether or not a string is
                           composed entirely of valid rad50 characters
	stringLineInfo    - determines how many lines are in a string
	stringExtractLine - extract a line from a string
	stringExtractDeviceNames - extract valid ACNET device names from
                                  a string
	consoleClassMaskToString - convert a console class mask to a string
	stringToConsoleClassMask - converts a string to a console class mask value
	offsetCharacter   - increments a character in a string by a
                           requested amount
	ascii             - convert a character value to its corresponding
                           ASCII code(s)
	char              - converts an ASCII code to its corresponding
                           character

	Data manipulation functions:

	arrayInvert           - inverts the order of an array
	arrayInsert           - inserts a new element in an array
	arrayAppend           - append a new entry at the end of an array
	arrayPrepend          - insert a new entry at the beginning of an array
	arrayDelete           - deletes an existing entry from an array
	arrayDeleteDuplicates - deletes duplicate entries from an array
	arrayDeleteValue      - deletes entries from an array matching a
                               particular value
	arrayFill             - fill an array with a value
	arrayValueExists      - determines if a value exists in an array
	arraySort             - sorts an array of values
	matrixAdd             - adds two matrices of the same size
	matrixMultiply        - multiplies two compatible matrices
	matrixScalarMultiply  - multiplies all members of a matrix by a
                               scalar value
	matrixDeterminant     - calculates the determinant of a matrix
	matrixInvert          - inverts a two dimensional matrix
	matrixSolve           - uses a two dimensional matrix to solve a
                               system of linear equations
	compareWithTolerance  - compares one or more values with another
                               with a tolerance

	Device oriented functions:

	device                - converts an ACNET device to a device index value
	deviceIndex           - converts an ACNET device to a device index value
	deviceSpec            - converts a value to a device specification
	deviceSpecExtractValues - extracts individual parameter values from
                                 a device specification
	deviceProperty        - returns the property value from a device spec
	deviceArrayIndex      - returns the array index and number of elements
                               for a device spec
	deviceOffset          - returns the offset and length in bytes for
                               a device spec
	deviceSpecToString    - converts a device specification to a string
	name                  - returns a device name string
	fullName              - returns a device full name string
	deviceNameExists      - determines if a string is an existing
                               device name
	historicName          - returns a device name on a specified date
	text                  - returns a device descriptive text string
	fullText              - returns a device full descriptive text string
	units                 - returns a device units string
	deviceValue           - returns a numeric device value
	deviceValueText       - returns a device value as a string
	deviceCalculatedValue - returns a calculated device value
	deviceDigitalStatus   - returns a device digital status value
	deviceType            - returns the type of a device property
	deviceTypeMismatch    - determines if a device property is typed
                               properly
	ssdnToDeviceType      - converts an SSDN/node/property combination
                               to its corresponding device type
	hasProperty           - determines whether or not a device has a
                               specified property
	hasReading            - determines whether or not a device has a
                               reading property
	hasSetting            - determines whether or not a device has a
                               setting property
	hasStatus             - determines whether or not a device has a
                               status property
	hasControl            - determines whether or not a device has a
                               control property
	hasAnalogAlarm        - determines whether or not a device has an
                               analog alarm property
	hasDigitalAlarm       - determines whether or not a device has a
                               digital alarm property
	deviceNode            - returns the source node for a device property
	devicePropertyLengths - returns device property lengths
	deviceDefaultLength   - returns the default length of a device property
                               in bytes
	deviceAtomicLength    - returns the atomic length of a device property
                               in bytes
	deviceMaximumLength   - returns the maximum length of a device property
                               in bytes
	deviceScalingLength   - returns the scaling length of a device property
                               in bytes
	deviceState           - returns the state of a device
                               (valid, obsolete, or invalid)
	isObsoleteDevice      - determines whether or not a device is obsolete
	isDeletedDevice       - determines whether or not a device has been
                               deleted
	isDocumentationDevice - determines whether or not a device has been
                               marked as documented
	isArrayDevice         - determines whether or not a device/property
                               is an array
	isStructureDevice     - determines whether or not a device/property
                               is a structure
	deviceDigitalStatus   - returns a device digital status value
	deviceDownloadProperties - returns the download properties associated
                                  with a device
	deviceIsDownloaded    - determines if a device property is downloaded
                               upon front end reboot
	deviceProperties      - returns the properties associated with a device
	numReadableProperties - returns the number of readable properties for
                               a device (optionally also returns the array
                               of properties)
	numSettableProperties - returns the number of settable properties for
                               a device (optionally also returns the array
                               of properties)
	deviceSsdn            - returns the SSDN for a device property
	deviceEmc             - returns the EMC for a device property
	deviceSsdr            - returns the SSDR for a device
	deviceProtectionMask  - returns the device setting protection mask
	previousSibling       - returns the device's previous sibling (or 0)
	nextSibling           - returns the device's next sibling (or 0)
	controllingDevice     - returns the device's controlling device (or 0)
	deviceDefaultDataEvent - returns the default data event for a property
	deviceDefaultFtd      - returns the default FTD for a property
	bitText               - returns the descriptive text for a specified bit
	bitTextAll            - returns the bit information for a device
	bitDataText           - returns the data text for a specified bit
	statusAttrToBitInfo   - returns bit information corresponding to a
                               device status attribute
	statusScalingInfo     - returns status scaling info matching
                               a search criteria
	statusScalingInfoAll  - returns all status scaling info for a device
	ftpMaxFreq            - returns the maximum fast time plot frequency
                               for a device or plot class
	ftpDefaultFreq        - returns the default fast time plot frequency
                               for a device or plot class
	snapshotMaxFreq       - returns the maximum snapshot plot frequency
                               for a device or plot class and optionally
                               the number of points as well
	snapshotDefaultFreq   - returns the default snapshot plot frequency
                               for a device or plot class
	deviceStructureName   - returns the structure name for a device property
	deviceExpression      - returns the expression for a device
	deviceMachine         - returns the machine associated with a device
	deviceArea            - returns the area associated with a device
	deviceLocation        - returns location information for a
                               device/property
	deviceSaveInfo        - returns save/restore configuration info for
                               a device
	deviceSaveList        - returns the save list for a device
	deviceDepartment      - returns the department responsible for a device
	deviceMaintainer      - returns the person responsible for
                               maintaining a device
	deviceCreator         - returns the user who created a device
	deviceLastModifier    - returns the user who last modified a device
	deviceLastModifiedDate - returns the date when a device was last
                                modified
	stringToDeviceName    - finds device names matching a search string
	deviceNameToFullName  - returns the full device name corresponding
				to a name
	deviceFullNameToName  - returns the device name corresponding to a
                               full name
	deviceIsSettableByClass - determines if a device can be set by a
                                 console class
	deviceVirtualMachine  - returns device virtual machine information
	deviceNodeType        - returns the node type for a device property
	isIrmDevice           - determines whether a device property is
                               sourced by an IRM node
	isLabviewDevice       - determines whether a device property is
                               sourced by a LabView node
	isMoocDevice          - determines whether a device property is
                               sourced by a MOOC node
	isOacDevice           - determines whether a device property is
                               sourced by an OAC
	isAcsysFefDevice      - determines whether a device property is
                               sourced by an Acsys/FEF node
	isCamacDevice         - determines if a device is a CAMAC device
	deviceIsStepMotor     - determines if a device is a step motor
	deviceIsTimer         - determines if a device is a timer
	deviceIsTimerRef      - determines if a device is a timer reference
	timerReadEvents       - returns the reference events for a timer device
	cacheDeviceInfo       - cache device database information for
                               later retrieval
	deviceFamilyMembers   - returns the members of a family device
	deviceInFamilies      - returns families that a device is a member of
	deviceInCompositeDevices - returns composite devices which use a
                                  given device
	deviceControlledDevices - returns the devices controlled by a device
	virtualMachineDevices - returns the devices belonging to a
                               virtual machine
	deviceListing         - creates formatted device information strings
	deviceListToDevices   - retrieves the devices from a device list
	duplicateSsdnProperties - returns any duplicate SSDN properties
                                 to a given property on the same node
	deviceParameterPageMapping - returns device parameter page mapping
                                    instances
	fileDevices           - returns the devices specified in a file
	sqlQueryDevices       - returns devices from a SQL query
	userAlarmListDevices  - returns the devices in a user alarm list
	userAlarmListLists    - returns the user alarm lists referenced
                               by a user alarm list
	userSaveListDevices   - returns the devices in a user save list
	downloadDevices       - returns front end download devices
	parameterPageDevices  - returns the devices on a parameter page
	lexSaDevices          - returns devices in a Lex SA display
	synopticDevices       - returns devices in a Synoptic display
	getDeviceMaintainers  - retrieves ACNET device maintainer names
	maintainerDevices     - retrieve the devices maintained by a user
	validateDeviceName    - checks to see if a string would be a
                               valid device name
	historicDataLength    - returns the data lengths for a device/property
                               for a given date
	historicDeviceAddressing - returns device addressing for a
                                  device/property for a given date
	historicRawDataType   - returns the raw data type for a device/property
                               for a given date
	deviceRawDataType     - returns the raw data type for a device/property
	deviceAddressingMode  - returns a device/property addressing mode
	deviceForeignDeviceInfo - returns foreign device information for
                                 a device

	Device search functions:

	genericDeviceSearch   - searches for devices matching various parameters
	deviceNameSearch      - searches for all devices whose names match
                               a string
	deviceFullNameSearch  - searches for all devices whose full names
                               match a string
	deviceDescriptionSearch - searches for all devices whose descriptions
                                 match a string
	deviceFullDescriptionSearch - searches for all devices whose full
                                     descriptions match a string
	deviceNodeSearch      - searches for all devices from a given node
	deviceSsdnSearch      - searches for all devices whose SSDNs match
                               a pattern

	Device scaling functions:

	deviceRawToScaled         - scale a raw device value
	deviceRawToScaledCustom   - scale a raw device value using
                                   caller-supplied scaling parameters
	deviceRawToHistoricScaled - scale a raw device value using historic
                                   scaling
	deviceRawToValueText      - scale a raw value to its corresponding
                                   string
	deviceRawToValueTextCustom - scale a raw value to its corresponding
                                    string using caller-supplied scaling
	deviceScaledToRaw         - convert a scaled device value to a raw value
	deviceScaledToRawCustom   - reverse scale a scaled device value using
                                   caller-supplied scaling parameters
	deviceRawToStatusText     - scale a raw status value to a text string
	deviceRawToStatusValue    - scale a raw status value to a boolean
                                   attribute value
	deviceRawToControlText    - scale a raw control value to a text string
	deviceRawToEnumText       - scale a raw enumerated reading value
                                   to a text string
	devicePrimaryToScaled     - scales a primary device value
	deviceScaledToPrimary     - convert a scaled device value to
                                   a primary value
	devicePrimaryToScaledCustom - scale a primary device value using
                                     caller-supplied scaling parameters
	deviceReadSetScaling      - return reading or setting scaling
                                   information
	deviceReadSetExtScaling   - return extended reading or setting scaling
                                   information
	deviceReadSetHistoricScaling - return reading or setting historic
                                      scaling information
	deviceDisplayInfo         - returns device value display information
	deviceStatusScaling       - returns status scaling information
				    for a device
	deviceStatusScalingAll    - returns all status scaling information for
                                   a device
	hasStatusAttribute        - determines whether or not a device has a
                                   status attribute
	digitalControlInfo        - returns digital control info for a device
	digitalControlInfoAll     - returns all of the digital control info
                                   for a device
	hasControlAttribute       - determines whether or not a device has
                                   a control attribute
	deviceControlAttributes   - returns the control attributes for a device
	deviceExtrema             - returns device extrema values
	deviceCalculateExtrema    - calculates device extrema values
	deviceCalculateRawValue   - calculates the raw value corresponding
                                   to a scaled value

	Device alarm functions:

	alarmStatus             - returns a current alarm status
	alarmBlockFieldValue    - returns individual alarm block field values
	extractAlarmBlockFieldValue - extracts individual alarm block
                                     field values
	extractAlarmHeaderParam - extracts a requested parameter from from
                                 an alarm header word
	readAlarmBlock          - reads a requested alarm block
	alarmIsBypassed         - determines if an alarm is bypassed
	alarmIsBypassedDb       - determines if the database copy of an alarm
                                 is bypassed
	alarmIsSnoozed          - determines if an alarm is in snooze mode
	alarmRemainingSnoozeTime - returns the time remaining for a
				   snoozed alarm
	deviceAlarmList         - returns the device alarm list
	deviceAlarmGroupInfo    - returns device alarm group information
	deviceIsInAlarmGroup    - determines if a device is a member of an
                                 alarm group
	deviceIsAlarmConsolidator - determines if a device is an alarm
                                   consolidator
	analogAlarmText         - returns the analog alarm text for a device
	analogAlarmPriority     - returns the analog alarm priority for a device
	analogAlarmHandlerInfo  - returns analog alarm handler info for a device
	analogAlarmUrl          - returns the analog alarm URL for a device
	analogAlarmLimits       - returns analog alarm limits for a device
	digitalAlarmText        - returns the digital alarm text for a device
	digitalAlarmTextAll     - returns all of the digital alarm text for
                                 a device
	digitalAlarmHandlerInfo - returns digital alarm handler info for a device
	digitalAlarmNominalMask - returns a digital alarm nominal and mask
	deviceCurrentAlarmText  - returns the current alarm text for a device
	currentAnalogAlarmText  - returns the current analog alarm text for
                                 a device
	deviceCanAbort          - determines if a device can generate an
                                 abort alarm
	alarmAcknowledgeMask    - returns a device's alarm acknowledge mask
	userAlarmList           - returns the state of a user alarm list
                                 (enabled, bypassed, or empty)
	setUserAlarmListStatus  - sets the status of a user alarm list
	usersMonitoringAlarm    - returns the user who are monitoring a
                                 particular alarm

	Time functions:

	stringToDate          - converts a string to a date value
	dateToString          - converts a date value to a string
	convertSeconds        - converts dates in seconds between date types
	julianDate            - converts a date value to a julian date
	julianDateToDate      - converts a julian date value to a date
	15hzCount             - returns 15Hz count since the calling process
                               started
	millisecondsNow       - returns the current time in milliseconds
                               since the Epoch
	currentDate           - returns the current date in seconds and
                               milliseconds
	currentTime           - current time in seconds and milliseconds
                               since the Epoch
	currentTimeInClinks   - current time in seconds and milliseconds
                               since January 1, 1972 00:00 CST
	millisecondsToDate    - converts a number of milliseconds to its
                               corresponding date
	dateToMilliseconds    - converts a date to its corresponding number
                               of milliseconds
	systemTime	      - returns system time in milliseconds since
                               ACL was initialized
	scriptExecutionTime   - returns the script execution system time in
                               milliseconds
	cpuTime               - returns CPU time in milliseconds since
                               ACL was initialized
	timeAgo               - returns date which is some number of
                               time units before a base time
	timeFromDate          - returns date which is some number of
                               time units after a base time
	getSpecialDate        - calculates special date times
	localtime             - break down a date value into its component
                               values
	dateIsDst             - determines if a date is in the DST period
	dateToDayOfWeek       - returns the corresponding day of the week
                               for a date
	timezoneInfo          - returns information about the local timezone
	timeSinceMidnight     - returns the number of seconds since midnight
	todStringToSeconds    - converts a time of day string to seconds
	secondsToTodString    - converts seconds to a time of day string
	timeIntervalToString  - converts a time interval into a string
	determineDstDates     - determines the DST dates for a given year
	utcSecondsToDate      - converts a UTC time in seconds to a date value
	mdatCurrentDate       - returns the current date being transmitted
                               on the MDAT link
	supercycleLength      - returns the length of the current supercycle
	timeInSupercycle      - returns the current time in the supercycle

	Clock event functions:

	eventOccurred         - determines if a clock event has occurred
	clearEventOccurred    - clear the detection status for a clock event
	timeSinceEvent        - returns the elapsed time since an event
                               has occurred
	eventDate             - returns the date in clinks when an event last
                               occurred
	eventCount            - returns the current count for an event
	eventInfo             - returns clock event configuration information
	eventTimelineInfo     - returns the times an event will occur
                               in the timeline
	eventOccurrenceHistory - returns the occurrences of a clock event in
                                a time period
	eventSupercycleHistory - returns the occurrences of a clock event in
                                a supercycle
	clockEventIsEnabled   - determines if a clock event is enabled
	clockEventTriggerIsEnabled - determines if a clock event trigger
                                    is enabled
	reflectedEvent        - retrieves the reflected TCLK event for a
                               beam sync event
	genericEventSearch    - searches for events matching various parameters

	State event functions:

	stateText             - returns the text for a state of a state device
	stateTextAll          - returns all of the state text for a state device
	stateTextToNumber     - returns the state number corresponding to a
                               state text string
	stateOccurrenceHistory - returns the occurrences of a state event in
                                a time period

	Save/restore file functions:

	oldestSrFile          - returns the oldest save/restore file number
	newestSrFile          - returns the newest save/restore file number
	saveFileInfo          - returns information about a single save/restore
                               file
	saveFileDeviceErrors  - returns all of the device errors from a
                               save file
	saveFileDeviceStatus  - returns the save status for a requested device
                               in a save file
	abortOperatorSave     - aborts the current operator save/restore save
	checkOperatorSaveStatus - checks the status of a save/restore
                                 operator save

	SDA functions:

	currentSdaFile        - returns the current SDA file number for a given
                               usage
	dateToSdaFile         - returns the SDA file number corresponding to
                               a given date
	sdaFileDate           - returns the starting or ending date for an
                               SDA file
	isValidSdaFile        - determines whether or not a value is a valid
                               SDA file number (file instance actually exists)
	isValidSdaCase        - determines whether or not a value is a valid
                               SDA case (case instance actually exists)
	isValidSdaSet         - determines whether or not a value is a valid
                               SDA set (set instance actually exists)

	Node oriented functions:

	node                  - converts a node name to a value
	nodeIs                - determines whether or not the specified
                               node has a particular status or type
	nodeIsUp              - determines whether or not the specified
                               node is up
	nodeAttributeValue    - returns ACNET node attribute values
	cacheNodeInfo         - cache node database information for
                               later retrieval
	nodeStatus            - returns the status of an ACNET node
	nodeSoftwareType      - returns the software type of an ACNET node
	nodeHardwareType      - returns the hardware type of an ACNET node
	ipNameToNode          - converts an IP name to an ACNET node value
	trunkNodeToNode       - converts a trunk and node number into a
                               node value
	nodeToTrunkNode       - converts an ACNET node value to its component
                               trunk and node number
	nodeAcnetTasks        - retrieves the ACNET tasks for a given node
	nodeType              - returns ACNET node type information
	isFrontendNode        - determines if an ACNET node is a frontend node
	isCentralNode         - determines if an ACNET node is a central node
	isConsoleNode         - determines if an ACNET node is a console node
	isMoocNode            - determines whether a node is a MOOC node
	isAcsysFefNode        - determines whether a node is an Acsys/FEF node
	isIrmNode             - determines whether a node is an IRM node
	isLabviewNode         - determines whether a node is a LabView node
	isOacNode             - determines whether a node is an OAC node
	frontendSoftwareVersion - returns the software version for a front end
	acsysSoftwareVersion  - returns the software version for an
                               ACSys/FEF frontend
	moocSoftwareVersion   - returns the software version for a MOOC frontend
	irmSoftwareVersion    - returns the software version for an IRM frontend
	acnetPing             - performs an ACNET ping on a node
	ping                  - sends a ping request to another computer
	coresidentNodes       - returns the coresident nodes on an ACNET node
	loggersOnNode         - returns the data loggers running on an
                               ACNET node
	oacsOnNode            - returns the names of OACs running on an
                               ACNET node
	nodeConsolidator      - returns the consolidating node(s) for a node
	defaultAcnetNode      - returns the default ACNET node for a given node
	nodeTimeError         - returns the current time error for a node
	nodeCreationDate      - returns the creation date for a node
	genericNodeSearch     - searches for nodes matching various parameters
	nodeAlarmList         - retrieves the default alarm list for an
                               ACNET node
	nodeAcnetNodeIpAddress - returns the IP address for one ACNET node
                                from another
	nodeDevicesWithProperty - returns devices from a node having a
                                 specified property

	Console oriented functions:

	consoleExists         - determines whether or not a specified
                               console exists (is defined) (may not be running)
	consoleIsUp           - determines whether or not a specified
                               console is running
	consoleSlotExists     - determines whether or not a console slot exists
	consoleProcessName    - retrieves the name of a console process
                               running in a specified console and slot
	consoleTaskName       - returns a console slot specific task name
	availableConsolePaSlots - determines the available PA slots on a console
	availableConsoleSaSlots - determines the available SA slots on a console
	consoleToNode         - converts a console number to its corresponding
                               ACNET node
	consoleToInstance     - converts a console number to its corresponding
                               instance
	findConsoleWindowTitle - find console window titles matching a string
	consoleUserName       - returns a console's user name
	consoleDisplayName    - returns a console's display name
	consoleLocation       - returns the location of a console
	consolePhoneNumber    - returns the phone number corresponding
                               to a console
	consoleClasses        - returns the classes a console belongs to
	consoleIsMemberOfClass - determines if a console is a member of a class
	consoleGetenv         - returns the value of an environment variable
                               from a console
	consoleGetLogicalName - returns the value of a logical name from
                               a console
	consoleSetLogicalName - sets a logical name on a console
	consoleDeleteLogicalName - deletes a logical name on a console
	genericConsoleSearch  - searches for consoles matching various parameters

	File oriented functions:

	fileExists            - determines whether or not a file exists
	fileLength            - returns the length of a file in bytes
	fileDate              - returns the date of a file
	fileOwner             - returns the owner of a file
	fileOwnerId           - returns the owner ID for a file
	filePermissions       - returns the complete file permission set
                               for a file
	fileHasPermission     - returns a specific permission for a file
	fileCopy              - copies an existing file
                               (requires file copy privilege)
	fileRename            - renames an existing file
                               (requires file rename privilege)
	fileDelete            - deletes an existing file
                               (requires file delete privilege)
	openFile              - opens a file for reading and/or writing
	closeFile             - closes a file opened by an earlier call to
                               openFile
	fileGetString         - reads a string from a file opened by openFile
	filePrintf            - functions like fprintf with the additional
                               functionality of toString
	printf                - functions like printf with the additional
                               functionality of toString
	printfNoNewline       - functions like printf with the additional
                               functionality of toString (no newline added)
	fscanf                - functions like fscanf with the additional
                               functionality of toNumeric
	fileRead              - reads binary values from a file
	fileRewind            - rewinds a file to its beginning
	fileSetPosition       - sets a file offset
	fileGetPosition       - retrieves a file current offset
	fileWrite             - writes binary values to a file
	parseFileName         - parses a file name into its component pieces
	expandFileName        - expands a file name starting with a tilde (~)
	createDirectory       - creates a new directory
	currentDirectory      - returns the current working directory
	changeDirectory       - changes the current working directory
	fileDirectory         - returns file names for a directory
	findInFile            - searches for a text string in a file
	findFileInPath        - determines whether a file name points to an
                               existing file
	fileNumLines          - returns the number of lines (also characters
                               and words) in a file
	fileFlush             - flush any unwritten information to the file
	flushOutputFile       - flush any unwritten information to an
                               output file
	flushLogFile          - flush any unwritten information to the log file
	closeFilesharingFile  - closes a Filesharing file
	translateSymbolicLink - translates a symbolic link

	Program environment functions:

	myConsole             - returns the caller's console number
	myConsoleClass        - returns the caller's console class
	myConsoleInstance     - returns the caller's console instance number
	myConsoleSlot         - returns the caller's console slot
	myExecutableName      - returns the caller's executable name
	myHostName            - returns the caller's host name
	myNode                - returns the caller's ACNET node
	myNodeName            - returns the caller's ACNET node name
	myDisplayName         - returns the caller's display name
	myProcessName         - returns the caller's process name
	myGenericProcessName  - returns the caller's generic process name
	myProgramName         - returns the caller's program (MECCA project)
                               name
	mySystemInfo          - returns basic system information
	myControlSystemName   - returns the control system instance name
	myUserName            - returns the caller's user name
	myAcnetUserName       - returns the caller's ACNET user name
	myUserId              - returns the caller's console user ID
	mySystemUserId        - returns the caller's system user ID
	myDbUserName          - returns the current database connection name
	myPrivilegeLevel      - returns the caller's ACL privilege level
	isConsoleEnvironment  - determines if the calling process is running
                               in a console environment
	isRunningOffsite      - determines if the calling process is
                               running offsite
	myPid                 - returns the caller's process ID
	myParentPid           - returns the caller's parent's process ID

	Data logger functions:

	oldestLoggerTime      - returns the oldest timestamp for a logged device
	newestLoggerTime      - returns the most recent timestamp for a
                               logged device
	loggerNameToNode      - converts a data logger name to its
                               corresponding node
	nodeToLoggerName      - convert a node value to a data logger name
	loggerIsUp            - determines if a requested data logger is running
	loggerIsEnabled       - determines if the requested data logger
                               is enabled (logging)
	loggerListInfo        - returns general logger list information
	loggerListDeviceStats - returns logger list device configuration stats
	loggerListWrapTime    - returns a logger list wrap time in hours
	deviceLoggerDataEvents - returns the data events that a device is
                                logged on
	whereDeviceIsLogged   - returns where a device is logged
	whereDeviceWasLogged  - returns where a device was logged in the past
	allLoggerNodes        - returns the names of all data loggers
	loggerListDevices     - returns the devices in a data logger list
	loggerAvailableDeviceDates - finds the available logged dates for
                                    a device from a node
	loggerAvailableDeviceDataEntries - finds available logged data entries
                                          for a device from a node
	loggerFindDevicesByDataEvent - finds the devices logged on a data event
	loggerFindListsByDataEvent - finds the lists logged on a data event
	loggerGetListDataEvents - retrieves all data logger data events

	User information functions:

	consoleUserIdToName   - converts a console user ID to its
                               corresponding name
	consoleUserNameToId   - converts a console user name to its
                               corresponding ID
	consoleUserNameToFullName - converts a console user name to a full name
	fullNameToConsoleUserName - converts a full name to a console user name
	userAttributeValue    - returns user attribute values
	systemUserNameToId    - converts a user name to a system user ID
	systemUserIdToName    - converts a user ID to a system user name
	isValidUserName       - determines if a string is a valid user name
	userIsaPerson         - determines if a user name represents an
                               actual person
	isAclUser             - determines if a user has special ACL permissions
	isDabbelUser          - determines if a user has DABBEL privileges
	genericUserSearch     - searches for users matching various parameters
	userMonitorContacts   - retrieves the monitor contacts registered
                               for a user

	Miscellaneous functions:

	exists                - determines if a device or variable/symbol exists
	sizeof                - returns the number of elements in a device,
                               device list, input, or variable
	byteSizeof            - returns the size of a device or variable
                               in bytes (static)
	sizeofVariable        - returns the number of elements in a variable
	byteSizeofVariable    - returns the size of a variable in bytes
	numElements           - returns the number of elements in a variable
                               or a device specification
	byteCompare           - performs a byte comparison of two values
	byteCopy              - performs a byte copy of one value to another
	condif                - returns the second argument if the first has a
                               value of true or the third argument if it has
                               a value of false
	scondif               - returns the second argument as a string if the
                               first has a value of true or the third argument
                               as a string if it has a value of false
	lor                   - logical or
	land                  - logical and
	floatToBinary         - converts a single precision floating point
                               value to its equivalent binary value
	binaryToFloat         - converts a binary value to its equivalent
                               single precision floating point value
	cast                  - return the equivalent value to a value
	castDouble            - return the equivalent double precision value
                               to a value
	castFloat             - return the equivalent single precision value
                               to a value
	castInteger           - return the equivalent integer value to a value
	castLogical           - return the equivalent logical (boolean) value
                               to a value
	castLongLong          - return the equivalent long integer value
                               to a value
	castUnsignedInt       - return the equivalent unsigned integer value
                               to a value
	castUnsignedLongLong  - return the equivalent unsigned long integer
                               value to a value
	getInputValue         - retrieves an input value
	makeSaveRestoreDataSourceString - builds a save/restore
                                         data source string
	makeLoggerDataSourceString - builds a data logger data source string
	makeSdaDataSourceString - builds an SDA data source string
	bcdToString           - convert a BCD-encoded value into decimal string
	bcdToDecimal          - convert a BCD-encoded value into decimal integer
	random                - returns pseudo random numbers from 0 to 2^31 - 1
	randomSeed            - sets the seed value for the random function
	systemRandomNumber    - returns random numbers from 0 to 2^31 - 1
	prec                  - output precision
                               (eg. prec(value,fraction_digits))
	stringToRad50         - convert a string to a radix 50 value
	rad50ToString         - converts a radix 50 value to a string
	stringToColor         - converts a string to a color value
	stringToProperty      - converts a string to a property value
	stringToConvertType   - converts a string to a convert type value
	convertTypeToString   - converts a convert type value to a string
	totalNumberOfDevices  - returns the total number of devices in the
                               control system
	maximumDeviceIndex    - returns the maximum device index
                               (and optionally the minimum)
	ssdnToString          - converts an SSDN value to a standard string
	stringToSsdn          - converts a string to an SSDN value
	emcToString           - converts an EMC value to a standard string
	stringToEmc           - converts a string to an EMC value
	timer                 - returns the current value of a timer
	error                 - converts an ACNET error string to a value
	errorToFacilityError  - converts an ACNET error value to its component
                               facility and error number
	settingsAreEnabled    - determines if settings are enabled
	                        (supports optional device name argument)
	enableSettingLogging  - enable setting logging
	oldestSettingLogDate  - returns the old and newest setting log
                               entry dates
	getLogicalName        - returns the string corresponding to a
                               logical name
	setLogicalName        - sets a logical name to a value
	deleteLogicalName     - deletes a logical name
	getenv                - returns the string corresponding to an
                               environment variable
	setenv                - sets an environment variable to a value
	unsetenv              - deletes an environment variable
	delenv                - deletes an environment variable
	readLock              - retrieves information about a lock
	readProgramLocks      - retrieves the locks held by a program
	consoleSlotToWindow   - convert a console slot to a primary window ID
	consoleWindowToSlot   - convert a console window ID to a slot
	playBeep              - plays a beep sound
	playSound             - plays an existing sound file
	isProgramRunning      - determines whether or not a program is running
                               in a location
	taskExists            - determines if an ACNET task exists
	taskId                - returns an ACNET task ID
	taskPid               - returns an ACNET task process ID
	taskIdToName          - converts an ACNET task ID to a name
	taskPidToName         - converts an ACNET task process ID to name(s)
	isServerTask          - determines whether or not an ACNET task is
                               a server
	processExists         - determines if a process exists
	processInfo           - retrieves information about a process
	pidProcessExists      - determines if a pid points to an active process
	findProcesses         - returns processes running on the host computer
	pidToProcessName      - retrieves the process name corresponding to
                               a pid
	processNameToPid      - retrieves the pid corresponding to a
                               process name
	sendPidSignal         - sends a signal to a process specified by its pid
	sendProcessSignal     - sends a signal to a process specified by its name
	convertIpAddress      - converts IP addresses between name and
                               numeric forms
	isNumericIpAddress    - determines whether or not an IP address is
                               in numeric form
	ipAddressCompare      - determines whether or not two IP address
                               strings point to the same address
	pageTitle             - returns the title for a page
	pageTitleList         - returns the titles for a list of pages
	programMapping        - returns the pages that a program is mapped to
	javaAppInfo           - returns Java application information given
                               the name or the application ID
	javaAppInfoByRef      - returns Java application information given
                               a reference ID
	concatenateStringArguments - concatenate the script string arguments
	fshareFileInfo        - returns information about a Filesharing file
	genericStructInfo     - returns information about a generic structure
	appdsTableInfo        - returns information about an APPDS table
	feClassInfo           - returns front end device class information
	feSsdnClassLocation   - returns the byte index of the device class
                               in an SSDN
	calculateStepMotorSteps - calculates the number of steps for a motor
                                 to move to a given position
	stepMotorIsMoving     - determines whether or not a stepping motor
                               is currently moving
	networkServiceToPort  - converts a network service name to a port
	executeProgram        - execute a program
                               (replaces process executing ACL)
	terminalSize          - returns the size of the output terminal
	tempFileName          - returns a unique temporary file name
	snapManagerDataDirectory - returns snapshot manager data file
                                  information
	deviceSnapManagerFiles - returns information about a device's snap
                                manager data files
	snapManagerSystemNames - returns snapshot manager system names
	snapManagerSystemFiles - returns snapshot manager data file information
                                for a system
	snapManagerSystemPlotSetups - returns plot setups for a snapshot
                                     manager system
	snapManagerFindDevice - returns snapshot manager plot setups for
                               a device
	snapManagerReinitPlot - reinitializes a snapshot manager plot
	meccaProjectAttributeValue - returns MECCA project attribute values
	maximumMeccaProjectNumber - returns the maximum number for a
                                   MECCA project type
	maximumPaNumber       - returns the maximum PA (Primary Application)
                               number
	maximumSaNumber       - returns the maximum SA (Secondary Application)
                               number
	getMeccaKeepers       - retrieves MECCA project keeper names
	isMeccaKeeper         - returns the number of MECCA projects that
                               a user is the keeper of
	getNodeKeepers        - retrieves ACNET node keeper names
	isNodeKeeper          - returns the number of ACNET nodes that
                               a user is the keeper of
	maximumConsoleNode    - returns the maximum console node
	dipoleThreeBumpInfo   - returns dipole three bump information
	dipoleFourBumpInfo    - returns dipole four bump information
	gifImageSize          - determines the dimensions of a GIF image
	bpmNameToIndex        - converts a BPM name to its corresponding
                               data array index
	bpmCrateChannelToName - converts a BPM crate and channel to their
                               corresponding BPM name
	bpmStatusToString     - converts a BPM or BLM status value to a string
	blmNameToIndex        - converts a BLM name to its corresponding data
                               array index
	llrfCurveRootName     - returns the LLRF curve device root name
	llrfCurveCurrentLength - returns the current length of a LLRF curve
	llrfCurveMaxLength    - returns the maximum length of a LLRF curve
	sendLlrfCommand       - sends a LLRF command
	beamSwitchIsOn        - determines if the requested beam switch is on
	thisSoftwareBeamSwitchIsOn - determines is the requested local
                                    software beam switch is on
	beamPermitIsUp        - determines if the requested beam permit is up
	abortLoopIsUp         - determines if an abort/permit loop is up
	abortSystemReset      - resets an abort/permit loop
	maskAbortInput        - masks an abort input
	unmaskAbortInput      - unmasks an abort input
	resetRfWatchdog       - reset an RF watchdog trip for the requested
                               machine
	rfWatchdogTripIsPresent - determines if there is an RF watchdog trip
                                 for the requested machine
	refreshAlarmNodeList  - refresh the list of alarmer nodes
	findAlarmsDaemon      - find the location of an alarms daemon
	readMjyDataFile       - reads values from an MJY (scope) data file
	deviceMadcLocation    - returns the MADC location of a device
	madcNumChannels       - returns the number of channels for an MADC
	madcNumAvailableClockLevels - returns the number of available
                                     clock levels for an MADC
	madcNumAvailableLists - returns the number of available lists
                               for an MADC
	madcNumAvailablePlotChannels - returns the number of available
                                      plot channels for an MADC
	rampcardGetRootDevice - returns the root name corresponding to a
                               rampcard device
	rampcardDeviceTableType - returns the table type for a rampcard device
	paramPageConfigInfo   - retrieves parameter page configuration
                               information
	paramPageSubpageMenuTitles - retrieves a list of parameter page
                                    subpage titles
	paramPageSubpageInfo  - retrieves a parameter page subpage's information
	camacModuleId         - returns the ID for a CAMAC module
	checkDeviceFile       - checks for bad device names in a device file
	genericErrorSearch    - searches for errors matching various parameters
	genericMdatSearch     - searches for MDAT frames matching various
                               parameters
	genericProgramSearch  - searches for programs matching various parameters
	genericSwitchSearch   - searches for network switches matching various
                               parameters
	switchAttributeValue  - returns network switch attribute values
	utilityGetDate        - retrieves the current date and time from a
                               utility process
	utilityPing           - pings a utility process

	Debugging functions:

	variableNumReadings   - returns the number of times a variable
                               has been read
	variableNumSettings   - returns the number of times a variable
                               has been set
	variableType          - returns the type of a variable as a string
	variableArrayDimensions - returns the array dimensions of a variable
	variableDimensionSize - returns the size of one dimension of a variable
	variableIsInitialized - determines whether or not a variable has been
                               initialized
	variableIsConstant    - determines whether or not a variable
                               is a constant
	variableIsDynamic     - determines whether or not a variable
                               is dynamically resizable
	valueType             - returns the type of a value as a string
	labelLineNumber       - returns the source line number for a label
	ifLevel               - returns the current 'if' level of the script
	loopLevel             - returns the current loop level of the script
	numQueuedDataEventCallbacks - returns the number of queued
                                     data event callbacks
	clibMemoryInfo        - returns CLIB memory allocation information
	commandStats          - returns execution statistics for an ACL command
	clearCommandStats     - clear command statistics values
	functionStats         - returns execution statistics for an
                               ACL intrinsic function
	clearFunctionStats    - clear function statistics values


	ACL Intrinsic functions (alphabetic order):

	15hzCount - returns 15Hz count since the calling process started
	abortLoopIsUp - determines if an abort/permit loop is up
	abortOperatorSave - aborts the current operator save/restore save
	abortSystemReset - resets an abort/permit loop
	abs - absolute value
	acnetPing - performs an ACNET ping on a node
	acos - arc cosine
	acosd - arc cosine (result in degrees)
	acosh - arc hyperbolic cosine
	acsysSoftwareVersion - returns the software version for an
                              ACSys/FEF frontend
	alarmAcknowledgeMask - returns a device's alarm acknowledge mask
	alarmBlockFieldValue - returns individual alarm block field values
	alarmIsBypassed - determines if an alarm is bypassed
	alarmIsBypassedDb - determines if the database copy of an alarm
                           is bypassed
	alarmIsSnoozed - determines if an alarm is in snooze mode
	alarmRemainingSnoozeTime - returns the time remaining for a
				   snoozed alarm
	alarmStatus - returns a current alarm status
	allLoggerNodes - returns the names of all data loggers
	analogAlarmHandlerInfo - returns analog alarm handler info for a device
	analogAlarmLimits - returns analog alarm limits for a device
	analogAlarmPriority - returns the analog alarm priority for a device
	analogAlarmText - returns the analog alarm text for a device
	analogAlarmUrl - returns the analog alarm URL for a device
	and - bitwise and
	appdsTableInfo - returns information about an APPDS table
	arrayAppend - append a new entry at the end of an array
	arrayDelete - deletes an existing entry from an array
	arrayDeleteDuplicates - deletes duplicate entries from an array
	arrayDeleteValue - deletes entries from an array matching a
                          particular value
	arrayFill - fill an array with a value
	arrayInsert - inserts a new element in an array
	arrayInvert - inverts the order of an array
	arrayPrepend - insert a new entry at the beginning of an array
	arraySort - sorts an array of values
	arrayValueExists - determines if a value exists in an array
	ascii - convert a character value to its corresponding ASCII code(s)
	asin - arc sine
	asind - arc sine (result in degrees)
	asinh - arc hyperbolic sine
	atan - arc tangent
	atan2 - arc tangent of the quotient of the arguments
	atan2d - arc tangent of the quotient of the arguments
		 (result in degrees)
	atand - arc tangent (result in degrees)
	atanh - arc hyperbolic tangent
	availableConsolePaSlots - determines the available PA slots on a console
	availableConsoleSaSlots - determines the available SA slots on a console
	bcdToDecimal - convert a BCD-encoded value into decimal integer
	bcdToString - convert a BCD-encoded value into decimal string
	beamPermitIsUp - determines if the requested beam permit is up
	beamSwitchIsOn - determines if the requested beam switch is on
	binary - returns a value as a binary string
	binaryToFloat - converts a binary value to its equivalent
			single precision floating point value
	bit - bit test
	bitComplement - complement (invert) bits in a value
	bitCount - returns the number of bits set in a value
	bitDataText - returns the data text for a specified bit
	bitField - extracts a bit field value
	bitFieldCircularShift - circularly shifts a bit field
	bitText - returns the descriptive text for a specified bit
	bitTextAll - returns the bit information for a device
	blmNameToIndex - converts a BLM name to its corresponding data
                        array index
	bpmCrateChannelToName - converts a BPM crate and channel to their
                               corresponding BPM name
	bpmNameToIndex - converts a BPM name to its corresponding
                        data array index
	bpmStatusToString - converts a BPM or BLM status value to a string
	byteCompare - performs a byte comparison of two values
	byteCopy - performs a byte copy of one value to another
	byteSizeof - returns the size of a device or variable in bytes (static)
	byteSizeofVariable - returns the size of a variable in bytes
	cacheDeviceInfo - cache device database information for later retrieval
	cacheNodeInfo - cache node database information for later retrieval
	calculateStepMotorSteps - calculates the number of steps for a motor
                                 to move to a given position
	camacModuleId - returns the ID for a CAMAC module
	capitalize - capitalizes the first character in each word of a string
	case - changes the case of a string
	cast - return the equivalent value to a value
	castDouble - return the equivalent double precision value to a value
	castFloat - return the equivalent single precision value to a value
	castInteger - return the equivalent integer value to a value
	castLogical - return the equivalent logical (boolean) value to a value
	castLongLong - return the equivalent long integer value to a value
	castUnsignedInt - return the equivalent unsigned integer value
                         to a value
	castUnsignedLongLong - return the equivalent unsigned long integer
                              value to a value
	ceil - smallest integer greater than or equal to its argument
	center - center a string
	changeDirectory - changes the current working directory
	char - converts an ASCII code to its corresponding character
	characterCount - returns the number of characters in a string
	characterType - returns the type of a character
	checkDeviceFile - checks for bad device names in a device file
	checkOperatorSaveStatus - checks the status of a save/restore
                                 operator save
	chiSquare - calculates the chi-squared value for a set of
                   data points
	circularShift - bit field circular shift
	clearBit - clear a bit in a value
	clearCommandStats - clear command statistics values
	clearEventOccurred - clear the detection status for a clock event
	clearFunctionStats - clear function statistics values
	clibMemoryInfo - returns CLIB memory allocation information
	clockEventIsEnabled - determines if a clock event is enabled
	clockEventTriggerIsEnabled - determines if a clock event trigger
                                    is enabled
	closeFile - closes a file opened by an earlier call to openFile
	closeFilesharingFile - closes a Filesharing file
	commandStats - returns execution statistics for an ACL command
	compareWithTolerance - compares one or more values with another
                              with a tolerance
	concatenateStringArguments - concatenate the script string arguments
	condif - returns the second argument if the first has a value of
		 true or the third argument if it has a value of false
	consoleClasses - returns the classes a console belongs to
	consoleClassMaskToString - convert a console class mask to a string
	consoleDeleteLogicalName - deletes a logical name on a console
	consoleDisplayName - returns a console's display name
	consoleExists - determines whether or not a specified console exists
			(is defined) (may not be running)
	consoleGetenv - returns the value of an environment variable
                       from a console
	consoleGetLogicalName - returns the value of a logical name from
                               a console
	consoleIsMemberOfClass - determines if a console is a member of a class
	consoleIsUp - determines whether or not a specified console is running
	consoleLocation - returns the location of a console
	consolePhoneNumber - returns the phone number corresponding to a console
	consoleProcessName - retrieves the name of a console process running
			     in a specified console and slot
	consoleSetLogicalName - sets a logical name on a console
	consoleSlotExists - determines whether or not a console slot exists
	consoleSlotToWindow - convert a console slot to a primary window ID
	consoleTaskName - returns a console slot specific task name
	consoleToInstance - converts a console number to its corresponding
                           instance
	consoleToNode - converts a console number to its corresponding
                       ACNET node
	consoleUserIdToName - converts a console user ID to its
                             corresponding name
	consoleUserName - returns a console's user name
	consoleUserNameToFullName - converts a console user name to a full name
	consoleUserNameToId - converts a console user name to its
                             corresponding ID
	consoleWindowToSlot - convert a console window ID to a slot
	controllingDevice - returns the device's controlling device (or 0)
	convertIpAddress - converts IP addresses between name and numeric forms
	convertSeconds - converts dates in seconds between date types
	convertTypeToString - converts a convert type value to a string
	coresidentNodes - returns the coresident nodes on an ACNET node
	cos - cosine
	cosd - cosine (argument in degrees)
	cosecant - cosecant
	cosh - hyperbolic cosine
	cotan - cotangent
	cotand - cotangent (argument in degrees)
	cpuTime - returns CPU time in milliseconds since ACL was initialized
	createDirectory - creates a new directory
	currentAnalogAlarmText - returns the current analog alarm text for
				 a device
	currentDate - returns the current date in seconds and milliseconds
	currentDirectory - returns the current working directory
	currentSdaFile - returns the current SDA file number for a given usage
	currentTime - current time in seconds and milliseconds since the Epoch
	currentTimeInClinks - current time in seconds and milliseconds
                             since January 1, 1972 00:00 CST
	dateIsDst - determines if a date is in the DST period
	dateToDayOfWeek - returns the corresponding day of the week for a date
	dateToMilliseconds - converts a date to its corresponding number
                            of milliseconds
	dateToSdaFile - returns the SDA file number corresponding to a
			given date
	dateToString - converts a date value to a string
	decimal - returns a value as a decimal string
	defaultAcnetNode - returns the default ACNET node for a given node
	delenv - deletes an environment variable
	deleteLogicalName - deletes a logical name
	delimitedStringLength - returns the length of a string using delimiters
	determineDstDates - determines the DST dates for a given year
	device - converts an ACNET device to a device index value
	deviceAddressingMode - returns a device/property addressing mode
	deviceAlarmGroupInfo - returns device alarm group information
	deviceAlarmList - returns the device alarm list
	deviceArea - returns the area associated with a device
	deviceArrayIndex - returns the array index and number of elements
                          for a device spec
	deviceAtomicLength - returns the atomic length of a device property
			     in bytes
	deviceBitField - extracts a bit field value from a device reading
	deviceCalculatedValue - returns a calculated device value
	deviceCalculateExtrema - calculates device extrema values
	deviceCalculateRawValue - calculates the raw value corresponding
                                 to a scaled value
	deviceCanAbort - determines if a device can generate an abort alarm
	deviceControlAttributes - returns the control attributes for a device
	deviceControlledDevices - returns the devices controlled by a device
	deviceCreator - returns the user who created a device
	deviceDefaultDataEvent - returns the default data event for a property
	deviceDefaultFtd - returns the default FTD for a property
	deviceDefaultLength - returns the default length of a device property
			      in bytes
	deviceDepartment - returns the department responsible for a device
	deviceDescriptionSearch - searches for all devices whose descriptions
                                 match a string
	deviceDigitalStatus - returns a device digital status value
	deviceDisplayInfo - returns device value display information
	deviceDownloadProperties - returns the download properties associated
                                  with a device
	deviceEmc - returns the EMC for a device property
	deviceExpression - returns the expression for a device
	deviceExtrema - returns device extrema values
	deviceFamilyMembers - returns the members of a family device
	deviceForeignDeviceInfo - returns foreign device information for
                                 a device
	deviceFullDescriptionSearch - searches for all devices whose full
                                     descriptions match a string
	deviceFullNameSearch - searches for all devices whose full names
                              match a string
	deviceFullNameToName - returns the device name corresponding to a
                              full name
	deviceInCompositeDevices - returns composite devices which use a
                                  given device
	deviceIndex - converts an ACNET device to a device index value
	deviceInFamilies - returns families that a device is a member of
	deviceIsAlarmConsolidator - determines if a device is an alarm
                                   consolidator
	deviceIsDownloaded - determines if a device property is downloaded
                            upon front end reboot
	deviceIsInAlarmGroup - determines if a device is a member of an
                              alarm group
	deviceIsSettableByClass - determines if a device can be set by a
                                 console class
	deviceIsStepMotor - determines if a device is a step motor
	deviceIsTimer - determines if a device is a timer
	deviceIsTimerRef - determines if a device is a timer reference
	deviceLastModifiedDate - returns the date when a device was last
                                modified
	deviceLastModifier - returns the user who last modified a device
	deviceListing - creates formatted device information strings
	deviceListToDevices - retrieves the devices from a device list
	deviceLocation - returns location information for a device/property
	deviceLoggerDataEvents - returns the data events that a device is
                                logged on
	deviceMachine - returns the machine associated with a device
	deviceMadcLocation - returns the MADC location of a device
	deviceMaintainer - returns the person responsible for
                          maintaining a device
	deviceMaximumLength - returns the maximum length of a device property
			      in bytes
	deviceNameExists - determines if a string is an existing device name
	deviceNameSearch - searches for all devices whose names match a string
	deviceNameToFullName - returns the full device name corresponding
                              to a name
	deviceNode - returns the source node for a device property
	deviceNodeSearch - searches for all devices from a given node
	deviceNodeType - returns the node type for a device property
	deviceOffset - returns the offset and length in bytes for a device spec
	deviceParameterPageMapping - returns device parameter page mapping
                                    instances
	devicePrimaryToScaled - scales a primary device value
	devicePrimaryToScaledCustom - scale a primary device value using
                                     caller-supplied scaling parameters
	deviceProperties - returns the properties associated with a device
	deviceProperty - returns the property value from a device spec
	devicePropertyLengths - returns device property lengths
	deviceProtectionMask - returns the device setting protection mask
	deviceRawDataType - returns the raw data type for a device/property
	deviceRawToControlText - scale a raw control value to a text string
	deviceRawToEnumText - scale a raw enumerated reading value to a
			      text string
	deviceRawToHistoricScaled - scale a raw device value using historic
                                   scaling
	deviceRawToScaled - scale a raw device value
	deviceRawToScaledCustom - scale a raw device value using
				  caller-supplied scaling parameters
	deviceRawToStatusText - scale a raw status value to a text string
	deviceRawToStatusValue - scale a raw status value to a
				 boolean attribute value
	deviceRawToValueText - scale a raw value to its corresponding string
	deviceRawToValueTextCustom - scale a raw value to its corresponding
                                    string using caller-supplied scaling
	deviceReadSetExtScaling - return extended reading or setting scaling
                                 information
	deviceReadSetHistoricScaling - return reading or setting historic
                                      scaling information
	deviceReadSetScaling - return reading or setting scaling information
	deviceSaveInfo - returns save/restore configuration info for a device
	deviceSaveList - returns the save list for a device
	deviceScaledToPrimary - convert a scaled device value to
                               a primary value
	deviceScaledToRaw - convert a scaled device value to a raw value
	deviceScaledToRawCustom - reverse scale a scaled device value using
                                 caller-supplied scaling parameters
	deviceScalingLength - returns the scaling length of a device property
			      in bytes
	deviceSnapManagerFiles - returns information about a device's snap
                                manager data files
	deviceSpec - converts a value to a device specification
	deviceSpecExtractValues - extracts individual parameter values from
                                 a device specification
	deviceSpecToString - converts a device specification to a string
	deviceSsdn - returns the SSDN for a device property
	deviceSsdnSearch - searches for all devices whose SSDNs match
                          a pattern
	deviceSsdr - returns the SSDR for a device
	deviceState - returns the state of a device
                     (valid, obsolete, or invalid)
	deviceStatusScaling - returns status scaling information for a device
	deviceStatusScalingAll - returns all status scaling information for
                                a device
	deviceStructureName - returns the structure name for a device property
	deviceType - returns the type of a device property
	deviceTypeMismatch - determines if a device property is typed properly
	deviceValue - returns a numeric device value
	deviceValueText - returns a device value as a string
	deviceVirtualMachine - returns device virtual machine information
	digitalAlarmHandlerInfo - returns digital alarm handler info for a device
	digitalAlarmNominalMask - returns a digital alarm nominal and mask
	digitalAlarmText - returns the digital alarm text for a device
	digitalAlarmTextAll   - returns all of the digital alarm text for
                               a device
	digitalControlInfo - returns digital control info for a device
	digitalControlInfoAll - returns all of the digital control info
                               for a device
	dipoleFourBumpInfo - returns dipole four bump information
	dipoleThreeBumpInfo - returns dipole three bump information
	downloadDevices - returns front end download devices
	duplicateSsdnProperties - returns any duplicate SSDN properties
                                 to a given property on the same node
	emcToString - converts an EMC value to a standard string
	enableSettingLogging - enable setting logging
	error - converts an ACNET error string to a value
	errorToFacilityError - converts an ACNET error value to its component
                              facility and error number
	escapeQuotesInSqlString - escapes quote characters in a SQL string
	escapeString - replaces characters in a string with their
		       corresponding escape characters
	eventCount - returns the current count for an event
	eventDate - returns the date in clinks when an event last occurred
	eventInfo - returns clock event configuration information
	eventOccurred - determines if a clock event has occurred
	eventOccurrenceHistory - returns the occurrences of a clock event in
                                a time period
	eventSupercycleHistory - returns the occurrences of a clock event in
                                a supercycle
	eventTimelineInfo - returns the times an event will occur
                           in the timeline
	executeProgram - execute a program (replaces process executing ACL)
	exists - determines if a device or variable/symbol exists
	exp - base e exponentiation (e^n)
	expandFileName - expands a file name starting with a tilde (~)
	extractAlarmBlockFieldValue - extracts individual alarm block
                                     field values
	extractAlarmHeaderParam - extracts a requested parameter from from
                                 an alarm header word
	feClassInfo - returns front end device class information
	feSsdnClassLocation - returns the byte index of the device class
                             in an SSDN
	fileCopy - copies an existing file (requires file copy privilege)
	fileDate - returns the date of a file
	fileDelete - deletes an existing file (requires file delete privilege)
	fileDevices - returns the devices specified in a file
	fileDirectory - returns file names for a directory
	fileExists - determines whether or not a file exists
	fileFlush - flush any unwritten information to the file
	fileGetPosition - retrieves a file current offset
	fileGetString - reads a string from a file opened by openFile
	fileHasPermission - returns a specific permission for a file
	fileLength - returns the length of a file in bytes
	fileNumLines - returns the number of lines (also characters and words)
                      in a file
	fileOwner - returns the owner of a file
	fileOwnerId - returns the owner ID for a file
	filePermissions - returns the complete file permission set for a file
	filePrintf - functions like fprintf with the additional functionality
                    of toString
	fileRead - reads binary values from a file
	fileRename - renames an existing file (requires file rename privilege)
	fileRewind - rewinds a file to its beginning
	fileSetPosition - sets a file offset
	fileWrite - writes binary values to a file
	findAlarmsDaemon - find the location of an alarms daemon
	findChar - returns the first location of one of a set of characters
		   in a string
	findConsoleWindowTitle - find console window titles matching a string
	findFileInPath - determines whether a file name points to an
                        existing file
	findInFile - searches for a text string in a file
	findNotChar - returns the first location of a character which is not
		      a member of a set of characters in a string
	findProcesses - returns processes running on the host computer
	findString - returns the position of one string within another
	findTagString - finds and extracts delimited tags from a string
	firstCharPos - find the first or last nonblank character position
	floatToBinary - converts a single precision floating point value to
			its equivalent binary value
	floor - largest integer less than or equal to its argument
	flushLogFile - flush any unwritten information to the log file
	flushOutputFile - flush any unwritten information to an output file
	fmod - remainder of the arguments
	formatDateString - format a date string using the format specifiers
			   in strftime
	fract - fractional component
	frontendSoftwareVersion - returns the software version for a front end
	fscanf - functions like fscanf with the additional functionality
                of toNumeric
	fshareFileInfo - returns information about a Filesharing file
	ftpDefaultFreq - returns the default fast time plot frequency
                        for a device or plot class
	ftpMaxFreq - returns the maximum fast time plot frequency for a
		     device or plot class
	fullName - returns a device full name string
	fullNameToConsoleUserName - converts a full name to a console user name
	fullText - returns a device full descriptive text string
	functionStats - returns execution statistics for an
                       ACL intrinsic function
	genericConsoleSearch - searches for consoles matching various parameters
	genericDeviceSearch - searches for devices matching various parameters
	genericErrorSearch - searches for errors matching various parameters
	genericEventSearch - searches for events matching various parameters
	genericMdatSearch - searches for MDAT frames matching various parameters
	genericNodeSearch - searches for nodes matching various parameters
	genericProgramSearch - searches for programs matching various parameters
	genericStructInfo - returns information about a generic structure
	genericSwitchSearch : searches for network switches matching various
                             parameters
	genericUserSearch - searches for users matching various parameters
	getDeviceMaintainers - retrieves ACNET device maintainer names
	getenv - returns the string corresponding to an environment variable
	getFirstChar - retrieve the first or last nonblank character
	getInputValue - retrieves an input value
	getLastChar - retrieve the last nonblank character in a string
	getLogicalName - returns the string corresponding to a logical name
	getMeccaKeepers - retrieves MECCA project keeper names
	getNodeKeepers - retrieves ACNET node keeper names
	getSpecialDate - calculates special date times
	getTaggedValue - extracts a tag/value pair from a string
	gifImageSize - determines the dimensions of a GIF image
	hasAnalogAlarm - determines whether or not a device has an
			 analog alarm property
	hasControl - determines whether or not a device has a control property
	hasControlAttribute - determines whether or not a device has
                             a control attribute
	hasDigitalAlarm - determines whether or not a device has a
			  digital alarm property
	hasProperty - determines whether or not a device has a
		      specified property
	hasReading - determines whether or not a device has a reading property
	hasSetting - determines whether or not a device has a setting property
	hasStatus - determines whether or not a device has a status property
	hasStatusAttribute - determines whether or not a device has a
                            status attribute
	head - returns the beginning of a string
	hex - returns a value as a hexadecimal string
	highestBit - returns the highest bit set in a value (or -1)
	histogram - divides an array of values into buckets
	historicDataLength - returns the data lengths for a device/property
                            for a given date
	historicDeviceAddressing - returns device addressing for a
                                  device/property for a given date
	historicName - returns a device name on a specified date
	historicRawDataType - returns the raw data type for a device/property
                             for a given date
	hypot - square root of the sum of the squares of the arguments
	identical - checks to see if all values in an array are identical
	identical2 - checks to see if all values in an array are identical
	ifLevel - returns the current 'if' level of the script
	insertString - inserts a string within another string
	integrateDataPoints - calculates the area under a set of data points
	ipAddressCompare - determines whether or not two IP address
                          strings point to the same address
	ipNameToNode - converts an IP name to an ACNET node value
	irmSoftwareVersion - returns the software version for an IRM frontend
	isAclUser - determines if a user has special ACL permissions
	isAcsysFefDevice - determines whether a device property is
                          sourced by an Acsys/FEF node
	isAcsysFefNode - determines whether a node is an Acsys/FEF node
	isAlphabeticString - determines whether or not a string is composed
			     entirely of alphabetic characters
			     (plus optional white space)
	isAlphanumericString - determines whether or not a string is composed
			       entirely of alphanumeric characters
			       (plus optional white space)
	isArrayDevice - determines whether or not a device/property is an array
	isBlankString - determines whether or not a string is composed
			entirely of white space
	isBracketedString - determines whether or not a string is bracketed
	isCamacDevice - determines if a device is a CAMAC device
	isCentralNode - determines if an ACNET node is a central node
	isConsoleEnvironment - determines if the calling process is running
                              in a console environment
	isConsoleNode - determines if an ACNET node is a console node
	isDabbelUser - determines if a user has DABBEL privileges
	isDateString - determines whether or not a string represents a date
	isDeletedDevice - determines whether or not a device has been deleted
	isDeviceString - determines whether or not a string represents a
			 device specification
	isDocumentationDevice - determines whether or not a device has been
                               marked as documented
	isErrorString - determines whether or not a string is an error name
	isEventString - determines whether or not a string represents a
			clock event
	isFloatString - determines whether or not a string represents a
			floating point number
	isFrontendNode - determines if an ACNET node is a frontend node
	isHexString - determines whether or not a string represents a
		      hexadecimal number
	isInfinity - tests to see if a value is infinite
	isIntegerString - determines whether or not a string represents
			  an integer number
	isIrmDevice - determines whether a device property is
                     sourced by an IRM node
	isIrmNode - determines whether a node is an IRM node
	isLabviewDevice - determines whether a device property is
                         sourced by a LabView node
	isLabviewNode - determines whether a node is a LabView node
	isLowerCase - determines whether or not a string is in all
		      lower case characters
	isMeccaKeeper - returns the number of MECCA projects that
                       a user is the keeper of
	isMoocDevice - determines whether a device property is
                      sourced by a MOOC node
	isMoocNode - determines whether a node is a MOOC node
	isNaN - tests to see if a value is a NaN
	isNodeKeeper - returns the number of ACNET nodes that
                      a user is the keeper of
	isNodeString - determines whether or not a string is a node name
	isNumericIpAddress - determines whether or not an IP address is
                            in numeric form
	isOacDevice - determines whether a device property is
                     sourced by an OAC
	isOacNode - determines whether a node is an OAC node
	isObsoleteDevice - determines whether or not a device is obsolete
	isPrintableString - determines whether or not a string is composed
			    entirely of printable characters
	isProgramRunning - determines whether or not a program is running
                          in a location
	isPropertyString - determines whether or not a string is a
			   device property name
	isQuotedString - determines whether or not a string is quoted
	isRad50String - determines whether or not a string is
                       composed entirely of valid rad50 characters
	isRunningOffsite - determines if the calling process is
                          running offsite
	isServerTask - determines whether or not an ACNET task is a server
	isStringFilledWithChar - determines whether or not a string is
				 composed entirely of a single character
	isStructureDevice - determines whether or not a device/property
                           is a structure
	isUpperCase - determines whether or not a string is in all
		      upper case characters
	isValidSdaCase - determines whether or not a value is a valid SDA
			 case (case instance actually exists)
	isValidSdaFile - determines whether or not a value is a valid SDA
			 file number (file instance actually exists)
	isValidSdaSet - determines whether or not a value is a valid SDA set
			(set instance actually exists)
	isValidUserName - determines if a string is a valid user name
	javaAppInfo - returns Java application information given
                     the name or the application ID
	javaAppInfoByRef - returns Java application information given
                          a reference ID
	julianDate - converts a date value to a julian date
	julianDateToDate - converts a julian date value to a date
	justify - left justify, right justify, or center a string
	labelLineNumber - returns the source line number for a label
	land - logical and
	lastCharPos - find the last nonblank character position in a string
	leftJustify - left justify a string
	leftShift - left shift a string
	leftTrim - removes leading blanks from a string
	lexSaDevices - returns devices in a Lex SA display
	llrfCurveCurrentLength - returns the current length of a LLRF curve
	llrfCurveMaxLength - returns the maximum length of a LLRF curve
	llrfCurveRootName - returns the LLRF curve device root name
	ln - natural log
	localtime - break down a date value into its component values
	log - base 10 log
	loggerAvailableDeviceDataEntries - finds available logged data entries
                                          for a device from a node
	loggerAvailableDeviceDates - finds the available logged dates for
                                    a device from a node
	loggerFindDevicesByDataEvent - finds the devices logged on a data event
	loggerFindListsByDataEvent - finds the lists logged on a data event
	loggerGetListDataEvents - retrieves all data logger data events
	loggerIsEnabled - determines if the requested data logger
                         is enabled (logging)
	loggerIsUp - determines if a requested data logger is running
	loggerListDevices - returns the devices in a data logger list
	loggerListDeviceStats - returns logger list device configuration stats
	loggerListInfo - returns general logger list information
	loggerListWrapTime - returns a logger list wrap time in hours
	loggerNameToNode - converts a data logger name to its corresponding node
	loggersOnNode - returns the data loggers running on an ACNET node
	loopLevel - returns the current loop level of the script
	lor - logical or
	lowestBit - returns the lowest bit set in a value (or -1)
	lshft - circular left shift
	madcNumAvailableClockLevels - returns the number of available
                                     clock levels for an MADC
	madcNumAvailableLists - returns the number of available lists
                               for an MADC
	madcNumAvailablePlotChannels - returns the number of available
                                      plot channels for an MADC
	madcNumChannels - returns the number of channels for an MADC
	maintainerDevices - retrieve the devices maintained by a user
	makeLoggerDataSourceString - builds a data logger data source string
	makePrintable - expand any tabs and remove or replace any
			nonprintable characters in a string
	makeSaveRestoreDataSourceString - builds a save/restore
                                         data source string
	makeLoggerDataSourceString - builds a data logger data source string
	maskAbortInput - masks an abort input
	matrixAdd - adds two matrices of the same size
	matrixDeterminant - calculates the determinant of a matrix
	matrixInvert - inverts a two dimensional matrix
	matrixMultiply - multiplies two compatible matrices
	matrixScalarMultiply - multiplies all members of a matrix by a
                              scalar value
	matrixSolve - uses a two dimensional matrix to solve a
                     system of linear equations
	max - maximum of two values
	maximum - determines the maximum of an array of values
	maximum2 - determines the maximum of an array of values
	maximumConsoleNode - returns the maximum console node
	maximumDeviceIndex - returns the maximum device index
                            (and optionally the minimum)
	maximumMeccaProjectNumber - returns the maximum number for a
                                   MECCA project type
	maximumPaNumber - returns the maximum PA (Primary Application) number
	maximumSaNumber - returns the maximum SA (Secondary Application) number
	mdatCurrentDate - returns the current date being transmitted
                         on the MDAT link
	mean - calculates the mean of an array of values
	mean2 - calculates the mean of an array of values
	meccaProjectAttributeValue - returns MECCA project attribute values
	median - calculates the median of an array of values
	median2 - calculates the median of an array of values
	millisecondsNow - returns the current time in milliseconds
                         since the Epoch
	millisecondsToDate - converts a number of milliseconds to its
                            corresponding date
	min - minimum of two values
	minimum - determines the minimum of an array of values
	minimum2 - determines the minimum of an array of values
	mode - returns the most commonly occurring value in an array
	       (If there are multiple mode values, the smallest value
		is returned.)
	mode2 - returns the most commonly occurring value in an array
	        (If there are multiple mode values, the smallest value
		 is returned.)
	moocSoftwareVersion - returns the software version for a MOOC frontend
	myAcnetUserName - returns the caller's ACNET user name
	myConsole - returns the caller's console number
	myConsoleClass - returns the caller's console class
	myConsoleInstance - returns the caller's console instance number
	myConsoleSlot - returns the caller's console slot
	myControlSystemName - returns the control system instance name
	myDbUserName - returns the current database connection name
	myDisplayName - returns the caller's display name
	myExecutableName - returns the caller's executable name
	myGenericProcessName - returns the caller's generic process name
	myHostName - returns the caller's host name
	myNode - returns the caller's ACNET node
	myNodeName - returns the caller's ACNET node name
	myParentPid - returns the caller's parent's process ID
	myPid - returns the caller's process ID
	myPrivilegeLevel - returns the caller's ACL privilege level
	myProcessName - returns the caller's process name
	myProgramName - returns the caller's program (MECCA project) name
	mySystemInfo - returns basic system information
	mySystemUserId - returns the caller's system user ID
	myUserId - returns the caller's console user ID
	myUserName - returns the caller's user name
	name - returns a device name string
	networkServiceToPort - converts a network service name to a port
	newestLoggerTime - returns the most recent timestamp for a
                          logged device
	newestSrFile - returns the newest save/restore file number
	nextSibling - returns the device's next sibling (or 0)
	node - converts a node name to a value
	nodeAcnetNodeIpAddress - returns the IP address for one ACNET node
                                from another
	nodeAcnetTasks - retrieves the ACNET tasks for a given node
	nodeAlarmList - retrieves the default alarm list for an ACNET node
	nodeAttributeValue - returns ACNET node attribute values
	nodeConsolidator - returns the consolidating node(s) for a node
	nodeCreationDate - returns the creation date for a node
	nodeDevicesWithProperty - returns devices from a node having a
                                 specified property
	nodeHardwareType - returns the hardware type of an ACNET node
	nodeIs - determines whether or not the specified node has a
		 particular status or type
	nodeIsUp - determines whether or not the specified node is up
	nodeSoftwareType - returns the software type of an ACNET node
	nodeStatus - returns the status of an ACNET node
	nodeTimeError - returns the current time error for a node
	nodeToLoggerName - convert a node value to a data logger name
	nodeToTrunkNode - converts an ACNET node value to its component
                         trunk and node number
	nodeType - returns ACNET node type information
	nonblankLength - returns the nonblank length of a string
	numElements - returns the number of elements in a variable or a
		      device specification (dynamic)
	numQueuedDataEventCallbacks - returns the number of queued
                                     data event callbacks
	numReadableProperties - returns the number of readable properties for
				a device (optionally also returns the array
				of properties)
	numSettableProperties - returns the number of settable properties for
				a device (optionally also returns the array
				of properties)
	oacsOnNode - returns the names of OACs running on an ACNET node
	octal - returns a value as an octal string
	offsetCharacter - increments a character in a string by a
                         requested amount
	oldestLoggerTime - returns the oldest timestamp for a logged device
	oldestSettingLogDate - returns the old and newest setting log
                              entry dates
	oldestSrFile - returns the oldest save/restore file number
	openFile - opens a file for reading and/or writing
	or - bitwise or
	pad - pads a string with a specified character to a specified length
	pageTitle - returns the title for a page
	pageTitleList - returns the titles for a list of pages
	parameterPageDevices - returns the devices on a parameter page
	paramPageConfigInfo - retrieves parameter page configuration
                             information
	paramPageSubpageInfo - retrieves a parameter page subpage's information
	paramPageSubpageMenuTitles - retrieves a list of parameter page
                                    subpage titles
	parseFileName - parses a file name into its component pieces
	pidProcessExists - determines if a pid points to an active process
	pidToProcessName - retrieves the process name corresponding to a pid
	ping - sends a ping request to another computer
	playBeep - plays a beep sound
	playSound - plays an existing sound file
	pos - pads with spaces/truncates a string to a specified length
	prec - output precision (eg. prec(value,fraction_digits))
	previousSibling - returns the device's previous sibling (or 0)
	printf - functions like printf with the additional functionality
                of toString
	printfNoNewline - functions like printf with the additional
                         functionality of toString (no newline added)
	processExists - determines if a process exists
	processInfo - retrieves information about a process
	processNameToPid - retrieves the pid corresponding to a process name
	programMapping - returns the pages that a program is mapped to
	quoteString - adds beginning and ending quotes to a string
	rad50ToString - converts a radix 50 value to a string
	radix - returns a value as an arbitrary radix (2-36) string
	rampcardDeviceTableType - returns the table type for a rampcard device
	rampcardGetRootDevice - returns the root name corresponding to a
                               rampcard device
	random - returns pseudo random numbers from 0 to 2^31 - 1
	randomSeed - sets the seed value for the random function
	range - determines the range of an array of values
	range2 - determines the range of an array of values
	readAlarmBlock - reads a requested alarm block
	readLock - retrieves information about a lock
	readMjyDataFile - reads values from an MJY (scope) data file
	readProgramLocks - retrieves the locks held by a program
	reflectedEvent - retrieves the reflected TCLK event for a
                        beam sync event
	refreshAlarmNodeList - refresh the list of alarmer nodes
	regexpCompareString - compares a string to a pattern (case sensitive)
	regexpCompareStringNocase - compares a string to a pattern
	regexpFindString - returns the position of one string within another
			   using regular expressions for the search
	regexpGetValue - returns the next token specified by a regular
			 expression from a string and removes it
	regexpInsertString - inserts a substring before or after a substring
                            matching a regular expression
	regexpRemoveString - removes a substring matching a regular expression
                            from another string
	regexpReplaceString - replaces one string with another string in a
			      string using regular expressions for the search
	regexpSplit - splits up a string based upon finding a delimiter string
		      which is a regular expression
	removeString - removes a substring from another string
	repeatString - repeats a substring a number of times
	replaceBracketedString - replace a bracketed substring
	replaceChar - replaces any of a set of characers with another character
	replaceCharactersWithString - replaces any of a set of characters
                                     with a string
	replaceCharactersWithStrings - replaces any of a set of characters
                                      with a corresponding string
	replaceString - replaces one string with another string in a string
	resetRfWatchdog - reset an RF watchdog trip for the requested machine
	reverse - reverses a string
	rfWatchdogTripIsPresent - determines if there is an RF watchdog trip
                                 for the requested machine
	rightJustify - right justify a string
	rightShift - right shift a string
	rightTrim - removes trailing blanks from a string
	rms - calculates the RMS of an array of values
	rms2 - calculates the RMS of an array of values
	round - round (to a specified number of digits)
	rshft - circular right shift
	saveFileDeviceErrors - returns all of the device errors from a save file
	saveFileDeviceStatus - returns the save status for a requested device
                              in a save file
	saveFileInfo - returns information about a single save/restore file
	scondif - returns the second argument as a string if the first has
		  a value of true or the third argument as a string if
		  it has a value of false
	scriptExecutionTime - returns the script execution system time in
                             milliseconds
	sdaFileDate - returns the starting or ending date for an SDA file
	secant - secant
	secondsToTodString - converts seconds to a time of day string
	sendLlrfCommand - sends a LLRF command
	sendPidSignal - sends a signal to a process specified by its pid
	sendProcessSignal - sends a signal to a process specified by its name
	setBit - set a bit in a value
	setBitField - sets a bit field value
	setenv - sets an environment variable to a value
	setLogicalName - sets a logical name to a value
	settingsAreEnabled - determines if settings are enable
			     (supports optional device name argument)
	setUserAlarmListStatus - sets the status of a user alarm list
	sin - sine
	sind - sine (argument in degrees)
	sinh - hyperbolic sine
	sizeof - returns the number of elements in a device, device list,
		 input, or variable
	sizeofVariable - returns the number of elements in a variable
	snapManagerDataDirectory - returns snapshot manager data file
                                  information
	snapManagerFindDevice - returns snapshot manager plot setups for
                               a device
	snapManagerReinitPlot - reinitializes a snapshot manager plot
	snapManagerSystemFiles - returns snapshot manager data file information
                                for a system
	snapManagerSystemNames - returns snapshot manager system names
	snapManagerSystemPlotSetups - returns plot setups for a snapshot
                                     manager system
	snapshotDefaultFreq - returns the default snapshot plot frequency
                             for a device or plot class
	snapshotMaxFreq - returns the maximum snapshot plot frequency for
			  a device or plot class and optionally the number
			  of points as well
	split - splits up a string based upon finding a delimiter string
	splitByCharSet - splits up a string based upon finding any of a set
			 of delimiter characters
	sprintf - formats output strings like sprintf with the additional
		  functionality of toString
	sqlQueryDevices - returns devices from a SQL query
	sqrt - square root
	sscanf - functions like sscanf with the additional functionality
                of toNumeric
	ssdnToDeviceType - converts an SSDN/node/property combination
                          to its corresponding device type
	ssdnToString - converts an SSDN value to a standard string
	stateOccurrenceHistory - returns the occurrences of a state event in
                                a time period
	stateText - returns the text for a state of a state device
	stateTextAll - returns all of the state text for a state device
	stateTextToNumber - returns the state number corresponding to a
                           state text string
	statusAttrToBitInfo - returns bit information corresponding to a
                             device status attribute
	statusScalingInfo - returns status scaling info matching
                           a search criteria
	statusScalingInfoAll - returns all status scaling info for a device
	stddev - calculates the standard deviation of an array of values
	stddev2 - calculates the standard deviation of an array of values
	stepMotorIsMoving - determines whether or not a stepping motor
                           is currently moving
	stringCompare - compares one string to another (case sensitive)
	stringCompareNocase - compares one string to another (case insensitive)
	stringConcatenate - concatenate two strings
	stringCopy - copies one string to another
	stringEndsWith - determines if a string ends with a substring
	stringEndsWithCharType - determines if the last character of a
                                string has a given type
	stringExtractDeviceNames - extract valid ACNET device names from
                                  a string
	stringExtractLine - extract a line from a string
	stringGetChar - retrieve a substring from a string
			(similar to substring but with different defaults)
	stringGetValue - returns the next token of the specified type from
			 a string and removes it from the original string
	stringLength - returns the length of a string
	stringLineInfo - determines how many lines are in a string
	stringSetChar - overwrite a substring of one string with another
			(similar to stringCopy)
	stringStartsWith - determines if a string starts/ends with a substring
	stringStartsWithCharType - determines if the first character of a
                                  string has a given type
	stringToColor - converts a string to a color value
	stringToConsoleClassMask - converts a string to a console class mask value
	stringToConvertType - converts a string to a convert type value
	stringToDate - converts a string to a date value
	stringToDeviceName - finds device names matching a search string
	stringToDouble - converts a string to a double precision
                           floating point value
	stringToEmc - converts a string to an EMC value
	stringToInteger - converts a string to an integer
	stringToken - returns the next token from a string and removes it
		      from the original string
	stringToProperty - converts a string to a property value
	stringToRad50 - convert a string to a radix 50 value
	stringToSsdn - converts a string to an SSDN value
	stringType - returns a string describing the argument string's type
	stripBrackets - strips beginning and ending brackets from a string
	stripCharacters - strips a requested set of characters from a string
	stripEolCharacters - strips end of line characters from a string
	stripHtml - strips HTML tags from a string
	stripNonprintables - strips nonprintable characters from a string
	stripQuotes - strips beginning and ending quotes from a string
	stripSpaces - strips any whitespace from a string
	strncmp - compares the first n characters of two strings
	strShift - left or right shift a string
	strstr - searches for a substring
	substring - returns a substring of a string
	sum - sum of an array of values
	sum2 - sum of an array of values
	supercycleLength - returns the length of the current supercycle
	switchAttributeValue - returns network switch attribute values
	synopticDevices - returns devices in a Synoptic display
	systemRandomNumber - returns random numbers from 0 to 2^31 - 1
	systemTime - returns system time in milliseconds since ACL
		     was initialized
	systemUserIdToName - converts a user ID to a system user name
	systemUserNameToId - converts a user name to a system user ID
	tail - returns the end of a string
	tan - tangent
	tand - tangent (argument in degrees)
	tanh - hyperbolic tangent
	taskExists - determines if an ACNET task exists
	taskId - returns an ACNET task ID
	taskIdToName - converts an ACNET task ID to a name
	taskPid - returns an ACNET task process ID
	taskPidToName - converts an ACNET task process ID to name(s)
	tempFileName - returns a unique temporary file name
	terminalSize - returns the size of the output terminal
	text - returns a device descriptive text string
	thisSoftwareBeamSwitchIsOn - determines is the requested local
                                    software beam switch is on
	timeAgo - returns date which is some number of time units before a base time
	timeFromDate - returns date which is some number of time units after
                      a base time
	timeInSupercycle - returns the current time in the supercycle
	timeIntervalToString - converts a time interval into a string
	timer - returns the current value of a timer
	timerReadEvents - returns the reference events for a timer device
	timeSinceEvent - returns the elapsed time since an event has occurred
	timeSinceMidnight - returns the number of seconds since midnight
	todStringToSeconds - converts a time of day string to seconds
	toLower - converts a string to lower case
	toNumeric - converts a string to its numeric value
	toString - converts a value to its corresponding string
	totalNumberOfDevices - returns the total number of devices in the
                              control system
	toTrimmedString - converts a value to a string with no spaces
	toUpper - converts a string to upper case
	translateSymbolicLink - translates a symbolic link
	trim - removes leading and trailing blanks from a string
	trunc - truncate
	trunkNodeToNode - converts a trunk and node number into a node value
	unescapeString - replaces escape characters in a string with
			 their original characters
	units - returns a device units string
	unmaskAbortInput - unmasks an abort input
	unsetenv - deletes an environment variable
	userAlarmList - returns the state of a user alarm list
			(enabled, bypassed, or empty)
	userAlarmListDevices - returns the devices in a user alarm list
	userAlarmListLists - returns the user alarm lists referenced
                            by a user alarm list
	userAttributeValue - returns user attribute values
	userIsaPerson - determines if a user name represents an actual person
	userMonitorContacts - retrieves the monitor contacts registered
                             for a user
	userSaveListDevices - returns the devices in a user save list
	usersMonitoringAlarm - returns the user who are monitoring a
                              particular alarm
	utcSecondsToDate - converts a UTC time in seconds to a date value
	utilityGetDate : retrieves the current date and time from a
                        utility process
	utilityPing : pings a utility process
	validateDeviceName - checks to see if a string would be a
                            valid device name
	valueToLogicalArray - converts bit values into a logical array
	valueType - returns the type of a value as a string
	variableArrayDimensions - returns the array dimensions of a variable
	variableDimensionSize - returns the size of one dimension of a variable
	variableIsConstant - determines whether or not a variable
                            is a constant
	variableIsDynamic - determines whether or not a variable
                           is dynamically resizable
	variableIsInitialized - determines whether or not a variable has been
                               initialized
	variableNumReadings - returns the number of times a variable
                             has been read
	variableNumSettings - returns the number of times a variable
                             has been set
	variableType - returns the type of a variable as a string
	variance - calculates the variance of an array of values
	variance2 - calculates the variance of an array of values
	virtualMachineDevices - returns the devices belonging to a
                               virtual machine
	whereDeviceIsLogged - returns where a device is logged
	whereDeviceWasLogged - returns where a device was logged in the past
	wordCount - returns the number of words in a string
	xor - bitwise exclusive or

-------------------------------------------------------------------------------

	15hzCount : returns 15Hz count since the calling process started

	count = 15hzCount([timeReference])

	Arguments:

	[timeReference]	time reference
			(delta -> return delta time since previous call,
			 scriptStart -> return delta time since start
					of script)
			(default is count since application started)

	This function returns values as follows:

	15 Hz count since the calling application started

	Related functions:

	millisecondsNow, currentTime, currentDate, currentTimeInClinks,
	systemTime, cpuTime, timer, timeSinceEvent, timeAgo, timeFromDate,
	stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, millisecondsToDate, dateToMilliseconds

-------------------------------------------------------------------------------

	abortLoopIsUp : determines if an abort/permit loop is up

	boolean = abortLoopIsUp(system [,dataEvent])

	Arguments:

	system		abort system of interest
			(Booster,
			 Recycler,
			 MainInjector,
			 Switchyard,
			 p1Line,
			 p2Line,
			 BooNE,
			 NuMI,
			 Muon,
			 Test)
	[dataEvent]	data event to uses when reading the loop status
			(default is one shot reading)

	This function returns values as follows:

	TRUE			abort/permit loop is up
	FALSE			abort/permit loop is down

	Related functions:

	abortSystemReset, maskAbortInput, unmaskAbortInput, beamPermitIsUp,
	beamSwitchIsOn, thisSoftwareBeamSwitchIsOn

-------------------------------------------------------------------------------

	abortOperatorSave : aborts the current operator save/restore save

	inProgress = abortOperatorSave()

	Arguments:

	<none>

	This function returns values as follows:

	TRUE			operator save was in progress
	FALSE			operator save was not in progress

	Related functions:

	checkOperatorSaveStatus, saveFileDeviceStatus, saveFileDeviceErrors,
	saveFileInfo, oldestSrFile, newestSrFile

-------------------------------------------------------------------------------

	abortSystemReset : resets an abort/permit loop

	boolean = abortSystemReset(system)

	Arguments:

	system		abort system of interest
			(Booster,
			 Recycler,
			 MainInjector,
			 Switchyard,
			 p1Line,
			 p2Line,
			 BooNE,
			 NuMI,
			 Muon,
			 Test)

	This function returns values as follows:

	<none>

	Related functions:

	abortLoopIsUp, maskAbortInput, unmaskAbortInput, beamPermitIsUp,
	beamSwitchIsOn, thisSoftwareBeamSwitchIsOn

-------------------------------------------------------------------------------

	abs : absolute value

	resultValue = abs(value)

	Arguments:

	value		value to take the absolute value of

	This function returns values as follows:

	absolute value of the argument

	Related functions:

	round, prec, trunc

-------------------------------------------------------------------------------

	acnetPing : performs an ACNET ping on a node

	responded = acnetPing(node [,responseTime])

	Arguments:

	node		node to check
	[responseTime]	response time in microseconds

	This function returns values as follows:

	TRUE			node responded to ping
	FALSE			node did not respond to ping

	Related functions:

	ping, nodeIsUp, nodeIs

-------------------------------------------------------------------------------

	acos : arc cosine

	resultValue = acos(value)

	Arguments:

	value		value to take the arc cosine of

	This function returns values as follows:

	arc cosine value of the argument (in radians)

	Related functions:

	acosd, acosh, cos, cosd, cosh, sin, sind, asin, sinh

-------------------------------------------------------------------------------

	acosd : arc cosine (result in degrees)

	resultValue = acosd(value)

	Arguments:

	value		value to take the arc cosine of

	This function returns values as follows:

	arc cosine value of the argument (in degrees)

	Related functions:

	acos, cosd, cosh, sin, sind, asin, sinh

-------------------------------------------------------------------------------

	acosh : arc hyperbolic cosine

	resultValue = acosh(value)

	Arguments:

	value		value to take the arc hyperbolic cosine of

	This function returns values as follows:

	arc hyperbolic cosine value of the argument

	Related functions:

	acos, acosd, cos, cosd, cosh, sin, sind, asin, sinh

-------------------------------------------------------------------------------

	acsysSoftwareVersion : returns the software version for an
                              ACSys/FEF frontend

	version = acsysSoftwareVersion(node [,valueType])

	Arguments:

	node		node to retrieve software version for
	[valueType]	desired form of the version value
			(string (default)
			 double
			 integer)

	This function returns values as follows:

	ACSys/FEF software version

	Related functions:

	frontendSoftwareVersion, moocSoftwareVersion, irmSoftwareVersion,
	nodeType, isFrontendNode, isCentralNode, isConsoleNode, isMoocNode,
	isMoocDevice, isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice,
	isOacNode, isOacDevice, isLabviewNode, isLabviewDevice

-------------------------------------------------------------------------------

	alarmAcknowledgeMask : returns a device's alarm acknowledge mask

	protectionMask = alarmAcknowledgeMask(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	alarm acknowledge mask

	Related functions:

	name, fullName, deviceProtectionMask, alarmBlockFieldValue,
	extractAlarmBlockFieldValue, extractAlarmHeaderParam,
	analogAlarmLimits, digitalAlarmNominalMask, readAlarmBlock

-------------------------------------------------------------------------------

	alarmBlockFieldValue : returns individual alarm block field values

	value = alarmBlockFieldValue(device, fieldType [,property]
				     [,dataSource] [,arrayIndex]
				     [,wantNumeric])

	Arguments:

	device		device of interest
	fieldType	field to return
			(state -> alarm state (bypassed, good, or bad),
			 enable -> alarm enable status (enabled or bypassed),
			 postMethod -> alarm post method (exception or event),
			 triesNeeded -> number of readings before changing
					alarm state,
			 triesNow -> current number of readings in alarm state,
			 ftd -> alarm reading sample FTD,
			 isAbort -> flag indicating if alarm can generate
				    an abort,
			 abortEnable -> flag indicating if aborts are enabled,
			 limitLength -> alarm limit length
			 limitType -> analog alarm limit type
			 limitDataType -> analog alarm limit data type
			 minimum -> analog alarm minimum value,
			 maximum -> analog alarm maximum value,
			 highLow -> analog alarm high/low status,
			 primaryMinimum -> analog alarm minimum value
					   (primary units),
			 primaryMaximum -> analog alarm maximum value
					   (primary units),
			 rawMinimum -> analog alarm minimum value (raw units),
			 rawMaximum -> analog alarm maximum value (raw units),
			 nominal -> analog alarm nominal value,
			 tolerance -> analog alarm tolerance value,
			 digitalNominal -> digital alarm nominal value,
			 mask -> digital alarm mask value,
			 displayEnable -> whether or not alarm display
					  is enabled)
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[dataSource]	data source
			(default is live reading)
	[arrayIndex]	array index
			(default is 0)
	[wantNumeric]	flag indicating whether or not to force the return
			type to be numeric
			(defaultFormat -> return default format (default),
			 wantNumeric -> return as a numeric value)

	This function returns values as follows:

	alarm block field value

	Related functions:

	extractAlarmBlockFieldValue, extractAlarmHeaderParam,
	alarmStatus, alarmIsBypassed, alarmIsBypassedDb, alarmIsSnoozed,
	alarmRemainingSnoozeTime, analogAlarmLimits, digitalAlarmNominalMask,
	readAlarmBlock, deviceValue, deviceValueText, deviceCalculatedValue,
	deviceDigitalStatus

-------------------------------------------------------------------------------

	alarmIsBypassed : determines if an alarm is bypassed

	isBypassed = alarmIsBypassed(device [,property] [,blockNumber])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[blockNumber]	block number to access
			(default is 0)

	This function returns values as follows:

	TRUE			alarm is bypassed
	FALSE			alarm is enabled

	Related functions:

	alarmIsBypassedDb, alarmStatus, alarmIsSnoozed,
	alarmRemainingSnoozeTime, alarmBlockFieldValue,
	extractAlarmBlockFieldValue, extractAlarmHeaderParam,
	analogAlarmLimits, digitalAlarmNominalMask, readAlarmBlock

-------------------------------------------------------------------------------

	alarmIsBypassedDb : determines if the database copy of an alarm
                           is bypassed

	isBypassed = alarmIsBypassedDb(device [,property] [,blockNumber])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[blockNumber]	block number to access
			(default is 0)

	This function returns values as follows:

	TRUE			alarm is bypassed
	FALSE			alarm is enabled

	Related functions:

	alarmIsBypassed, alarmStatus, alarmIsSnoozed,
	alarmRemainingSnoozeTime, alarmBlockFieldValue,
	extractAlarmBlockFieldValue, extractAlarmHeaderParam,
	analogAlarmLimits, digitalAlarmNominalMask, readAlarmBlock

-------------------------------------------------------------------------------

	alarmIsSnoozed : determines if an alarm is in snooze mode

	isSnoozed = alarmIsSnoozed(device [,property] [,endSnoozeTime]
				   [,snoozedTime])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[endSnoozeTime]	returned end of snooze time
	[snoozedTime]	returned time alarm was put in snooze mode

	This function returns values as follows:

	TRUE			alarm is snoozed
	FALSE			alarm is not snoozed

	Related functions:

	alarmRemainingSnoozeTime, alarmStatus, alarmIsBypassed,
	alarmIsBypassedDb, alarmBlockFieldValue, extractAlarmBlockFieldValue,
	extractAlarmHeaderParam, analogAlarmLimits, digitalAlarmNominalMask,
	readAlarmBlock

-------------------------------------------------------------------------------

	alarmRemainingSnoozeTime : returns the time remaining for a
                                  snoozed alarm

	isSnoozed = alarmRemainingSnoozeTime(device [,property]
					     [,remainingTime])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[remainingTime]	returned remaining snooze time in seconds

	This function returns values as follows:

	TRUE			alarm is snoozed
	FALSE			alarm is not snoozed

	Related functions:

	alarmIsSnoozed, alarmStatus, alarmIsBypassed, alarmIsBypassedDb,
	alarmBlockFieldValue, extractAlarmBlockFieldValue, readAlarmBlock,
	extractAlarmHeaderParam, analogAlarmLimits, digitalAlarmNominalMask

-------------------------------------------------------------------------------

	alarmStatus : returns a current alarm status

	statusString = alarmStatus(device [,property] [,blockNumber]
				   [,highLowStatus])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[blockNumber]	block number to access
			(default is 0)
	[highLowStatus]	returned high/low status string
			(high -> current value is above alarm maximum,
			 low -> current value is below alarm minimum)
			(analog alarms only)

	This function returns values as follows:

	none			alarm property does not exist
	good			alarm is good and enabled
	alarming		alarm is enabled and alarming
	bypassed		alarm is bypassed
	snoozed			alarm is snoozed

	Related functions:

	alarmIsBypassed, alarmIsBypassedDb, alarmIsSnoozed,
	alarmRemainingSnoozeTime, alarmBlockFieldValue,
	extractAlarmBlockFieldValue, extractAlarmHeaderParam,
	analogAlarmLimits, digitalAlarmNominalMask, readAlarmBlock

-------------------------------------------------------------------------------

	allLoggerNodes : returns the names of all data loggers

	numLoggers = allLoggerNodes([loggerNames] [,nameType] [,loggerNodes])

	Arguments:

	[loggerNames]	returned data logger names
	[nameType]	type of names to return
			(simpleNames -> return simple logger names,
			 fullNames -> return names with node names (default))
	[loggerNodes]	returned ACNET node values	

	This function returns values as follows:

	number of data loggers

	Related functions:

	loggerIsUp, loggerIsEnabled, loggerListDevices, loggerListDeviceStats,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	oldestLoggerTime, loggerNameToNode, nodeToLoggerName,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	analogAlarmHandlerInfo : returns analog alarm handler info for a device

	handlerCode = analogAlarmHandlerInfo(device [,soundId] [,speechId])

	Arguments:

	device		device of interest
	[soundId]	returned alarm sound ID
	[speechId]	returned alarm speech ID

	This function returns values as follows:

	analog alarm handler code

	Related functions:

	analogAlarmText, analogAlarmPriority, analogAlarmUrl,
	digitalAlarmHandlerInfo, digitalAlarmText, digitalAlarmTextAll

-------------------------------------------------------------------------------

	analogAlarmLimits : returns analog alarm limits for a device

	typeString = analogAlarmLimits(device [,limit1] [,limit2]
				       [,limitType])

	Arguments:

	device		device of interest
	[limit1]	returned first limit (minimum or nominal)
	[limit2]	returned second limit (maximum or tolerance)
	[limitType]	desired limit type
			(minimum/maximum
			 nominal/tolerance)
			(default is the front end's default format)

	This function returns values as follows:

	none			no analog alarm block exists
	minimum/maximum		returned limit type is minimum/maximum
	nominal/tolerance	returned limit type is nominal/tolerance

	Related functions:

	alarmBlockFieldValue, extractAlarmBlockFieldValue,
	digitalAlarmNominalMask, analogAlarmHandlerInfo,
	extractAlarmHeaderParam, readAlarmBlock, analogAlarmText,
	analogAlarmPriority, digitalAlarmHandlerInfo, digitalAlarmText,
	digitalAlarmTextAll

-------------------------------------------------------------------------------

	analogAlarmPriority : returns the analog alarm priority for a device

	priority = analogAlarmPriority(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	analog alarm priority value

	Related functions:

	analogAlarmText, analogAlarmHandlerInfo, analogAlarmUrl,
	digitalAlarmText, digitalAlarmTextAll, digitalAlarmHandlerInfo,
	currentAnalogAlarmText, deviceCurrentAlarmText,
	alarmBlockFieldValue, extractAlarmBlockFieldValue,
	readAlarmBlock, extractAlarmHeaderParam

-------------------------------------------------------------------------------

	analogAlarmText : returns the analog alarm text for a device

	alarmText = analogAlarmText(device [,priority])

	Arguments:

	device		device of interest
	[priority]	returned analog alarm priority

	This function returns values as follows:

	analog alarm text

	Related functions:

	analogAlarmPriority, analogAlarmHandlerInfo, analogAlarmUrl,
	digitalAlarmText, digitalAlarmTextAll, digitalAlarmHandlerInfo,
	currentAnalogAlarmText, deviceCurrentAlarmText,
	alarmBlockFieldValue, extractAlarmBlockFieldValue,
	readAlarmBlock, extractAlarmHeaderParam

-------------------------------------------------------------------------------

	analogAlarmUrl : returns the analog alarm URL for a device

	alarmUrl = analogAlarmUrl(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	analog alarm URL

	Related functions:

	analogAlarmPriority, analogAlarmHandlerInfo, analogAlarmText,
	digitalAlarmText, digitalAlarmTextAll, digitalAlarmHandlerInfo,
	currentAnalogAlarmText, deviceCurrentAlarmText,
	alarmBlockFieldValue, extractAlarmBlockFieldValue,
	readAlarmBlock, extractAlarmHeaderParam

-------------------------------------------------------------------------------

	and : bitwise and

	resultValue = and(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	bitwise and of the two arguments

	Related functions:

	or, xor

-------------------------------------------------------------------------------

	appdsTableInfo : returns information about an APPDS table

	recordSize = appdsTableInfo(tableName [,maxRecords] [,numFields]
				    [,dataTypes] [,dataLengths] [,numElements])

	Arguments:

	tableName	APPDS table to check
	[maxRecords]	returned maximum number of records in the table
	[numFields]	returned number of fields
	[dataTypes]	returned array of field data types
			(CNV_BYTE,
			 CNV_SHORT,
			 CNV_LONG,
			 CNV_FLOAT,
			 CNV_DOUBLE,
			 CNV_CHAR,
			 CNV_HEX_STRING)
	[dataLengths]	returned array of field data lengths in bytes
	[numElements]	returned array of field numbers of elements

	This function returns values as follows:

	size of each record in bytes

	Related functions:

	fshareFileInfo

-------------------------------------------------------------------------------

	arrayAppend : append a new entry at the end of an array

	status = arrayAppend(variable, value [,numElements])

	Arguments:

	variable	array variable to append to
	value		value(s) to append
	[numElements]	number of elements to append
			(default is 1)

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayPrepend, arrayInsert, arrayDelete, arrayDeleteDuplicates,
	arrayDeleteValue, arrayFill, arrayInvert, arrayValueExists,
	arraySort

-------------------------------------------------------------------------------

	arrayDelete : deletes an existing entry from an array

	status = arrayDelete(variable, element [,numElements])

	Arguments:

	variable	array variable to delete from
	element		deletion element position (starts at 1)
			(A string having a value of "last" can
			 be used to indicate the last element(s).)
	[numElements]	number of elements to delete
			(Note: You cannot delete all elements in
			 an array.  You must leave at least one
			 element.)
			(default is 1)

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayDeleteDuplicates, arrayDeleteValue, arrayInsert, arrayAppend,
	arrayPrepend, arrayFill, arrayInvert, arrayValueExists, arraySort

-------------------------------------------------------------------------------

	arrayDeleteDuplicates : deletes duplicate entries from an array

	status = arrayDeleteDuplicates(variable)

	Arguments:

	variable	array variable to delete duplicates from

	This function returns status values as follows:

	FALSE			array not modified
	otherwise		number of elements deleted

	Related functions:

	arrayDelete, arrayDeleteValue, arrayInsert, arrayAppend, arrayPrepend,
	arrayFill, arrayInvert, arrayValueExists, arraySort

-------------------------------------------------------------------------------

	arrayDeleteValue : deletes entries from an array matching a
			   particular value

	numDeleted = arrayDeleteValue(variable, value [,fillValue])

	Arguments:

	variable	array variable to delete from
	value		matching value to delete
	[fillValue]	value to fill the end of the array with
			(default is 0)

	This function returns status values as follows:

	number of entries deleted

	Related functions:

	arrayDelete, arrayDeleteDuplicates, arrayInsert, arrayAppend,
	arrayPrepend, arrayFill, arrayInvert, arrayValueExists,
	arraySort

-------------------------------------------------------------------------------

	arrayFill : fill an array with a value

	status = arrayFill(variable, value [,startElement] [,endElement])

	Arguments:

	variable	array variable to fill
	value		value to fill with
	startElement	start element position (starts at 1)
			(default is 1)
	endElement	end element position (starts at 1)
			(default is last element)

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayInsert, arrayAppend, arrayPrepend, arrayDelete,
	arrayDeleteDuplicates, arrayDeleteValue, arrayInvert,
	arrayValueExists, arraySort

-------------------------------------------------------------------------------

	arrayInsert : inserts a new element in an array

	status = arrayInsert(variable, value, element [,numElements])

	Arguments:

	variable	array variable to insert into
	value		value(s) to insert
	element		insertion element position (starts at 1)
			(A string having a value of "last" can
			 be used to indicate the last element.)
	[numElements]	number of elements to insert
			(default is 1)

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayAppend, arrayPrepend, arrayDelete, arrayDeleteDuplicates,
	arrayDeleteValue, arrayFill, arrayInvert, arrayValueExists,
	arraySort

-------------------------------------------------------------------------------

	arrayInvert : inverts the order of an array

	status = arrayInvert(variable)

	Arguments:

	variable	array variable to invert

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayInsert, arrayAppend, arrayPrepend, arrayDelete,
	arrayDeleteDuplicates, arrayDeleteValue, arrayFill,
	arrayValueExists, arraySort

-------------------------------------------------------------------------------

	arrayPrepend : insert a new entry at the beginning of an array

	status = arrayPrepend(variable, value [,numElements])

	Arguments:

	variable	array variable to prepend to
	value		value(s) to prepend
	[numElements]	number of elements to prepend
			(default is 1)

	This function returns status values as follows:

	TRUE			array modified
	FALSE			array not modified

	Related functions:

	arrayAppend, arrayInsert, arrayDelete, arrayDeleteDuplicates,
	arrayDeleteValue, arrayFill, arrayInvert, arrayValueExists,
	arraySort

-------------------------------------------------------------------------------

	arraySort : sorts an array of values

	arraySort(variable, [,sortType])

	Arguments:

	variable	array variable to sort
	[sortType]	sort type
			(asc[ending] -> sort ascending (default),
			 desc[ending] -> sort descending,
			 asciiAsc[ending] -> sort by ASCII value (ascending),
			 asciiDesc[ending] -> sort by ASCII value (descending))

	This function returns status values as follows:

	<none>

	Related functions:

	arrayDelete, arrayDeleteDuplicates, arrayDeleteValue, arrayInsert,
	arrayAppend, arrayPrepend, arrayFill, arrayInvert, arrayValueExists

-------------------------------------------------------------------------------

	arrayValueExists : determines if a value exists in an array

	numMatches = arrayValueExists(variable, matchValue [,matchIndex]
				      [,numElements])

	Arguments:

	variable	array variable to search
	matchValue	value to match
	[matchIndex]	returned match index of first match
			(A value of -1 is returned if there is no match.)
	[numElements]	number of elements to search
			(default is the whole array)

	This function returns status values as follows:

	number of matches found

	Related functions:

	arrayInsert, arrayAppend, arrayPrepend, arrayDelete,
	arrayDeleteDuplicates, arrayDeleteValue, arrayFill, arrayInvert,
	arraySort

-------------------------------------------------------------------------------

	ascii : convert a character value to its corresponding ASCII code(s)

	asciiCode = ascii(characterValue)

	Arguments:

	characterValue	character value to convert (up to 4 characters)

	This function returns values as follows:

	corresponding ASCII code(s)

	Related functions:

	char

-------------------------------------------------------------------------------

	asin : arc sine

	resultValue = asin(value)

	Arguments:

	value		value to take the arc sine of

	This function returns values as follows:

	arc sine value of the argument (in radians)

	Related functions:

	asind, asinh, sin, sind, sinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	asind : arc sine (result in degrees)

	resultValue = asind(value)

	Arguments:

	value		value to take the arc sine of

	This function returns values as follows:

	arc sine value of the argument (in degrees)

	Related functions:

	asin, asinh, sin, sind, sinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	asinh : arc hyperbolic sine

	resultValue = asinh(value)

	Arguments:

	value		value to take the arc hyperbolic sine of

	This function returns values as follows:

	arc hyperbolic sine value of the argument

	Related functions:

	asin, asind, sin, sind, sinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	atan : arc tangent

	resultValue = atan(value)

	Arguments:

	value		value to take the arc tangent of in radians

	This function returns values as follows:

	arc tangent value of the argument

	Related functions:

	tan, tand, tanh, atand, atan2, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	atan2 : arc tangent of the quotient of the arguments

	resultValue = atan2(y, x)

	Arguments:

	y		y value
	x		x value

	This function returns values as follows:

	arc tangent value of the argument (-pi to pi)

	Related functions:

	tan, tand, tanh, atan, atand, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	atan2d : arc tangent of the quotient of the arguments
		 (result in degrees)

	resultValue = atan2d(y, x)

	Arguments:

	y		y value
	x		x value

	This function returns values as follows:

	arc tangent value of the argument

	Related functions:

	tan, tand, tanh, atan, atand, atan2, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	atand : arc tangent (result in degrees)

	resultValue = atand(value)

	Arguments:

	value		value to take the arc tangent of in degrees

	This function returns values as follows:

	arc tangent value of the argument

	Related functions:

	tan, tand, tanh, atan, atan2, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	atanh : arc hyperbolic tangent

	resultValue = atanh(value)

	Arguments:

	value		value to take the arc hyperbolic tangent of

	This function returns values as follows:

	arc hyperbolic tangent value of the argument

	Related functions:

	tan, tand, tanh, atan, atand, atan2, atan2d, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	availableConsolePaSlots : determines the available PA slots on a console

	numAvailableSlots = availableConsolePaSlots([availableSlots] [,console])

	Arguments:

	[availableSlots] returned available PA slots
	[console]	 console number to check
			 (default is the current console)

	This function returns values as follows:

	number of available console PA slots

	Synonyms: availablePaSlots

	Related functions:

	availableConsoleSaSlots, consoleSlotExists, consoleExists, consoleIsUp,
	consoleToNode, consoleProcessName, consoleTaskName, consoleSlotToWindow,
	consoleWindowToSlot

-------------------------------------------------------------------------------

	availableConsoleSaSlots : determines the available SA slots on a console

	numAvailableSlots = availableConsoleSaSlots([availableSlots] [,console])

	Arguments:

	[availableSlots] returned available SA slots
	[console]	 console number to check
			 (default is the current console)

	This function returns values as follows:

	number of available console SA slots

	Synonyms: availableSaSlots

	Related functions:

	availableConsolePaSlots, consoleSlotExists, consoleExists, consoleIsUp,
	consoleToNode, consoleProcessName, consoleTaskName, consoleSlotToWindow,
	consoleWindowToSlot

-------------------------------------------------------------------------------

	bcdToDecimal : convert a BCD-encoded value into decimal integer

	value = bcdToDecimal(value [,numCharacters])

	Arguments:

	value		BCD encoded value to convert
	[numCharacters]	number of characters to convert
			(default is twice the data length of the value in bytes)

	This function returns values as follows:

	corresponding integer value

	Related functions:

	bcdToString

-------------------------------------------------------------------------------

	bcdToString : convert a BCD-encoded value into decimal string

	string = bcdToString(value [,numCharacters])

	Arguments:

	value		BCD encoded value to convert
	[numCharacters]	number of characters to convert
			(default is twice the data length of the value in bytes)

	This function returns values as follows:

	corresponding string

	Related functions:

	bcdToDecimal

-------------------------------------------------------------------------------

	beamPermitIsUp : determines if the requested beam permit is up

	boolean = beamPermitIsUp(permitType)

	Arguments:

	permitType	permit type to check
			(linac,
			 booster,
			 recycler,
			 mainInjector,
			 switchyard,
			 p1Line,
			 p2Line,
			 BooNE,
			 NuMI,
			 Muon,
			 MTA,
			 LBNF)

	This function returns values as follows:

	TRUE			beam permit is up
	FALSE			beam permit is down

	Related functions:

	beamSwitchIsOn, thisSoftwareBeamSwitchIsOn

-------------------------------------------------------------------------------

	beamSwitchIsOn : determines if the requested beam switch is on

	boolean = beamSwitchIsOn(switchName [,switchType] [,numSoftware]
				 [,softSwitches] [,numHardware]
				 [,hardSwitches])

	Arguments:

	switchName	beam switch name
			(master,
			 booster,
			 muon,
			 mainInjector,
			 mta,
			 switchyard,
			 recycler,
			 numi,
			 boone)
	[switchType]	switch types to check
			(all -> all switch types (default),
			 software -> software switches only,
			 hardware -> hardware switches only)
	[numSoftware]	returned number of software beam switches which are off
	[softSwitches]	returned consoles whose software switches are off
	[numHardware]	returned number of hardware beam switches which are off
	[hardSwitches]	returned consoles whose hardware switches are off

	This function returns values as follows:

	TRUE			beam switch is on
	FALSE			beam switch is off

	Related functions:

	thisSoftwareBeamSwitchIsOn, beamPermitIsUp

-------------------------------------------------------------------------------

	binary : returns a value as a binary string

	string = binary(value [,convertLength] [,fillChar] [,dataType])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[fillChar]	fill character
	[dataType]	data type
			(integer,
			 float,
			 double)
			(default is to use the native type of the value)

	This function returns values as follows:

	converted string value

	Synonyms: toBinary

	Related functions:

	hex, octal, decimal, radix, toString, toTrimmedString, rad50ToString

-------------------------------------------------------------------------------

	binaryToFloat : converts a binary value to its equivalent
			single precision floating point value

	floatValue = binaryToFloat(binaryValue)

	Arguments:

	binaryValue		binary (integer) value to convert to a float

	This function returns values as follows:

	corresponding float value

	Related functions:

	floatToBinary

-------------------------------------------------------------------------------

	bit : bit test

	boolean = bit(value, bitNumber)

	Arguments:

	value		value to test
	bitNumber	bit number (starts at 1)

	This function returns values as follows:

	TRUE			bit is set
	FALSE			bit is clear

	Synonyms: tstbit, testBit, isBitSet

	Related functions:

	bitCount, lowestBit, highestBit, bitField, deviceBitField, bitText,
	bitDataText, valueToLogicalArray

-------------------------------------------------------------------------------

	bitComplement : complement (invert) bits in a value

	value = bitComplement(sourceValue [,numBits] [,startBit])

	Arguments:

	sourceValue	value to modify
	[numBits]	number of bits to complement
			(default is all)
	[startBit]	starting bit number (starts at 1)
			(default is 1)

	This function returns values as follows:

	modified value with the requested bits complemented

	Synonyms: bitNot

	Related functions:

	clearBit, setBit, bit, bitCount, bitField, circularShift

-------------------------------------------------------------------------------

	bitCount : returns the number of bits set in a value

	numSet = bitCount(value, startBit [,numBits])

	Arguments:

	value		value to test
	startBit	starting bit number (starts at 1)
	[numBits]	number of bits (default is 1)

	This function returns values as follows:

	number of bits set

	Related functions:

	bit, bitField, deviceBitField, bitText, bitDataText

-------------------------------------------------------------------------------

	bitDataText : returns the data text for a specified bit

	string = bitDataText(device, bit [,bitValue])

	Arguments:

	device		device/property of interest
	bit		bit number (starts at 1)
	[bitValue]	bit value to return text for
			(0, 1, or 'default' (current bit reading))
			(default is current bit reading)

	This function returns values as follows:

	bit data descriptive text string

	Related functions:

	bitText, deviceBitField, bitField, statusAttrToBitInfo

-------------------------------------------------------------------------------

	bitField : extracts a bit field value

	fieldValue = bitField(value, startBit [,numBits])

	Arguments:

	value		value to extract bit field from
	startBit	starting bit number (starts at 1)
	[numBits]	number of bits (default is 1)

	This function returns values as follows:

	extracted bit field value

	Related functions:

	bit, bitCount, deviceBitField, bitText, bitDataText, statusAttrToBitInfo

-------------------------------------------------------------------------------

	bitFieldCircularShift : circularly shifts a bit field

	value = bitFieldCircularShift(sourceValue, startBit [,numBits]
				      [,numShift])

	Arguments:

	sourceValue	value to modify
	startBit	starting bit number (starts at 1)
	[numBits]	number of bits to shift
			(default is 32)
	[numShift]	number of bits to shift by
			(A positive number produces a left shift while a
			 negative number will produce a right shift.)
			(default is 1)

	This function returns values as follows:

	modified value with the requested bits circularly shifted

	Synonyms: circularShift

	Related functions:

	lshft, rshft, clearBit, setBit, bit, bitCount, bitField, bitComplement

-------------------------------------------------------------------------------

	bitText : returns the descriptive text for a specified status bit

	string = bitText(device, bit)

	Arguments:

	device		device/property of interest
	bit		bit number (starts at 1)

	This function returns values as follows:

	bit descriptive text string

	Related functions:

	bitDataText, deviceBitField, bitField, bitTextAll, statusAttrToBitInfo

-------------------------------------------------------------------------------

	bitTextAll : returns the bit information for a device

	numBits = bitTextAll(device [,numbers] [,text] [,text_if_0] [,text_if_1]
			     [,color_if_0] [,color_if_1])

	Arguments:

	device		device of interest
	[numbers]	returned bit numbers
	[text]		returned bit descriptive text
	[text_if_0]	returned data text if the bit value is 0
	[text_if_1]	returned data text if the bit value is 1
	[color_if_0]	returned text color if the bit value is 0
	[color_if_1]	returned text color if the bit value is 1

	This function returns values as follows:

	number of bit descriptions

	Related functions:

	bitText, bitDataText, deviceBitField, bitField, statusAttrToBitInfo

-------------------------------------------------------------------------------

	blmNameToIndex : converts a BLM name to its corresponding
                        data array index

	dataIndex = blmNameToIndex(machine, blmName [,dataView])

	Arguments:

	machine		BPM machine
			(400Mev,
			 booster,
			 mi8Line,
			 mainInjector,
			 mainInjectorDevelopment,
			 miAbort,
			 recycler,
			 recyclerDevelopment,
			 recyclerAbort,
			 rrToMiLine,
			 p1Line,
			 p2Line,
			 p3Line,
			 m1Line,
			 m3Line,
			 m5Line,
			 deliveryRing,
			 miniboone,
			 MTA)
	blmName		BLM name to convert
	[dataView]	desired data view
			(default is default)

	This function returns values as follows:

	success			corresponding BLM data index
	otherwise		-1

	Related functions:

	bpmNameToIndex, bpmCrateChannelToName, bpmStatusToString

-------------------------------------------------------------------------------

	bpmCrateChannelToName : converts a BPM crate and channel to their
                               corresponding BPM name

	bpmName = bpmCrateChannelToName(machine, crate, channel)

	Arguments:

	machine		BPM machine
			(400Mev,
			 booster,
			 mi8Line,
			 mainInjector,
			 mainInjectorDevelopment,
			 miAbort,
			 recycler,
			 recyclerDevelopment,
			 recyclerAbort,
			 rrToMiLine,
			 p1Line,
			 p2Line,
			 p3Line,
			 m1Line,
			 m3Line,
			 m5Line,
			 deliveryRing,
			 miniboone,
			 MTA)
	crate		BPM crate (name or index)
	channel		BPM channel

	This function returns values as follows:

	success			corresponding BPM name
	otherwise		null string

	Related functions:

	bpmNameToIndex, bpmStatusToString, blmNameToIndex

-------------------------------------------------------------------------------

	bpmNameToIndex : converts a BPM name to its corresponding
                        data array index

	dataIndex = bpmNameToIndex(machine, bpmName [,plane] [,dataView])

	Arguments:

	machine		BPM machine
			(400Mev,
			 booster,
			 mi8Line,
			 mainInjector,
			 mainInjectorDevelopment,
			 miAbort,
			 recycler,
			 recyclerDevelopment,
			 recyclerAbort,
			 rrToMiLine,
			 p1Line,
			 p2Line,
			 p3Line,
			 m1Line,
			 m3Line,
			 m5Line,
			 deliveryRing,
			 miniboone,
			 MTA)
	bpmName		BPM name to convert
	[plane]		plane
			(horz,
			 vert)
			(default is to determine the plane from the BPM name)
	[dataView]	desired data view
			(default is default)

	This function returns values as follows:

	success			corresponding BPM data index
	otherwise		-1

	Related functions:

	bpmCrateChannelToName, bpmStatusToString, blmNameToIndex

-------------------------------------------------------------------------------

	bpmStatusToString : converts a BPM or BLM status value to a string

	statusString = bpmStatusToString(bpmStatus [,wantSymbolic])

	Arguments:

	bpmStatus	BPM or BLM status value to convert
	[wantSymbolic]	flag indicating whether or not to return the
			symbolic form of the status string
			(default is FALSE -> return normal strings)

	This function returns values as follows:

	corresponding status string

	Related functions:

	bpmNameToIndex, bpmCrateChannelToName, blmNameToIndex

-------------------------------------------------------------------------------

	byteCompare : performs a byte comparison of two values

	value = byteCompare(firstValue, secondValue [,compareLength]
			    [,firstIndex] [,secondIndex])

	Arguments:

	firstValue	first value to compare
	secondValue	second value to compare
	[compareLength]	number of bytes to compare
			(default is to compare the entire values)
	[firstIndex]	byte index in the first value to start comparing
			(starts at 1)
			(default is 1)
	[secondIndex]	byte index in the second value to start comparing
			(starts at 1)
			(default is 1)

	This function returns values as follows:

	0			values match
	otherwise		values don't match

	Related functions:

	byteCopy, stringCompare, stringCopy

-------------------------------------------------------------------------------

	byteCopy : performs a byte copy of one value to another

	numBytes = byteCopy(destValue, copyValue [,copyLength]
			    [,destIndex] [,copyIndex])

	Arguments:

	destValue	value to be copied to
	copyValue	value to copy
	[copyLength]	number of bytes to copy
			(default is the length of the copy value)
	[destIndex]	index to start copying to (starts at 1)
			(default is 1)
	[copyIndex]	index to start copying (starts at 1)
			(default is 1)

	This function returns values as follows:

	number of bytes actually copied

	Related functions:

	stringCopy, byteCompare

-------------------------------------------------------------------------------

	byteSizeof : returns the size of a device or variable in bytes (static)

	byteSize = byteSizeof(value)

	Arguments:

	value		value to determine the size in bytes of
			(device property or variable)

	This function returns values as follows:

	size in bytes

	Related functions:

	byteSizeofVariable, sizeof, sizeofVariable

-------------------------------------------------------------------------------

	byteSizeofVariable : returns the size of a variable in bytes (dynamic)

	byteSize = byteSizeofVariable(variable)

	Arguments:

	variable	variable to determine the size in bytes of

	This function returns values as follows:

	size in bytes

	Related functions:

	byteSizeof, sizeof, sizeofVariable, numElements, variableType,
	variableArrayDimensions, variableDimensionSize, variableNumReadings,
	variableNumSettings

-------------------------------------------------------------------------------

	cacheDeviceInfo : cache device database information for later retrieval

	numCached = cacheDeviceInfo(devices [,numDevices] [,attribute1] ...)

	Arguments:

	devices		devices to cache database information for
			(either an array of device names or a
			 device list specifier (deviceList={list}))
	[numDevices]	number of devices (default is all devices specified)
	[attribute1]	first of a variable number of device attributes
			to cache (some require a following property specifier - *)
			(name,
			 fullName,
			 previousName,
			 description,
			 fullDescription,
			 requestInfo (*),
			 scalingInfo (*),
			 deviceType (*),
			 deviceClass (*),
			 saveInfo,
			 auditInfo,
			 siblings,
			 location,
			 dbAlarmInfo (*),
			 alarmList,
			 actualAlarmList,
			 alarmHandler (*),
			 alarmText (*),
			 alarmUrl,
			 maintainer,
			 department,
			 outOfService,
			 controlledSetting (*),
			 dataType (*),
			 expression,
			 foreignDeviceInfo (*),
			 structure (*),
			 emc,
			 virtualMachine,
			 controllingDevice,
			 alarmGroupInfo,
			 etc.)

	This function returns status values as follows:

	number of devices cached

	Related functions:

	genericDeviceSearch, deviceNameSearch, deviceFullNameSearch,
	deviceDescriptionSearch, deviceFullDescriptionSearch, deviceNodeSearch,
	deviceSsdnSearch

-------------------------------------------------------------------------------

	cacheNodeInfo : cache node database information for later retrieval

	numCached = cacheNodeInfo(nodes [,numNodes])

	Arguments:

	nodes		nodes to cache database information for
	[numNodes]	number of nodes (default is all nodes specified)

	This function returns status values as follows:

	number of nodes cached

	Related functions:

	nodeAttributeValue, node, nodeIs, isIrmNode, isLabviewNode,
	isMoocNode, isOacNode, isAcsysFefNode, nodeAlarmList

-------------------------------------------------------------------------------

	calculateStepMotorSteps : calculates the number of steps for a motor
                                 to move to a given position

	numSteps = calculateStepMotorSteps(device, desiredPosition
					   [,currPosition])

	Arguments:

	device		stepper motor device of interest
	desiredPosition	desired position
	[currPosition]	current position
			(default is to read the actual current position)

	This function returns values as follows:

	number of steps required to move to the desired position

	Related functions:

	stepMotorIsMoving

-------------------------------------------------------------------------------

	camacModuleId : returns the ID for a CAMAC module

	moduleId = camacModuleId(node, crate, slot [,numRetries])

	Arguments:

	node		desired CAMAC front end node
	crate		desired CAMAC crate
	slot		desired CAMAC slot
	[numRetries]	desired number of CAMAC retries

	This function returns values as follows:

	CAMAC module ID

	Related functions:

	node

-------------------------------------------------------------------------------

	capitalize : capitalizes the first character in each word of a string

	string = capitalize(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	case, toUpper, toLower

-------------------------------------------------------------------------------

	case : changes the case of a string

	string = case(sourceString, caseType)

	Arguments:

	sourceString	source string
	caseType	case desired
			(upper -> upper case,
			 lower -> lower case,
			 capitalize -> capitalize the first character
				       of each word)

	This function returns values as follows:

	modified string

	Related functions:

	toLower, toUpper, capitalize

-------------------------------------------------------------------------------

	cast : return the equivalent value to a value

	newValue = cast(oldValue, desiredType)

	Arguments:

	oldValue		value to convert
	desiredType		type to convert to

	This function returns values as follows:

	corresponding converted value

	Related functions:

	castDouble, castFloat, castInteger, castLogical, castLongLong,
	castUnsignedInt, castUnsignedLongLong

-------------------------------------------------------------------------------

	castDouble : return the equivalent double precision value to a value

	doubleValue = castDouble(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted double value

	Synonyms: float

	Related functions:

	cast, castFloat, castInteger, castLogical, castLongLong,
	castUnsignedInt, castUnsignedLongLong

-------------------------------------------------------------------------------

	castFloat : return the equivalent single precision value to a value

	floatValue = castFloat(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted float value

	Related functions:

	cast, castDouble, castInteger, castLogical, castLongLong,
	castUnsignedInt, castUnsignedLongLong

-------------------------------------------------------------------------------

	castInteger : return the equivalent integer value to a value

	integerValue = castInteger(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted integer value

	Synonyms: int, integer

	Related functions:

	cast, castDouble, castFloat, castLogical, castLongLong, castUnsignedInt,
	castUnsignedLongLong

-------------------------------------------------------------------------------

	castLogical : return the equivalent logical (boolean) value to a value

	logicalValue = castLogical(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted logical (boolean) value

	Synonyms: bool, logical, boolean

	Related functions:

	cast, castDouble, castFloat, castInteger, castLongLong, castUnsignedInt,
	castUnsignedLongLong

-------------------------------------------------------------------------------

	castLongLong : return the equivalent long integer value to a value

	longLongValue = castLongLong(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted long integer value

	Synonyms: longLong

	Related functions:

	cast, castDouble, castFloat, castInteger, castLogical, castUnsignedInt,
	castUnsignedLongLong

-------------------------------------------------------------------------------

	castUnsignedInt : return the equivalent unsigned integer value
			  to a value

	unsignedIntValue = castUnsignedInt(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted unsigned integer value

	Related functions:

	cast, castDouble, castFloat, castInteger, castLogical, castLongLong,
	castUnsignedLongLong

-------------------------------------------------------------------------------

	castUnsignedLongLong : return the equivalent unsigned long integer value
			       to a value

	unsignedLongLongValue = castUnsignedLongLong(oldValue)

	Arguments:

	oldValue		value to convert

	This function returns values as follows:

	corresponding converted unsigned long integer value

	Related functions:

	cast, castDouble, castFloat, castInteger, castLogical, castLongLong,
	castUnsignedInt

-------------------------------------------------------------------------------

	ceil : smallest integer greater than or equal to its argument

	resultValue = ceil(value)

	Arguments:

	value		original value

	This function returns values as follows:

	smallest integer greater than or equal to its argument

	Related functions:

	floor

-------------------------------------------------------------------------------

	center : center a string

	string = center(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	justify, leftJustify, rightJustify, leftShift, rightShift, strShift, pad

-------------------------------------------------------------------------------

	changeDirectory : changes the current working directory

	dirExists = changeDirectory(directory)

	Arguments:

	directory	desired directory

	This function returns values as follows:

	TRUE			directory exists
	FALSE			directory does not exist

	Synonyms: cd, chdir

	Related functions:

	currentDirectory, createDirectory, fileDirectory, fileNumLines,
	filePermissions, fileExists, fileRename, fileCopy, fileDelete,
	fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	char : converts an ASCII code to its corresponding character

	string = char(asciiCode)

	Arguments:

	asciiCode	ASCII code(s) to convert (up to 4)

	This function returns values as follows:

	corresponding text

	Related functions:

	ascii

-------------------------------------------------------------------------------

	characterCount : returns the number of characters in a string

	count = characterCount(sourceString [,searchChar])

	Arguments:

	sourceString	source string
	[searchChar]	character to count
			(default is all nonwhite space characters)

	This function returns values as follows:

	number of characters found

	Related functions:

	wordCount, findChar, findNotChar, findString, regexpFindString

-------------------------------------------------------------------------------

	characterType : returns the type of a character

	charType = characterType(characterValue)

	Arguments:

	characterValue	character value

	This function returns values as follows:

	corresponding character type:
	alphabetic
	numeric
	quote
	paren
	brace
	comparator
	arithmetic operator
	bitwise operator
	white space
	punctuation
	control
	????

	Related functions:

	ascii, char, stringStartsWithCharType, stringEndsWithCharType

-------------------------------------------------------------------------------

	checkDeviceFile : checks for bad device names in a device file

	numBadNames = checkDeviceFile(fileName [,parseOptions] [,badNames]
				      [,lineNumbers])

	Arguments:

	fileName	file name including path of data file
	[parseOptions]	file parsing options (values can be combined
			by using the "|" character)
			(fullNames -> parse for full names,
			 allowObsolete -> allow obsolete device names,
			 multiple -> allow for multiple names per line)
	[badNames]	returned bad device names
	[lineNumbers]	returned line numbers where bad device names
			were found

	This function returns values as follows:

	number of bad device names found

	Synonyms: check_device_file

	Related functions:

	none

-------------------------------------------------------------------------------

	checkOperatorSaveStatus : checks the status of a save/restore
				  operator save

	inProgress = checkOperatorSaveStatus([percentComplete] [,console])

	Arguments:

	[percentComplete]	save file completion percentage
	[console]		console requesting the current save

	This function returns values as follows:

	TRUE			operator save is in progress
	FALSE			no operator save is in progress

	Related functions:

	abortOperatorSave, saveFileDeviceStatus, saveFileDeviceErrors,
	saveFileInfo, oldestSrFile, newestSrFile

-------------------------------------------------------------------------------

	chiSquare : calculates the chi-squared value for a set of
                   data points

	chiSquareValue = chiSquare(measuredValues, predictedValues [,numValues]
				   [,retNumValues])

	Arguments:

	measuredValues	measured values
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	predictedValues	predicted values
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to use for the calculation
			(default is the minimum number of measured or
			 predicted values)
	[retNumValues]	returned number of values used

	This function returns values as follows:

	chi-squared value

	Examples:

	declare measuredValues double[] = 1.4, 1.8, 3.3, 4.2, 4.9
	declare predictedValues double[] = 1, 2, 1, 4, 2
	integral = chiSquare(measuredValues[],predictedValues[])

	Related functions:

	integrateDataPoints, rms2, rms, mean2, mean, median2, median,
	mode2, mode, minimum2, minimum, maximum2, maximum, sum2, sum,
	range2, range, stddev2, stddev, variance2, variance,
	identical2, identical, min, max, histogram

-------------------------------------------------------------------------------

	circularShift : bit field circular shift

	value = circularShift(sourceValue, startBit [,numBits] [,numShift])

	Arguments:

	sourceValue	value to modify
	startBit	starting bit number (starts at 1)
	[numBits]	number of bits to shift
			(default is 32)
	[numShift]	number of bits to shift by
			(A positive number produces a left shift while a
			 negative number will produce a right shift.)
			(default is 1)

	This function returns values as follows:

	modified value with the requested bits circularly shifted

	Synonyms: bitFieldCircularShift

	Related functions:

	lshft, rshft, clearBit, setBit, bit, bitCount, bitField, bitComplement

-------------------------------------------------------------------------------

	clearBit : clear a bit in a value

	value = clearBit(sourceValue, bitNumber)

	Arguments:

	sourceValue	value to modify
	bitNumber	bit number (starts at 1)

	This function returns values as follows:

	modified value with the requested bit cleared

	Synonyms: rstbit

	Related functions:

	setBit, bit, bitCount, bitField, circularShift, bitComplement

-------------------------------------------------------------------------------

	clearCommandStats : clear command statistics values

	clearCommandStats([command])

	Arguments:

	[command]	command to clear statistics for
			(default is to clear statistics for all commands)

	This function returns values as follows:

	<none>

	Related functions:

	commandStats, clearFunctionStats, functionStats, clibMemoryInfo,
	ifLevel, loopLevel, labelLineNumber, variableNumReadings,
	variableNumSettings, variableArrayDimensions, variableDimensionSize,
	variableType, variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements, variableIsInitialized,
	variableIsConstant, variableIsDynamic, numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	clearEventOccurred : clear the detection status for a clock event

	boolean = clearEventOccurred(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	TRUE			event has occurred
	FALSE			event has not occurred

	Related functions:

	eventOccurred, timeSinceEvent, eventDate, eventCount, eventInfo,
	eventTimelineInfo, clockEventIsEnabled, clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	clearFunctionStats : clear function statistics values

	clearFunctionStats([function])

	Arguments:

	[function]	function to clear statistics for
			(default is to clear statistics for all functions)

	This function returns values as follows:

	<none>

	Related functions:

	functionStats, clearCommandStats, commandStats, clibMemoryInfo,
	ifLevel, loopLevel, labelLineNumber, variableNumReadings,
	variableNumSettings, variableArrayDimensions, variableDimensionSize,
	variableType, variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements, variableIsInitialized,
	variableIsConstant, variableIsDynamic, numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	clibMemoryInfo : returns CLIB memory allocation information

	numBytes = clibMemoryInfo([numBlocks] [,numFreeErrs] [,numMallocErrs]
				  [,numReallocErrs] [,badAllocList] [,badHeader]
				  [,badHeaderNum] [,badFooter] [,badFooterNum])

	Arguments:

	[numBlocks]	 returned number of allocated blocks
	[numFreeErrs]	 returned number of free errors
	[numMallocErrs]	 returned number of malloc errors
	[numReallocErrs] returned number of realloc errors
	[badAllocList]	 returned bad allocation list
	[badHeader]	 returned bad block header
	[badHeaderNum]	 returned bad header block number
	[badFooter]	 returned bad block footer
	[badFooterNum]	 returned bad footer block number

	This function returns values as follows:

	total number of bytes allocated

	Related functions:

	ifLevel, loopLevel, labelLineNumber, variableNumReadings,
	variableNumSettings, variableArrayDimensions, variableDimensionSize,
	variableType, variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements, variableIsInitialized,
	variableIsConstant, variableIsDynamic, numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	clockEventIsEnabled : determines if a clock event is enabled

	boolean = clockEventIsEnabled(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event)

	This function returns values as follows:

	TRUE			event is enabled
	FALSE			event is disabled

	Related functions:

	clockEventTriggerIsEnabled, eventOccurred, clearEventOccurred,
	timeSinceEvent, eventDate, eventCount, eventInfo, eventTimelineInfo

-------------------------------------------------------------------------------

	clockEventTriggerIsEnabled : determines if a clock event trigger
                                    is enabled

	boolean = clockEventTriggerIsEnabled(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event)

	This function returns values as follows:

	TRUE			event trigger is enabled
	FALSE			event trigger is disabled

	Related functions:

	clockEventIsEnabled, eventOccurred, clearEventOccurred, timeSinceEvent,
	eventDate, eventCount, eventInfo, eventTimelineInfo

-------------------------------------------------------------------------------

	closeFile : closes a file opened by an earlier call to openFile

	status = closeFile(fileId)

	Arguments:

	fileId		file ID returned by openFile

	This function returns values as follows:

	status of close

	Synonyms: fclose, fileClose

	Related functions:

	openFile, fileGetString, filePrintf, fscanf, fileRead, fileRewind,
	fileWrite

-------------------------------------------------------------------------------

	closeFilesharingFile : closes a Filesharing file

	status = closeFilesharingFile(fileId)

	Arguments:

	fileId		Filesharing file ID

	This function returns values as follows:

	status of close

	Synonyms: close_filesharing_file

	Related functions:

	closeFile, openFile, fileGetString, filePrintf, fscanf, fileRead,
	fileRewind, fileWrite

-------------------------------------------------------------------------------

	commandStats : returns execution statistics for an ACL command

	numCalls = commandStats(command [,totalTime] [,longestTime] [,numErrors]
				[,lastError] [,lastErrorLine] [,lastLine])

	Arguments:

	command		command to retrieve statistics for
	[totalTime]	returned total time spent in the command
	[longestTime]	returned longest time spent in the command
	[numErrors]	returned number of errors when executing the command
	[LastError]	returned last error when executing the command
	[lastErrorLine]	returned line number of last error from the command
	[lastLine]	returned last line where the command was executed

	This function returns values as follows:

	number of times the command has been called

	Related functions:

	clearCommandStats, functionStats, clearFunctionStats, clibMemoryInfo,
	ifLevel, loopLevel, labelLineNumber, variableNumReadings,
	variableNumSettings, variableArrayDimensions, variableDimensionSize,
	variableType, variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements, variableIsInitialized,
	variableIsConstant, variableIsDynamic, numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	compareWithTolerance : compares one or more values with another
                              with a tolerance

	mismatch = compareWithTolerance(value, compareValue, tolerance
					[,numValues])

	Arguments:

	value		value(s) to compare to comparison value
	comparisonValue	comparison value
	tolerance	comparison tolerance
	[numValues]	number of values from the first argument to compare
			to the comparison value
			(default is 1)

	This function returns values as follows:

	TRUE			value(s) did not match
	FALSE			value(s) matched within the specified tolerance

	Related functions:

	none

-------------------------------------------------------------------------------

	concatenateStringArguments : concatenate the script string arguments

	string = concatenateStringArguments([startIndex] [,numStrings]
					    [,separatorString])

	Arguments:

	variable	  array variable to delete duplicates from
	[startIndex]	  starting argument string index
			  (default is 0)
	[numStrings]	  number of strings to concatenate
			  (default is all available strings)
	[separatorString] string to insert between adjacent argument strings
			  (default is the null string)

	This function returns status values as follows:

	concatenated argument string

	Related functions:

	none

-------------------------------------------------------------------------------

	condif : returns the second argument if the first has a value of true
		 or the third argument if it has a value of false

	value = condif(booleanValue, trueValue, falseValue)

	Arguments:

	booleanValue	boolean value to test
	trueValue	value to return if the first argument
			has a value of TRUE
	falseValue	value to return if the first argument
			has a value of FALSE

	This function returns values as follows:

	selected value

	Related functions:

	scondif

-------------------------------------------------------------------------------

	consoleClasses : returns the classes a console belongs to

	classMask = consoleClasses([console] [,numClasses] [,classNames])

	Arguments:

	[console]	console number to check
			(defaults to the local console)
	[numClasses]	returned number of classes
	[classNames]	returned member class name(s)

	This function returns values as follows:

	class mask for the console

	Related functions:

	consoleIsMemberOfClass, consoleClassMaskToString,
	stringToConsoleClassMask, consoleUserName, consoleDisplayName,
	consoleLocation, consolePhoneNumber, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleClassMaskToString : convert a console class mask to a string

	string = consoleClassMaskToString([classMask] [,joinString])

	Arguments:

	[classMask]	console class mask to convert
			(default is the calling console's class mask)
	[joinString]	desired join string between successive names
			(default is "+")

	This function returns values as follows:

	converted console class mask string

	Related functions:

	stringToConsoleClassMask, myConsoleClass

-------------------------------------------------------------------------------

	consoleDeleteLogicalName : deletes a logical name on a console

	status = consoleDeleteLogicalName(logicalName, [,console])

	Arguments:

	logicalName	logical name to set
	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	status of delete

	Related functions:

	consoleSetLogicalName, consoleGetLogicalName, getLogicalName,
	setLogicalName, deleteLogicalName, consoleGetenv

-------------------------------------------------------------------------------

	consoleDisplayName : returns a console's display name

	displayName = consoleDisplayName([console])

	Arguments:

	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	display name associated with the console

	Related functions:

	consoleUserName, consoleLocation, consolePhoneNumber,
	consoleClasses, consoleIsMemberOfClass, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleExists : determines whether or not a specified console exists
			(is defined) (may not be running)

	boolean = consoleExists(console)

	Arguments:

	console		console number to check

	This function returns values as follows:

	TRUE			console exists
	FALSE			console doesn't exist

	Related functions:

	consoleIsUp, consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleGetenv : returns the value of an environment variable
			from a console

	valueString = consoleGetenv(variableName [,console])

	Arguments:

	variableName	environment variable name to read
	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	value of environment variable

	Related functions:

	consoleGetLogicalName, consoleUserName, consoleDisplayName,
	consoleExists, consoleIsUp, consoleSlotExists, consoleToNode,
	consoleProcessName, consoleTaskName, consoleSlotToWindow,
	consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleGetLogicalName : returns the value of a logical name from
                               a console

	valueString = consoleGetLogicalName(logicalName [,console])

	Arguments:

	logicalName	logical name to read
	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	value of environment variable

	Related functions:

	consoleSetLogicalName, consoleDeleteLogicalName, getLogicalName,
	setLogicalName, deleteLogicalName, consoleGetenv, consoleUserName,
	consoleDisplayName, consoleExists, consoleIsUp, consoleSlotExists,
	consoleToNode, consoleProcessName, consoleTaskName,
	consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleIsMemberOfClass : determines if a console is a member of a class

	isMember = consoleIsMemberOfClass(consoleClass [,console])

	Arguments:

	consoleClass	console class to check for
	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	TRUE			console is a member of the class
	FALSE			console is not a member of the class

	Related functions:

	consoleClasses, consoleClassMaskToString,
	stringToConsoleClassMask, consoleUserName, consoleDisplayName,
	consoleLocation, consolePhoneNumber, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleIsUp : determines whether or not a specified console is running

	boolean = consoleIsUp(console)

	Arguments:

	console		console number to check

	This function returns values as follows:

	TRUE			console is up
	FALSE			console is not up

	Related functions:

	consoleExists, consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleLocation : returns the location of a console

	location = consoleLocation([console])

	Arguments:

	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	location associated with the console

	Related functions:

	consoleUserName, consoleDisplayName, consolePhoneNumber,
	consoleClasses, consoleIsMemberOfClass, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consolePhoneNumber : returns the phone number corresponding to a console

	phoneNumber = consolePhoneNumber([console])

	Arguments:

	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	phone number (extension only) associated with the console

	Related functions:

	consoleUserName, consoleDisplayName, consoleLocation,
	consoleClasses, consoleIsMemberOfClass, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleProcessName : retrieves the name of a console process running
			     in a specified console and slot

	name = consoleProcessName(console, slot [,nameType])

	Arguments:

	console		console number
	slot		console slot
	[nameType]	name type to return
			(actual -> actual process name (default),
			 generic -> corresponding generic process name)

	This function returns values as follows:

	process name string

	Related functions:

	consoleTaskName, consoleIsUp, consoleExists, consoleSlotExists,
	consoleToNode, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleSetLogicalName : sets a logical name on a console

	status = consoleSetLogicalName(logicalName, logicalValue [,console])

	Arguments:

	logicalName	logical name to set
	logicalValue	desired logical name value
	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	status of set

	Related functions:

	consoleGetLogicalName, consoleDeleteLogicalName, getLogicalName,
	setLogicalName, deleteLogicalName, consoleGetenv

-------------------------------------------------------------------------------

	consoleSlotExists : determines whether or not a console slot exists

	boolean = consoleSlotExists(console, slot)

	Arguments:

	console		console number to check
	slot		console slot to check

	This function returns values as follows:

	TRUE			slot exists
	FALSE			slot doesn't exist

	Related functions:

	consoleExists, consoleIsUp, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleSlotToWindow : convert a console slot to a primary window ID

	windowId = consoleSlotToWindow(slot)

	Arguments:

	slot		console slot to translate

	This function returns values as follows:

	corresponding window ID

	Related functions:

	consoleWindowToSlot, consoleExists, consoleIsUp, consoleToNode,
	consoleProcessName, consoleTaskName, consoleSlotExists

-------------------------------------------------------------------------------

	consoleTaskName : returns a console slot specific task name

	name = consoleTaskName(genericName, slot [,console])

	Arguments:

	genericName	generic task name
	slot		console slot
	[console]	console number (default is the caller's console)

	This function returns values as follows:

	corresponding console task name

	Related functions:

	consoleProcessName, consoleToNode, consoleExists, consoleIsUp,
	consoleSlotExists, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleToInstance : converts a console number to its corresponding
			    instance

	node = consoleToInstance(console [,node])

	Arguments:

	console		console number
	[node]		corresponding ACNET node

	This function returns values as follows:

	corresponding console instance

	Related functions:

	consoleToNode, consoleProcessName, consoleTaskName, consoleExists,
	consoleIsUp, consoleSlotExists, consoleSlotToWindow,
	consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleToNode : converts a console number to its corresponding
			ACNET node

	node = consoleToNode(console)

	Arguments:

	console		console number

	This function returns values as follows:

	corresponding ACNET node

	Related functions:

	consoleToInstance, consoleProcessName, consoleTaskName, consoleExists,
	consoleIsUp, consoleSlotExists, consoleSlotToWindow,
	consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleUserIdToName : converts a console user ID to its
                             corresponding name

	userName = consoleUserIdToName(userId [,allowInactive])

	Arguments:

	userId		user ID to convert
	[allowInactive]	determine whether or not to convert inactive users
			(allowInactive -> allow inactive users
			 noInactive -> only allow active users (default))

	This function returns values as follows:

	corresponding console user name

	Related functions:

	consoleUserNameToId, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserName, myUserId, systemUserIdToName,
	systemUserNameToId, mySystemUserId, userAttributeValue

-------------------------------------------------------------------------------

	consoleUserName : returns a console's user name

	userName = consoleUserName([console])

	Arguments:

	[console]	console number to check
			(defaults to the local console)

	This function returns values as follows:

	user name associated with the console

	Related functions:

	consoleDisplayName, consoleLocation, consolePhoneNumber,
	consoleClasses, consoleIsMemberOfClass, consoleGetenv,
	consoleGetLogicalName, consoleExists, consoleIsUp,
	consoleSlotExists, consoleToNode, consoleProcessName,
	consoleTaskName, consoleSlotToWindow, consoleWindowToSlot

-------------------------------------------------------------------------------

	consoleUserNameToFullName : converts a console user name to a full name

	fullName = consoleUserNameToFullName(userName)

	Arguments:

	userName	console user name

	This function returns values as follows:

	corresponding full name

	Related functions:

	fullNameToConsoleUserName, consoleUserNameToId, consoleUserIdToName,
	userAttributeValue, myUserName, myUserId, systemUserNameToId,
	systemUserIdToName

-------------------------------------------------------------------------------

	consoleUserNameToId : converts a console user name to its
                             corresponding ID

	userId = consoleUserNameToId(userName [,allowInactive])

	Arguments:

	userName	user name to convert
	[allowInactive]	determine whether or not to convert inactive users
			(allowInactive -> allow inactive users
			 noInactive -> only allow active users (default))

	This function returns values as follows:

	corresponding console user ID

	Related functions:

	consoleUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserId, myUserName, systemUserNameToId,
	systemUserIdToName, userAttributeValue

-------------------------------------------------------------------------------

	consoleWindowToSlot : convert a console window ID to a slot

	slot = consoleWindowToSlot(windowId)

	Arguments:

	windowId	console window ID to translate

	This function returns values as follows:

	corresponding slot number

	Related functions:

	consoleSlotToWindow, consoleExists, consoleIsUp, consoleToNode,
	consoleProcessName, consoleTaskName, consoleSlotExists

-------------------------------------------------------------------------------

	controllingDevice : returns the device's controlling device (or 0)

	controlDevice = controllingDevice(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	controlling device

	Related functions:

	previousSibling, nextSibling

-------------------------------------------------------------------------------

	convertIpAddress : converts IP addresses between name and numeric forms

	address = convertIpAddress(ipAddress [,addressType] [,addressValue])

	Arguments:

	ipAddress	IP address string to convert
	[addressType]	conversion type
			(toggle -> convert to the other address type (default),
			 numeric -> convert to a numeric IP address,
			 name -> convert to an IP name)
	[addressValue]	returned numeric address value

	This function returns values as follows:

	converted IP address string

	Related functions:

	isNumericIpAddress, ipAddressCompare, ipNameToNode

-------------------------------------------------------------------------------

	convertSeconds : converts dates in seconds between date types

	seconds = convertSeconds(dateTypeFrom, dateTypeTo [,baseDate])

	Arguments:

	dateTypeFrom	date type to convert from
			(utc -> original time is in UTC,
			 localCtime -> original time is local time since
				       January 1, 1970,
			 clinks -> original time is in clinks
				   (seconds since January 1, 1972 local time),
			 labview -> original date is in LabView time,
			 dbDateDiff -> original date is the result of an
				       SQL datediff function performed on
				       dates stored as local time)
	dateTypeTo	date type to convert to
			(utc -> convert to UTC time,
			 localCtime -> convert to local time since
				       January 1, 1970,
			 clinks -> convert to clinks
				   (seconds since January 1, 1972 local time),
			 labview -> convert to LabView time,
			 dbDateDiff -> convert to the equivalent of an
				       SQL datediff function performed on
				       dates stored as local time)
	[baseDate]	base date
			(default is now)

	This function returns values as follows:

	seconds in the new date type

	Related functions:

	timeAgo, timeFromDate, stringToDate, dateToString, timeSinceEvent,
	cpuTime, systemTime, 15HzCount, timer, julianDate, julianDateToDate,
	currentDate, currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	convertTypeToString : converts a convert type value to a string

	string = convertTypeToString(convertTypeValue)

	Arguments:

	convertTypeValue convert type value to convert

	This function returns values as follows:

	converted string

	Related functions:

	stringToConvertType, rad50ToString, stringToRad50, stringToColor,
	stringToProperty

-------------------------------------------------------------------------------

	coresidentNodes : returns the coresident nodes on an ACNET node

	numNodes = coresidentNodes([node] [,nodeNames])

	Arguments:

	[node]		node of interest
			(default is local node)
	[nodeNames]	returned coresident node names

	This function returns values as follows:

	number of coresident nodes found

	Related functions:

	defaultAcnetNode, loggersOnNode, oacsOnNode, nodeAcnetTasks, node,
	nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	cos : cosine

	resultValue = cos(value)

	Arguments:

	value		value to take the cosine of in radians

	This function returns values as follows:

	cosine value of the argument

	Related functions:

	cosd, cosh, sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	cosd : cosine (argument in degrees)

	resultValue = cosd(value)

	Arguments:

	value		value to take the cosine of in degrees

	This function returns values as follows:

	cosine value of the argument

	Related functions:

	cos, cosh, sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	cosecant : cosecant

	resultValue = cosecant(value)

	Arguments:

	value		value to take the cosecant of in radians

	This function returns values as follows:

	cosecant value of the argument

	Related functions:

	secant, cotan, cotand, tan, tand, tanh, atan, atand, atan2, atan2d,
	atanh, cos, cosd, cosh, sin, sind, sinh, acos, acosd, acosh, asin,
	asind, asinh

-------------------------------------------------------------------------------

	cosh : hyperbolic cosine

	resultValue = cosh(value)

	Arguments:

	value		value to take the hyperbolic cosine of

	This function returns values as follows:

	hyperbolic cosine value of the argument

	Related functions:

	cos, cosd, sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	cotan : cotangent

	resultValue = cotan(value)

	Arguments:

	value		value to take the cotangent of in radians

	This function returns values as follows:

	cotangent value of the argument

	Related functions:

	cotand, tan, tand, tanh, atan, atand, atan2, atan2d, atanh, cos, cosd,
	cosh, sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	cotand : cotangent (argument in degrees)

	resultValue = cotand(value)

	Arguments:

	value		value to take the cotangent of in degrees

	This function returns values as follows:

	cotangent value of the argument

	Related functions:

	cotan, tan, tand, tanh, atan, atand, atan2, atan2d, atanh, cos, cosd,
	cosh, sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	cpuTime : returns CPU time in milliseconds since ACL was initialized

	elapsedTime = cpuTime([prevCpuTime])

	Arguments:

	[prevCpuTime]	reference time
			(delta -> CPU time in milliseconds since last call,
			 scriptStart -> CPU time in milliseconds since the
					start of the script
			 otherwise -> previous CPU time in milliseconds)
			(default is 0)

	This function returns values as follows:

	elapsed time in milliseconds since ACL was initialized

	Related functions:

	systemTime, 15HzCount, timer, timeAgo, timeFromDate, timeSinceEvent,
	stringToDate, dateToString, convertSeconds, julianDate, julianDateToDate

-------------------------------------------------------------------------------

	createDirectory : creates a new directory

	createDirectory(directory [,fileMode])

	Arguments:

	directory	desired directory
	[fileMode]	desired file mode
			(This can either be an integer or a set of the
			 following strings separated by a pipe (|):
			 userRead,
			 userWrite,
			 userExec,
			 groupRead,
			 groupWrite,
			 groupExec,
			 otherRead,
			 otherWrite,
			 otherExec)
			(default is the mode of the parent directory)

	This function returns values as follows:

	TRUE			directory was created

	Synonyms: mkdir

	Related functions:

	currentDirectory, changeDirectory, fileDirectory, fileNumLines,
	filePermissions, fileExists, fileRename, fileCopy, fileDelete,
	fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	currentAnalogAlarmText : returns the current analog alarm text for
				 a device

	alarmText = currentAnalogAlarmText(device [,timestamp] [,rawData])

	Arguments:

	device		device of interest
	[timestamp]	returned alarm timestamp
	[rawData]	returned raw data value

	This function returns values as follows:

	number of current alarm text entries

	Related functions:

	deviceCurrentAlarmText, analogAlarmText, analogAlarmPriority,
	digitalAlarmText, digitalAlarmTextAll

-------------------------------------------------------------------------------

	currentDate : returns the current date in seconds and milliseconds

	seconds = currentDate([milliseconds] [,timeReference])

	Arguments:

	[milliseconds]	milliseconds since the start of second
	[timeReference]	time reference
			(delta -> return delta time since previous call,
			 scriptStart -> return delta time since start
					of script)
			(default is the beginning of the Epoch)

	This function returns values as follows:

	current date in seconds

	Synonyms: current_date

	Related functions:

	currentTimeInClinks, currentTime, millisecondsNow, 15hzCount,
	systemTime, cpuTime, timer, timeSinceEvent, timeAgo, timeFromDate,
	stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, localtime, millisecondsToDate, dateToMilliseconds

-------------------------------------------------------------------------------

	currentDirectory : returns the current working directory

	directory = currentDirectory()

	Arguments:

	none

	This function returns values as follows:

	current directory string

	Synonyms: pwd

	Related functions:

	changeDirectory, createDirectory, fileDirectory, fileNumLines,
	filePermissions, fileExists, fileRename, fileCopy, fileDelete,
	fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	currentSdaFile : returns the current SDA file number for a given usage

	fileNumber = currentSdaFile([sdaUsage])

	Arguments:

	[sdaUsage]	desired SDA usage string
			(default is "Collider")

	This function returns values as follows:

	current SDA file number for the requested usage

	Related functions:

	dateToSdaFile, sdaFileDate, isValidSdaFile, isValidSdaCase,
	isValidSdaSet

-------------------------------------------------------------------------------

	currentTime : current time in seconds and milliseconds since the Epoch

	seconds = currentTime([milliseconds] [,timeReference])

	Arguments:

	[milliseconds]	milliseconds since the start of second
	[timeReference]	time reference
			(delta -> return delta time since previous call,
			 scriptStart -> return delta time since start
					of script)
			(default is the beginning of the Epoch)

	This function returns values as follows:

	seconds since the Epoch

	Related functions:

	currentTimeInClinks, currentDate, millisecondsNow, 15hzCount,
	systemTime, cpuTime, timer, timeSinceEvent, timeAgo, timeFromDate,
	stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, localtime, millisecondsToDate, dateToMilliseconds

-------------------------------------------------------------------------------

	currentTimeInClinks : current time in seconds and milliseconds
			      since January 1, 1972 00:00 CST

	seconds = currentTimeInClinks([milliseconds] [,timeReference])

	Arguments:

	[milliseconds]	milliseconds since the start of second
	[timeReference]	time reference
			(delta -> return delta time since previous call,
			 scriptStart -> return delta time since start
					of script)
			(default is the beginning of the Epoch)

	This function returns values as follows:

	seconds since January 1, 1972 00:00 CST

	Synonyms: timeNow

	Related functions:

	currentDate, currentTime, millisecondsNow, 15hzCount, systemTime,
	cpuTime, timer, timeSinceEvent, timeAgo, timeFromDate, stringToDate,
	dateToString, convertSeconds, julianDate, julianDateToDate,
	localtime, millisecondsToDate, dateToMilliseconds

-------------------------------------------------------------------------------

	dateIsDst : determines if a date is in a DST period

	boolean = dateIsDst([date])

	Arguments:

	[date]		date to test
			(default is the present time)

	This function returns values as follows:

	TRUE			date is during a DST period
	FALSE			date is not during a DST period

	Related functions:

	localtime, stringToDate, dateToString, currentDate, currentTimeInClinks,
	currentTime, millisecondsNow, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, timezoneInfo, dateToDayOfWeek, millisecondsToDate,
	dateToMilliseconds

-------------------------------------------------------------------------------

	dateToDayOfWeek : returns the corresponding day of the week for a date

	dayName = dateToDayOfWeek([date] [,dayIndex] [,longText])

	Arguments:

	[date]		date of interest
			(default is the present time)
	[dayIndex]	returned day index (1 -> Monday ... 7 -> Sunday)
	[longText]	type of day string to return
			(short -> 3 character day of week names (default),
			 long -> full day of week names)

	This function returns values as follows:

	day of the week name

	Related functions:

	localtime, stringToDate, dateToString, currentDate, currentTimeInClinks,
	currentTime, millisecondsNow, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, dateIsDst, timezoneInfo, millisecondsToDate,
	dateToMilliseconds

-------------------------------------------------------------------------------

	dateToMilliseconds : converts a date to its corresponding number
                            of milliseconds

	date = dateToMilliseconds([date])

	Arguments:

	[date]		date value to convert
			(default is 0 which results in the current time)

	This function returns values as follows:

	corresponding number of milliseconds since the Epoch

	Related functions:

	millisecondsToDate, millisecondsNow, 15hzCount, currentTime,
	currentDate, currentTimeInClinks, systemTime, cpuTime, timer,
	timeSinceEvent, timeAgo, timeFromDate, stringToDate, dateToString,
	convertSeconds, julianDate, julianDateToDate, localtime

-------------------------------------------------------------------------------

	dateToSdaFile : returns the SDA file number corresponding to a
			given date

	fileNumber = dateToSdaFile([date] [,sdaUsage])

	Arguments:

	[date]		date value
			(default is current time)
	[sdaUsage]	desired SDA usage string
			(default is "Collider")

	This function returns values as follows:

	corresponding SDA file number

	Related functions:

	currentSdaFile, sdaFileDate, isValidSdaFile, isValidSdaCase,
	isValidSdaSet

-------------------------------------------------------------------------------

	dateToString : converts a date value to a string

	string = dateToString([formatString] [,date] [,locale])

	Arguments:

	[formatString]	desired format
			(standard -> "dd-Mmm-yyyy hh:mm:ss" format (default),
			 ctime -> "Www Mmm dd hh:mm:ss yyyy" format,
			 ctime+ -> "Www Mmm dd hh:mm:ss yyyy zzz" format,
			 compare -> "yyyy-mm-dd hh:mm:ss" format,
			 numeric -> "mm/dd/yyyy hh:mm:ss" format,
			 numericNoCentury -> "mm/dd/yy hh:mm:ss" format,
			 numericDescending -> "yyyy/mm/dd hh:mm:ss" format,
			 timeOfDay -> "hh:mm:ss" format,
			 otherwise -> format string suitable for use
				      with strftime)
	[date]		date value to convert
			(default is now)
	[locale]	time locale
			(local -> local time (default),
			 utc -> UTC time)

	This function returns values as follows:

	converted date string

	Related functions:

	stringtoDate, convertSeconds, timeAgo, timeFromDate, timeSinceEvent,
	cpuTime, systemTime, 15HzCount, timer, julianDate, julianDateToDate,
	currentDate, currentTimeInClinks, currentTime, localtime,
	timeIntervalToString

-------------------------------------------------------------------------------

	decimal : returns a value as a decimal string

	string = decimal(value [,convertLength] [,fillChar] [,dataType])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[fillChar]	fill character
	[dataType]	data type
			(integer,
			 float,
			 double)
			(default is to use the native type of the value)

	This function returns values as follows:

	converted string value

	Synonyms: dec, toDec, toDecimal

	Related functions:

	hex, binary, octal, radix, toString, toTrimmedString, rad50ToString

-------------------------------------------------------------------------------

	defaultAcnetNode : returns the default ACNET node for a given node

	defaultNode = defaultAcnetNode([node])

	Arguments:

	[node]		node of interest
			(default is local node)

	This function returns values as follows:

	default ACNET node name

	Related functions:

	coresidentNodes, loggersOnNode, oacsOnNode, nodeAcnetTasks, node,
	nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	delenv : deletes an environment variable

	status = delenv(envVariable)

	Arguments:

	envVariable	environment variable name

	This function returns values as follows:

	OK

	Related functions:

	unsetenv, getenv, setenv, getLogicalName, setLogicalName,
	deleteLogicalName

-------------------------------------------------------------------------------

	deleteLogicalName : deletes a logical name

	status = deleteLogicalName(logicalName [,nameType])

	Arguments:

	logicalName	logical name
	[nameType]	type of logical name
			(group (default),
			 process)

	This function returns values as follows:

	OK

	Related functions:

	getLogicalName, setLogicalName, getenv, setenv, unsetenv, delenv

-------------------------------------------------------------------------------

	delimitedStringLength : returns the length of a string using delimiters

	length = delimitedStringLength(string, delimiters [,maxLength]
				       [,option])

	Arguments:

	string		string to determine the length of
	delimiters	string delimiter characters
	[maxLength]	maximum length to return
			(default is infinite)
	[option]	options
			(handleQuotes -> observe quoted strings when searching
					 for delimiter characters)

	This function returns values as follows:

	string length

	Related functions:

	stringLength, nonblankLength, sizeof, sizeofVariable

-------------------------------------------------------------------------------

	determineDstDates : determines the DST dates for a given year

	determineDstDates(firstDate, lastDate [,year] [,firstDateValues]
			  [,lastDateValues])

	Arguments:

	firstDate	  returned first DST date
	lastDate	  returned last DST date
	[year]		  year to determine DST dates for
			  (default is the current year)
	[firstDateValues] returned first DST date values
			  (hours,
			   day of the month,
			   month index,
			   year,
			   day of the week index,
			   day of the year)
	[lastDateValues]  returned last DST date values
			  (see firstDateValues)

	This function returns values as follows:

	first DST date

	Synonyms: calculateDstDates

	Related functions:

	localtime, stringToDate, dateToString, currentDate, currentTimeInClinks,
	currentTime, millisecondsNow, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, millisecondsToDate, dateToMilliseconds

-------------------------------------------------------------------------------

	device : converts an ACNET device to a device index value

	deviceIndex = device(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device index value

	Related functions:

	deviceIndex, name, fullName, text, fullText, deviceSpec

-------------------------------------------------------------------------------

	deviceAddressingMode : returns a device/property addressing mode

	addrMode = deviceRawDataType(device [,property] [,dataType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[dataType]	data type to return
			(name -> return addressing mode string (default),
			 number -> return addressing mode number)

	This function returns values as follows:

	device property's addressing mode

	Related functions:

	devicePropertyLengths, deviceDefaultLength, deviceAtomicLength,
	deviceMaximumLength, deviceRawDataType, historicRawDataType,
	deviceReadSetScaling

-------------------------------------------------------------------------------

	deviceAlarmGroupInfo : returns device alarm group information

	alarmGroup = deviceAlarmGroupInfo(device [,isConsolidator] [,dataType])

	Arguments:

	device		 device of interest
	[isConsolidator] returned boolean indicating whether or not the
			 requested device is an alarm group consolidator
			 (TRUE -> device is an alarm group consolidator,
			  FALSE -> device is not an alarm group consolidator)
	[dataType]	 data type to return
			 (number -> return alarm group number (default),
			  name -> return alarm group name)

	This function returns values as follows:

	device alarm group

	Related functions:

	deviceIsInAlarmGroup, deviceIsAlarmConsolidator, deviceAlarmList

-------------------------------------------------------------------------------

	deviceAlarmList : returns the device alarm list

	alarmList = deviceAlarmList(device [,option] [,dataType])

	Arguments:

	device		device of interest
	[option]	handling of default alarm list values
			(resolveDefault -> resolve a default alarm list
					   (default),
			 dontResolveDefault -> don't resolve a default
					       alarm list)
	[dataType]	data type to return
			(number -> return alarm list number (default),
			 name -> return alarm list name)

	This function returns values as follows:

	device alarm list

	Related functions:

	deviceAlarmGroupInfo, name, fullName, text, fullText,
	devicePropertyLengths, deviceAtomicLength, deviceDefaultLength,
	deviceMaximumLength

-------------------------------------------------------------------------------

	deviceArea : returns the area associated with a device

	area = deviceArea(device [,dataType])

	Arguments:

	device		device of interest
	[dataType]	data type to return
			(name -> return area name (default),
			 number -> return area number)

	This function returns values as follows:

	associated area value

	Related functions:

	deviceMachine

-------------------------------------------------------------------------------

	deviceArrayIndex : returns the array index and number of elements
                          for a device spec

	arrayIndex = deviceArrayIndex(deviceSpec [,numElements])

	Arguments:

	deviceSpec	device specification to query
	[numElements]	returned number of elements value

	This function returns values as follows:

	device array index value

	Related functions:

	deviceSpecExtractValues, name, device, deviceOffset, deviceProperty,
	deviceSpec, deviceSpecToString

-------------------------------------------------------------------------------

	deviceAtomicLength : returns the atomic length of a device property
			     in bytes

	length = deviceAtomicLength(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	atomic length of the device/property in bytes

	Related functions:

	devicePropertyLengths, deviceDefaultLength, deviceMaximumLength,
	deviceScalingLength, isArrayDevice, device

-------------------------------------------------------------------------------

	deviceBitField : extracts a bit field value from a device reading

	fieldValue = deviceBitField(device, startBit [,numBits])

	Arguments:

	device		device/property of interest
	startBit	starting bit number (starts at 1)
	numBits		number of bits (default is 1)

	This function returns values as follows:

	extracted bit field value

	Related functions:

	device, bitField, bitText, bitDataText, statusAttrToBitInfo

-------------------------------------------------------------------------------

	deviceCalculatedValue : returns a calculated numeric device value

	value = deviceCalculatedValue(device [,calcType] [,calcDataEvent]
				      [,calcInterval] [,property] [,arrayIndex]
				      [,scalingType] [,isValid])

	Arguments:

	device		device of interest
	[calcType]	desired calculation type
			(average,
			 primaryAverage,
			 integralAverage,
			 integral,
			 absoluteValueIntegral,
			 rms,
			 integralRms,
			 standardDeviation,
			 slope)
			(default is the implicit value from the device argument)
	[calcDataEvent]	desired calculation update data event
			(default is the implicit value from the device argument)
	[calcInterval]	desired calculation time interval
			(default is the implicit value from the device argument)
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit value from the device argument)
	[arrayIndex]	array index
			(default is the implicit value from the device argument)
	[scalingType]	scaling type
			(common -> engineering units (default),
			 primary -> primary units,
			 raw -> raw units)
	[isValid]	returned flag indicating whether or not a valid value
			was returned

	This function returns values as follows:

	calculated numeric device reading

	Related functions:

	deviceValue, deviceValueText, deviceDigitalStatus, alarmBlockFieldValue,
	extractAlarmHeaderParam, readAlarmBlock

-------------------------------------------------------------------------------

	deviceCalculateExtrema : calculates device extrema values

	success = deviceCalculateExtrema(device [,property] [,minimum]
					 [,maximum] [,rawMinimum] [,rawMaximum])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[minimum]	returned minimum scaled value
	[maximum]	returned maximum scaled value
	[rawMinimum]	returned raw value corresponding to minimum scaled value
	[rawMaximum]	returned raw value corresponding to maximum scaled value

	This function returns values as follows:

	TRUE			extrema were successfully calculated
	FALSE			failed to calculate extrema

	Related functions:

	deviceExtrema, deviceCalculateRawValue

-------------------------------------------------------------------------------

	deviceCalculateRawValue : calculates the raw value corresponding
                                 to a scaled value

	success = deviceCalculateRawValue(device, property, scaledValue
					  [,rawValue] [,deltaValue])

	Arguments:

	device		device of interest
	property	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	scaledValue	scaled value to convert
	[rawValue]	returned raw value corresponding to the scaled value
	[deltaValue]	returned delta between the value found and the target
			scaled value

	This function returns values as follows:

	TRUE			raw value was successfully calculated
	FALSE			failed to calculate raw value

	Related functions:

	deviceCalculateExtrema

-------------------------------------------------------------------------------

	deviceCanAbort : determines if a device can generate an abort alarm

	numEntries = deviceCanAbort(device [,property] [,checkInhibit])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[checkInhibit]	flag indicating whether or not to check the
			abort inhibit flag
			(checkInhibit/true -> check the abort inhibit flag,
			 dontCheckInhibit/false -> don't check the abort
						   inhibit flag (default))

	This function returns values as follows:

	TRUE			device property can cause an abort
	FALSE			device property cannot cause an abort

	Related functions:

	deviceCurrentAlarmText, analogAlarmText, analogAlarmPriority,
	digitalAlarmText, digitalAlarmTextAll

-------------------------------------------------------------------------------

	deviceControlAttributes : returns the control attributes for a device

	numAttrs = deviceControlAttributes(device [,attributes] [,setValues])

	Arguments:

	device		device of interest
	[attributes]	returned attribute names
	[setValues]	returned setting values

	This function returns values as follows:

	number of control attributes

	Related functions:

	hasControlAttribute, digitalControlInfoAll, digitalControlInfo,
	deviceStatusScalingAll, deviceStatusScaling, hasStatusAttribute

-------------------------------------------------------------------------------

	deviceControlledDevices : returns the devices controlled by a device

	numControlled = deviceControlledDevices(device [,controlledDevices])

	Arguments:

	device			device of interest
	[controlledDevices]	returned devices which are controlled by
				this device

	This function returns values as follows:

	number of devices which are controlled by this device

	Related functions:

	controllingDevice, virtualMachineDevices, deviceInCompositeDevices,
	deviceInFamilies

-------------------------------------------------------------------------------

	deviceCreator : returns the user who created a device

	creator = deviceCreator(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	user who created a device

	Related functions:

	deviceLastModifier, deviceLastModifiedDate, device

-------------------------------------------------------------------------------

	deviceCurrentAlarmText : returns the current alarm text for a device

	numEntries = deviceCurrentAlarmText(device [,textType] [,alarmText]
					    [,returnTypes] [,timestamps]
					    [,rawData] [,masks])

	Arguments:

	device		device of interest
	[textType]	desired alarm text type
			(analog,
			 digital,
			 both (default))
	[alarmText]	returned alarm text strings
	[returnTypes]	returned alarm text types
			(analog,
			 digital)
	[timestamps]	returned alarm timestamps
	[rawData]	returned raw data values
	[masks]		returned mask values
			(only meaningful for digital alarms)

	This function returns values as follows:

	number of current alarm text entries

	Related functions:

	currentAnalogAlarmText, analogAlarmText, analogAlarmPriority,
	digitalAlarmText, digitalAlarmTextAll

-------------------------------------------------------------------------------

	deviceDefaultDataEvent : returns the default data event for a property

	defaultDataEvent = deviceDefaultDataEvent(device [,property])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	device property's default data event

	Related functions:

	deviceDefaultFtd

-------------------------------------------------------------------------------

	deviceDefaultFtd : returns the default FTD for a property

	defaultFtd = deviceDefaultFtd(device [,property] [,dataType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[dataType]	data type to return
			(string -> return FTD string (default),
			 dabbelString -> return FTD string (DABBEL format),
			 number -> return FTD numeric value)

	This function returns values as follows:

	device property's default FTD

	Related functions:

	deviceDefaultDataEvent

-------------------------------------------------------------------------------

	deviceDefaultLength : returns the default length of a device property
			      in bytes

	length = deviceDefaultLength(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	default length of the device/property in bytes

	Related functions:

	devicePropertyLengths, deviceAtomicLength, deviceMaximumLength,
	deviceScalingLength, isArrayDevice, device

-------------------------------------------------------------------------------

	deviceDepartment : returns the department responsible for a device

	department = deviceDepartment(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	department responsible for a device

	Related functions:

	deviceMaintainer, device

-------------------------------------------------------------------------------

	deviceDescriptionSearch : searches for all devices whose text match
                                 a string

	numDevices = deviceDescriptionSearch(string [,deviceNames])

	Arguments:

	string		string to match to device descriptive text
	[deviceNames]	returned matching device names

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceFullDescriptionSearch, genericDeviceSearch, deviceNameSearch,
	deviceFullNameSearch, deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceDigitalStatus : returns a device digital status value

	status = deviceDigitalStatus(device [,onOffStatus] [,readyTripStatus]
				     [,remoteLocalStatus] [,polarityStatus]
				     [,rampDcStatus] [,statusType] [,arrayIndex]
				     [,dataEvent] [,dataSource])

	Arguments:

	device			device of interest
	[onOffStatus]		returned on/off status
	[readyTripStatus]	returned ready/tripped status
	[remoteLocalStatus]	returned remote/local status
	[polarityStatus]	returned polarity status
	[rampDcStatus]		returned ramp/DC status
	[statusType]		type of status to return
				(logicals -> logical value (default),
				 shortStrings -> short strings,
				 longStrings -> long strings)
	[arrayIndex]		device array index (default is 0)
	[dataEvent]		device reading data event
				(default is database default)
	[dataSource]		device data source (default is accelerator)

	This function returns values as follows:

	composite status string

	Related functions:

	deviceValue, deviceValueText, deviceStatusScaling,
	deviceStatusScalingAll, hasStatusAttribute, deviceCalculatedValue

-------------------------------------------------------------------------------

	deviceDisplayInfo : returns device value display information

	convertLength = deviceDisplayInfo(device [,property]
					  [,convertType] [,dataManip])

	Arguments:

	device			device/property of interest
	[property]		desired property
				(reading,
				 setting)
				(default is the implicit property from the
				 device argument)
	[convertType]		returned display value conversion type
				(CNV_xxx)
	[dataManip]		returned display value conversion data
				manipulation type
				(none -> no data manipulation,
				 swap bytes,
				 swap words)

	This function returns values as follows:

	device display length

	Related functions:

	deviceReadSetScaling, deviceReadSetExtScaling, deviceScalingLength,
	units, deviceRawToScaled, deviceRawToScaledCustom, deviceScaledToRaw,
	deviceScaledToRawCustom, deviceValue, deviceValueText,
	deviceReadSetHistoricScaling, deviceCalculatedValue

-------------------------------------------------------------------------------

	deviceDownloadProperties : returns the download properties associated
                                  with a device

	numProperties = deviceDownloadProperties(device [,properties]
						 [,filterProps])

	Arguments:

	device		device of interest
	[properties]	returned array of properties found
	[filterProps]	property or properties to match
			(If you want to match multiple properties,
			 separate property strings with an '|'
			 or ',' character.)
			(default is all properties)

	This function returns values as follows:

	number of download properties found for the requested device

	Related functions:

	deviceIsDownloaded, deviceProperties, numReadableProperties,
	numSettableProperties, hasProperty, hasReading, hasSetting,
	hasStatus, hasControl, hasAnalogAlarm, hasDigitalAlarm, device

-------------------------------------------------------------------------------

	deviceEmc : returns the EMC for a device property

	emcLongword = deviceEmc(device, emc [,property])

	Arguments:

	device		device/property of interest
	emc		returned EMC value
			(If this argument has a data type of short,
			 the EMC value is returned as 4 shorts.
			 If this argument has a data type of integer,
			 the EMC value is returned as 2 integers.
			 Otherwise, the EMC is returned as 8 bytes.)
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	first 4 bytes of the EMC

	Related functions:

	deviceSsdn

-------------------------------------------------------------------------------

	deviceExpression : returns the expression for a device

	expression = deviceExpression(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device expression

	Related functions:

	name

-------------------------------------------------------------------------------

	deviceExtrema : returns device extrema values

	success = deviceExtrema(device [,property] [,minimum] [,maximum])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[minimum]	returned minimum scaled value
	[maximum]	returned maximum scaled value

	This function returns values as follows:

	TRUE			extrema were successfully retrieved
	FALSE			failed to retrieve extrema

	Related functions:

	deviceCalculateExtrema

-------------------------------------------------------------------------------

	deviceFamilyMembers : returns the members of a family device

	numMembers = deviceFamilyMembers(device [,members] [,fullNames])

	Arguments:

	device		device of interest (should be a family device)
	[members]	returned family member devices
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of family members

	Related functions:

	deviceInFamilies, deviceInCompositeDevices, deviceControlledDevices,
	virtualMachineDevices

-------------------------------------------------------------------------------

	deviceForeignDeviceInfo : returns foreign device information for
                                 a device

	numEntries = deviceForeignDeviceInfo(device [,property] [,wantStrings]
					     [,pvNames] [,dataTypes]
					     [,controlSystems] [,dataLengths]
					     [,startIndices] [,numElements]
					     [,fieldNumbers])

	Arguments:

	device		 device of interest
	[property]	 desired property value
			 (property name or property index)
	[wantStrings]	 flag indicating whether to return strings or numeric
			 values for the data type and control system arguments
			 (string (default)
			  numeric)
	[pvNames]	 returned process variable names
	[dataTypes]	 returned data types
	[controlSystems] returned control system types
	[dataLengths]	 returned data lengths in bytes
	[startIndices]	 returned starting array indices
	[numElements]	 returned number of elements values
	[fieldNumbers]	 returned field number values

	This function returns values as follows:

	returned number of entries

	Related functions:

	none

-------------------------------------------------------------------------------

	deviceFullDescriptionSearch : searches for all devices whose full
                                     descriptions match a string

	numDevices = deviceFullDescriptionSearch(string [,deviceNames])

	Arguments:

	string		string to match to device full descriptions
	[deviceNames]	returned matching device full names

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceDescriptionSearch, genericDeviceSearch, deviceFullNameSearch,
	deviceNameSearch, deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceFullNameSearch : searches for all devices whose full names
                              match a string

	numDevices = deviceFullNameSearch(string [,deviceNames])

	Arguments:

	string		string to match to device full names
	[deviceNames]	returned matching device full names

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceNameSearch, genericDeviceSearch, deviceDescriptionSearch,
	deviceFullDescriptionSearch, deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceFullNameToName : returns the device name corresponding to a
                              full name

	name = deviceFullNameToName(fullName)

	Arguments:

	fullName	full name to convert

	This function returns values as follows:

	corresponding normal device name

	Related functions:

	deviceNameToFullName, stringToDeviceName

-------------------------------------------------------------------------------

	deviceInCompositeDevices : returns composite devices which use a
                                  given device

	numComposites = deviceInCompositeDevices(device [,composites])

	Arguments:

	device		device of interest
	[composites]	returned composite devices which use this device

	This function returns values as follows:

	number of composite devices which use this device

	Related functions:

	deviceInFamilies

-------------------------------------------------------------------------------

	deviceIndex : converts an ACNET device to a device index value

	deviceIndex = deviceIndex(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device index value

	Related functions:

	device, name, fullName, text, fullText, deviceSpec

-------------------------------------------------------------------------------

	deviceInFamilies : returns families that a device is a member of

	numFamilies = deviceInFamilies(device [,families])

	Arguments:

	device		device of interest
	[families]	returned families that the device is a membe of

	This function returns values as follows:

	number of families that the device is a membe of

	Related functions:

	deviceFamilyMembers, deviceInCompositeDevices

-------------------------------------------------------------------------------

	deviceIsAlarmConsolidator : determines if a device is an alarm
                                   consolidator

	isConsolidator = deviceIsAlarmConsolidator(device [,isTopLevel])

	Arguments:

	device		device to check
	[isTopLevel]	returned logical indicating whether or not this
			is a top level alarm consolidator
			(true -> is top level,
			 false -> is not a top level consolidator)

	This function returns values as follows:

	TRUE			device is an alarm consolidator
	FALSE			device is not an alarm consolidator

	Related functions:

	deviceAlarmGroupInfo, deviceIsInAlarmGroup, deviceAlarmList

-------------------------------------------------------------------------------

	deviceIsDownloaded : determines if a device property is downloaded
                            upon front end reboot

	isDownloaded = deviceIsDownloaded(device [,property])

	Arguments:

	device		device to check
	[property]	desired property
			(setting,
			 basicControl,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the
			 device argument)

	This function returns values as follows:

	TRUE			device property is downloaded upon reboot
	FALSE			device property is not downloaded upon reboot

	Related functions:

	deviceDownloadProperties

-------------------------------------------------------------------------------

	deviceIsInAlarmGroup : determines if a device is a member of an
                              alarm group

	inAlarmGroup = deviceIsInAlarmGroup(device)

	Arguments:

	device		device to check

	This function returns values as follows:

	TRUE			device is a member of an alarm group
	FALSE			device is not a member of an alarm group

	Related functions:

	deviceAlarmGroupInfo, deviceIsAlarmConsolidator, deviceAlarmList

-------------------------------------------------------------------------------

	deviceIsSettableByClass : determines if a device can be set by a
                                 console class

	isSettable = deviceIsSettableByClass(device, console_class)

	Arguments:

	device		device of interest
	console_class	class(es) to test for

	This function returns values as follows:

	logical value which indicates whether or not the device can be set

	Related functions:

	settingsAreEnabled, deviceProtectionMask

-------------------------------------------------------------------------------

	deviceIsStepMotor : determines if a device is a step motor

	isSettable = deviceIsStepMotor(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device is a step motor
	FALSE			device is not a step motor

	Related functions:

	deviceIsTimer, deviceIsTimerRef, isMoocDevice, isOacDevice, isIrmDevice,
	isLabviewDevice, isAcsysFefDevice

-------------------------------------------------------------------------------

	deviceIsTimer : determines if a device is a timer

	isTimer = deviceIsTimer(device [,eventType])

	Arguments:

	device		device of interest
	[eventType]	returned clock event type for this timer
			(tclk -> TCLK event,
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nclk -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	TRUE			device is a timer
	FALSE			device is not a timer

	Related functions:

	deviceIsTimerRef, timerReadEvents, deviceIsStepMotor, isMoocDevice,
	isOacDevice, isIrmDevice, isLabviewDevice, isAcsysFefDevice

-------------------------------------------------------------------------------

	deviceIsTimerRef : determines if a device is a timer reference

	isTimerRef = deviceIsTimerRef(device [,eventType])

	Arguments:

	device		device of interest
	[eventType]	returned clock event type for this timer
			(tclk -> TCLK event,
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nclk -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	TRUE			device is a timer reference
	FALSE			device is not a timer reference

	Related functions:

	deviceIsTimer, timerReadEvents, deviceIsStepMotor, isMoocDevice,
	isOacDevice, isIrmDevice, isLabviewDevice, isAcsysFefDevice

-------------------------------------------------------------------------------

	deviceLastModifiedDate : returns the date when a device was last
                                modified

	date = deviceLastModifiedDate(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	date when the device was last modified

	Related functions:

	deviceLastModifier, deviceCreator, device

-------------------------------------------------------------------------------

	deviceLastModifier : returns the user who last modified a device

	modifier = deviceLastModifier(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	user who last modified a device

	Related functions:

	deviceLastModifiedDate, deviceCreator, device

-------------------------------------------------------------------------------

	deviceListing : creates formatted device information strings

	numLines = deviceListing(devices [,numDevices] [,formatString]
				 [,strings] [,dataSource] [,headerFlag]
				 [,filters])

	Arguments:

	devices		devices to cache database information for
			(either an array of device names or a
			 device list specifier (deviceList={list}))
	[numDevices]	number of devices (default is all devices specified)
	[formatString]	output format string
			(%nm -> output device name,
			 %tx -> output device description,
			 etc.)
			(See the ACL list command help for more format
			 specifier options.  You can also see the help
			 for the CLIB routine device_listing_c.)
	[strings]	returned output strings (one per device)
	[dataSource]	data source for reading output fields
			(accelerator -> live readings (default),
			 db -> database,
			 sr:{file} -> save/restore file,
			 sda:{file}:{case}:{set}:usage} -> SDA data set,
			 dl:{date}:{node} -> data logger)
	[headerFlag]	header line flag
			{noHeaders (default),
			 allowHeaders)
	[filters]	comma separated device filters
			(hasReading -> only include devices having a reading,
			 hasSetting -> only include devices having a setting,
			 hasStatus -> only include devices having status,
			 hasControl -> only include devices having control,
			 hasAnalogAlarm -> only include devices having an
					   analog alarm,
			 hasDigitalAlarm -> only include devices having a
					    digital alarm,
			 analogAlarm -> only include devices in analog alarm,
			 analogBypassed -> only include devices with their
					    analog alarm bypassed,
			 digitalAlarm -> only include devices in digital alarm,
			 digitalBypassed -> only include devices with their
					    digital alarm bypassed,
			 broken/oos -> only include devices that are marked as
				       broken/out of service,
			 readingArray -> only include devices whose reading
					 property is an array,
			 settingArray -> only include devices whose setting
					 property is an array,
			 statusArray -> only include devices whose status
					property is an array,
			 readSizeMismatch -> only include devices whose
					     default reading property length
					     does not match its scaling length,
			 setSizeMismatch -> only include devices whose
					    default setting property length
					    does not match its scaling length)

	This function returns status values as follows:

	number of strings returned

	Related functions:

	genericDeviceSearch, deviceNameSearch, deviceFullNameSearch,
	deviceDescriptionSearch, deviceFullDescriptionSearch, deviceNodeSearch,
	deviceSsdnSearch, cacheDeviceInfo

-------------------------------------------------------------------------------

	deviceListToDevices : retrieves the devices from a device list

	numDevices = deviceListToDevices(listName [,deviceNames] [,properties]
					 [,filterProps] [,fullNames])

	Arguments:

	listName	device list name
	[deviceNames]	returned device names
	[properties]	returned array of properties found
	[filterProps]	property or properties to match
			(If you want to match multiple properties,
			 separate property strings with an '|'
			 or ',' character.)
			(default is all properties)
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices

	Related functions:

	genericDeviceSearch, deviceNameSearch, deviceFullNameSearch,
	deviceDescriptionSearch, deviceFullDescriptionSearch,
	deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceLocation : returns location information for a device/property

	machine = deviceLocation(device [,property] [,rack] [,xCoord] [,yCoord]
				 [,zCoord] [,crate] [,slot] [,channel]
				 [,madcNumber] [,madcChannel])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[rack]		returned rack string
	[xCoord]	returned X coordinate
	[yCoord]	returned Y coordinate
	[zCoord]	returned Z coordinate
	[crate]		returned crate number
	[slot]		returned slot number
	[channel]	returned channel number
	[madcNumber]	returned MADC number
	[madcChannel]	returned MADC channel number

	This function returns values as follows:

	device location string

	Related functions:

	deviceMachine, deviceArea

-------------------------------------------------------------------------------

	deviceLoggerDataEvents : returns the data events that a device is
                                logged on

	numLogged = deviceLoggerDataEvents(device [,dataEvents] [,loggerNodes]
					   [,loggerLists] [,deviceNames])

	Arguments:

	device		device of interest
	[dataEvents]	returned data events
	[loggerNodes]	returned logger nodes
	[loggerLists]	returned logger list numbers (0-17)
	[deviceNames]	returned device names

	This function returns values as follows:

	number of locations where the device is being logged

	Related functions:

	whereDeviceIsLogged, whereDeviceWasLogged, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	oldestLoggerTime, loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	loggerIsUp, loggerIsEnabled

-------------------------------------------------------------------------------

	deviceMachine : returns the machine associated with a device

	machine = deviceMachine(device [,dataType])

	Arguments:

	device		device of interest
	[dataType]	data type to return
			(name -> return machine name (default),
			 number -> return machine number)

	This function returns values as follows:

	associated machine value

	Related functions:

	deviceArea, deviceLocation

-------------------------------------------------------------------------------

	deviceMadcLocation : returns the MADC location of a device

	madcNumber = deviceMadcLocation(device [,node] [,madcChannel])

	Arguments:

	device		desired device
	[node]		returned MADC node
	[madcChannel]	returned MADC channel

	This function returns values as follows:

	MADC number (0 if not an MADC)

	Related functions:

	madcNumChannels, madcNumAvailableLists, madcNumAvailablePlotChannels,
	madcNumAvailableClockLevels

-------------------------------------------------------------------------------

	deviceMaintainer : returns the person responsible for
                          maintaining a device

	maintainer = deviceMaintainer(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	person responsible for maintaining a device

	Related functions:

	deviceDepartment, device

-------------------------------------------------------------------------------

	deviceMaximumLength : returns the maximum length of a device property
			      in bytes

	length = deviceMaximumLength(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	maximum length of the device/property in bytes

	Related functions:

	devicePropertyLengths, deviceDefaultLength, deviceAtomicLength,
	deviceScalingLength, isArrayDevice, device

-------------------------------------------------------------------------------

	deviceNameExists : determines if a string is an existing device name

	boolean = deviceNameExists(string [,nameType])

	Arguments:

	string		string to test
	[nameType]	type of device name
			(classicName (default),
			 fullName)

	This function returns values as follows:

	TRUE			device name exists
	FALSE			device name does not exist

	Related functions:

	exists, name, fullName, historicName

-------------------------------------------------------------------------------

	deviceNameSearch : searches for all devices whose names match a string

	numDevices = deviceNameSearch(string [,deviceNames])

	Arguments:

	string		string to match to device names
	[deviceNames]	returned matching device names

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceFullNameSearch, genericDeviceSearch, deviceDescriptionSearch,
	deviceFullDescriptionSearch, deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceNameToFullName : returns the full device name corresponding
			       to a name

	fullName = deviceNameToFullName(name)

	Arguments:

	name		device name to convert

	This function returns values as follows:

	corresponding full device name

	Related functions:

	deviceFullNameToName, stringToDeviceName

-------------------------------------------------------------------------------

	deviceNode : returns the source node for a device property

	node = deviceNode(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	device node

	Related functions:

	deviceNodeType, isMoocDevice, isIrmDevice, isOacDevice, isLabviewDevice,
	isAcsysFefDevice, name, fullName, text, fullText, deviceAtomicLength,
	deviceDefaultLength, deviceMaximumLength

-------------------------------------------------------------------------------

	deviceNodeSearch : searches for all devices from a given node

	numDevices = deviceNodeSearch(node [,deviceNames] [,property])

	Arguments:

	node		node to match
	[deviceNames]	returned matching device names
	[property]	property or properties to match
			(If you want to match multiple properties,
			 separate property strings with an '|'
			 or ',' character.)
			(default is all properties)

	This function returns values as follows:

	number of matching device names

	Related functions:

	genericDeviceSearch, deviceNameSearch, deviceFullNameSearch,
	deviceDescriptionSearch, deviceFullDescriptionSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	deviceNodeType : returns the node type for a device property

	nodeType = deviceNodeType(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	string indicating the device node type

	Related functions:

	deviceNode, isMoocDevice, isIrmDevice, isOacDevice, isLabviewDevice,
	isAcsysFefDevice

-------------------------------------------------------------------------------

	deviceOffset : returns the offset and length in bytes for a device spec

	offset = deviceOffset(deviceSpec [,length])

	Arguments:

	deviceSpec	device specification to query
	[length]	returned length in bytes value

	This function returns values as follows:

	device offset value in bytes

	Related functions:

	deviceSpecExtractValues, name, device, deviceArrayIndex, deviceProperty,
	deviceSpec, deviceSpecToString

-------------------------------------------------------------------------------

	deviceParameterPageMapping : returns device parameter page mapping
                                    instances

	numSubpages = deviceParameterPageMapping(device [,pages] [,subpageText]
						 [,subpages] [,rows]
						 [,arrayIndices])

	Arguments:

	device		device to search for
	[pages]		returned matching parameter pages
	[subpageText]	returned subpage text including page title
	[subpages]	returned matching subpages (integer)
	[rows]		returned matching subpage rows
	[arrayIndices]	returned matching device array indices

	This function returns values as follows:

	number of matching parameter page subpages

	Related functions:

	parameterPageDevices, paramPageConfigInfo, paramPageSubpageMenuTitles,
	paramPageSubpageInfo

-------------------------------------------------------------------------------

	devicePrimaryToScaled : scales a primary device value

	value = devicePrimaryToScaled(device, primaryValue [,property]
				      [,unitsText])

	Arguments:

	device		device to use for scaling
	primaryValue	primary data value
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the
			 device argument)
	[unitsText]	common scaling units text

	This function returns values as follows:

	value corresponding to the requested primary data

	Related functions:

	deviceScaledToPrimary, devicePrimaryToScaledCustom, deviceRawToScaled,
	deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom,
	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToEnumText, deviceRawToHistoricScaled 

-------------------------------------------------------------------------------

	devicePrimaryToScaledCustom : scale a primary device value using
                                     caller-supplied scaling parameters

	value = devicePrimaryToScaledCustom(primaryValue commonTrans
					    [,constant1..6])

	Arguments:

	primaryValue	primary data value
	commonTrans	common transform number
	[constant1..6]	up to 6 scaling constants for the common transform

	This function returns values as follows:

	value corresponding to the requested primary data

	Related functions:

	devicePrimaryToScaled, deviceScaledToPrimary, deviceRawToScaled,
	deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom,
	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToEnumText, deviceRawToHistoricScaled 

-------------------------------------------------------------------------------

	deviceProperties : returns the properties associated with a device

	numProperties = deviceProperties(device [,properties] [,filterProps])

	Arguments:

	device		device of interest
	[properties]	returned array of properties found
	[filterProps]	property or properties to match
			(If you want to match multiple properties,
			 separate property strings with an '|'
			 or ',' character.)
			(default is all properties)

	This function returns values as follows:

	number of properties found for the requested device

	Related functions:

	numReadableProperties, numSettableProperties, hasProperty, hasReading,
	hasSetting, hasStatus, hasControl, hasAnalogAlarm, hasDigitalAlarm,
	deviceDownloadProperties, device

-------------------------------------------------------------------------------

	deviceProperty : returns the property value from a device spec

	property = deviceProperty(deviceSpec [,propertyFormat])

	Arguments:

	deviceSpec	 device specification to query
	[propertyFormat] desired returned property format
			 (string (default),
			  longString,
			  integer)

	This function returns values as follows:

	device property value

	Related functions:

	deviceSpecExtractValues, name, device, deviceArrayIndex, deviceOffset,
	deviceSpec, deviceSpecToString

-------------------------------------------------------------------------------

	devicePropertyLengths : returns device property lengths

	defaultLength = devicePropertyLengths(device [,property]
					      [,maximumLength] [,atomicLength]
					      [,scalingLength])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[maximumLength]	returned maximum length
	[atomicLength]	returned atomic length
	[scalingLength]	returned scaling length

	This function returns values as follows:

	default length of the device/property in bytes

	Related functions:

	deviceDefaultLength, deviceAtomicLength, deviceMaximumLength,
	deviceScalingLength, isArrayDevice, device

-------------------------------------------------------------------------------

	deviceProtectionMask : returns the device setting protection mask

	protectionMask = deviceProtectionMask(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device protection mask

	Related functions:

	deviceIsSettableByClass, consoleClassMaskToString,
	stringToConsoleClassMask, name, fullName, text, fullText,
	deviceAtomicLength, deviceDefaultLength, deviceMaximumLength

-------------------------------------------------------------------------------

	deviceRawDataType : returns the raw data type for a device/property

	rawDataType = deviceRawDataType(device [,property] [,dataType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[dataType]	data type to return
			(name -> return data type string (default),
			 number -> return data type number)

	This function returns values as follows:

	device property's raw data type

	Related functions:

	historicRawDataType, deviceReadSetScaling, devicePropertyLengths,
	deviceDefaultLength, deviceAddressingMode

-------------------------------------------------------------------------------

	deviceRawToControlText : scale a raw control value to a text string

	string = deviceRawToControlText(device, rawValue [,stringType])

	Arguments:

	device		device to use for scaling
	rawValue	raw control value
	[stringType]	string type
			(short -> short text (default),
			 long -> long text)

	This function returns values as follows:

	string corresponding to the requested control value

	Related functions:

	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToEnumText,
	deviceRawToScaled, deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom

-------------------------------------------------------------------------------

	deviceRawToEnumText : scale a raw enumerated reading value to a
			      text string

	string = deviceRawToEnumText(device, rawValue [,stringType])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	[stringType]	string type
			(short -> short text (default),
			 long -> long text)

	This function returns values as follows:

	string corresponding to the requested data value

	Related functions:

	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToScaled, deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom

-------------------------------------------------------------------------------

	deviceRawToHistoricScaled : scale a raw device value using historic
                                   scaling

	value = deviceRawToHistoricScaled(device, rawValue, date
					  [,statusAttr])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	date		date of scaling information
	[statusAttr]	status attribute for basic status request
			(onOff -> on/off status,
			 readyTripped -> ready/tripped status,
			 remoteLocal -> remote/local status,
			 polarity -> positive/negative status,
			 rampDC -> ramp/DC status)

	This function returns values as follows:

	value corresponding to the requested raw data

	Related functions:

	deviceRawToScaled, deviceRawToScaledCustom, deviceRawToValueText,
	deviceRawToValueTextCustom, deviceScaledToRaw, deviceScaledToRawCustom,
	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToEnumText

-------------------------------------------------------------------------------

	deviceRawToScaled : scale a raw device value

	value = deviceRawToScaled(device, rawValue [,statusAttr] [,property])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	[statusAttr]	status attribute for basic status request
			(onOff -> on/off status,
			 readyTripped -> ready/tripped status,
			 remoteLocal -> remote/local status,
			 polarity -> positive/negative status,
			 rampDC -> ramp/DC status)
	[property]	desired property
			(reading,
			 setting,
			 status)
			(default is the implicit property from the
			 device argument)

	This function returns values as follows:

	value corresponding to the requested raw data

	Related functions:

	deviceRawToValueText, deviceRawToScaledCustom,
	deviceRawToValueTextCustom, deviceScaledToRaw, deviceScaledToRawCustom,
	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToEnumText, deviceRawToHistoricScaled 

-------------------------------------------------------------------------------

	deviceRawToScaledCustom : scale a raw device value using
				  caller-supplied scaling parameters

	value = deviceRawToScaledCustom(device, rawValue, primaryTrans,
					commonTrans [,constant1..6])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	primaryTrans	primary transform number
	commonTrans	common transform number
	[constant1..6]	up to 6 scaling constants for the common transform

	This function returns values as follows:

	value corresponding to the requested raw data

	Related functions:

	deviceRawToScaled, deviceRawToValueText, deviceRawToValueTextCustom,
	deviceScaledToRaw, deviceScaledToRawCustom, deviceRawToStatusText,
	deviceRawToStatusValue, deviceRawToControlText, deviceRawToEnumText

-------------------------------------------------------------------------------

	deviceRawToStatusText : scale a raw status value to a text string

	string = deviceRawToStatusText(device, rawValue, statusAttr)

	Arguments:

	device		device to use for scaling
	rawValue	raw status value
	statusAttr	string indicating which status attribute is desired
			(onOff -> on/off status,
			 readyTripped -> ready/tripped status,
			 remoteLocal -> remote/local status,
			 polarity -> positive/negative status,
			 rampDC -> ramp/DC status)

	This function returns values as follows:

	string corresponding to the requested status attribute

	Related functions:

	deviceRawToStatusValue, deviceRawToControlText, deviceRawToEnumText,
	deviceRawToScaled, deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom

-------------------------------------------------------------------------------

	deviceRawToStatusValue : scale a raw status value to a boolean
				 attribute value

	status = deviceRawToStatusValue(device, rawValue, statusAttr)

	Arguments:

	device		device to use for scaling
	rawValue	raw status value
	statusAttr	string indicating which status attribute is desired
			(onOff -> on/off status,
			 readyTripped -> ready/tripped status,
			 remoteLocal -> remote/local status,
			 polarity -> positive/negative status,
			 rampDC -> ramp/DC status)

	This function returns values as follows:

	TRUE			"first" status asserted
	FALSE			"second" status asserted

	Related functions:

	deviceRawToStatusText, deviceRawToControlText, deviceRawToEnumText,
	deviceRawToScaled, deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom

-------------------------------------------------------------------------------

	deviceRawToValueText : scale a raw value to its corresponding string

	string = deviceRawToValueText(device, rawValue [,statusAttr]
				      [,property])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	[statusAttr]	status attribute for basic status request
			(composite -> composite text (default),
			 onOff -> on/off status,
			 readyTripped -> ready/tripped status,
			 remoteLocal -> remote/local status,
			 polarity -> positive/negative status,
			 rampDC -> ramp/DC status)
	[property]	desired property
			(reading,
			 setting,
			 status)
			(default is the implicit property from the
			 device argument)

	This function returns values as follows:

	string corresponding to the requested raw data

	Related functions:

	deviceRawToValueTextCustom, deviceRawToScaled, deviceRawToScaledCustom,
	deviceScaledToRaw, deviceScaledToRawCustom, deviceRawToStatusText,
	deviceRawToStatusValue, deviceRawToControlText, deviceRawToEnumText,
	deviceRawToHistoricScaled 

-------------------------------------------------------------------------------

	deviceRawToValueTextCustom : scale a raw value to its corresponding
                                    string using caller-supplied scaling

	string = deviceRawToValueTextCustom(device, rawValue [,stringLength]
					    [,stringFormat] [,primaryTrans]
					    [,commonTrans] [,constant1...6])

	Arguments:

	device		device to use for scaling
	rawValue	raw data value
	[stringLength]	desired string length
			(default is the default length for the scaling type)
	[stringFormat]	desired string format
			(noSpaces - simple trimmed string (default),
			 spacePadded - blank padded to the requested length,
			 uniformLength - blank padded to 10 characters)
	[primaryTrans]	primary transform number
			(default is the device's current primary transform)
	[commonTrans]	common transform number
			(default is the device's current common transform)
	[constant1...6]	up to 6 scaling constants for the common transform

	This function returns values as follows:

	value corresponding to the requested raw data

	Related functions:

	deviceRawToValueText, deviceRawToScaledCustom, deviceRawToScaled,
	deviceScaledToRaw, deviceScaledToRawCustom, deviceRawToStatusText,
	deviceRawToStatusValue, deviceRawToControlText, deviceRawToEnumText

-------------------------------------------------------------------------------

	deviceReadSetExtScaling : return extended reading or setting scaling
				  information

	commonTransform = deviceReadSetExtScaling(device [,property]
						  [,primaryTransform]
						  [,commonTransform]
						  [,numConstants] [,constants]
						  [,primaryUnits] [,commonUnits]
						  [,scalingLength]
						  [,displayLength]
						  [,displayType])

	Arguments:

	device			device/property of interest
	[property]		desired property
				(reading,
				 setting)
				(default is the implicit property from the
				 device argument)
	[primaryTransform]	primary transform number
	[commonTransform]	common transform number
	[numConstants]		number of scaling constants
	[constants]		array of scaling constants
				(numConstants values)
	[primaryUnits]		primary scaling units text
	[commonUnits]		common scaling units text
	[scalingLength]		scaling data length in bytes
	[displayLength]		default number of characters to display
	[displayType]		display value conversion type

	This function returns values as follows:

	common transform number

	Related functions:

	deviceReadSetScaling, deviceReadSetHistoricScaling, deviceDisplayInfo,
	deviceScalingLength, units, deviceRawToScaled, deviceRawToScaledCustom,
	deviceScaledToRaw, deviceScaledToRawCustom, deviceValue,
	deviceValueText, deviceCalculatedValue

-------------------------------------------------------------------------------

	deviceReadSetHistoricScaling : return reading or setting historic
                                      scaling information

	commonTransform = deviceReadSetHistoricScaling(device, date [,property]
						       [,primaryTransform]
						       [,commonTransform]
						       [,numConstants]
						       [,constants]
						       [,primaryUnits]
						       [,commonUnits]
						       [,scalingLength]
						       [,displayLength]
						       [,displayType])

	Arguments:

	device			device/property of interest
	date			date of scaling information
	[property]		desired property
				(reading,
				 setting)
				(default is the implicit property from the
				 device argument)
	[primaryTransform]	primary transform number
	[commonTransform]	common transform number
	[numConstants]		number of scaling constants
	[constants]		array of scaling constants
				(numConstants values)
	[primaryUnits]		primary scaling units text
	[commonUnits]		common scaling units text
	[scalingLength]		scaling data length in bytes
	[displayLength]		default number of characters to display
	[displayType]		display value conversion type

	This function returns values as follows:

	common transform number

	Related functions:

	deviceReadSetScaling, deviceReadSetExtScaling, deviceDisplayInfo,
	deviceScalingLength, units, deviceRawToScaled, deviceRawToScaledCustom,
	deviceScaledToRaw, deviceScaledToRawCustom, deviceValue,
	deviceValueText, deviceCalculatedValue

-------------------------------------------------------------------------------

	deviceReadSetScaling : return reading or setting scaling information

	commonTransform = deviceReadSetScaling(device [,property]
					       [,primaryTransform]
					       [,commonTransform]
					       [,numConstants] [,constants]
					       [,primaryUnits] [,commonUnits]
					       [,scalingLength] [,displayLength]
					       [,displayType])

	Arguments:

	device			device/property of interest
	[property]		desired property
				(reading,
				 setting)
				(default is the implicit property from the
				 device argument)
	[primaryTransform]	returned primary transform number
	[commonTransform]	returned common transform number
	[numConstants]		returned number of scaling constants
	[constants]		returned array of scaling constants
				(numConstants values)
	[primaryUnits]		returned primary scaling units text
	[commonUnits]		returned common scaling units text
	[scalingLength]		returned scaling data length in bytes
	[displayLength]		returned default number of characters to display
	[displayType]		returned display value conversion type

	This function returns values as follows:

	common transform number

	Related functions:

	deviceReadSetExtScaling, deviceReadSetHistoricScaling,
	deviceDisplayInfo, deviceScalingLength, units, deviceRawToScaled,
	deviceRawToScaledCustom, deviceScaledToRaw, deviceScaledToRawCustom,
	deviceValue, deviceValueText, deviceCalculatedValue

-------------------------------------------------------------------------------

	deviceSaveInfo : returns save/restore configuration info for a device

	saveList = deviceSaveInfo(device [,saveProps] [,numProps] [,saveCode]
				  [,saveSubcode] [,displayCode] [,displaySubcode]
				  [,dataType])

	Arguments:

	device		 device of interest
	[saveProps]	 returned save properties
	[numProps]	 returned number of properties
	[saveCode]	 returned save code
	[saveSubcode]	 returned save subcode
	[displayCode]	 returned display code
	[displaySubcode] returned display subcode
	[dataType]	 data type to return
			 (name -> return save list name (default),
			  number -> return save list number)

	This function returns values as follows:

	device save list

	Related functions:

	deviceSaveList

-------------------------------------------------------------------------------

	deviceSaveList : returns the save list for a device

	saveList = deviceSaveList(device [,dataType])

	Arguments:

	device		device of interest
	[dataType]	data type to return
			(name -> return save list name (default),
			 number -> return save list number)

	This function returns values as follows:

	device save list

	Related functions:

	deviceSaveInfo, deviceAlarmList

-------------------------------------------------------------------------------

	deviceScaledToPrimary : convert a scaled device value to a primary value

	value = deviceScaledToPrimary(device, scaledValue [,property]
				      [,unitsText])

	Arguments:

	device		device to use for scaling
	scaledValue	scaled data value
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the
			 device argument)
	[unitsText]	primary scaling units text

	This function returns values as follows:

	primary value corresponding to the requested scaled data

	Related functions:

	devicePrimaryToScaled, devicePrimaryToScaledCustom, deviceScaledToRaw,
	deviceScaledToRawCustom, deviceRawToScaled, deviceRawToScaledCustom,
	deviceRawToStatusText, deviceRawToStatusValue, deviceRawToControlText,
	deviceRawToEnumText

-------------------------------------------------------------------------------

	deviceScaledToRaw : convert a scaled device value to a raw value

	value = deviceScaledToRaw(device, scaledValue [,scalingType])

	Arguments:

	device		device to use for scaling
	scaledValue	scaled data value
			(This will be treated as a floating point value
			 for reading or setting and as a string for
			 basic control values.)
	[scalingType]	scaling type for a reading or setting request
			(common -> engineering units (default),
			 primary -> primary units)

	This function returns values as follows:

	raw value corresponding to the requested scaled data

	Related functions:

	deviceScaledToRawCustom, deviceRawToScaled, deviceRawToScaledCustom,
	deviceScaledToPrimary, deviceRawToStatusText, deviceRawToStatusValue,
	deviceRawToControlText, deviceRawToEnumText, 

-------------------------------------------------------------------------------

	deviceScaledToRawCustom : reverse scale a scaled device value using
				  caller-supplied scaling parameters

	rawValue = deviceScaledToRawCustom(device, scaledValue, primaryTrans,
					   commonTrans [,constant1..6])

	Arguments:

	device		device to use for scaling
	scaledValue	scaled data value
	primaryTrans	primary transform number
	commonTrans	common transform number
	[constant1..6]	up to 6 scaling constants for the common transform

	This function returns values as follows:

	raw value corresponding to the requested scaled value

	Related functions:

	deviceScaledToRaw, deviceRawToScaledCustom, deviceRawToScaled,
	deviceRawToValueText, deviceRawToValueTextCustom,
	deviceRawToStatusText, deviceRawToStatusValue,
	deviceRawToControlText, deviceRawToEnumText

-------------------------------------------------------------------------------

	deviceScalingLength : returns the scaling length of a device property
			      in bytes

	length = deviceScalingLength(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	scaled data length of the device/property in bytes

	Related functions:

	devicePropertyLengths, deviceDefaultLength, deviceAtomicLength,
	deviceMaximumLength, device, deviceReadSetScaling

-------------------------------------------------------------------------------

	deviceSnapManagerFiles : returns information about a device's snap
                                manager data files

	numFiles = deviceSnapManagerFiles(device [,systemNames] [,records]
					  [,dates] [,errors])

	Arguments:

	device		device of interest
	[systemNames]	returned detached snapshot manager system names
			(linac,
			 booster,
			 mainInj
			 tevatron
			 switchyard
			 pbar
			 cryo
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 misc)
	[records]	returned matching file records
	[dates]		returned matching file dates
	[errors]	returned matching file error status values

	This function returns values as follows:

	number of matching files

	Related functions:

	snapManagerFindDevice, snapManagerSystemFiles,
	snapManagerSystemPlotSetups, snapManagerSystemNames,
	snapManagerDataDirectory, snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	deviceSpec : converts a value to a device specification

	deviceIndex = deviceSpec(value, device [,allowObsolete])

	Arguments:

	value		value to convert
			(must be a simple device name with no modifiers)
	device		output device specification
			(variable or changeable device)
	[allowObsolete]	flag indicating whether or not to allow obsolete devices
			(obsolete -> allow obsolete devices,
			 noObsolete -> don't allow obsolete devices (default))

	This function returns values as follows:

	device index value

	Related functions:

	device, deviceSpecExtractValues, deviceSpecToString

-------------------------------------------------------------------------------

	deviceSpecExtractValues : extracts individual parameter values from
                                 a device specification

	device = deviceSpecExtractValues(deviceSpec [,device] [,property]
					 [,arrayIndex] [,numElements]
					 [,offset] [,length] [,wantStrings])

	Arguments:

	deviceSpec	device specification to query
	[device]	returned device value
			(device name or device index)
	[property]	returned property value
			(property name or property index)
	[arrayIndex]	returned array index value
	[numElements]	returned number of elements value
	[offset]	returned offset value
	[length]	returned length value
	[wantStrings]	flag indicating whether to return strings or numeric
			values for the device and property arguments
			(string (default)
			 numeric)

	This function returns values as follows:

	device name or device index value

	Related functions:

	deviceSpec, deviceSpecToString, name, device

-------------------------------------------------------------------------------

	deviceSpecToString : converts a device specification to a string

	string = deviceSpecToString(device [,property] [,arrayIndex]
				    [,propertyName])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[arrayIndex]	array index
			(default is the array index from the device)
	[propertyName]	flag indicating how to represent the property
			(TRUE -> display full property name,
			 FALSE -> indicate property with special character
				  (default))

	This function returns values as follows:

	device specification string

	Related functions:

	deviceSpec, deviceSpecExtractValues, device

-------------------------------------------------------------------------------

	deviceSsdn : returns the SSDN for a device property

	ssdnLongword = deviceSsdn(device, ssdn [,property])

	Arguments:

	device		device/property of interest
	ssdn		returned SSDN value
			(If this argument has a data type of short,
			 the SSDN value is returned as 4 shorts.
			 If this argument has a data type of integer,
			 the SSDN value is returned as 2 integers.
			 Otherwise, the SSDN is returned as 8 bytes.)
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	first 4 bytes of the SSDN

	Related functions:

	ssdnToString, stringToSsdn, name, fullName, text, fullText,
	deviceAtomicLength, deviceDefaultLength, deviceMaximumLength,
	deviceEmc, deviceSsdr

-------------------------------------------------------------------------------

	deviceSsdnSearch : searches for all devices whose SSDNs match a pattern

	numDevices = deviceSsdnSearch(ssdn [,compareFlags] [,deviceNames]
				      [,node] [,fullNames])

	Arguments:

	ssdn		SSDN values to match (8 bytes) or SSDN match string
			having the form of 'xxxx/nnnn/xxxx/xxxx' where bytes
			indicated by 'xx' are not compared
	[compareFlags]	array of 8 logicals indicating which bytes to compare
			(default is to compare all bytes)
			(This argument is ignored if the first argument is
			 an SSDN match string.)
	[deviceNames]	returned matching device names
	[node]		node to match (default is all nodes)
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of matching device names

	Related functions:

	genericDeviceSearch, deviceNameSearch, deviceFullNameSearch,
	deviceDescriptionSearch, deviceFullDescriptionSearch, deviceNodeSearch

-------------------------------------------------------------------------------

	deviceSsdr : returns the SSDR for a device property

	ssdrLength = deviceSsdr(device, ssdr)

	Arguments:

	device		device of interest
	ssdr		returned SSDR value
			(If this argument has a data type of short,
			 the SSDR value is returned as an array of shorts.
			 If this argument has a data type of integer,
			 the SSDR value is returned as an array of integers.
			 Otherwise, the SSDR is returned as an array of bytes.)

	This function returns values as follows:

	length of the SSDR in bytes

	Related functions:

	deviceSsdn, deviceEmc

-------------------------------------------------------------------------------

	deviceState : returns the state of a device
                     (valid, obsolete, or invalid)

	stateString = deviceState(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	valid			valid/normal device
	documentation device	documentation device
	obsolete		obsolete device
	deleted			deleted device
	invalid			invalid device

	Related functions:

	isObsoleteDevice, device, deviceIndex, name, fullName, text,
	fullText, deviceSpec

-------------------------------------------------------------------------------

	deviceStatusScaling : returns status scaling information for a device

	attrExists = deviceStatusScaling(device, attribute [,attrMask]
					 [,invertFlag] [,matchChar]
					 [,nonmatchChar] [,matchColor]
					 [,nonmatchColor] [,altCharFlag])

	Arguments:

	device			device of interest
	attribute		desired status attribute
				(onOff,
				 readyTripped,
				 remoteLocal,
				 positiveNegative,
				 rampDC)
	[attrMask]		returned status attribute mask
	[invertFlag]		returned status data invert flag
	[matchChar]		returned character to display if the data
				matches the mask
	[nonmatchChar]		returned character to display if the data
				does not match the mask
	[matchColor]		returned color to display if the data
				matches the mask
	[nonmatchColor]		returned color to display if the data
				does not match the mask
	[altCharFlag]		returned alternate character definition flag

	This function returns values as follows:

	TRUE			status attribute exists
	FALSE			status attribute does not exist

	Related functions:

	deviceStatusScalingAll, hasStatusAttribute, hasControlAttribute,
	deviceControlAttributes, digitalControlInfo, digitalControlInfoAll,
	deviceScalingLength, deviceReadSetScaling, deviceReadSetExtScaling

-------------------------------------------------------------------------------

	deviceStatusScalingAll : returns all status scaling information for
                                a device

	numAttrs = deviceStatusScalingAll(device [,attrDefFlags]
					  [,attrMasks] [,invertFlags]
					  [,matchChars] [,nonmatchChars]
					  [,matchColors] [,nonmatchColors]
					  [,altCharFlags] [,attrNames])

	Arguments:

	device			device of interest
	[attrDefFlags]		returned status attribute definition flags
	[attrMasks]		returned status attribute masks
	[invertFlags]		returned status data invert flags
	[matchChars]		returned characters to display if the data
				matches the mask
	[nonmatchChars]		returned characters to display if the data
				does not match the mask
	[matchColors]		returned colors to display if the data
				matches the mask
	[nonmatchColors]	returned colors to display if the data
				does not match the mask
	[altCharFlags]		returned alternate character definition flags
	[attrNames]		returned attribute names

	This function returns values as follows:

	number of attribute values returned

	Related functions:

	deviceStatusScaling, hasStatusAttribute, digitalControlInfoAll,
	digitalControlInfo, deviceControlAttributes, hasControlAttribute,
	deviceScalingLength, deviceReadSetScaling, deviceReadSetExtScaling

-------------------------------------------------------------------------------

	deviceStructureName : returns the structure name for a device property

	structureName = deviceStructureName(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	device structure name

	Related functions:

	deviceAtomicLength, deviceDefaultLength, deviceMaximumLength

-------------------------------------------------------------------------------

	deviceType : returns the type of a device property

	type = deviceType(device [,property] [,class] [,source] [,returnType]
			  [,deviceNumber] [,subtype])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[class]		returned device class string
	[source]	source of device type information
			(live -> determine the type at the time of the call
				 (default),
			 db -> return the device type stored in the database)
	[returnType]	type of returned data
			(text -> return short text (default),
			 longText -> return long text,
			 numeric -> return numeric values (ids))
	[deviceNumber]	returned device number
			(meaning depends on the device class and is
			 mostly useful for CAMAC devices)
	[subtype]	returned subtype
			(meaning depends on the device class and is
			 mostly useful for CAMAC devices)

	This function returns values as follows:

	device type string

	Related functions:

	deviceTypeMismatch, ssdnToDeviceType, device

-------------------------------------------------------------------------------

	deviceTypeMismatch : determines if a device property is typed properly

	type = deviceTypeMismatch(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is not typed properly
	FALSE			device is typed properly

	Related functions:

	deviceType, device

-------------------------------------------------------------------------------

	deviceValue : returns a numeric device value

	value = deviceValue(device [,property] [,arrayIndex] [,dataEvent]
			    [,dataSource] [,scalingType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[arrayIndex]	array index
			(default is 0)
	*[dataEvent]	data event string
			(default is a one shot reading)
	*[dataSource]	data source
			(default is live reading)
	*[scalingType]	scaling type
			(common -> engineering units (default),
			 primary -> primary units,
			 raw -> raw units)

	* - denotes arguments that can come in any relative order

	This function returns values as follows:

	numeric device reading

	Related functions:

	deviceValueText, deviceCalculatedValue, deviceDigitalStatus,
	alarmBlockFieldValue, extractAlarmHeaderParam, readAlarmBlock,
	device, name, fullName, text, fullText

-------------------------------------------------------------------------------

	deviceValueText : returns a device value as a string

	string = deviceValueText(device [,property] [,arrayIndex] [,dataEvent]
				 [,dataSource] [,scalingType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[arrayIndex]	array index
			(default is 0)
	*[dataEvent]	data event string
			(default is a one shot reading)
	*[dataSource]	data source
			(default is live reading)
	*[scalingType]	scaling type
			(common -> engineering units (default),
			 primary -> primary units,
			 raw -> raw units)

	* - denotes arguments that can come in any relative order

	This function returns values as follows:

	device reading string

	Synonyms: deviceValueString

	Related functions:

	deviceValue, deviceCalculatedValue, deviceDigitalStatus,
	alarmBlockFieldValue, readAlarmBlock, deviceRawToValueText,
	deviceRawToValueTextCustom, device, name, fullName, text, fullText

-------------------------------------------------------------------------------

	deviceVirtualMachine : returns device virtual machine information

	virtualDevice = deviceVirtualMachine(device [,numProps] [,properties])

	Arguments:

	device		device of interest
	[numProps]	returned number of properties affected by the
			virtual machine device
	[properties]	returned properties affected by the
			virtual machine device

	This function returns values as follows:

	virtual machine device

	Related functions:

	controllingDevice

-------------------------------------------------------------------------------

	digitalAlarmHandlerInfo : returns digital alarm handler info for a device

	numEntries = digitalAlarmHandlerInfo(device [,masks] [,handlerCodes]
					     [,soundIds] [,speechIds])

	Arguments:

	device		device of interest
	[masks]		returned value masks
	[handlerCodes]	returned handler codes
	[soundIds]	returned alarm sound IDs
	[speechIds]	returned alarm speech IDs

	This function returns values as follows:

	number of digital alarm text entries

	Related functions:

	digitalAlarmText, digitalAlarmTextAll, analogAlarmHandlerInfo,
	analogAlarmText, analogAlarmPriority

-------------------------------------------------------------------------------

	digitalAlarmNominalMask : returns a digital alarm nominal and mask

	hasAlarm = digitalAlarmNominalMask(device [,nominal] [,mask])

	Arguments:

	device		device of interest
	[nominal]	returned digital alarm nominal
	[mask]		returned digital alarm mask

	This function returns values as follows:

	TRUE			has digital alarm
	FALSE			doesn't have digital alarm

	Related functions:

	alarmBlockFieldValue, analogAlarmLimits, digitalAlarmHandlerInfo,
	digitalAlarmText, digitalAlarmTextAll, extractAlarmHeaderParam,
	analogAlarmHandlerInfo, analogAlarmText, analogAlarmPriority,
	readAlarmBlock, extractAlarmBlockFieldValue,

-------------------------------------------------------------------------------

	digitalAlarmText : returns the digital alarm text for a device

	alarmText = digitalAlarmText(device [,maskValue] [,priority])

	Arguments:

	device		device of interest
	[maskValue]	digital mask value
			(default is the raw reading of the basic status)
	[priority]	returned corresponding priority value

	This function returns values as follows:

	digital alarm text

	Related functions:

	digitalAlarmTextAll, digitalAlarmHandlerInfo, analogAlarmText,
	analogAlarmPriority, analogAlarmHandlerInfo, deviceCurrentAlarmText,
	currentAnalogAlarmText

-------------------------------------------------------------------------------

	digitalAlarmTextAll : returns all of the digital alarm text for
                             a device

	numEntries = digitalAlarmTextAll(device [,maskValues] [,text]
					 [,priorities])

	Arguments:

	device		device of interest
	[maskValues]	returned mask values
	[text]		returned alarm text strings
	[priorities]	returned alarm priorities

	This function returns values as follows:

	number of digital alarm text entries

	Related functions:

	digitalAlarmText, digitalAlarmHandlerInfo, analogAlarmText,
	analogAlarmPriority, analogAlarmHandlerInfo, deviceCurrentAlarmText,
	currentAnalogAlarmText

-------------------------------------------------------------------------------

	digitalControlInfo : returns digital control info for a device

	wasFound = digitalControlInfo(device, searchValue [,searchType]
				      [,orderNumber] [,value] [,text]
				      [,longText])

	Arguments:

	device		device of interest
	searchValue	search value (ex: 'Reset', 0xA)
	[searchType]	search type
			(text -> search text followed by long text (default),
			 longText -> search long text only,
			 value -> search setting values)
	[orderNumber]	returned order number value
	[value]		returned setting value
	[text]		returned text value
	[longText]	returned long text value

	This function returns values as follows:

	TRUE			control entry was found
	FALSE			control entry was not found

	Related functions:

	digitalControlInfoAll, hasControlAttribute, deviceControlAttributes,
	deviceStatusScaling, deviceStatusScalingAll, hasStatusAttribute

-------------------------------------------------------------------------------

	digitalControlInfoAll : returns all of the digital control info
                               for a device

	numEntries = digitalControlInfoAll(device [,orderNumbers] [,values]
					   [,text] [,longText])

	Arguments:

	device		device of interest
	[orderNumbers]	returned order number values
	[values]	returned setting values
	[text]		returned text values
	[longText]	returned long text values

	This function returns values as follows:

	number of digital control entries

	Related functions:

	digitalControlInfo, deviceControlAttributes, hasControlAttribute,
	deviceStatusScalingAll, deviceStatusScaling, hasStatusAttribute

-------------------------------------------------------------------------------

	dipoleFourBumpInfo : returns dipole four bump information

	numEntries = dipoleFourBumpInfo(location [,multipliers] [,deviceNames])

	Arguments:

	location	location of bump
	[multipliers]	returned bump multiplier values
	[deviceNames]	returned bump device names

	This function returns values as follows:

	number of bump entries (4)

	Related functions:

	dipoleThreeBumpInfo

-------------------------------------------------------------------------------

	dipoleThreeBumpInfo : returns dipole three bump information

	numEntries = dipoleThreerBumpInfo(location [,multipliers]
					  [,deviceNames])

	Arguments:

	location	location of bump
	[multipliers]	returned bump multiplier values
	[deviceNames]	returned bump device names

	This function returns values as follows:

	number of bump entries (3)

	Related functions:

	dipoleFourBumpInfo

-------------------------------------------------------------------------------

	downloadDevices : returns front end download devices

	numDevices = downloadDevices(node [,crate] [,deviceNames]
				     [,properties] [,fullNames])

	Arguments:

	node		desired ACNET front end node
	[crate]		desired crate (CAMAC only)
			(default is 0)
	[deviceNames]	returned device names
	[properties]	returned device properties
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices found in the node's download list

	Related functions:

	fileDevices, sqlQueryDevices, loggerListDevices, userAlarmListDevices,
	userSaveListDevices, parameterPageDevices, lexSaDevices, synopticDevices

-------------------------------------------------------------------------------

	duplicateSsdnProperties : returns any duplicate SSDN properties
                                 to a given property on the same node

	numDuplicates = duplicateSsdnProperties(device [,property]
						[,deviceNames] [,properties]
						[,fullNames])

	Arguments:

	device		device of interest
	[property]	desired property
			(null -> all readable/settable properties,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[deviceNames]	returned duplicate property device names
	[properties]	returned duplicate property values
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of duplicate device properties

	Related functions:

	deviceSsdn, deviceSsdnSearch, deviceProperties

-------------------------------------------------------------------------------

	emcToString : converts an EMC value to a standard string

	string = emcToString(emc)

	Arguments:

	emc		EMC to convert

	This function returns values as follows:

	converted string

	Related functions:

	stringToEmc, ssdnToString, stringToSsdn, deviceEmc 

-------------------------------------------------------------------------------

	enableSettingLogging : enable setting logging

	previousState = enableSettingLogging()

	Arguments:

	<none>

	This function returns values as follows:

	TRUE			settings logging was previously blocked
	FALSE			settings logging was previously enabled

	Related functions:

	blockSettingLogging

-------------------------------------------------------------------------------

	error : converts an ACNET error string to a value

	errorValue = error(value [,outputType)

	Arguments:

	value		value to convert
	[outputType]	output type
			(numeric -> integer value (default),
			 name -> error symbolic name string,
			 facilityError -> facility/error string,
			 hex -> hex string)

	This function returns values as follows:

	error value

	Related functions:

	isErrorString, errorToFacilityError, node, isNodeString, device,
	name, fullName, text, fullText

-------------------------------------------------------------------------------

	errorToFacilityError : converts an ACNET error value to its component
                              facility and error number

	isValidError = errorToFacilityError(error [,facility] [,errorNumber])

	Arguments:

	error		ACNET error value
	[facility]	returned error facility number
	[errorNumber]	returned error number

	This function returns values as follows:

	TRUE			is valid ACNET error value
	FALSE			is not a valid ACNET error value

	Related functions:

	error, isErrorString, nodeToTrunkNode, trunkNodeToNode

-------------------------------------------------------------------------------

	escapeQuotesInSqlString : escapes quote characters in a SQL string

	string = escapeQuotesInSqlString(sourceString, quoteChar [,quoteString])

	Arguments:

	sourceString	original string
	quoteChar	type of quote character
			(' or ")
	[quoteString]	flag indicating whether or not to quote the string
			(default is false)

	This function returns values as follows:

	modified string

	Related functions:

	escapeString, unescapeString

-------------------------------------------------------------------------------

	escapeString : replaces characters in a string with their
		       corresponding escape characters

	string = escapeString(sourceString, escapeType [,handleQuotes]
			      [,escapeChars])

	Arguments:

	sourceString	original string
	escapeType	type of escape characters
			(C,
			 URL,
			 HTML,
			 bash)
	[handleQuotes]	preserve characters enclosed in a quoted string
	[escapeChars]	list of characters to escape
			(default is to escape all appropriate characters)

	This function returns values as follows:

	modified string

	Related functions:

	unescapeString, escapeQuotesInSqlString

-------------------------------------------------------------------------------

	eventCount : returns the current count for an event

	count = eventCount(event [,eventType] [,count0F] [,count02]
			   [,usecOffset])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)
	[count0F]	event 0F occurrence count when the requested
			event occurred
	[count02]	event 02 occurrence count when the requested
			event occurred
	[usecOffset]	number of microseconds past the previous event 02
			when the requested event last occurred

	This function returns values as follows:

	current count for the requested event

	Related functions:

	eventDate, timeSinceEvent, eventOccurred, clearEventOccurred,
	eventInfo, eventTimelineInfo, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventDate : returns the date in clinks when an event last occurred

	date = eventDate(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	date when the clock event last occurred

	Related functions:

	timeSinceEvent, eventCount, eventOccurred, clearEventOccurred,
	eventInfo, eventTimelineInfo, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventInfo : returns clock event configuration information

	symName = eventInfo(event [,eventType] [,description] [,triggerType]
			    [,numTriggers] [,triggerTypes] [,triggerDevices])

	Arguments:

	event		 clock event value
	[eventType]	 type of clock event
			 (tclk -> TCLK event (default),
			  mibs -> MIBS clock event,
			  rrbs -> RRBS clock event,
			  tvbs -> TVBS clock event,
			  pclk -> PCLK (Project) clock event,
			  nml -> NML clock event,
			  test -> test clock event)
	[description]	 returned event description
	[triggerType]	 returned overall trigger type string
	[numTriggers]	 returned number of triggers
	[triggerTypes]	 returned array of numeric trigger/timer types
	[triggerDevices] returned array of trigger devices

	This function returns values as follows:

	event symbolic name

	Related functions:

	timeSinceEvent, eventCount, eventOccurred, clearEventOccurred,
	eventDate, eventTimelineInfo, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventOccurred : determines if a clock event has occurred

	boolean = eventOccurred(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	TRUE			event has occurred
	FALSE			event has not occurred

	Related functions:

	clearEventOccurred, timeSinceEvent, eventDate, eventCount,
	eventInfo, eventTimelineInfo, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventOccurrenceHistory : returns the occurrences of a clock event in
                                a time period

	numEvents = eventOccurrenceHistory(event, eventType, startTime,
					   [,endTime] [,timestamps]
					   [,milliseconds] [,times])

	Arguments:

	event		clock event value
	eventType	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)
	startTime	start of time period to search
	[endTime]	end of time period to search
			(default is now)
	[timestamps]	returned array of event occurrence timestamps
	[milliseconds]	returned array of event occurrence milliseconds
	[times]		returned array of event times in the supercycle

	This function returns values as follows:

	number of events found

	Related functions:

	eventSupercycleHistory, eventOccurred, clearEventOccurred,
	timeSinceEvent, eventDate, eventCount, eventInfo, eventTimelineInfo,
	stateOccurrenceHistory, clockEventIsEnabled, clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventSupercycleHistory : returns the occurrences of a clock event in
                                a supercycle

	numEvents = eventSupercycleHistory(event, eventType, cycleNumber
					   [,times])

	Arguments:

	event		clock event value
	eventType	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)
	cycleNumber	cycle number to retrieve events for (>= 0)
			(0 -> current supercycle,
			 -1 -> last supercycle,
			 -n -> n supercycles ago)
	[endTime]	end of time period to search
			(default is now)
	[times]		returned array of event times in the supercycle

	This function returns values as follows:

	number of events found

	Related functions:

	eventOccurrenceHistory, eventOccurred, clearEventOccurred,
	timeSinceEvent, eventDate, eventCount, eventInfo, eventTimelineInfo,
	clockEventIsEnabled, clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	eventTimelineInfo : returns the times an event will occur
                           in the timeline

	numEvents = eventTimelineInfo(event [,eventTimes])

	Arguments:

	event		clock event value
	[eventTimes]	returned times in cycle that the event will occur

	This function returns values as follows:

	number of times that the event will occur

	Related functions:

	eventOccurred, clearEventOccurred, timeSinceEvent, eventDate,
	eventCount, eventInfo, clockEventIsEnabled, clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	executeProgram : execute a program (replaces process executing ACL)

	executeProgram(fileName [,arguments] [,envValues] [,includePgmArg])

	Arguments:

	fileName	file name including path of program to execute
	[arguments]	array of arguments to pass to the program
	[envValues]	array of environment values for the program
			(having the format 'name=value')
	[includePgmArg]	flag indicating whether or not to have this function
			insert the root program name as the first argument
			(includeProgramArgument -> include the program name
						   as the first argument (default),
			 noProgramArgument -> do not include the program name
					      as the first argument)

	This function returns values as follows:

	<none> (on success the calling process is replaced by the new one)

	Synonyms: exec, execute_program

	Related functions:

	none

-------------------------------------------------------------------------------

	exists : determines if a device or variable/symbol exists

	boolean = exists(object)

	Arguments:

	object		object (device or variable) to check for the
			existence of

	This function returns values as follows:

	TRUE			object exists
	FALSE			object does not exist

	Related functions:

	sizeof, sizeofVariable, byteSizeof, byteSizeofVariable, numElements

-------------------------------------------------------------------------------

	exp : base e exponentiation (e^n)

	resultValue = exp(value)

	Arguments:

	value		exponent value

	This function returns values as follows:

	e raised to the power of the argument

	Related functions:

	ln

-------------------------------------------------------------------------------

	expandFileName : expands a file name starting with a tilde (~)

	expandedFileName = expandFileName(fileName)

	Arguments:

	fileName	file name to expand

	This function returns values as follows:

	expanded file name

	Related functions:

	parseFileName, openFile, closeFile, fileGetString, filePrintf, fscanf,
	fileRead, fileRewind, fileWrite, findFileInPath, findInFile

-------------------------------------------------------------------------------

	extractAlarmBlockFieldValue : extracts individual alarm block
                                     field values

	value = extractAlarmBlockFieldValue(alarmBlock, fieldType
					    [,wantNumeric])

	Arguments:

	alarmBlock	alarm block to retrieve value from
	fieldType	field to return
			(state -> alarm state (bypassed, good, or bad),
			 enable -> alarm enable status (enabled or bypassed),
			 postMethod -> alarm post method (exception or event),
			 triesNeeded -> number of readings before changing
					alarm state,
			 triesNow -> current number of readings in alarm state,
			 ftd -> alarm reading sample FTD,
			 isAbort -> flag indicating if alarm can generate
				    an abort,
			 abortEnable -> flag indicating if aborts are enabled,
			 limitLength -> alarm limit length
			 limitType -> analog alarm limit type
			 limitDataType -> analog alarm limit data type
			 minimum -> analog alarm minimum value,
			 maximum -> analog alarm maximum value,
			 highLow -> analog alarm high/low status,
			 primaryMinimum -> analog alarm minimum value
					   (primary units),
			 primaryMaximum -> analog alarm maximum value
					   (primary units),
			 rawMinimum -> analog alarm minimum value (raw units),
			 rawMaximum -> analog alarm maximum value (raw units),
			 nominal -> analog alarm nominal value,
			 tolerance -> analog alarm tolerance value,
			 digitalNominal -> digital alarm nominal value,
			 mask -> digital alarm mask value,
			 displayEnable -> whether or not alarm display
					  is enabled)
	[wantNumeric]	flag indicating whether or not to force the return
			type to be numeric
			(defaultFormat -> return default format (default),
			 wantNumeric -> return as a numeric value)

	This function returns values as follows:

	alarm block field value

	Related functions:

	readAlarmBlock, alarmBlockFieldValue, extractAlarmHeaderParam,
	alarmStatus, alarmIsBypassed, alarmIsBypassedDb, alarmIsSnoozed,
	alarmRemainingSnoozeTime, analogAlarmLimits, digitalAlarmNominalMask,
	deviceValue, deviceValueText, deviceCalculatedValue,
	deviceDigitalStatus

-------------------------------------------------------------------------------

	extractAlarmHeaderParam : extracts a requested parameter from from
                                 an alarm header word

	value = extractAlarmHeaderParam(headerWord, alarmParam [,wantString])

	Arguments:

	headerWord	header word value
	alarmParam	alarm header parameter to return
			(state -> alarm state (bypassed, good, or bad),
			 enable -> alarm enable status (enabled or bypassed),
			 postMethod -> alarm post method (exception or event),
			 isAbort -> flag indicating if alarm can generate
				    an abort,
			 abortEnable -> flag indicating if aborts are enabled,
			 limitLength -> alarm limit length
			 limitType -> analog alarm limit type,
			 highLow -> whether alarm reading is high or low
				    (analog alarms only),
			 displayEnable -> whether or not alarm display
					  is enabled,
			 type -> alarm type (analog or digital))
	[wantString]	flag indicating whether or not to return values as
			strings
			(string (default),
			 numeric)

	This function returns values as follows:

	alarm header parameter value

	Related functions:

	alarmBlockFieldValue, readAlarmBlock, extractAlarmBlockFieldValue,
	alarmStatus, alarmIsBypassed, alarmIsBypassedDb, alarmIsSnoozed,
	alarmRemainingSnoozeTime, analogAlarmLimits, digitalAlarmNominalMask, 
	deviceValue, deviceValueText, deviceCalculatedValue,
	deviceDigitalStatus

-------------------------------------------------------------------------------

	feClassInfo : returns front end device class information

	numClases = feClassInfo(node [,classNames] [,classNumbers])

	Arguments:

	node		front end node
	[classNames]	returned array of class names
	[classNumbers]	returned array of class numbers

	This function returns values as follows:

	number of classes

	Related functions:

	feSsdnClassLocation

-------------------------------------------------------------------------------

	feSsdnClassLocation : returns the byte index of the device class
                             in an SSDN

	byteIndex = feSsdnClassLocation(node)

	Arguments:

	node		front end node

	This function returns values as follows:

	byte index of class number in SSDN

	Related functions:

	feClassInfo

-------------------------------------------------------------------------------

	fileCopy : copies an existing file (requires file copy privilege)

	status = fileCopy(sourceFile [,destFile])

	Arguments:

	sourceFile	file to copy
	[destFile]	destination file name
			(default is to copy to current directory)

	This function returns values as follows:

	OK			success
	CLIB_NO_SUCH		source file not found
	CLIB_NOPRIV		no permission for the copy
	CLIB_GENERR		other error during copy

	Related functions:

	fileRename, fileDate, fileDelete, fileExists, fileHasPermission,
	fileLength, fileOwner, fileOwnerId, filePermissions

-------------------------------------------------------------------------------

	fileDate : returns the date of a file

	date = fileDate(fileName [,dateType])

	Arguments:

	fileName	file to check
	[dateType]	date type to return
			(modify (default),
			 change,
			 access)

	This function returns values as follows:

	corresponding file date

	Related functions:

	fileLength, fileOwner, fileOwnerId, fileHasPermission, filePermissions,
	fileExists, fileRename, fileCopy, fileDelete 

-------------------------------------------------------------------------------

	fileDelete : deletes an existing file (requires file delete privilege)

	status = fileDelete(fileName)

	Arguments:

	fileName	file to delete

	This function returns values as follows:

	OK			success
	CLIB_NO_SUCH		file not found
	CLIB_NOPRIV		no permission for the delete
	CLIB_GENERR		other error during delete

	Related functions:

	fileRename, fileCopy, fileDate, fileExists, fileHasPermission,
	fileLength, fileOwner, fileOwnerId, filePermissions

-------------------------------------------------------------------------------

	fileDevices : returns the devices specified in a file

	numDevices = fileDevices(fileName, [,deviceNames] [,properties]
				 [,arrayIndices] [,fullNames] [,is2dFile]
				 [,ignoreBadNames])

	Arguments:

	fileName	file name
	[deviceNames]	returned device names
	[properties]	returned device properties
	[arrayIndices]	returned device array indices
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))
	[is2dFile]	treat the file as 2 dimensional
			(multiple devices per line)
			(is2dFile -> multiple devices per line,
			 is1dFile -> one device per line (default))
	[ignoreBadNames] ignore invalid devices found
			 (ignoreBadNames,
			  dontIgnoreBadNames (default))

	This function returns values as follows:

	number of devices found in the file

	Related functions:

	sqlQueryDevices, loggerListDevices, userAlarmListDevices,
	userSaveListDevices, parameterPageDevices

-------------------------------------------------------------------------------

	fileDirectory : returns file names for a directory

	numFiles = fileDirectory(fileSpec [,fileNames])

	Arguments:

	fileSpec	file specification to search for
	[fileNames]	returned matching file names

	This function returns values as follows:

	number of matching files found

	Synonyms: dir, directory

	Related functions:

	currentDirectory, changeDirectory, createDirectory, fileNumLines,
	filePermissions, fileExists, fileRename, fileCopy, fileDelete,
	fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	fileExists : determines whether or not a file exists

	status = fileExists(fileName)

	Arguments:

	fileName	file to check

	This function returns values as follows:

	TRUE			file exists
	FALSE			file does not exist

	Related functions:

	fileRename, fileCopy, fileDelete, fileDate, fileHasPermission,
	fileLength, fileOwner, fileOwnerId, filePermissions

-------------------------------------------------------------------------------

	fileFlush : flush any unwritten information to the file

	wasFlushed = fileFlush([fileId])

	Arguments:

	[fileId]	file ID returned by openFile
			(default is to flush all file streams)

	This function returns values as follows:

	TRUE			file was flushed
	FALSE			file was not flushed

	Synonyms: flushFile, fflush

	Related functions:

	openFile, closeFile, filePrintf, fileWrite, flushOutputFile,
	flushLogFile, fileSetPosition, fileGetPosition

-------------------------------------------------------------------------------

	fileGetPosition : retrieves a file current offset

	offset = fileGetPosition(fileId)

	Arguments:

	fileId		file ID returned by openFile

	This function returns values as follows:

	file offset

	Synonyms: ftell, fgetpos

	Related functions:

	fileSetPosition, openFile, closeFile, fileRewind, fileRead,
	fileGetString, fscanf, fileWrite, filePrintf

-------------------------------------------------------------------------------

	fileGetString : reads a string from a file opened by openFile

	string = closeFile(fileId)

	Arguments:

	fileId		file ID returned by openFile

	This function returns values as follows:

	string read from file (without newline terminator)

	Synonyms: fgets

	Related functions:

	openFile, closeFile, filePrintf, fileRead, fscanf, fileRewind,
	fileWrite, fileSetPosition, fileGetPosition

-------------------------------------------------------------------------------

	fileHasPermission : returns a specific permission for a file

	boolean = fileHasPermission(fileName [,permission] [,userType])

	Arguments:

	fileName	file to check
	[permission]	permission to check
			(read -> read access (default),
			 write -> write access,
			 execute -> execute status)
	[userType]	user type to check
			(owner (default),
			 group,
			 all)

	This function returns values as follows:

	TRUE			file has permission
	FALSE			file does not have permission

	Related functions:

	filePermissions, fileExists, fileRename, fileCopy, fileDelete, fileDate,
	fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	fileLength : returns the length of a file in bytes

	length = fileLength(fileName)

	Arguments:

	fileName	file to check

	This function returns values as follows:

	file length in bytes

	Related functions:

	fileDate, fileOwner, fileOwnerId, fileHasPermission, filePermissions,
	fileExists, fileRename, fileCopy, fileDelete 

-------------------------------------------------------------------------------

	fileNumLines : returns the number of lines (also characters and words)
                      in a file

	numLines = fileNumLines(fileName [,numChars] [,numWords]
				[,searchString] [,startString] [,termString])

	Arguments:

	fileName	file to check
	[numChars]	returned number of characters in the file
	[numWords]	returned number of words in the file
	[searchString]	only count lines containing this string
	[startString]	only start counting strings after the line in
			which this string is found
	[termString]	stop counting lines when a line containing
			this string is found

	This function returns values as follows:

	number of lines in the file

	Related functions:

	fileDirectory, filePermissions, fileExists, fileRename, fileCopy,
	fileDelete, fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	fileOwner : returns the owner of a file

	ownerName = fileOwner(fileName [,groupName])

	Arguments:

	fileName	file to check
	[groupName]	returned group name

	This function returns values as follows:

	file owner name

	Related functions:

	fileOwnerId, fileLength, fileDate, fileHasPermission, filePermissions,
	fileExists, fileRename, fileCopy, fileDelete 

-------------------------------------------------------------------------------

	fileOwnerId : returns the owner ID for a file

	ownerId = fileOwnerId(fileName [,groupId])

	Arguments:

	fileName	file to check
	[groupId]	returned group ID

	This function returns values as follows:

	file owner ID

	Related functions:

	fileOwner, fileLength, fileDate, fileHasPermission, filePermissions,
	fileExists, fileRename, fileCopy, fileDelete 

-------------------------------------------------------------------------------

	filePermissions : returns the complete file permission set for a file

	permissionSet = filePermissions(fileName [,userType])

	Arguments:

	fileName	file to check
	[userType]	user type to check
			(owner (default),
			 group,
			 all)

	This function returns values as follows:

	file permission set

	Related functions:

	fileHasPermission, fileExists, fileRename, fileCopy, fileDelete,
	fileDate, fileLength, fileOwner, fileOwnerId

-------------------------------------------------------------------------------

	filePrintf : functions like fprintf with the additional
		     functionality of toString

	numChars = filePrintf(fileId, formatString [,arg1] ...)

	Arguments:

	fileId		file ID returned by openFile
	formatString	format string
	[arg1]		first value to format

	This function returns values as follows:

	number of characters output

	Synonyms: fprintf

	Related functions:

	openFile, closeFile, fileWrite, fileFlush, fscanf, fileGetString,
	fileRead, fileRewind, fileSetPosition, fileGetPosition, sprintf,
	printf, toString, toTrimmedString, formatDateString, stringCopy,
	toNumeric

-------------------------------------------------------------------------------

	fileRead : reads binary values from a file

	numRead = fileRead(fileId, value [,numElements] [,dataType]
			   [stringLength])

	Arguments:

	fileId		file ID returned by openFile
	value		returned file values
	[numElements]	number of elements to read (default is 1)
	[dataType]	data type of file data
			(default is type of value argument)
	[stringLength]	length of each string if the data type is string
			(Passing a value of 0 for this argument will
			 result in reading one line of the file per string.)
			(default is 1)

	This function returns values as follows:

	number of values read

	Synonyms: fread, readFile, file_read, read_file

	Related functions:

	openFile, closeFile, fileGetString, fileRewind, fileWrite, fscanf,
	filePrintf, fileSetPosition, fileGetPosition

-------------------------------------------------------------------------------

	fileRename : renames an existing file (requires file rename privilege)

	status = fileRename(sourceFile [,destFile])

	Arguments:

	sourceFile	file to rename
	[destFile]	destination file name
			(default is to rename to current directory)

	This function returns values as follows:

	OK			success
	CLIB_NO_SUCH		source file not found
	CLIB_NOPRIV		no permission for the rename
	CLIB_GENERR		other error during rename

	Related functions:

	fileCopy, fileDate, fileDelete, fileExists, fileHasPermission,
	fileLength, fileOwner, fileOwnerId, filePermissions

-------------------------------------------------------------------------------

	fileRewind : rewinds a file to its beginning

	status = fileRewind(fileId)

	Arguments:

	fileId		file ID returned by openFile

	This function returns values as follows:

	status of rewind

	Synonyms: rewindFile, file_rewind, rewind_file

	Related functions:

	fileSetPosition, fileGetPosition, openFile, closeFile, fileRead,
	fileGetString, fscanf, fileWrite, filePrintf

-------------------------------------------------------------------------------

	fileSetPosition : sets a file offset

	offset = fileSetPosition(fileId, fileOffset [,reference])

	Arguments:

	fileId		file ID returned by openFile
	fileOffset	desired file offset
	[reference]	desired offset reference
			(start -> relative to the start of the file
			 current -> relative to the current offset
			 end -> relative to the end of the file)

	This function returns values as follows:

	file offset

	Synonyms: fseek, fsetpos

	Related functions:

	fileGetPosition, openFile, closeFile, fileRewind, fileRead,
	fileGetString, fscanf, fileWrite, filePrintf

-------------------------------------------------------------------------------

	fileWrite : writes binary values to a file

	numWritten = fileWrite(fileId, value [,numElements] [,dataType])

	Arguments:

	fileId		file ID returned by openFile
	value		values to write to the file
	[numElements]	number of elements to write (default is 1)
	[dataType]	data type of data to write to file
			(default is type of value argument)

	This function returns values as follows:

	number of values written

	Synonyms: fwrite, writeFile, file_write, write_file

	Related functions:

	openFile, closeFile, filePrintf, fileFlush, fileRead, fileGetString,
	fileRewind, fscanf, fileSetPosition, fileGetPosition

-------------------------------------------------------------------------------

	findAlarmsDaemon : find the location of an alarms daemon

	daemonHost = findAlarmsDaemon([port])

	Arguments:

	[port]		returned alarms daemon port

	This function returns values as follows:

	IP name of alarms daemon host

	Related functions:

	refreshAlarmNodeList

-------------------------------------------------------------------------------

	findChar : returns the first location of one of a set of characters
		   in a string

	position = findChar(searchChars, sourceString [,direction])

	Arguments:

	searchChars	character(s) to search for
	sourceString	source string
	[direction]	search direction
			(first -> find first occurrence,
			 last -> find last occurrence,
			 n -> find the nth occurrence)

	This function returns values as follows:

	0			character(s) were not found
	otherwise		character position (starts at 1)

	Related functions:

	findNotChar, findString, regexpFindString, strstr, stringStartsWith,
	stringEndsWith

-------------------------------------------------------------------------------

	findConsoleWindowTitle : find console window titles matching a string

	numWindows = findConsoleWindowTitle(title, [,console] [,windowIds]
					    [,slots] [,processNames])

	Arguments:

	title		title string to search for
	[console]	console to search (default is the local console)
	[windowIds]	returned matching window IDs
	[slots]		returned matching console slots
	[processNames]	returned matching process names

	This function returns values as follows:

	number of matching windows found

	Synonyms: findWindowTitle

	Related functions:

	consoleWindowToSlot, consoleSlotToWindow, consoleProcessName,
	consoleExists, consoleIsUp, consoleSlotExists

-------------------------------------------------------------------------------

	findFileInPath : determines whether a file name points to an
			 existing file

	foundFileName = findFileInPath(fileName, path [,pathType]
				       [,pathSeparator])

	Arguments:

	fileName	file name to find
	path		file path string
	[pathType]	type of path provided
			(literal -> literal path string (default),
			 environmentVariable -> treat the path as an environment
						variable)
	[pathSeparator]	path entry separator character (default is ':')

	This function returns values as follows:

	returned matching file name or null string

	Related functions:

	findInFile, parseFileName, expandFileName, openFile, closeFile,
	fileGetString, filePrintf, fscanf, fileRead, fileRewind, fileWrite

-------------------------------------------------------------------------------

	findInFile : searches for a text string in a file

	numMatches = findInFile(fileName, searchString [,matchLimit]
				[,caseSensitive] [,lineNumbers]
				[,lineText])

	Arguments:

	fileName	name of file to search
	searchString	text to search for (supports regular expressions)
	[matchLimit]	maximum number of matches to look for
			(all -> search for all occurrences (default),
			 otherwise -> maximum number of matches to search for)
	[caseSensitive]	search case sensitivity
			(caseSensitive -> case sensitive search,
			 caseInsensitive -> case insensitive search (default))
	[lineNumbers]	returned matching line numbers
	[lineText]	returned text for matching lines

	This function returns values as follows:

	number of matches found

	Related functions:

	findFileInPath, parseFileName, expandFileName, openFile, closeFile,
	fileGetString, filePrintf, fscanf, fileRead, fileRewind, fileWrite

-------------------------------------------------------------------------------

	findNotChar : returns the first location of a character which is not
		      a member of a set of characters in a string

	position = findNotChar(searchChars, sourceString [,direction])

	Arguments:

	searchChars	character(s) to search for
	sourceString	source string
	[direction]	search direction
			(first -> find first occurrence,
			 last -> find last occurrence,
			 n -> find the nth occurrence)

	This function returns values as follows:

	0			character(s) were not found
	otherwise		character position (starts at 1)

	Related functions:

	findChar, findString, regexpFindString, strstr, stringStartsWith,
	stringEndsWith

-------------------------------------------------------------------------------

	findProcesses : returns processes running on the host computer

	numProcesses = findProcesses([searchType] [,searchValue] [,pids]
				     [,processNames] [,node])

	Arguments:

	[searchType]	requested search type
			(none or all -> return all processes (default)
			 name -> return processes matching a name
			 children -> return all first generation children
				     for a process
			 allChildren -> return all children for a process
			 userName -> return all processes belonging to
				     a user (by user name)
			 userId -> return all processes belonging to
				   a user (by user ID)
			 commandLine -> return all processes matching a
					command line string
			 startedBefore -> return all processes started before
					  a requested date
			 startedAfter -> return all processes started on or
					 after a requested date
			 state -> return all processes in a particular state
			 memorySize -> return all processes having a
				       memory size of at least a certain size
				       in bytes
			 cpuTime -> return all processes that have used at
				    least a certain amount of CPU time in ticks)
	[searchValue]	requested search value (which depends on searchType)
			(none -> no argument needed
			 name -> name string to match
			 children -> pid of parent process
			 allChildren -> pid of parent process
			 userName -> user name to match
			 userId -> user ID to match
			 commandLine -> comamnd line string to match
			 startedBefore -> process start date to match
			 startedAfter -> process start date to match
			 state -> state string to match
			 memorySize -> memory size in bytes to match
			 cpuTime -> CPU time in ticks to match)
	[pids]		returned matching pids
	[processNames]	returned matching process names
	[node]		node or console to search
			(default is 0 (local node))

	This function returns values as follows:

	number of matching processes

	Related functions:

	pidProcessExists, processExists, processInfo, processNameToPid,
	pidToProcessName, sendPidSignal, sendProcessSignal, taskExists,
	nodeAcnetTasks, taskId, taskPid, isServerTask, taskIdToName,
	taskPidToName

-------------------------------------------------------------------------------

	findString : returns the position of one string within another

	position = findString(searchString, sourceString [,option1]
			      [,option2] [,option3])

	Arguments:

	searchString	search string
	sourceString	source string
	[option1...3]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default),
			 ignoreSpaces -> ignore spaces while matching,
			 wildcard=c -> specify a wildcard character)

	This function returns values as follows:

	0		search string was not found
	otherwise	match position (starts at 1)

	Related functions:

	strstr, regexpFindString, findChar, findNotChar, findTagString,
	stringStartsWith, stringEndsWith

-------------------------------------------------------------------------------

	findTagString : finds and extracts delimited tags from a string

	tagString = findTagString(sourceString [,tagType] [,isEndTag])

	Arguments:

	sourceString	original string
			(If a tag is found, this string will be modified
			 with the tag removed,)
	tagType		type of tag
			(HTML)
	[isEndTag]	returned boolean indicating if the found tag is
			an end tag

	This function returns values as follows:

	tag string

	Related functions:

	getTaggedValue, findString, regexpFindString, strstr

-------------------------------------------------------------------------------

	firstCharPos : find the first or last nonblank character position

	position = firstCharPos(sourceString [,direction])

	Arguments:

	sourceString	source string
	[direction]	search direction
			(first -> find first nonblank character position,
			 last -> find last nonblank character position)

	This function returns values as follows:

	0			no nonblank characters were not found
	otherwise		character position (starts at 1)

	Related functions:

	lastCharPos, getFirstChar, stringStartsWith, findChar, findNotChar

-------------------------------------------------------------------------------

	floatToBinary : converts a single precision floating point value to
			its equivalent binary value

	binaryValue = floatToBinary(floatValue)

	Arguments:

	floatValue		float value to convert to binary (integer)

	This function returns values as follows:

	corresponding binary (integer) value

	Related functions:

	binaryToFloat

-------------------------------------------------------------------------------

	floor : largest integer less than or equal to its argument

	resultValue = floor(value)

	Arguments:

	value		original value

	This function returns values as follows:

	largest integer less than or equal to its argument

	Related functions:

	ceil

-------------------------------------------------------------------------------

	flushLogFile : flush any unwritten information to the log file

	wasFlushed = flushLogFile()

	This function returns values as follows:

	TRUE			log file established
	FALSE			no log file established

	Related functions:

	flushOutputFile, fileFlush

-------------------------------------------------------------------------------

	flushOutputFile : flush any unwritten information to an output file

	wasFlushed = flushOutputFile([fileName])

	Arguments:

	[fileName]	output file name to flush
			(default is the last output file written to)

	This function returns values as follows:

	TRUE			output file was flushed
	FALSE			output file was not flushed

	Related functions:

	flushLogFile, fileFlush

-------------------------------------------------------------------------------

	fmod : remainder of the arguments

	remainder = fmod(numerator, denominator)

	Arguments:

	numerator	numerator value
	denominator	denominator value

	This function returns values as follows:

	remainder of the arguments

	Related functions:

	fract

-------------------------------------------------------------------------------

	formatDateString : format a date string using the format specifiers
			   in strftime

	string = formatDateString([formatString] [,date] [,locale])

	Arguments:

	[formatString]	desired format
			(standard -> "dd-Mmm-yyyy hh:mm:ss" format (default),
			 ctime -> "Www Mmm dd hh:mm:ss yyyy" format,
			 ctime+ -> "Www Mmm dd hh:mm:ss yyyy zzz" format,
			 compare -> "yyyy-mm-dd hh:mm:ss" format,
			 otherwise -> format string suitable for use
				      with strftime)
	[date]		date value to convert
			(default is now)
	[locale]	time locale
			(local -> local time (default),
			 utc -> UTC time)

	This function returns values as follows:

	converted date string

	Related functions:

	dateToString, stringtoDate, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	fract : fractional component

	fraction = fract(value)

	Arguments:

	value		original value

	This function returns values as follows:

	fractional component of argument

	Related functions:

	fmod

-------------------------------------------------------------------------------

	frontendSoftwareVersion : returns the software version for a front end

	version = frontendSoftwareVersion(node)

	Arguments:

	node		node to retrieve software version for

	This function returns values as follows:

	frontend software version

	Related functions:

	acsysSoftwareVersion, moocSoftwareVersion, irmSoftwareVersion,
	nodeType, isFrontendNode, isCentralNode, isConsoleNode, isMoocNode,
	isMoocDevice, isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice,
	isOacNode, isOacDevice, isLabviewNode, isLabviewDevice

-------------------------------------------------------------------------------

	fscanf : functions like fscanf with the additional functionality
                of toNumeric

	numConverted = fscanf(fileId, formatString [,arg1] ...)

	Arguments:

	fileId		file ID returned by openFile
	formatString	format string
	[arg1]		first value to convert or conversion type

	This function returns values as follows:

	number of values converted

	Synonyms: fileScanf

	Related functions:

	sscanf, openFile, closeFile, fileGetString, filePrintf, sprintf,
	printf, toNumeric, toString, toTrimmedString, formatDateString,
	stringCopy 

-------------------------------------------------------------------------------

	fshareFileInfo : returns information about a Filesharing file

	recordSize = fshareFileInfo(fileName [,numRecords] [,fileType])

	Arguments:

	fileName	Filesharing file to check
	[numRecords]	returned number of records in the file
	[fileType]	returned file organization type
			(Sequential,
			 Relative,
			 Indexed)

	This function returns values as follows:

	size of each record in bytes

	Related functions:

	appdsTableInfo

-------------------------------------------------------------------------------

	ftpDefaultFreq : returns the default fast time plot frequency
                        for a device or plot class

	defaultFreq = ftpDefaultFreq(device, plotLength [,plotClass])

	Arguments:

	device		device of interest (or plot class)
	plotLength	plot length in seconds
	[plotClass]	returned plot class number

	This function returns values as follows:

	default fast time plot frequency

	Related functions:

	ftpMaxFreq, snapshotDefaultFreq, snapshotMaxFreq

-------------------------------------------------------------------------------

	ftpMaxFreq : returns the maximum fast time plot frequency for a
		     device or plot class

	maxFreq = ftpMaxFreq(device [,plotClass])

	Arguments:

	device		device of interest (or plot class)
	[plotClass]	returned plot class number

	This function returns values as follows:

	maximum fast time plot frequency

	Related functions:

	ftpDefaultFreq, snapshotMaxFreq, snapshotDefaultFreq

-------------------------------------------------------------------------------

	fullName : returns a device full name string

	string = fullName(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device full name string

	Related functions:

	name, deviceNameExists, historicName, fullText, text

-------------------------------------------------------------------------------

	fullNameToConsoleUserName : converts a full name to a console user name

	userName = fullNameToConsoleUserName(fullName)

	Arguments:

	fullName	full user name

	This function returns values as follows:

	corresponding console user name

	Related functions:

	consoleUserNameToFullName, consoleUserNameToId, consoleUserIdToName,
	userAttributeValue, myUserName, myUserId, systemUserNameToId,
	systemUserIdToName

-------------------------------------------------------------------------------

	fullText : returns a device full descriptive text string

	string = fullText(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device full descriptive text string

	Synonyms: fullDescription, fullDeviceText, fullDeviceDescription

	Related functions:

	text, fullName, name

-------------------------------------------------------------------------------

	functionStats : returns execution statistics for an
                       ACL intrinsic function

	numCalls = functionStats(function [,totalTime] [,longestTime]
				 [,numErrors] [,lastError] [,lastErrorLine])

	Arguments:

	function	function to retrieve statistics for
	[totalTime]	returned total time spent in the function
	[longestTime]	returned longest time spent in the function
	[numErrors]	returned number of errors when executing the function
	[LastError]	returned last error when executing the function
	[lastErrorLine]	returned line number of last error from the function

	This function returns values as follows:

	number of times the function has been called

	Related functions:

	clearFunctionStats, commandStats, clearCommandStats, clibMemoryInfo,
	ifLevel, loopLevel, labelLineNumber, variableNumReadings,
	variableNumSettings, variableArrayDimensions, variableDimensionSize,
	variableType, variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements, variableIsInitialized,
	variableIsConstant, variableIsDynamic, numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	genericConsoleSearch : searches for consoles matching various parameters

	numConsoles = genericConsoleSearch(searchString [,consoles]
					   [,allowInactive] [,wantExact])

	Arguments:

	searchString	search string
	[consoles]	returned matching consoles
	[allowInactive]	allow inactive consoles
			(true,
			 false (default))
	[wantExact]	allow exact matches only
			(true,
			 false (default))

	This function returns values as follows:

	number of matching consoles

	Related functions:

	genericNodeSearch, genericUserSearch, genericProgramSearch,
	genericEventSearch, genericMdatSearch, genericErrorSearch,
	genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericDeviceSearch : searches for devices matching various parameters

	numDevices = genericDeviceSearch(deviceNames [,properties]
					 [,duplicateFlag]
					 [,type1] [,value1] ...)

	Arguments:

	deviceNames	returned matching device names
	[properties]	returned matching device properties
	[duplicateFlag]	duplicate device flag
			(allowDuplicates -> allow duplicate devices (default),
			 noDuplicates -> don't allow duplicate devices)
	[type1]		first search type
			(name,
			 fullName,
			 text,
			 fullText,
			 nodeString,
			 node,
			 nodeSystem,
			 nodeSoftware,
			 nodeArea,
			 nodeStatus,
			 deviceClass,
			 deviceType,
			 properties,
			 alarmList,
			 actualAlarmList,
			 analogAlarmHandler,
			 digitalAlarmHandler,
			 saveList,
			 restoreCode,
			 restoreSubcode,
			 displayCode,
			 consoleClassMask,
			 defaultFtd,
			 ssdn,
			 virtualMachine,
			 dataType,
			 commonTransform,
			 commonUnits,
			 primaryTransform,
			 primaryUnits,
			 department,
			 maintainer,
			 structureClass,
			 structureName,
			 foreignSystem,
			 foreignName,
			 crate,
			 slot,
			 madc)
	[value1]	first value

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceNameSearch, deviceFullNameSearch, deviceDescriptionSearch,
	deviceFullDescriptionSearch, deviceNodeSearch, deviceSsdnSearch

-------------------------------------------------------------------------------

	genericErrorSearch : searches for ACNET errors matching various parameters

	numErrors = genericErrorSearch(searchString [,errors] [,allowObsolete])

	Arguments:

	searchString	search string
	[errors]	returned matching ACNET errors
	[allowObsolete]	allow obsolete ACNET errors
			(true,
			 false (default))

	This function returns values as follows:

	number of matching ACNET errors

	Related functions:

	genericNodeSearch, genericConsoleSearch, genericEventSearch,
	genericMdatSearch, genericUserSearch, genericProgramSearch,
	genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericEventSearch : searches for events matching various parameters

	numEvents = genericEventSearch(searchString [,events] [,clockType]
				       [,allowObsolete])

	Arguments:

	searchString	search string
	[events]	returned matching events
	[clockType]	desired clock type
			(tclk (default),
			 pclk,
			 nclk,
			 mibs,
			 rrbs,
			 test)
	[allowObsolete]	allow obsolete events
			(true,
			 false (default))

	This function returns values as follows:

	number of matching events

	Related functions:

	genericMdatSearch, genericNodeSearch, genericConsoleSearch,
	genericUserSearch, genericProgramSearch, genericErrorSearch,
	genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericMdatSearch : searches for MDAT frames matching various parameters

	numFrames = genericMdatSearch(searchString [,mdatFrames])

	Arguments:

	searchString	search string
	[mdatFrames]	returned matching MDAT frames

	This function returns values as follows:

	number of matching MDAT frames

	Related functions:

	genericEventSearch, genericNodeSearch, genericConsoleSearch,
	genericUserSearch, genericProgramSearch, genericErrorSearch,
	genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericNodeSearch : searches for nodes matching various parameters

	numNodes = genericNodeSearch(searchString [,nodes] [,allowObsolete])

	Arguments:

	searchString	search string
	[nodes]		returned matching nodes
	[allowObsolete]	allow obsolete nodes
			(true,
			 false (default))

	This function returns values as follows:

	number of matching nodes

	Related functions:

	nodeAttributeValue, genericConsoleSearch, genericUserSearch,
	genericProgramSearch, genericEventSearch, genericMdatSearch,
	genericErrorSearch, genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericProgramSearch : searches for programs matching various parameters

	numPrograms = genericProgramSearch(searchString [,programs]
					   [,allowObsolete])

	Arguments:

	searchString	search string
	[users]		returned matching users
	[allowObsolete]	allow obsolete programs
			(true,
			 false (default))

	This function returns values as follows:

	number of matching programs

	Related functions:

	meccaProjectAttributeValue, genericNodeSearch, genericConsoleSearch,
	genericEventSearch, genericMdatSearch, genericUserSearch,
	genericErrorSearch, genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericStructInfo : returns information about a generic structure

	structSize = genericStructInfo(structureName [,numFields] [,fieldNames]
				       [,dataTypes] [,numElements]
				       [,dataLengths])

	Arguments:

	structureName	structure to check
	[numFields]	returned number of fields
	[fieldNames]	returned array of field names
	[dataTypes]	returned array of field data types
			(CNV_xxx)
	[numElements]	returned array of field numbers of elements
	[dataLengths]	returned array of field data lengths in bytes

	This function returns values as follows:

	size of structure in bytes

	Related functions:

	appdsTableInfo

-------------------------------------------------------------------------------

	genericSwitchSearch : searches for netowrk switches matching various
			      parameters

	numSwitches = genericSwitchSearch(searchString [,switches]
					  [,allowObsolete])

	Arguments:

	searchString	search string
	[errors]	returned matching network switches
	[allowObsolete]	allow obsolete network switches
			(true,
			 false (default))

	This function returns values as follows:

	number of matching network switches

	Related functions:

	switchAttributeValue, genericNodeSearch, genericConsoleSearch,
	genericEventSearch, genericMdatSearch, genericUserSearch,
	genericProgramSearch, genericErrorSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	genericUserSearch : searches for users matching various parameters

	numUsers = genericUserSearch(searchString [,users] [,allowInactive])

	Arguments:

	searchString	search string
	[users]		returned matching users
	[allowInactive]	allow inactive users
			(true,
			 false (default))

	This function returns values as follows:

	number of matching users

	Related functions:

	userAttributeValue, genericNodeSearch, genericConsoleSearch,
	genericEventSearch, genericMdatSearch, genericProgramSearch,
	genericErrorSearch, genericSwitchSearch, genericDeviceSearch

-------------------------------------------------------------------------------

	getDeviceMaintainers : retrieves ACNET device maintainer names

	numMaintainers = getDeviceMaintainers(maintainerNames [,userActiveType])

	Arguments:

	maintainerNames	returned device maintainer names
	[userActiveType] user active type
			 (active -> active users (default),
			  inactive -> inactive users,
			  all -> all users)

	This function returns values as follows:

	number of matching device maintainers

	Related functions:

	maintainerDevices

-------------------------------------------------------------------------------

	getenv : returns the string corresponding to an environment variable

	value = getenv(envVariable)

	Arguments:

	envVariable	environment variable name

	This function returns values as follows:

	value of the requested environment variable

	Related functions:

	setenv, unsetenv, delenv, getLogicalName, setLogicalName,
	deleteLogicalName

-------------------------------------------------------------------------------

	getFirstChar : retrieve the first or last nonblank character

	string = getFirstChar(sourceString [,direction] [,position] [,numChars])

	Arguments:

	sourceString	source string
	[direction]	search direction
			(first -> get first nonblank character (default),
			 last -> get last nonblank character)
	[position]	returned position of nonblank character (starts at 1)
			(A value of 0 means that no nonblank characters
			 were found.)
	[numChars]	number of characters to return
			(default is 1)

	This function returns values as follows:

	null string		no nonblank characters were found
	otherwise		string containing first or last character

	Related functions:

	getLastChar, firstCharPos, stringStartsWith, stringEndsWith,
	findChar, findNotChar, stringGetChar

-------------------------------------------------------------------------------

	getInputValue : retrieves an input value

	inputValue = getInputValue(inputName [,dataType])

	Arguments:

	inputName	input name
	[dataType]	desired data type
			(string
			 compoundString
			 integer
			 unsignedInt
			 longLong
			 unsignedLongLong
			 float
			 double
			 date
			 node
			 acknowledge)
			(default is the default type of the input specifier)

	This function returns values as follows:

	input value

	Synonyms: get_input_value

	Related functions:

	none

-------------------------------------------------------------------------------

	getLastChar : retrieve the last nonblank character in a string

	string = getLastChar(sourceString [,position] [,numChars])

	Arguments:

	sourceString	source string
	[position]	returned position of nonblank character (starts at 1)
			(A value of 0 means that no nonblank characters
			 were found.)
	[numChars]	number of characters to return
			(default is 1)

	This function returns values as follows:

	null string		no nonblank characters were found
	otherwise		string containing last character

	Related functions:

	getFirstChar, lastCharPos, firstCharPos, stringEndsWith,
	stringStartsWith, findChar, findNotChar, stringGetChar

-------------------------------------------------------------------------------

	getLogicalName : returns the string corresponding to a logical name

	value = getLogicalName(logicalName)

	Arguments:

	logicalName	logical name

	This function returns values as follows:

	value of the requested logical name

	Related functions:

	setLogicalName, deleteLogicalName, getenv, setenv, unsetenv, delenv

-------------------------------------------------------------------------------

	getMeccaKeepers : retrieves MECCA project keeper names

	numKeepers = getMeccaKeepers(keeperNames [,projectType] [,keeperType]
				     [,userActiveType])

	Arguments:

	keeperNames	returned keeper names
	[projectType]	MECCA project type
			(pas -> primary applications,
			 sas -> secondary applications,
			 uls -> user libraries,
			 services -> services,
			 pasAndSas -> primary and secondary applications,
			 all -> all project types (default))
	[keeperType]	keeper type
			(primary -> primary keeper,
			 backup -> backup keeper,
			 all -> any type of keeper (default))
	[userActiveType] user active type
			 (active -> active users (default),
			  inactive -> inactive users,
			  all -> all users)

	This function returns values as follows:

	number of matching MECCA project keepers

	Related functions:

	isMeccaKeeper, getNodeKeepers, isNodeKeeper,
	meccaProjectAttributeValue, maximumMeccaProjectNumber

-------------------------------------------------------------------------------

	getNodeKeepers : retrieves ACNET node keeper names

	numKeepers = getNodeKeepers(keeperNames [,frontendOnly] [,keeperType]
				    [,userActiveType])

	Arguments:

	keeperNames	returned keeper names
	[frontendOnly]	only return keepers for frontend nodes
			(true -> frontend nodes only,
			 false -> all nodes (default))
	[keeperType]	keeper type
			(primary -> primary keeper,
			 backup -> backup keeper,
			 all -> any type of keeper (default))
	[userActiveType] user active type
			 (active -> active users (default),
			  inactive -> inactive users,
			  all -> all users)

	This function returns values as follows:

	number of matching ACNET node keepers

	Related functions:

	isNodeKeeper, getMeccaKeepers, isMeccaKeeper

-------------------------------------------------------------------------------

	getSpecialDate : calculates special date times

	date = getSpecialDate(dateType [,dateOption] [,baseDate])

	Arguments:

	dateType	desired date base type
			(min[ute] -> time of the most recent minute,
			 hour -> time of the most recent hour,
			 shift -> time of the most recent shift,
			 day -> time of the most recent day,
			 week -> time of the most recent week,
			 month -> time of the most recent month,
			 year -> time of the most recent year)
	[dateOption]	date option
			(this -> current time interval (default),
			 previous -> previous time interval,
			 next -> next time interval)
	[baseDate]	base date for calculation
			(default is now)

	This function returns values as follows:

	calculated special date

	Related functions:

	timeFromDate, timeAgo, timeSinceMidnight, systemTime, cpuTime, timer,
	15HzCount, timeSinceEvent, stringToDate, dateToString, convertSeconds,
	julianDate, julianDateToDate, currentDate, currentTimeInClinks,
	currentTime, localtime

-------------------------------------------------------------------------------

	getTaggedValue : extracts a tag/value pair from a string

	boolean = getTaggedValue(sourceString, tagString, valueString,
				 [,termChars])

	Arguments:

	sourceString	original string
			(If a tag is found, this string will be modified
			 with the tag/value pair removed.)
	tagString	returned tag string
	valueString	returned value string
	[termChars]	tag/value terminator characters

	This function returns values as follows:

	TRUE			tag/value pair found
	FALSE			tag/value pair not found

	Related functions:

	findTagString, findString, regexpFindString

-------------------------------------------------------------------------------

	gifImageSize : determines the dimensions of a GIF image

	numPixels = gifImageSize(fileName [,width] [,height])

	Arguments:

	fileName	GIF file name
	[width]		returned width of image in pixels
	[height]	returned height of image in pixels

	This function returns values as follows:

	size of image in pixels

	Related functions:

	<none>

-------------------------------------------------------------------------------

	hasAnalogAlarm : determines whether or not a device has an analog alarm property

	boolean = hasAnalogAlarm(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has an analog alarm
	FALSE			device does not have an analog alarm

	Related functions:

	hasProperty, hasReading, hasSetting, hasStatus, hasControl,
	hasDigitalAlarm, device, name, fullName, text, fullText, deviceValue,
	deviceValueText, alarmBlockFieldValue, extractAlarmHeaderParam,
	analogAlarmLimits, digitalAlarmNominalMask, readAlarmBlock,
	extractAlarmBlockFieldValue, deviceCalculatedValue

-------------------------------------------------------------------------------

	hasControl : determines whether or not a device has a control property

	boolean = hasControl(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has a control property
	FALSE			device does not have a control property

	Related functions:

	hasProperty, hasReading, hasSetting, hasStatus, hasAnalogAlarm,
	hasDigitalAlarm, device

-------------------------------------------------------------------------------

	hasControlAttribute : determines whether or not a device has
                             a control attribute

	attrExists = hasControlAttribute(device, attribute [,setValue])

	Arguments:

	device			device of interest
	attribute		desired control attribute
				(reset,
				 on,
				 off,
				 positive,
				 negative,
				 ramp,
				 dc)
	[setValue]		returned corresponding setting value

	This function returns values as follows:

	TRUE			control attribute exists
	FALSE			control attribute does not exist

	Related functions:

	deviceControlAttributes, digitalControlInfo, digitalControlInfoAll,
	hasStatusAttribute, deviceStatusScaling, deviceStatusScalingAll,
	deviceScalingLength, deviceReadSetScaling, deviceReadSetExtScaling

-------------------------------------------------------------------------------

	hasDigitalAlarm : determines whether or not a device has a
			  digital alarm property

	boolean = hasDigitalAlarm(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has a digital alarm
	FALSE			device does not have a digital alarm

	Related functions:

	hasProperty, hasReading, hasSetting, hasStatus, hasControl,
	hasAnalogAlarm, alarmBlockFieldValue, extractAlarmHeaderParam,
	digitalAlarmNominalMask, analogAlarmLimits, readAlarmBlock,
	extractAlarmBlockFieldValue, device

-------------------------------------------------------------------------------

	hasProperty : determines whether or not a device has a
		      specified property

	boolean = hasProperty(device [,property])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device has the requested property
	FALSE			device does not have the requested property

	Related functions:

	hasReading, hasSetting, hasStatus, hasControl, hasAnalogAlarm,
	hasDigitalAlarm, device, name, fullName, text, fullText, deviceValue,
	deviceValueText, deviceCalculatedValue, deviceDigitalStatus,
	alarmBlockFieldValue, extractAlarmHeaderParam, analogAlarmLimits,
	digitalAlarmNominalMask, readAlarmBlock, extractAlarmBlockFieldValue

-------------------------------------------------------------------------------

	hasReading : determines whether or not a device has a reading property

	boolean = hasReading(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has a reading property
	FALSE			device does not have a reading property

	Related functions:

	hasProperty, hasSetting, hasStatus, hasControl, hasAnalogAlarm,
	hasDigitalAlarm, device

-------------------------------------------------------------------------------

	hasSetting : determines whether or not a device has a setting property

	boolean = hasSetting(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has a setting property
	FALSE			device does not have a setting property

	Related functions:

	hasProperty, hasReading, hasStatus, hasControl, hasAnalogAlarm,
	hasDigitalAlarm, device

-------------------------------------------------------------------------------

	hasStatus : determines whether or not a device has a status property

	boolean = hasStatus(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has a status property
	FALSE			device does not have a status property

	Related functions:

	hasProperty, hasReading, hasSetting, hasControl, hasAnalogAlarm,
	hasDigitalAlarm, hasStatusAttribute, device

-------------------------------------------------------------------------------

	hasStatusAttribute : determines whether or not a device has a
                            status attribute

	attrExists = hasStatusAttribute(device, attribute [,attrMask]
					 [,invertFlag] [,trueString]
					 [,falseString] [,wantLongText]
					 [,trueColor] [,falseColor])

	Arguments:

	device			device of interest
	attribute		desired status attribute
				(onOff,
				 readyTripped,
				 remoteLocal,
				 positiveNegative,
				 rampDC)
	[attrMask]		returned status attribute mask
	[invertFlag]		returned status data invert flag
	[trueString]		returned string to display if the data
				matches the mask
	[falseChar]		returned string to display if the data
				does not match the mask
	[wantLongText]		flag indicating whether or not to return
				long text strings
	[trueColor]		returned color to display if the data
				matches the mask
	[falseColor]		returned color to display if the data
				does not match the mask

	This function returns values as follows:

	TRUE			status attribute exists
	FALSE			status attribute does not exist

	Related functions:

	deviceStatusScaling, deviceStatusScalingAll, hasControlAttribute,
	deviceControlAttributes, digitalControlInfo, digitalControlInfoAll,
	deviceScalingLength, deviceReadSetScaling, deviceReadSetExtScaling,
	statusAttrToBitInfo

-------------------------------------------------------------------------------

	head : returns the beginning of a string

	string = head(sourceString, numChars)

	Arguments:

	sourceString	source string
	numChars	length of string to return

	This function returns values as follows:

	beginning of source string

	Related functions:

	tail

-------------------------------------------------------------------------------

	hex : returns a value as a hexadecimal string

	string = hex(value [,convertLength] [,fillChar] [,dataType])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[fillChar]	fill character
	[dataType]	data type
			(integer,
			 float,
			 double)
			(default is to use the native type of the value)

	This function returns values as follows:

	converted string value

	Synonyms: toHex

	Related functions:

	binary, octal, decimal, radix, toString, toTrimmedString, rad50ToString

-------------------------------------------------------------------------------

	highestBit : returns the highest bit set in a value (or -1)

	bitNumber = highestBit(sourceValue [,startBit] [,numBits])

	Arguments:

	sourceValue	value to check
	[startBit]	starting bit number (starts at 1)
			(default is 1)
	[numBits]	number of bits to check
			(default is 32)

	This function returns values as follows:

	-1			no bits were set
	otherwise		highest set bit number starting at 1

	Related functions:

	lowestBit, bit, bitCount, clearBit, setBit, bitField, bitComplement,
	circularShift

-------------------------------------------------------------------------------

	histogram : divides an array of values into buckets

	numFilled = histogram(values, numBuckets, bucketCounts [,minimum]
			      [,maximum])

	Arguments:

	values		values to histogram
	numBuckets	number of buckets
	bucketCounts	returned array of bucket counts
	[minimum]	minimum of range of histogram
			(default is the minimum input value)
	[maximum]	maximum of range of histogram
			(default is the maximum input value)

	This function returns values as follows:

	number of filled buckets

	Related functions:

	mean, mean2, median, median2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms, stddev, stddev2,
	variance, variance2, identical, identical2, min, max

-------------------------------------------------------------------------------

	historicDataLength : returns the data lengths for a device/property
                            for a given date

	defaultLength = historicDataLength(device, date [,property]
					   [,maximumLength] [,atomicLength])

	Arguments:

	device			device/property of interest
	date			date of interest
	[property]		desired property
				(reading,
				 setting,
				 status,
				 control,
				 analogAlarm,
				 digitalAlarm)
				(default is the implicit property from the
				 device argument)
	[maximumLength]		returned maximum length in bytes
	[atomicLength]		returned atomic length in bytes

	This function returns values as follows:

	default length in bytes

	Related functions:

	historicDeviceAddressing, deviceReadSetHistoricScaling,
	deviceRawToHistoricScaled, devicePropertyLengths,
	deviceDefaultLength, deviceMaximumLength, deviceAtomicLength

-------------------------------------------------------------------------------

	historicDeviceAddressing : returns device addressing for a
                                  device/property for a given date

	node = historicDeviceAddressing(device, date [,property]
					[,ssdn] [,node])

	Arguments:

	device			device/property of interest
	date			date of interest
	[property]		desired property
				(reading,
				 setting,
				 status,
				 control,
				 analogAlarm,
				 digitalAlarm)
				(default is the implicit property from the
				 device argument)
	[ssdn]			returned device property SSDN
	[node]			returned device node

	This function returns values as follows:

	device node

	Related functions:

	historicDataLength, deviceReadSetHistoricScaling,
	deviceRawToHistoricScaled, deviceNode, deviceSsdn

-------------------------------------------------------------------------------

	historicName : returns a device name on a specified date

	string = historicName(device, date [,nameType] [,allowObsolete])

	Arguments:

	device		device of interest
	date		date of interest
	[nameType]	type of device name
			(classicName (default),
			 fullName)
	[allowObsolete]	flag indicating whether or not to allow obsolete devices
			(obsolete -> allow obsolete devices,
			 noObsolete -> don't allow obsolete devices (default))

	This function returns values as follows:

	historic device name string

	Related functions:

	name, fullName, deviceNameExists, text, fullText

-------------------------------------------------------------------------------

	historicRawDataType : returns the raw data type for a device/property
                             for a given date

	rawDataType = historicRawDataType(device, date [,property] [,dataType])

	Arguments:

	device		device of interest
	date		date of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[dataType]	data type to return
			(name -> return data type string (default),
			 number -> return data type number)

	This function returns values as follows:

	device property's raw data type

	Related functions:

	deviceRawDataType, deviceReadSetScaling, deviceDefaultLength,
	historicDataLength, historicDeviceAddressing

-------------------------------------------------------------------------------

	hypot : square root of the sum of the squares of the arguments

	hypotValue = hypot(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	square root of the sum of the squares of the arguments

	Related functions:

	none

-------------------------------------------------------------------------------

	identical : checks to see if all values in an array are identical

	areIdentical = identical(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	TRUE			all of the values are identical
	FALSE			not all of the values are the same

	Examples:

	declare values double[] = 1, 2, 3, 4
	areIdentical = identical(values[])

	areIdentical = identical(value1, value2, value3, value4)

	Related functions:

	identical2, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, sum, sum2, range, range2,
	rms, stddev, stddev2, variance, variance2, min, max, histogram

-------------------------------------------------------------------------------

	identical2 : checks to see if all values in an array are identical

	areIdentical = identical2(values [,numValues] [,tolerance]
				  [,retNumValues])

	Arguments:

	values		values to test
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to test
	[tolerance]	desired tolerance for the comparison test
			(default is 0.0)
	[retNumValues]	returned number of values used

	This function returns values as follows:

	TRUE			all of the values are identical
	FALSE			not all of the values are the same

	Examples:

	declare values double[] = 1, 2, 2, 4
	areIdentical = identical2(values[2],2)

	areIdentical = identical2(values)

	Related functions:

	identical, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, sum, sum2, range, range2,
	rms, stddev, stddev2, variance, variance2, min, max, histogram

-------------------------------------------------------------------------------

	ifLevel : returns the current 'if' level of the script (debugging)

	level = ifLevel()

	This function returns values as follows:

	'if' level of the script (for debugging purposes)

	Related functions:

	loopLevel, variableType, variableArrayDimensions, valueType,
	numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	insertString : inserts a string within another string

	string = insertString(insertString, sourceString [,insertIndex])

	Arguments:

	insertString	string to insert
	sourceString	source string
	[insertIndex]	index at which to insert the string (starts at 1)
			(default is 1)

	This function returns values as follows:

	modified string

	Related functions:

	stringCopy, stringSetChar, replaceString, regexpReplaceString

-------------------------------------------------------------------------------

	integrateDataPoints : calculates the area under a set of data points

	integral = integrateDataPoints(xValues, yValues [,numValues]
				       [,retNumValues])

	Arguments:

	xValues		X coordinate values
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	yValues		Y coordinate values
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to integrate
			(default is the minimum number of X or Y values)
	[retNumValues]	returned number of values used

	This function returns values as follows:

	integral value

	Examples:

	declare xValues double[] = 1, 2, 3, 4, 5
	declare yValues double[] = 1, 2, 1, 4, 2
	integral = integrateDataPoints(xvalues[],yValues[])

	Related functions:

	chiSquare, rms2, rms, mean2, mean, median2, median, mode2, mode,
	minimum2, minimum, maximum2, maximum, sum2, sum, range2, range,
	stddev2, stddev, variance2, variance, identical2, identical,
	min, max, histogram

-------------------------------------------------------------------------------

	ipAddressCompare : determines whether or not two IP address
                          strings point to the same address

	boolean = ipAddressCompare(ipAddress1, ipAddress2)

	Arguments:

	ipAddress1	first IP address string to compare
	ipAddress2	second IP address string to compare

	This function returns values as follows:

	TRUE			IP addresses are not equal
	FALSE			IP addresses are equal

	Related functions:

	convertIpAddress, isNumericIpAddress, ipNameToNode

-------------------------------------------------------------------------------

	ipNameToNode : converts an IP name to an ACNET node value

	nodeValue = ipNameToNode(ipName)

	Arguments:

	ipName		IP name to convert

	This function returns values as follows:

	node value

	Related functions:

	node, trunkNodeToNode, nodeToTrunkNode, isNodeString, nodeIs, nodeIsUp,
	convertIpAddress, isNumericIpAddress, ipAddressCompare

-------------------------------------------------------------------------------

	irmSoftwareVersion : returns the software version for an IRM frontend

	version = irmSoftwareVersion(node [,valueType])

	Arguments:

	node		node to retrieve software version for
	[valueType]	desired form of the version value
			(string (default)
			 date
			 unsignedInteger)

	This function returns values as follows:

	IRM software version

	Related functions:

	frontendSoftwareVersion, acsysSoftwareVersion, moocSoftwareVersion,
	nodeType, isFrontendNode, isCentralNode, isConsoleNode, isMoocNode,
	isMoocDevice, isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice,
	isOacNode, isOacDevice, isLabviewNode, isLabviewDevice

-------------------------------------------------------------------------------

	isAclUser : determines if a user has special ACL permissions

	hasPriv = isAclUser(userName [,privClass] [,privLevel] [,editLevel]
			    [,privMismatch])

	Arguments:

	userName	user name to check
	[privClass]	returned ACL privilege class (0-255)
	[privLevel]	returned ACL privilege level (0-255)
	[editLevel]	returned ACL editor level
	[privMismatch]	returned flag indicating whether or not there
			is a privilege database mismatch

	This function returns values as follows:

	TRUE			user has special ACL permissions
	FALSE			user doesn't have special ACL permissions

	Related functions:

	isValidUserName, isDabbelUser, userIsaPerson, consoleUserNameToId,
	consoleUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserId, myUserName, systemUserNameToId,
	systemUserIdToName, userAttributeValue

-------------------------------------------------------------------------------

	isAcsysFefDevice : determines whether a device property is
                          sourced by an Acsys/FEF node

	boolean = isAcsysFefDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is sourced by a Acsys/FEF front end
	FALSE			device is not sourced by a Acsys/FEF front end

	Related functions:

	isAcsysFefNode, deviceNode, deviceNodeType, isMoocDevice, isOacDevice,
	isIrmDevice, isLabviewDevice, deviceIsStepMotor, deviceIsTimer,
	deviceIsTimerRef

-------------------------------------------------------------------------------

	isAcsysFefNode : determines whether a node is an Acsys/FEF node

	boolean = isAcsysFefNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is an Acsys/FEF front end
	FALSE			node is not an Acsys/FEF front end

	Related functions:

	isAcsysFefDevice, isMoocNode, isIrmNode, isOacNode, isLabviewNode,
	nodeAttributeValue, cacheNodeInfo

-------------------------------------------------------------------------------

	isAlphabeticString : determines whether or not a string is composed
			     entirely of alphabetic characters (plus optional
			     white space)

	boolean = isAlphabeticString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is an alphabetic string
	FALSE			is not an alphabetic string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphanumericString,
	isBlankString, isFloatString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isAlphanumericString : determines whether or not a string is composed
			       entirely of alphanumeric characters (plus
			       optional white space)

	boolean = isAlphanumericString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is an alphanumeric string
	FALSE			is not an alphanumeric string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isBlankString, isFloatString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isArrayDevice : determines whether or not a device/property is an array

	boolean = isArrayDevice(device [,property] [,numElements])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control)
			(default is the implicit property from the device
			 argument)
	[numElements]	returned number of elements

	This function returns values as follows:

	TRUE			device/property is an array
	FALSE			device/property is not an array

	Related functions:

	isStructureDevice, devicePropertyLengths, deviceDefaultLength,
	deviceAtomicLength, deviceMaximumLength, deviceisOacDevice,
	isMoocDevice, isIrmDevice, isLabviewDevice, isAcsysFefDevice

-------------------------------------------------------------------------------

	isBlankString : determines whether or not a string is composed
			entirely of white space

	boolean = isBlankString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a blank string
	FALSE			is not a blank string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isFloatString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isBracketedString : determines whether or not a string is bracketed

	boolean = isBracketedString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a bracketed string
	FALSE			is not a bracketed string

	Related functions:

	stripBrackets, isQuotedString, quoteString, stripQuotes, isLowerCase,
	isUpperCase, isAlphabeticString, isAlphanumericString, isBlankString,
	isFloatString, isIntegerString, isHexString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isPropertyString, isNodeString,
	isErrorString, isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isCamacDevice : determines if a device property is a CAMAC device

	boolean = isCamacDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is a CAMAC device
	FALSE			device is not a CAMAC device

	Related functions:

	isMoocDevice, isMoocNode, deviceNode, deviceNodeType, isOacDevice,
	isIrmDevice, isLabviewDevice, isAcsysFefDevice, deviceIsStepMotor,
	deviceIsTimer, deviceIsTimerRef

-------------------------------------------------------------------------------

	isCentralNode : determines if an ACNET node is a central node

	boolean = isCentralNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is a central node
	FALSE			node is not a central node

	Related functions:

	nodeType, isFrontendNode, isConsoleNode, isMoocNode, isMoocDevice,
	isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice, isOacNode,
	isOacDevice, isLabviewNode, isLabviewDevice, nodeAttributeValue,
	cacheNodeInfo

-------------------------------------------------------------------------------

	isConsoleEnvironment : determines if the calling process is running
                              in a console environment

	boolean = isConsoleEnvironment()

	Arguments:

	<none>

	This function returns values as follows:

	TRUE			running in a console environment
	FALSE			not running in a console environment

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myDisplayName, myControlSystemName, myNode, myNodeName,
	myProcessName, myGenericProcessName, myProgramName, myExecutableName,
	myUserName, myPrivilegeLevel, isRunningOffsite

-------------------------------------------------------------------------------

	isConsoleNode : determines if an ACNET node is a console node

	boolean = isConsoleNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is a console node
	FALSE			node is not a console node

	Related functions:

	nodeType, isFrontendNode, isCentralNode, isMoocNode, isMoocDevice,
	isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice, isOacNode,
	isOacDevice, isLabviewNode, isLabviewDevice, nodeAttributeValue,
	cacheNodeInfo

-------------------------------------------------------------------------------

	isDabbelUser : determines if a user has DABBEL privileges

	hasPriv = isDabbelUser(userName)

	Arguments:

	userName	user name to check

	This function returns values as follows:

	TRUE			user has DABBEL privileges
	FALSE			user doesn't have DABBEL privileges

	Related functions:

	isValidUserName, isAclUser, userIsaPerson, consoleUserNameToId,
	consoleUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserId, myUserName, systemUserNameToId,
	systemUserIdToName, userAttributeValue

-------------------------------------------------------------------------------

	isDateString : determines whether or not a string represents a date

	boolean = isDateString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a date string
	FALSE			is not a date string

	Related functions:

	makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isPropertyString, isNodeString,
	isErrorString, isEventString, isRad50String

-------------------------------------------------------------------------------

	isDeletedDevice : determines whether or not a device has been deleted

	isDeleted = isDeletedDevice(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device has been deleted
	FALSE			device has not been deleted

	Related functions:

	isObsoleteDevice, isDocumentationDevice, deviceState

-------------------------------------------------------------------------------

	isDeviceString : determines whether or not a string represents a
			 device specification

	boolean = isDeviceString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a device string
	FALSE			is not a device string

	Related functions:

	makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isPropertyString, isNodeString, isErrorString,
	isEventString, isDateString, isRad50String, stringExtractDeviceNames

-------------------------------------------------------------------------------

	isDocumentationDevice : determines whether or not a device has been
                               marked as documented

	isDeleted = isDocumentationDevice(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device is a documentation device
	FALSE			device is not a documentation device

	Related functions:

	isObsoleteDevice, isDeletedDevice, deviceState

-------------------------------------------------------------------------------

	isErrorString : determines whether or not a string is an error name

	boolean = isErrorString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is an error string
	FALSE			is not an error string

	Related functions:

	makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isPropertyString, isNodeString,
	isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isEventString : determines whether or not a string represents a
			clock event

	boolean = isEventString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a clock event string
	FALSE			is not a clock event string

	Related functions:

	makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isPropertyString, isNodeString,
	isErrorString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isFloatString : determines whether or not a string represents a
			floating point number

	boolean = isFloatString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a floating point string
	FALSE			is not a floating point string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isBlankString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isFrontendNode : determines if an ACNET node is a frontend node

	boolean = isFrontendNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is a front end
	FALSE			node is not a front end

	Related functions:

	nodeType, isCentralNode, isConsoleNode, isMoocNode, isMoocDevice,
	isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice, isOacNode,
	isOacDevice, isLabviewNode, isLabviewDevice, nodeAttributeValue,
	cacheNodeInfo

-------------------------------------------------------------------------------

	isHexString : determines whether or not a string represents a
		      hexadecimal number

	boolean = isHexString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a hex string
	FALSE			is not a hex string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isBlankString, isFloatString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isInfinity : tests to see if a value is infinite

	boolean = isInfinity(value)

	Arguments:

	value		value to test

	This function returns values as follows:

	TRUE			value is infinite
	FALSE			value is not infinite

	Related functions:

	isNaN

-------------------------------------------------------------------------------

	isIntegerString : determines whether or not a string represents an
			  integer number

	boolean = isIntegerString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is an integer string
	FALSE			is not an integer string

	Synonyms: isNumericString

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isBlankString, isFloatString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isIrmDevice : determines whether a device property is
                     sourced by an IRM node

	boolean = isIrmDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is sourced by an IRM front end
	FALSE			device is not sourced by an IRM front end

	Related functions:

	isIrmNode, deviceNode, deviceNodeType, isMoocDevice, isOacDevice,
	isLabviewDevice, isAcsysFefDevice, deviceIsStepMotor, deviceIsTimer,
	deviceIsTimerRef

-------------------------------------------------------------------------------

	isIrmNode : determines whether a node is an IRM node

	boolean = isIrmNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is an IRM front end
	FALSE			node is not an IRM front end

	Related functions:

	isIrmDevice, isMoocNode, isOacNode, isLabviewNode, isAcsysFefNode,
	nodeAttributeValue, cacheNodeInfo

-------------------------------------------------------------------------------

	isLabviewDevice : determines whether a device property is
                         sourced by a LabView node

	boolean = isLabviewDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is sourced by a LabView front end
	FALSE			device is not sourced by a LabView front end

	Related functions:

	isLabviewNode, deviceNode, deviceNodeType, isMoocDevice, isOacDevice,
	isIrmDevice, isAcsysFefDevice, deviceIsStepMotor, deviceIsTimer,
	deviceIsTimerRef

-------------------------------------------------------------------------------

	isLabviewNode : determines whether a node is a LabView node

	boolean = isLabviewNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is a Labview front end
	FALSE			node is not a Labview front end

	Related functions:

	isLabviewDevice, isMoocNode, isIrmNode, isOacNode, isAcsysFefNode,
	nodeAttributeValue, cacheNodeInfo

-------------------------------------------------------------------------------

	isLowerCase : determines whether or not a string is in all lower case
		      characters

	boolean = isLowerCase(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			string is lower case
	FALSE			string is not lower case

	Related functions:

	isUpperCase, isQuotedString, isAlphabeticString, isAlphanumericString,
	isBlankString, isFloatString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isRad50String

-------------------------------------------------------------------------------

	isMeccaKeeper : returns the number of MECCA projects that
                       a user is the keeper of

	numProjects = isMeccaKeeper(userName [,projectType] [,keeperType]
				    [,projects])

	Arguments:

	userName	user name to check
	[projectType]	MECCA project type
			(pas -> primary applications,
			 sas -> secondary applications,
			 uls -> user libraries,
			 services -> services,
			 pasAndSas -> primary and secondary applications,
			 all -> all project types (default))
	[keeperType]	keeper type
			(primary -> primary keeper,
			 backup -> backup keeper,
			 all -> any type of keeper (default))
	[projects]	returned matching project names

	This function returns values as follows:

	number of matching MECCA projects

	Related functions:

	getMeccaKeepers, isNodeKeeper, getNodeKeepers,
	meccaProjectAttributeValue, maximumMeccaProjectNumber

-------------------------------------------------------------------------------

	isMoocDevice : determines whether a device property is
                      sourced by a MOOC node

	boolean = isMoocDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is sourced by a MOOC front end
	FALSE			device is not sourced by a MOOC front end

	Related functions:

	isMoocNode, deviceNode, deviceNodeType, isOacDevice, isIrmDevice,
	isLabviewDevice, isAcsysFefDevice, isCamacDevice, deviceIsStepMotor,
	deviceIsTimer, deviceIsTimerRef

-------------------------------------------------------------------------------

	isMoocNode : determines whether a node is a MOOC node

	boolean = isMoocNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is a MOOC front end
	FALSE			node is not a MOOC front end

	Related functions:

	isMoocDevice, isIrmNode, isOacNode, isLabviewNode, isAcsysFefNode,
	nodeAttributeValue, cacheNodeInfo

-------------------------------------------------------------------------------

	isNaN : tests to see if a value is a NaN

	boolean = isNaN(value)

	Arguments:

	value		value to test

	This function returns values as follows:

	TRUE			value is not a number (NaN)
	FALSE			value is a number (not a NaN)

	Related functions:

	isInfinity

-------------------------------------------------------------------------------

	isNodeKeeper : returns the number of ACNET nodes that
                      a user is the keeper of

	numNodes = isNodeKeeper(userName [,frontendOnly] [,keeperType]
				[,nodes])

	Arguments:

	userName	user name to check
	[frontendOnly]	only return keepers for frontend nodes
			(true -> frontend nodes only,
			 false -> all nodes (default))
	[keeperType]	keeper type
			(primary -> primary keeper,
			 backup -> backup keeper,
			 all -> any type of keeper (default))
	[nodes]		returned matching node values

	This function returns values as follows:

	number of matching ACNET nodes

	Related functions:

	getNodeKeepers, isMeccaKeeper, getMeccaKeepers

-------------------------------------------------------------------------------

	isNodeString : determines whether or not a string is a node name

	boolean = isNodeString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a node string
	FALSE			is not a node string

	Related functions:

	node, makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isPropertyString, isErrorString,
	isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isNumericIpAddress : determines whether or not an IP address is
                            in numeric form

	boolean = isNumericIpAddress(ipAddress)

	Arguments:

	ipAddress	IP address string to check

	This function returns values as follows:

	TRUE			IP address is in numeric form
	FALSE			IP address is not in numeric form

	Related functions:

	convertIpAddress, ipAddressCompare, ipNameToNode

-------------------------------------------------------------------------------

	isOacDevice : determines whether a device property is
                     sourced by an OAC

	boolean = isOacDevice(device [,property])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(global -> overall device node,
			 reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	TRUE			device is sourced by an OAC
	FALSE			device is not sourced by an OAC

	Related functions:

	isOacNode, deviceNode, deviceNodeType, isMoocDevice, isIrmDevice,
	isLabviewDevice, isAcsysFefDevice, deviceIsStepMotor, deviceIsTimer,
	deviceIsTimerRef

-------------------------------------------------------------------------------

	isOacNode : determines whether a node is an OAC node

	boolean = isOacNode(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is an OAC front end
	FALSE			node is not an OAC front end

	Related functions:

	isOacDevice, isMoocNode, isIrmNode, isLabviewNode, isAcsysFefNode,
	nodeAttributeValue, cacheNodeInfo

-------------------------------------------------------------------------------

	isObsoleteDevice : determines whether or not a device is obsolete

	isObsolete = isObsoleteDevice(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	TRUE			device is obsolete
	FALSE			device is not obsolete

	Related functions:

	isDeletedDevice, isDocumentationDevice, deviceState, device,
	deviceIndex, name, fullName, text, fullText, deviceSpec

-------------------------------------------------------------------------------

	isPrintableString : determines whether or not a string is composed
			    entirely of printable characters

	boolean = isPrintableString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a printable string
	FALSE			is not a printable string

	Related functions:

	makePrintable, stripNonprintables, isLowerCase, isUpperCase,
	isQuotedString, isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isStringFilledWithChar,
	isDeviceString, isPropertyString, isNodeString, isErrorString,
	isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isProgramRunning : determines whether or not a program is running
                          in a location

	numInstances = isProgramRunning(program [,console] [,slot]
					[,matchConsoles] [,matchSlots]
					[,matchNames])

	Arguments:

	program		program name
	[console]	search console
			(default is all)
	[slot]		search slot
			(default is all)
	[matchConsoles]	returned matching consoles
	[matchSlots]	returned matching slots
	[matchNames]	returned matching page names (PAs only)

	This function returns values as follows:

	number of matching instances found

	Related functions:

	taskExists, pidProcessExists, processExists, nodeAcnetTasks, taskId,
	taskPid, isServerTask, taskIdToName, taskPidToName, processInfo

-------------------------------------------------------------------------------

	isPropertyString : determines whether or not a string is a
			   device property name

	boolean = isPropertyString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a property string
	FALSE			is not a property string

	Related functions:

	makePrintable, isLowerCase, isUpperCase, isQuotedString,
	isAlphabeticString, isAlphanumericString, isFloatString,
	isIntegerString, isHexString, isBlankString, isPrintableString,
	isStringFilledWithChar, isDeviceString, isNodeString, isErrorString,
	isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isQuotedString : determines whether or not a string is quoted

	boolean = isQuotedString(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a quoted string
	FALSE			is not a quoted string

	Related functions:

	quoteString, stripQuotes, isBracketedString, isLowerCase, isUpperCase,
	isAlphabeticString, isAlphanumericString, isBlankString, isFloatString,
	isIntegerString, isHexString, isPrintableString, isStringFilledWithChar,
	isDeviceString, isPropertyString, isNodeString, isErrorString,
	isEventString, isDateString, isRad50String

-------------------------------------------------------------------------------

	isRad50String : determines whether or not a string is
                       composed entirely of valid rad50 characters

	boolean = isRad50String(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			is a rad50 string
	FALSE			is not a rad50 string

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isFloatString, isIntegerString, isHexString,
	isBlankString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString, isPrintableString

-------------------------------------------------------------------------------

	isRunningOffsite : determines if the calling process is running offsite

	boolean = isRunningOffsite()

	Arguments:

	<none>

	This function returns values as follows:

	TRUE			running offsite
	FALSE			running onsite

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myDisplayName, myControlSystemName, myNode, myNodeName,
	myProcessName, myGenericProcessName, myProgramName, myExecutableName,
	myUserName, myPrivilegeLevel, isConsoleEnvironment

-------------------------------------------------------------------------------

	isServerTask : determines whether or not an ACNET task is a server

	boolean = isServerTask(taskName [,node])

	Arguments:

	taskName	task name
	[node]		task node
			(default is local machine)

	This function returns values as follows:

	TRUE			task is a server task
	FALSE			task is not a server task

	Related functions:

	taskExists, taskId, taskPid, taskIdToName, taskPidToName,
	pidProcessExists

-------------------------------------------------------------------------------

	isStringFilledWithChar : determines whether or not a string is composed
				 entirely of a single character

	boolean = isStringFilledWithChar(sourceString, character)

	Arguments:

	sourceString	source string
	character	character to check for

	This function returns values as follows:

	TRUE			string is filled with the character
	FALSE			string is not filled with the character

	Related functions:

	isLowerCase, isUpperCase, isQuotedString, isAlphabeticString,
	isAlphanumericString, isFloatString, isIntegerString, isHexString,
	isBlankString, isPrintableString, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString

-------------------------------------------------------------------------------

	isStructureDevice : determines whether or not a device/property
                           is a structure

	boolean = isStructureDevice(device [,property] [,structureName])

	Arguments:

	device		device/property of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[structureName]	returned structure name (if one exists)

	This function returns values as follows:

	TRUE			device/property is a structure
	FALSE			device/property is not a structure

	Related functions:

	isArrayDevice, isOacDevice, isMoocDevice, isIrmDevice,
	isLabviewDevice, isAcsysFefDevice

-------------------------------------------------------------------------------

	isUpperCase : determines whether or not a string is in all upper case
		      characters

	boolean = isUpperCase(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	TRUE			string is upper case
	FALSE			string is not upper case

	Related functions:

	isLowerCase, isQuotedString, isAlphabeticString, isAlphanumericString,
	isBlankString, isFloatString, isIntegerString, isHexString,
	isPrintableString, isStringFilledWithChar, isDeviceString,
	isPropertyString, isNodeString, isErrorString, isEventString,
	isDateString

-------------------------------------------------------------------------------

	isValidSdaCase : determines whether or not a value is a valid SDA case
			 (case instance actually exists)

	boolean = isValidSdaCase(fileNumber, caseValue [,sdaUsage])

	Arguments:

	fileNumber	file number to test
	caseValue	case value to test (number or name)
	[sdaUsage]	desired SDA usage string
			(default is "Collider")

	This function returns values as follows:

	TRUE			is a valid SDA case
	FALSE			is not a valid SDA case

	Related functions:

	isValidSdaFile, isValidSdaSet, dateToSdaFile, sdaFileDate,
	currentSdaFile

-------------------------------------------------------------------------------

	isValidSdaFile : determines whether or not a value is a valid SDA file
			 number (file instance actually exists)

	boolean = isValidSdaFile([fileNumber] [,sdaUsage])

	Arguments:

	[fileNumber]	file number to test
			(default is current SDA file number)
	[sdaUsage]	desired SDA usage string
			(default is "Collider")

	This function returns values as follows:

	TRUE			is a valid SDA file number
	FALSE			is not a valid SDA file number

	Related functions:

	isValidSdaCase, isValidSdaSet, dateToSdaFile, sdaFileDate,
	currentSdaFile

-------------------------------------------------------------------------------

	isValidSdaSet : determines whether or not a value is a valid SDA set
			(set instance actually exists)

	boolean = isValidSdaSet(fileNumber, caseValue [,setNumber] [,sdaUsage])

	Arguments:

	fileNumber	file number to test
	caseValue	case value to test (number or name)
	[setNumber]	set number to test
			(default is 0)
	[sdaUsage]	desired SDA usage string
			(default is "Collider")

	This function returns values as follows:

	TRUE			is a valid SDA set
	FALSE			is not a valid SDA set

	Related functions:

	isValidSdaFile, isValidSdaCase, dateToSdaFile, sdaFileDate,
	currentSdaFile

-------------------------------------------------------------------------------

	isValidUserName : determines if a string is a valid user name

	isValid = isValidUserName(userName [,allowNonuser])

	Arguments:

	userName	user name to validate
	[allowNonuser]	flag indicating whether or not to consider nonuser
			names as valid
			(allowNonuser -> consider nonuser names as valid,
			 dontAllowNonuser -> consider nonuser names as invalid
					     (default))

	This function returns values as follows:

	TRUE			is a valid user name
	FALSE			is not a valid user name

	Related functions:

	userIsaPerson, consoleUserNameToId, consoleUserIdToName,
	consoleUserNameToFullName, fullNameToConsoleUserName, myUserId,
	myUserName, systemUserNameToId, systemUserIdToName, userAttributeValue,
	isAclUser, isDabbelUser

-------------------------------------------------------------------------------

	javaAppInfo : returns Java application information given the name
                     or the application ID

	appName = javaAppInfo(appNameOrId [,appId] [,description] [,helpUrl]
			      [,author] [,reference])

	Arguments:

	appNameOrId	application name or ID to retrieve information for
	[appId]		returned application ID
	[description]	returned application description
	[helpUrl]	returned application help URL
	[author]	returned application author user name
	[reference]	returned application reference string

	This function returns values as follows:

	application name

	Related functions:

	javaAppInfoByRef

-------------------------------------------------------------------------------

	javaAppInfoByRef : returns Java application information given
			   a reference ID

	appName = javaAppInfoByRef(referenceId [,codeType] [,appId]
				   [,description] [,helpUrl] [,author]
				   [,reference])

	Arguments:

	referenceId	reference ID to retrieve information for
	[codeType]	code type to retrieve information for
			(jws -> Java Web Start,
			 html -> HTML,
			 excel -> Excel,
			 applet -> applet,
			 standalone -> standalone app,
			 jas -> Java Analysis Studio)
			(default is any code type)
	[appId]		returned application ID
	[description]	returned application description
	[helpUrl]	returned application help URL
	[author]	returned application author user name
	[reference]	returned application reference string

	This function returns values as follows:

	application name

	Related functions:

	javaAppInfo

-------------------------------------------------------------------------------

	julianDate : converts a date value to a julian date

	julianDate = julianDate([date])

	Arguments:

	[date]		date value to convert
			(default is now)

	This function returns values as follows:

	converted Julian date

	Related functions:

	julianDateToDate, dateToString, stringtoDate, convertSeconds, timeAgo,
	timeFromDate, timeSinceEvent, cpuTime, systemTime, 15HzCount, timer,
	currentDate, currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	julianDateToDate : converts a julian date value to a date

	date = julianDateToDate([julianDate])

	Arguments:

	[julianDate]	Julian date value to convert
			(default is now)

	This function returns values as follows:

	converted date

	Related functions:

	julianDate, dateToString, stringtoDate, convertSeconds, timeAgo,
	timeFromDate, timeSinceEvent, cpuTime, systemTime, 15HzCount, timer,
	currentDate, currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	justify : left justify, right justify, or center a string

	string = justify(sourceString [,justifyType])

	Arguments:

	sourceString	source string
	[justifyType]	justification type
			(none -> leave string as is (default),
			 left -> left justify,
			 right -> right justify,
			 center -> center string)

	This function returns values as follows:

	modified string

	Related functions:

	leftJustify, rightJustify, center, leftShift, rightShift, strShift, pad

-------------------------------------------------------------------------------

	labelLineNumber : returns the source line number for a label

	lineNumber = labelLineNumber(labelName)

	Arguments:

	labelName	desired label name

	This function returns values as follows:

	source line number of the requested label

	Synonyms: label_line_number

	Related functions:

	none

-------------------------------------------------------------------------------

	land : logical and

	boolean = land(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	TRUE
	FALSE

	Related functions:

	lor

-------------------------------------------------------------------------------

	lastCharPos : find the last nonblank character position in a string

	position = lastCharPos(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	0			no nonblank characters were not found
	otherwise		character position (starts at 1)

	Related functions:

	firstCharPos, getLastChar, getFirstChar, stringEndsWith,
	stringStartsWith, findChar, findNotChar

-------------------------------------------------------------------------------

	leftJustify : left justify a string

	string = leftJustify(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	justify, rightJustify, center, leftShift, rightShift, strShift, pad

-------------------------------------------------------------------------------

	leftShift : left shift a string

	string = leftShift(sourceString [,numChars])

	Arguments:

	sourceString	source string
	[numChars]	number of characters to shift
			(default is 1)

	This function returns values as follows:

	modified string

	Related functions:

	strShift, rightShift, justify, leftJustify, rightJustify, center, pad

-------------------------------------------------------------------------------

	leftTrim : removes leading blanks from a string

	string = leftTrim(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	trim, rightTrim, toTrimmedString, pad

-------------------------------------------------------------------------------

	lexSaDevices : returns devices in a Lex SA display

	numDevices = lexSaDevices(lexSaName, [,deviceNames] [,properties]
				  [,arrayIndices] [,fullNames])

	Arguments:

	lexSaName	Lex SA name
	[deviceNames]	returned device names
	[properties]	returned device properties
	[arrayIndices]	returned device array indices
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices found in the Lex SA display

	Related functions:

	fileDevices, sqlQueryDevices, loggerListDevices, userAlarmListDevices,
	userSaveListDevices, parameterPageDevices, synopticDevices

-------------------------------------------------------------------------------

	llrfCurveCurrentLength : returns the current length of a LLRF curve

	rootName = llrfCurveCurrentLength(device)

	Arguments:

	device		curve device name

	This function returns values as follows:

	current number of slots in the requested LLRF curve

	Related functions:

	llrfCurveMaxLength, llrfCurveRootName

-------------------------------------------------------------------------------

	llrfCurveMaxLength : returns the maximum length of a LLRF curve

	rootName = llrfCurveMaxLength(device)

	Arguments:

	device		curve device name

	This function returns values as follows:

	maximum number of slots in the requested LLRF curve

	Related functions:

	llrfCurveCurrentLength, llrfCurveRootName

-------------------------------------------------------------------------------

	llrfCurveRootName : returns the LLRF curve device root name

	rootName = llrfCurveRootName(device)

	Arguments:

	device		curve device name

	This function returns values as follows:

	root name for LLRF curve devices

	Related functions:

	llrfCurveMaxLength, llrfCurveCurrentLength

-------------------------------------------------------------------------------

	ln : natural log (base e)

	logValue = ln(value)

	Arguments:

	value		original value

	This function returns values as follows:

	natural (base e) logarithm of argument

	Synonyms: loge

	Related functions:

	log, exp

-------------------------------------------------------------------------------

	localtime : breaks down a date value into its component values

	date = localtime([date] [,year] [,month] [,day] [,hour] [,minute]
			 [,second] [,yearDay] [,weekDay] [,isDst]
			 [,monthIndex] [,dayIndex])

	Arguments:

	[date]		date to break down
			(default is the present time)
	[year]		returned year value
	[month]		returned month string value
	[day]		returned day of the month value
	[hour]		returned hour value
	[minute]	returned minute value
	[second]	returned second value
	[yearDay]	returned day of the year value
	[weekDay]	returned day of the week string value
	[isDst]		returned DST boolean value
	[monthIndex]	returned month index value
	[dayIndex]	returned day of the week index value

	This function returns values as follows:

	date value in seconds

	Synonyms: brokenDownTime

	Related functions:

	stringToDate, dateToString, currentDate, currentTimeInClinks,
	currentTime, millisecondsNow, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, determineDstDates, millisecondsToDate,
	dateToMilliseconds

-------------------------------------------------------------------------------

	log : base 10 log

	logValue = log(value)

	Arguments:

	value		original value

	This function returns values as follows:

	base 10 logarithm of argument

	Synonyms: log10

	Related functions:

	ln

-------------------------------------------------------------------------------

	loggerAvailableDeviceDataEntries : finds available logged data entries
                                          for a device from a node

	numEntries = loggerAvailableDeviceDataEntries(loggerNode, device,
						      [,deviceNames]
						      [,dataEvents]
						      [,listIds])

	Arguments:

	loggerNode	logger node
	device		device
	[deviceNames]	returned matching device names
	[dataEvents]	returned matching data events
	[listIds]	returned matching list IDs

	This function returns values as follows:

	number of matching data entries found

	Related functions:

	loggerAvailableDeviceDates, oldestLoggerTime, loggerListDevices,
	allLoggerNodes, loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	whereDeviceWasLogged, loggerNameToNode, nodeToLoggerName,
	loggerGetListDataEvents, loggerFindListsByDataEvent,
	loggerFindDevicesByDataEvent

-------------------------------------------------------------------------------

	loggerAvailableDeviceDates : finds the available logged dates for
                                    a device from a node

	datesFound = loggerAvailableDeviceDates(loggerNode, deviceName
						[,sampleSpec] [,sampleType]
						[,oldestDate] [,oldestMillis]
						[,newestDate] [,newestMillis])

	Arguments:

	loggerNode	logger node
	deviceName	device name
	[sampleSpec]	sample specification which depends on the
			sampleType argument
			(data event string (default is null string),
			 logger list number (0-17))
	[sampleType]	sample specification type
			(dataEvent (default),
			 list)
	[oldestDate]	returned oldest available date found
	[oldestMillis]	returned oldest available date fraction of a second
			in milliseconds
	[newestDate]	returned newest available date found
	[newestMillis]	returned newest available date fraction of a second
			in milliseconds

	This function returns values as follows:

	TRUE			device dates were found
	FALSE			no matching data was found

	Related functions:

	loggerAvailableDeviceDataEntries, oldestLoggerTime, loggerListDevices,
	allLoggerNodes, loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	whereDeviceWasLogged, loggerNameToNode, nodeToLoggerName,
	loggerGetListDataEvents, loggerFindListsByDataEvent,
	loggerFindDevicesByDataEvent

-------------------------------------------------------------------------------

	loggerFindDevicesByDataEvent : finds the devices logged on a data event

	numDevices = loggerFindDevicesByDataEvent(dataEvent [,loggerNode]
						  [,deviceNames] [,nodes]
						  [,nodeNames] [,listIds]
						  [,listNames] [,indices]
						  [,dataEvents])

	Arguments:

	dataEvent	data event string to match
	[loggerNode]	logger node
			(default is all nodes)
	[deviceNames]	returned matching device names
	[nodes]		returned matching node values
	[nodeNames]	returned matching logger node names
	[listIds]	returned matching list ID numbers (0-17)
	[listNames]	returned matching list names
	[indices]	returned matching device display indices (0-59)
	[dataEvents]	returned matching data event strings

	This function returns values as follows:

	number of matching devices

	Related functions:

	loggerFindListsByDataEvent, loggerGetListDataEvents,
	loggerAvailableDeviceDates, loggerAvailableDeviceDataEntries,
	oldestLoggerTime, loggerListDevices, allLoggerNodes,
	loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	whereDeviceWasLogged, loggerNameToNode, nodeToLoggerName

-------------------------------------------------------------------------------

	loggerFindListsByDataEvent : finds the lists logged on a data event

	numLists = loggerFindListsByDataEvent(dataEvent [,loggerNode]
					      [,nodes] [,nodeNames]
					      [,listIds] [,listNames]
					      [,columns] [,dataEvents])

	Arguments:

	dataEvent	data event string to match
	[loggerNode]	logger node
			(default is all nodes)
	[nodes]		returned matching node values
	[nodeNames]	returned matching logger node names
	[listIds]	returned matching list ID numbers (0-17)
	[listNames]	returned matching list names
	[columns]	returned matching list column numbers (-1-4)
	[dataEvents]	returned matching data event strings

	This function returns values as follows:

	number of logger lists

	Related functions:

	loggerGetListDataEvents, loggerFindDevicesByDataEvent,
	loggerAvailableDeviceDates, loggerAvailableDeviceDataEntries,
	oldestLoggerTime, loggerListDevices, allLoggerNodes,
	loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	whereDeviceWasLogged, loggerNameToNode, nodeToLoggerName

-------------------------------------------------------------------------------

	loggerGetListDataEvents : retrieves all data logger data events

	numEvents = loggerGetListDataEvents(dataEvents [,loggerNode]
					    [,listId])

	Arguments:

	dataEvents	returned array of logger data event strings
	[loggerNode]	logger node
			(default is all nodes)
	[listId]	logger list ID (0-17)
			(default is all lists)
			(If this argument is specified, the logger node
			 should also be specified, and all of the data
			 events for that logger list will be returned
			 in the order they are specified.)

	This function returns values as follows:

	number of distinct logger data event strings

	Related functions:

	loggerFindListsByDataEvent, loggerFindDevicesByDataEvent,
	loggerAvailableDeviceDates, loggerAvailableDeviceDataEntries,
	oldestLoggerTime, loggerListDevices, allLoggerNodes,
	loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	whereDeviceWasLogged, loggerNameToNode, nodeToLoggerName

-------------------------------------------------------------------------------

	loggerIsEnabled : determines if the requested data logger
                         is enabled (logging)

	isEnabled = loggerIsEnabled(loggerNode)

	Arguments:

	loggerNode	data logger node

	This function returns values as follows:

	TRUE			data logger is enabled (logging)
	FALSE			data logger is disabled (not logging)

	Related functions:

	loggerIsUp, allLoggerNodes, loggerNameToNode, nodeToLoggerName,
	loggerListInfo, loggerListDevices, loggerListDeviceStats,
	loggerListWrapTime, whereDeviceIsLogged, whereDeviceWasLogged,
	oldestLoggerTime

-------------------------------------------------------------------------------

	loggerIsUp : determines if a requested data logger is running

	isUp = loggerIsUp(loggerNode [,restartTime] [,startTime])

	Arguments:

	loggerNode	data logger node
	[restartTime]	returned date and time when the logger was restarted
	[startTime]	returned date and time when the logger was started

	This function returns values as follows:

	TRUE			data logger is running
	FALSE			data logger is not running

	Related functions:

	loggerIsEnabled, allLoggerNodes, loggerNameToNode, nodeToLoggerName,
	loggerListInfo, loggerListDevices, loggerListDeviceStats,
	loggerListWrapTime, whereDeviceIsLogged, whereDeviceWasLogged,
	oldestLoggerTime

-------------------------------------------------------------------------------

	loggerListDevices : returns the devices in a data logger list

	numDevices = loggerListDevices(loggerNode, list [,devices] [,fullNames])

	Arguments:

	loggerNode	logger node
	list		logger list number (0-17)
	[devices]	returned logger list device names
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices being logged in the requested list

	Related functions:

	allLoggerNodes, loggerListDeviceStats, loggerIsUp, loggerIsEnabled,
	loggerListInfo, loggerListWrapTime, whereDeviceIsLogged,
	oldestLoggerTime, loggerNameToNode, nodeToLoggerName,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	loggerListDeviceStats : returns logger list device configuration stats

	numDevices = loggerListDeviceStats(loggerNode, list [,numElements]
					   [,maxElesPerDev] [,minArrayIndex]
					   [,maxArrayIndex] [,hasReading]
					   [,hasSetting] [,hasStatus])

	Arguments:

	loggerNode	logger node
	list		logger list number (0-17)
	[numElements]	returned total number of elements logged
	[maxElesPerDev]	returned maximum number of elements per device
	[minArrayIndex]	returned minimum device array index
	[maxArrayIndex]	returned maximum device array index
	[hasReading]	returned flag indicating the presence of
			reading properties
	[hasSetting]	returned flag indicating the presence of
			setting properties
	[hasStatus]	returned flag indicating the presence of
			status properties

	This function returns values as follows:

	number of devices being logged

	Related functions:

	loggerListDevices, loggerListInfo, loggerListWrapTime, loggerIsUp,
	loggerIsEnabled, whereDeviceIsLogged, oldestLoggerTime,
	loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	loggerListInfo : returns general logger list information

	numDevices = loggerListInfo(loggerNode, list [,name] [,numEvents]
				    [,events] [,maxElements] [,numElements]
				    [,maxElesPerDev] [,minArrayIndex]
				    [,maxArrayIndex] [,hasReading]
				    [,hasSetting] [,hasStatus])

	Arguments:

	loggerNode	logger node
	list		logger list number (0-17)
	[name]		returned list name
	[numEvents]	returned number of supported data events
	[events]	returned data event(s)
	[maxElements]	returned maximum number of elements that list can hold
	[numElements]	returned total number of elements logged
	[maxElesPerDev]	returned maximum number of elements per device
	[minArrayIndex]	returned minimum device array index
	[maxArrayIndex]	returned maximum device array index
	[hasReading]	returned flag indicating the presence of
			reading properties
	[hasSetting]	returned flag indicating the presence of
			setting properties
	[hasStatus]	returned flag indicating the presence of
			status properties

	This function returns values as follows:

	number of devices being logged

	Related functions:

	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	loggerIsUp, loggerIsEnabled, whereDeviceIsLogged, oldestLoggerTime,
	loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	loggerListWrapTime : returns a logger list wrap time in hours

	wrapTime = loggerListWrapTime(loggerNode, list)

	Arguments:

	loggerNode	logger node
	list		logger list number (0-17)

	This function returns values as follows:

	list wrap time in hours

	Related functions:

	loggerListInfo, loggerListDevices, loggerListDeviceStats, loggerIsUp,
	loggerIsEnabled, whereDeviceIsLogged, oldestLoggerTime,
	loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	loggerNameToNode : converts a data logger name to its corresponding node

	node = loggerNameToNode(loggerName)

	Arguments:

	loggerName	logger name to convert

	This function returns values as follows:

	corresponding node

	Related functions:

	nodeToLoggerName, allLoggerNodes, loggerIsUp, loggerIsEnabled,
	oldestLoggerTime, whereDeviceIsLogged, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	loggersOnNode : returns the data loggers running on an ACNET node

	numLoggers = loggersOnNode([node] [,loggerNames])

	Arguments:

	[node]		node of interest
			(default is local node)
	[loggerNames]	returned data logger names

	This function returns values as follows:

	number of data loggers found

	Related functions:

	oacsOnNode, coresidentNodes, nodeAcnetTasks, node, nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	loopLevel : returns the current loop level of the script (debugging)

	level = loopLevel()

	This function returns values as follows:

	loop level of the script (for debugging purposes)

	Related functions:

	ifLevel, variableType, variableArrayDimensions, valueType,
	numQueuedDataEventCallbacks

-------------------------------------------------------------------------------

	lor : logical or

	boolean = lor(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	TRUE
	FALSE

	Related functions:

	land

-------------------------------------------------------------------------------

	lowestBit : returns the lowest bit set in a value (or -1)

	bitNumber = lowestBit(sourceValue [,startBit] [,numBits])

	Arguments:

	sourceValue	value to check
	[startBit]	starting bit number (starts at 1)
			(default is 1)
	[numBits]	number of bits to check
			(default is 32)

	This function returns values as follows:

	-1			no bits were set
	otherwise		lowest set bit number starting at 1

	Related functions:

	highestBit, bit, bitCount, clearBit, setBit, bitField, bitComplement,
	circularShift

-------------------------------------------------------------------------------

	lshft : circular left shift

	value = lshft(sourceValue, numShift)

	Arguments:

	sourceValue	value to modify
	numShift	number of bits to shift by

	This function returns values as follows:

	modified value with the bits circularly shifted to the left

	Related functions:

	circularShift, rshft, clearBit, setBit, bit, bitCount, bitField,
	bitComplement

-------------------------------------------------------------------------------

	madcNumAvailableClockLevels : returns the number of available
                                     clock levels for an MADC

	numAvailable = madcNumAvailableClockLevels(node, madcNumber)

	Arguments:

	node		desired node
	madcNumber	desired MADC number

	This function returns values as follows:

	number of available clock levels

	Related functions:

	deviceMadcLocation, madcNumChannels, madcNumAvailableLists,
	madcNumAvailablePlotChannels

-------------------------------------------------------------------------------

	madcNumAvailableLists : returns the number of available lists
                               for an MADC

	numAvailable = madcNumAvailableLists(node, madcNumber)

	Arguments:

	node		desired node
	madcNumber	desired MADC number

	This function returns values as follows:

	number of available lists

	Related functions:

	deviceMadcLocation, madcNumChannels, madcNumAvailableClockLevels,
	madcNumAvailablePlotChannels

-------------------------------------------------------------------------------

	madcNumAvailablePlotChannels : returns the number of available
                                      plot channels for an MADC

	numAvailable = madcNumAvailablePlotChannels(node, madcNumber)

	Arguments:

	node		desired node
	madcNumber	desired MADC number

	This function returns values as follows:

	number of available plot channels

	Related functions:

	deviceMadcLocation, madcNumChannels, madcNumAvailableLists,
	madcNumAvailableClockLevels

-------------------------------------------------------------------------------

	madcNumChannels : returns the number of channels for an MADC

	numChannels = madcNumChannels(node, madcNumber [,maxChannelUsed])

	Arguments:

	node		 desired node
	madcNumber	 desired MADC number
	[maxChannelUsed] returned maximum channel used

	This function returns values as follows:

	number of MADC channels

	Related functions:

	deviceMadcLocation, madcNumAvailableLists,
	madcNumAvailableClockLevels, madcNumAvailablePlotChannels

-------------------------------------------------------------------------------

	maintainerDevices : retrieve the devices maintained by a user

	numDevices = maintainerDevices(maintainerName [,deviceNames])

	Arguments:

	maintainerName	maintainer name
	[deviceNames]	returned device names

	This function returns values as follows:

	number of matching devices

	Related functions:

	getDeviceMaintainers

-------------------------------------------------------------------------------

	makeLoggerDataSourceString : builds a data logger data source string

	string = makeLoggerDataSourceString(loggerNode, sampleDate [,accuracy])

	Arguments:

	loggerNode	desired logger node
	sampleDate	desired data sample date
	[accuracy]	desired sample date accuracy in seconds
			(default is 60)

	This function returns values as follows:

	data logger data source string

	Related functions:

	makeSaveRestoreDataSourceString, makeSdaDataSourceString

-------------------------------------------------------------------------------

	makePrintable : expand any tabs and remove or replace any nonprintable
			characters in a string

	string = makePrintable(sourceString [,modifyType])

	Arguments:

	sourceString	source string
	[modifyType]	string modification type
			(remove -> remove nonprintable characters (default),
			 replace -> replace nonprintable characters with
			 blanks)

	This function returns values as follows:

	modified string

	Related functions:

	stripNonprintables, isPrintableString

-------------------------------------------------------------------------------

	makeSaveRestoreDataSourceString : builds a save/restore
                                         data source string

	string = makeSaveRestoreDataSourceString(fileNumber)

	Arguments:

	fileNumber	desired save/restore file number

	This function returns values as follows:

	save/restore data source string

	Related functions:

	makeLoggerDataSourceString, makeSdaDataSourceString

-------------------------------------------------------------------------------

	makeSdaDataSourceString : builds an SDA data source string

	string = makeSdaDataSourceString(sdaUsage, fileNumber, sdaCase
					 [,sdaSubcase])

	Arguments:

	sdaUsage	desired SDA usage
			(ColliderShot,
			 PbarTransferShot,
			 RecyclerShot)
	fileNumber	desired SDA file number
	sdaCase		desired SDA case (depends on the desired SDA usage)
	[sdaSubcase]	desired SDA subcase (depends on the desired SDA usage)

	This function returns values as follows:

	SDA data source string

	Related functions:

	makeSaveRestoreDataSourceString, makeLoggerDataSourceString

-------------------------------------------------------------------------------

	maskAbortInput : masks an abort input

	boolean = maskAbortInput(system, module, input)

	Arguments:

	system		abort system of interest
			(Booster,
			 Recycler,
			 MainInjector,
			 Switchyard,
			 p1Line,
			 p2Line,
			 BooNE,
			 NuMI,
			 Muon,
			 Test)
	module		name of the module to mask
	input		abort input number to mask (1-8)

	This function returns values as follows:

	TRUE			abort input was masked

	Related functions:

	unmaskAbortInput, abortLoopIsUp, abortSystemReset, beamPermitIsUp,
	beamSwitchIsOn, thisSoftwareBeamSwitchIsOn

-------------------------------------------------------------------------------

	matrixAdd : adds two matrices of the same size

	numElements = matrixAdd(matrix1, matrix2 [,resultMatrix])

	Arguments:

	matrix1		first input matrix (If the resultMatrix is defaulted,
			this will also be the output matrix.)
	matrix2		second input matrix
	[resultMatrix]	result matrix

	This function returns status values as follows:

	number of elements modified

	Related functions:

	matrixMultiply, matrixScalarMultiply, matrixDeterminant,
	matrixInvert, matrixSolve

-------------------------------------------------------------------------------

	matrixDeterminant : calculates the determinant of a matrix

	determinant = matrixDeterminant(matrix)

	Arguments:

	matrix		matrix of interest

	This function returns status values as follows:

	determinant of the matrix

	Related functions:

	matrixMultiply, matrixScalarMultiply, matrixAdd, matrixInvert,
	matrixSolve

-------------------------------------------------------------------------------

	matrixInvert : inverts a two dimensional matrix

	matrixInvert(matrix, [,invertedMatrix])

	Arguments:

	matrix		 matrix to invert
	[invertedMatrix] resulting inverted matrix

	This function returns values as follows:

	<none>

	Related functions:

	matrixAdd, matrixMultiply, matrixScalarMultiply, matrixDeterminant,
	matrixSolve

-------------------------------------------------------------------------------

	matrixMultiply : multiplies two compatible matrices

	numElements = matrixMultiply(matrix1, matrix2, resultMatrix)

	Arguments:

	matrix1		first input matrix
	matrix2		second input matrix
	resultMatrix	result matrix

	This function returns status values as follows:

	number of elements in result matrix

	Related functions:

	matrixAdd, matrixScalarMultiply, matrixDeterminant, matrixInvert,
	matrixSolve

-------------------------------------------------------------------------------

	matrixScalarMultiply : multiplies all members of a matrix by a
                              scalar value

	numElements = matrixScalarMultiply(matrix, multiplier [,resultMatrix])

	Arguments:

	matrix		input matrix (If the resultMatrix is defaulted,
			this will also be the output matrix.)
	multiplier	scalar multiplier
	[resultMatrix]	result matrix

	This function returns status values as follows:

	number of elements modified

	Related functions:

	matrixMultiply, matrixAdd, matrixDeterminant, matrixInvert, matrixSolve

-------------------------------------------------------------------------------

	matrixSolve : uses a two dimensional matrix to solve a
                     system of linear equations

	numValues = matrixSolve(matrix, rhsValues [,solutionValues])

	Arguments:

	matrix		 input matrix
	rhsValues	 equation right hand side values
	[solutionValues] solution values

	This function returns status values as follows:

	number of solution values

	Related functions:

	matrixAdd, matrixMultiply, matrixScalarMultiply, matrixDeterminant,
	matrixInvert

-------------------------------------------------------------------------------

	max : maximum of two values

	maximumValue = max(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	maximum value

	Related functions:

	min, maximum, maximum2, minimum, minimum2, mean, mean2,
	median, median2, mode, mode2, sum, sum2, range, range2,
	rms, stddev, stddev2, variance, variance2,
	identical, identical2

-------------------------------------------------------------------------------

	maximum : determines the maximum of an array of values

	maxValue = maximum(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	maximum value

	Examples:

	declare values double[] = 1, 2, 3, 4
	maxValue = maximum(values[])

	maxValue = maximum(value1, value2, value3, value4)

	Related functions:

	maximum2, minimum, minimum2, mean, mean2, median, median2,
	mode, mode2, sum, sum2, range, range2, rms, stddev, stddev2,
	variance, variance2, identical, identical2, min, max

-------------------------------------------------------------------------------

	maximum2 : determines the maximum of an array of values

	maxValue = maximum2(values [,numValues] [,retNumValues])

	Arguments:

	value		values to find the maximum of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to find the maximum of
	[retNumValues]	returned number of values used

	This function returns values as follows:

	maximum value

	Examples:

	declare values double[] = 1, 2, 3, 4
	maxValue = maximum2(values[2],2)

	maxValue = maximum2(values[])

	Related functions:

	maximum, minimum2, minimum, mean2, mean, median2, median,
	mode2, mode, sum2, sum, range2, range, rms, stddev2, stddev,
	variance, variance2, identical, identical2, min, max

-------------------------------------------------------------------------------

	maximumConsoleNode : returns the maximum console node

	consoleNodeName = maximumConsoleNode([nodeValue] [,nodeNumber])

	Arguments:

	[nodeValue]		returned maximum console node value
	[nodeNumber]		returned maximum console node number

	This function returns values as follows:

	maximum console node name

	Related functions:

	none

-------------------------------------------------------------------------------

	maximumDeviceIndex : returns the maximum device index
                            (and optionally the minimum)

	maxDeviceIndex = maximumDeviceIndex([minDeviceIndex] [,options...])

	Arguments:

	[minDeviceIndex]	returned minimum device index
	[options...]		query options
				(obsolete -> include obsolete devices,
				 deleted -> include deleted devices)

	This function returns values as follows:

	maximum device index in the control system

	Related functions:

	totalNumberOfDevices

-------------------------------------------------------------------------------

	maximumMeccaProjectNumber : returns the maximum number for a
                                   MECCA project type

	maximumNumber = maximumMeccaProjectNumber([projectType])

	Arguments:

	[projectType]	MECCA project type
			(pas -> primary applications (default),
			 sas -> secondary applications)

	This function returns values as follows:

	maximum MECCA project number

	Related functions:

	maximumPaNumber, maximumSaNumber, meccaProjectAttributeValue,
	getMeccaKeepers, isMeccaKeeper

-------------------------------------------------------------------------------

	maximumPaNumber : returns the maximum PA (Primary Application) number

	maximumNumber = maximumPaNumber()

	Arguments:

	none

	This function returns values as follows:

	maximum PA number

	Related functions:

	maximumMeccaProjectNumber, maximumSaNumber

-------------------------------------------------------------------------------

	maximumSaNumber : returns the maximum SA (Secondary Application) number

	maximumNumber = maximumSaNumber()

	Arguments:

	none

	This function returns values as follows:

	maximum SA number

	Related functions:

	maximumMeccaProjectNumber, maximumPaNumber

-------------------------------------------------------------------------------

	mdatCurrentDate : returns the current date being transmitted
                         on the MDAT link

	date = mdatCurrentDate([timeError])

	Arguments:

	[timeError]	returned time error with respect to the calling node
			in seconds

	This function returns values as follows:

	current MDAT date value

	Related functions:

	currentDate, currentTimeInClinks, currentTime, localtime,
	convertSeconds, utcSecondsToDate, timeAgo, timeFromDate, stringToDate,
	dateToString, timeSinceEvent, cpuTime, systemTime, 15HzCount, timer,
	julianDate, julianDateToDate

-------------------------------------------------------------------------------

	mean : calculates the mean of an array of values

	meanValue = mean(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	mean value

	Examples:

	declare values double[] = 1, 2, 3, 4
	meanValue = mean(values[])

	meanValue = mean(value1, value2, value3, value4)

	Related functions:

	mean2, median, median2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms,
	stddev, stddev2, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	mean2 : calculates the mean of an array of values

	meanValue = mean2(values [,numValues] [,sum] [,retNumValues])

	Arguments:

	values		values to average
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to average
	[sum]		returned sum value
	[retNumValues]	returned number of values used

	This function returns values as follows:

	mean value

	Examples:

	declare values double[] = 1, 2, 3, 4
	meanValue = mean2(values[2],2)

	meanValue = mean2(values[])

	Related functions:

	mean, median2, median, mode2, mode, minimum2, minimum,
	maximum2, maximum, sum2, sum, range2, range, rms,
	stddev2, stddev, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	meccaProjectAttributeValue : returns MECCA project attribute values

	value = meccaProjectAttributeValue(program, attribute [,projectType])

	Arguments:

	program		program/project name to retrieve value for
	attribute	program/project attribute type
			(keeper -> keeper name,
			 keeperEmail -> keeper email,
			 backup -> backup keeper name,
			 backupEmail -> backup keeper email,
			 author -> author name,
			 authorEmail -> author email,
			 description -> program/project description,
			 projectType -> MECCA project type,
			 status -> program/project status,
			 location(codeType) -> program/project location/code type,
			 numBuilds -> number of builds,
			 modifyDate -> date last modified,
			 modifiedBy -> last modifier user name,
			 modifierEmail -> last modifier's email,
			 modifiedFrom -> directory last modified from,
			 modifyTag -> CVS tag from last modification,
			 releaseDate -> date last released,
			 releasedBy -> user name who last released,
			 releaserEmail -> last releaser's email,
			 releasedFrom -> directory last released from,
			 releaseTag -> CVS tag from last release,
			 sqaLevel -> SQA (Software Quality Assurance) level)
	[projectType]	MECCA project type
			(pas,
			 sas
			 uls
			 services)
			(default is to ignore the project type)

	This function returns values as follows:

	MECCA project attribute value

	Related functions:

	genericProgramSearch, maximumMeccaProjectNumber, isMeccaKeeper,
	getMeccaKeepers

-------------------------------------------------------------------------------

	median : calculates the median of an array of values

	medianValue = median(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	median value

	Examples:

	declare values double[] = 1, 2, 3, 4
	medianValue = median(values[])

	medianValue = median(value1, value2, value3, value4)

	Related functions:

	median2, mean, mean2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms,
	stddev, stddev2, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	median2 : calculates the median of an array of values

	medianValue = median2(values [,numValues] [,midpoint] [,retNumValues])

	Arguments:

	values		values to calculate the median of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to find the median of
	[midpoint]	returned array midpoint index
	[retNumValues]	returned number of values used

	This function returns values as follows:

	median value

	Examples:

	declare values double[] = 1, 2, 3, 4
	medianValue = median2(values[2],2)

	medianValue = median2(values[])

	Related functions:

	median, mean, mean2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms,
	stddev, stddev2, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	millisecondsNow : returns the current time in milliseconds
			  since the Epoch

	milliseconds = millisecondsNow([timeReference])

	Arguments:

	[timeReference]	time reference
			(delta -> return delta time since previous call,
			 scriptStart -> return delta time since start
					of script)
			(default is the beginning of the Epoch)

	This function returns values as follows:

	milliseconds since the Epoch

	Related functions:

	millisecondsToDate, dateToMilliseconds, 15hzCount, currentTime,
	currentDate, currentTimeInClinks, systemTime, cpuTime, timer,
	timeSinceEvent, timeAgo, timeFromDate, stringToDate, dateToString,
	convertSeconds, julianDate, julianDateToDate, localtime

-------------------------------------------------------------------------------

	millisecondsToDate : converts a number of milliseconds to its
                            corresponding date

	date = millisecondsToDate([milliseconds])

	Arguments:

	[milliseconds]	milliseconds to convert
			(default is 0 which results in the current time)

	This function returns values as follows:

	corresponding date

	Related functions:

	dateToMilliseconds, millisecondsNow, 15hzCount, currentTime,
	currentDate, currentTimeInClinks, systemTime, cpuTime, timer,
	timeSinceEvent, timeAgo, timeFromDate, stringToDate, dateToString,
	convertSeconds, julianDate, julianDateToDate, localtime

-------------------------------------------------------------------------------

	min : minimum of two values

	minimumValue = min(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	minimum value

	Related functions:

	max, minimum, minimum2, maximum, maximum2, mean, mean2,
	median, median2, mode, mode2, sum, sum2, range, range2,
	rms, stddev, stddev2, variance, variance2,
	identical, identical2, histogram

-------------------------------------------------------------------------------

	minimum : determines the minimum of an array of values

	minValue = minimum(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	minimum value

	Examples:

	declare values double[] = 1, 2, 3, 4
	minValue = minimum(values[])

	minValue = minimum(value1, value2, value3, value4)

	Related functions:

	minimum2, maximum, maximum2, mean, mean2, median, median2,
	mode, mode2, sum, sum2, range, range2, rms, stddev, stddev2,
	variance, variance2, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	minimum2 : determines the minimum of an array of values

	minValue = minimum2(values [,numValues] [,retNumValues])

	Arguments:

	values		values to find the minimum of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to find the minimum of
	[retNumValues]	returned number of values used

	This function returns values as follows:

	minimum value

	Examples:

	declare values double[] = 1, 2, 3, 4
	minValue = minimum2(values[2],2)

	minValue = minimum2(values[])

	Related functions:

	minimum, maximum2, maximum, mean2, mean, median2, median,
	mode2, mode, sum2, sum, range2, range, rms, stddev2, stddev,
	variance2, variance, identical, identical2, min, max

-------------------------------------------------------------------------------

	mode : returns the most commonly occurring value in an array
	       (If there are multiple mode values, the smallest value
		is returned.)

	modeValue = mode(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	smallest mode value

	Examples:

	declare values double[] = 1, 2, 3, 4
	modeValue = mode(values[])

	modeValue = mode(value1, value2, value3, value4)

	Related functions:

	mode2, median, median2, mean, mean2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms,
	stddev, stddev2, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	mode2 : returns the most commonly occurring value in an array
	        (If there are multiple mode values, the smallest value
		 is returned.)

	modeValue = mode2(values [,numValues] [,modeCount] [,retNumValues])

	Arguments:

	values		values to calculate the mode of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to determine the mode from
	[modeCount]	returned mode count
	[retNumValues]	returned number of values used

	This function returns values as follows:

	smallest mode value

	Examples:

	declare values double[] = 1, 2, 1, 3, 1, 4, 4
	modeValue = mode2(values[3],4)

	modeValue = mode2(values[])

	Related functions:

	mode, median, median2, mean, mean2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms,
	stddev, stddev2, variance, variance2, identical, identical2,
	min, max, histogram

-------------------------------------------------------------------------------

	moocSoftwareVersion : returns the software version for a MOOC frontend

	version = moocSoftwareVersion(node [,valueType])

	Arguments:

	node		node to retrieve software version for
	[valueType]	desired form of the version value
			(string (default)
			 double
			 integer)

	This function returns values as follows:

	MOOC software version

	Related functions:

	frontendSoftwareVersion, acsysSoftwareVersion, irmSoftwareVersion,
	nodeType, isFrontendNode, isCentralNode, isConsoleNode, isMoocNode,
	isMoocDevice, isAcsysFefNode, isAcsysFefDevice, isIrmNode, isIrmDevice,
	isOacNode, isOacDevice, isLabviewNode, isLabviewDevice

-------------------------------------------------------------------------------

	myAcnetUserName : returns the caller's ACNET user name

	userName = myAcnetUserName()

	Arguments:

	<none>

	This function returns values as follows:

	ACNET user name

	Related functions:

	myUserName, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myNode, myNodeName, myDisplayName,
	myProcessName, myGenericProcessName, myProgramName, myExecutableName,
	myPrivilegeLevel, myControlSystemName, consoleUserNameToFullName,
	fullNameToConsoleUserName, userAttributeValue, systemUserNameToId,
	systemUserIdToName

-------------------------------------------------------------------------------

	myConsole : returns the caller's console number

	consoleNumber = myConsole()

	Arguments:

	<none>

	This function returns values as follows:

	console number

	Related functions:

	myConsoleClass, myConsoleInstance, myConsoleSlot,  myHostName, myNode,
	myNodeName, myDisplayName, myProcessName, myGenericProcessName,
	myProgramName, myExecutableName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myConsoleClass : returns the caller's console class

	classMask = myConsoleClass([numClasses] [,classNames])

	Arguments:

	[numClasses]	returned number of classes
	[classNames]	returned array of class names

	This function returns values as follows:

	console class mask

	Related functions:

	consoleClassMaskToString, stringToConsoleClassMask, myConsole,
	myConsoleInstance, myConsoleSlot, myHostName, myNode, myNodeName,
	myDisplayName, myProcessName, myGenericProcessName, myProgramName,
	myExecutableName, myUserName, myPrivilegeLevel, myControlSystemName

-------------------------------------------------------------------------------

	myConsoleInstance : returns the caller's console instance number

	instanceNumber = myConsoleInstance()

	Arguments:

	<none>

	This function returns values as follows:

	console instance number

	Related functions:

	myConsole, myConsoleClass, myConsoleSlot, myHostName, myNode,
	myNodeName, myDisplayName, myProcessName, myGenericProcessName,
	myProgramName, myExecutableName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myConsoleSlot : returns the caller's console slot

	consoleSlot = myConsoleSlot()

	Arguments:

	<none>

	This function returns values as follows:

	console slot

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myHostName, myNode,
	myNodeName, myDisplayName, myProcessName, myGenericProcessName,
	myProgramName, myExecutableName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myControlSystemName : returns the control system instance name

	name = myControlSystemName()

	Arguments:

	<none>

	This function returns values as follows:

	control system instance name

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myNode, myNodeName, myHostName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName, myUserName,
	myPrivilegeLevel

-------------------------------------------------------------------------------

	myDbUserName : returns the current database connection name

	userName = myDbUserName([wantSpecial])

	Arguments:

	[wantSpecial]	flag indicating whether or not to include special
			login information
			(wantSpecial
			 dontWantSpecial (default))

	This function returns values as follows:

	database user name

	Related functions:

	myUserName, myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myNode, myNodeName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName,
	myPrivilegeLevel, myControlSystemName, consoleUserNameToFullName,
	fullNameToConsoleUserName, userAttributeValue, systemUserNameToId,
	systemUserIdToName

-------------------------------------------------------------------------------

	myDisplayName : returns the caller's display name

	name = myDisplayName()

	Arguments:

	<none>

	This function returns values as follows:

	caller's display name

	Related functions:

	myHostName, myNode, myNodeName, myConsole, myConsoleClass,
	myConsoleInstance, myConsoleSlot, myProcessName, myGenericProcessName,
	myProgramName, myExecutableName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myExecutableName : returns the caller's executable name

	name = myExecutableName([nameType])

	Arguments:

	[nameType]	name type
			(fullPath -> return the full path (default),
			 rootOnly -> return the root of the name)

	This function returns values as follows:

	executable name

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myNode, myNodeName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myGenericProcessName : returns the caller's generic process name

	name = myGenericProcessName()

	Arguments:

	<none>

	This function returns values as follows:

	generic process name

	Related functions:

	myProcessName, myProgramName, myExecutableName, myConsole,
	myConsoleClass, myConsoleInstance, myConsoleSlot, myHostName, myNode,
	myNodeName, myDisplayName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myHostName : returns the caller's host name

	name = myHostName()

	Arguments:

	<none>

	This function returns values as follows:

	host name

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myNode, myNodeName, myDisplayName, myProcessName, myGenericProcessName,
	myProgramName, myExecutableName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myNode : returns the caller's ACNET node

	node = myNode()

	Arguments:

	<none>

	This function returns values as follows:

	ACNET node

	Related functions:

	myNodeName, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName, myUserName,
	myPrivilegeLevel, myControlSystemName

-------------------------------------------------------------------------------

	myNodeName : returns the caller's ACNET node name

	nodeName = myNodeName()

	Arguments:

	<none>

	This function returns values as follows:

	ACNET node name

	Related functions:

	myNode, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName,
	myUserName, myPrivilegeLevel, myControlSystemName

-------------------------------------------------------------------------------

	myParentPid : returns the caller's parent's process ID

	pid = myParentPid()

	Arguments:

	<none>

	This function returns values as follows:

	caller's parent's process ID (pid)

	Related functions:

	myPid, myNodeName, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName, myUserName,
	myPrivilegeLevel, myControlSystemName, myNode

-------------------------------------------------------------------------------

	myPid : returns the caller's process ID

	pid = myPid()

	Arguments:

	<none>

	This function returns values as follows:

	caller's process ID (pid)

	Related functions:

	myParentPid, myNodeName, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName, myUserName,
	myPrivilegeLevel, myControlSystemName, myNode

-------------------------------------------------------------------------------

	myPrivilegeLevel : returns the caller's ACL privilege level

	level = myPrivilegeLevel()

	Arguments:

	<none>

	This function returns values as follows:

	caller's ACL privilege level (0-255)

	Related functions:

	myProcessName, myGenericProcessName, myProgramName, myExecutableName,
	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myNode, myNodeName, myDisplayName, myUserName,
	myControlSystemName

-------------------------------------------------------------------------------

	myProcessName : returns the caller's process name

	name = myProcessName([nameType])

	Arguments:

	[nameType]	name type
			(generic -> generic process name (default),
			 current -> current process name,
			 full -> full process name)

	This function returns values as follows:

	process name

	Related functions:

	myGenericProcessName, myProgramName, myExecutableName, myConsole,
	myConsoleClass, myConsoleInstance, myConsoleSlot, myHostName, myNode,
	myNodeName, myDisplayName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	myProgramName : returns the caller's program (MECCA project) name

	name = myProgramName()

	Arguments:

	<none>

	This function returns values as follows:

	program (MECCA project) name

	Related functions:

	myProcessName, myGenericProcessName, myExecutableName, myConsole,
	myConsoleClass, myConsoleInstance, myConsoleSlot, myHostName, myNode,
	myNodeName, myDisplayName, myUserName, myPrivilegeLevel,
	myControlSystemName

-------------------------------------------------------------------------------

	mySystemInfo : returns basic system information

	hostName = mySystemInfo([domainName] [,opSystem] [,opRelease]
				[,opVersion] [,machine])

	Arguments:

	[domainName]	returned domain name
	[opSystem]	returned operating system
	[opRelease]	returned operating system release
	[opVersion]	returned operating system version
	[machineType]	returned machine type

	This function returns values as follows:

	host name

	Related functions:

	myConsole, myConsoleClass, myConsoleInstance, myConsoleSlot,
	myHostName, myNode, myNodeName, myDisplayName, myProcessName,
	myGenericProcessName, myProgramName, myExecutableName, myUserName,
	myPrivilegeLevel, myControlSystemName

-------------------------------------------------------------------------------

	mySystemUserId : returns the caller's system user ID

	userId = mySystemUserId()

	Arguments:

	<none>

	This function returns values as follows:

	caller's system user ID

	Related functions:

	myUserId, myUserName, myConsole, myConsoleClass,
	myConsoleInstance, myConsoleSlot, myHostName, myNode, myNodeName,
	myDisplayName, myProcessName, myGenericProcessName, myProgramName,
	myExecutableName, myPrivilegeLevel, myControlSystemName,
	consoleUserNameToFullName, fullNameToConsoleUserName,
	userAttributeValue, systemUserNameToId, systemUserIdToName

-------------------------------------------------------------------------------

	myUserId : returns the caller's console user ID

	userId = myUserId()

	Arguments:

	<none>

	This function returns values as follows:

	caller's console user ID

	Related functions:

	myUserName, mySystemUserId, myConsole, myConsoleClass,
	myConsoleInstance, myConsoleSlot, myHostName, myNode, myNodeName,
	myDisplayName, myProcessName, myGenericProcessName, myProgramName,
	myExecutableName, myPrivilegeLevel, myControlSystemName,
	consoleUserNameToFullName, fullNameToConsoleUserName,
	userAttributeValue, systemUserNameToId, systemUserIdToName

-------------------------------------------------------------------------------

	myUserName : returns the caller's user name

	userName = myUserName()

	Arguments:

	<none>

	This function returns values as follows:

	user name

	Related functions:

	myAcnetUserName, myConsole, myConsoleClass, myConsoleInstance,
	myConsoleSlot, myHostName, myNode, myNodeName, myDisplayName,
	myProcessName, myGenericProcessName, myProgramName, myExecutableName,
	myPrivilegeLevel, myControlSystemName, consoleUserNameToFullName,
	fullNameToConsoleUserName, userAttributeValue, systemUserNameToId,
	systemUserIdToName

-------------------------------------------------------------------------------

	name : returns a device name string

	string = name(device [,nameType] [,allowObsolete] [,completeName])

	Arguments:

	device		device of interest
	[nameType]	type of device name
			(classicName (default),
			 fullName)
	[allowObsolete]	flag indicating whether or not to allow obsolete devices
			(obsolete -> allow obsolete devices,
			 noObsolete -> don't allow obsolete devices (default))
	[completeName]	flag indicating whether or not to return complete names
			(complete -> return complete names including property
				     and array index,
			 simple -> return simple names (default))

	This function returns values as follows:

	device name string

	Related functions:

	fullName, deviceNameExists, historicName, text, fullText

-------------------------------------------------------------------------------

	networkServiceToPort : converts a network service name to a port

	port = networkServiceToPort(serviceName)

	Arguments:

	serviceName	service name to convert

	This function returns values as follows:

	port number

	Related functions:

	<none>

-------------------------------------------------------------------------------

	newestLoggerTime : returns the most recent timestamp for a logged device

	date = newestLoggerTime(device [,loggerNode] [,dataEvent])

	Arguments:

	device		device to check
	[loggerNode]	logger node to check
			(default is "fastest")
	[dataEvent]	data event string to check for
			(default is null string)

	This function returns values as follows:

	most recent logged timestamp for the requested device

	Related functions:

	oldestLoggerTime, loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	loggerIsUp, loggerIsEnabled, whereDeviceIsLogged, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	whereDeviceWasLogged, oldestSrFile, newestSrFile, currentSdaFile,
	dateToSdaFile, sdaFileDate

-------------------------------------------------------------------------------

	newestSrFile : returns the newest save/restore file number

	fileNumber = newestSrFile([category])

	Arguments:

	[category]	desired save/restore category
			(all -> all categories (default),
			 global,
			 linac,
			 booster,
			 mainInjector,
			 externalBeams,
			 tevatron,
			 muon,
			 frig (cryo),
			 electronCooling,
			 archive,
			 recycler,
			 shots,
			 circular,
			 miniboone,
			 numi,
			 pxie,
			 nml,
			 mta,
			 syconfig,
			 cmtf)

	This function returns values as follows:

	newest save/restore file number for the requested category

	Related functions:

	oldestSrFile, saveFileInfo, currentSdaFile, dateToSdaFile, sdaFileDate,
	saveFileDeviceErrors, saveFileDeviceStatus, checkOperatorSaveStatus,
	abortOperatorSave

-------------------------------------------------------------------------------

	nextSibling : returns the device's next sibling (or 0)

	siblingDevice = nextSibling(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device's next sibling

	Related functions:

	previousSibling, controllingDevice

-------------------------------------------------------------------------------

	node : converts a node name to a value

	nodeValue = node(value [,outputType])

	Arguments:

	value		value to convert (device, string, or node value)
			(If the value is a device value, the node for that
			 device will be used.)
	[outputType]	output type
			(numeric -> integer value (default),
			 name -> node symbolic name string,
			 trunkNode -> trunk/node string,
			 hex -> hex string,
			 ipName -> IP name string,
			 ipAddress -> IP address string,
			 device -> treat value as a device index and
				   return the corresponding node value)

	This function returns values as follows:

	node value

	Related functions:

	isNodeString, nodeIs, nodeIsUp, nodeAcnetTasks, error, isErrorString,
	device, name, fullName, text, fullText

-------------------------------------------------------------------------------

	nodeAcnetNodeIpAddress : returns the IP address for one ACNET node
				 from another

	ipAddress = nodeAcnetNodeIpAddress(node, ipNode [,addressType])

	Arguments:

	node		node to read from
	ipNode		node to retrieve IP address for
	[addressType]	type of IP address to return
			(integer,
			 numeric,
			 name)

	This function returns values as follows:

	node IP address value

	Related functions:

	node, nodeToTrunkNode, nodeStatus, nodeAttributeValue, nodeAcnetTasks,
	nodeType, nodeSoftwareType, nodeHardwareType, nodeConsolidator,
	nodeTimeError, nodeCreationDate, genericNodeSearch, cacheNodeInfo,
	nodeIs, nodeIsUp, isIrmNode, isLabviewNode, isMoocNode, isOacNode,
	isAcsysFefNode, nodeAlarmList

-------------------------------------------------------------------------------

	nodeAcnetTasks : retrieves the ACNET tasks for a given node

	numTasks = nodeAcnetTasks([node] [,taskNames] [,isRum] [,taskIds]
				  [,pids])

	Arguments:

	[node]		node of interest
			(default is local node)
	[taskNames]	returned ACNET task names
	[isRum]		returned flags indicating whether or not the
			corresponding tasks are RUM connected (server)
	[taskIds]	returned ACNET task IDs
	[pids]		returned process IDs

	This function returns values as follows:

	number of ACNET tasks found

	Related functions:

	taskExists, taskPidToName, taskIdToName, node, nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	nodeAlarmList : retrieves the default alarm list for an ACNET node

	alarmList = nodeAlarmList(node [,wantString])

	Arguments:

	node		node to retrieve value for
	[wantString]	return value type
			(string -> return string value (default),
			 numeric -> return numeric value)

	This function returns values as follows:

	node default alarm list

	Related functions:

	nodeAttributeValue, genericNodeSearch, cacheNodeInfo, nodeIs, nodeIsUp,
	isIrmNode, isLabviewNode, isMoocNode, isOacNode, isAcsysFefNode,
	nodeStatus, nodeType, nodeSoftwareType, nodeHardwareType

-------------------------------------------------------------------------------

	nodeAttributeValue : returns ACNET node attribute values

	value = nodeAttributeValue(node, attribute)

	Arguments:

	node		node to retrieve value for
	attribute	node attribute type
			(name -> node name,
			 description -> node description,
			 location -> node location,
			 keeper -> node keeper,
			 keeperUserName -> node keeper console user name,
			 keeperEmail -> node keeper email,
			 backupKeeper -> node backup keeper,
			 backupKeeperUserName -> node backup keeper console
						 user name,
			 backupKeeperEmail -> node backup keeper email,
			 status -> node status,
			 system -> node system type,
			 software -> node software type,
			 hardware -> node hardware type,
			 opsys -> node operating system,
			 area -> node area,
			 readDevice -> node guaranteed readable device,
			 setDevice -> node guaranteed settable device,
			 todDevice -> node time of day device,
			 uptimeDevice -> node uptime device,
			 downloadDevice -> node download device,
			 rebootDevice -> node reboot device,
			 versionDevice -> node version device,
			 ipName -> node IP name,
			 url -> node help URL,
			 isFrontend -> flag indicating if the node is a frontend,
			 isCentral -> flag indicating if the node is a central,
			 isConsole -> flag indicating if the node is a console,
			 isOac -> flag indicating if the node is an OAC,
			 supportsAlarms -> flag indicating if the node supports
					   alarms,
			 supportsFtp -> flag indicating if the node supports
					fast time plot protocol,
			 supportsTclk -> flag indicating if the node supports
					 retrieving data on a TCLK event,
			 supportsGets32 -> flag indicating if the node supports
					   retrieving data with the Gets32
					   protocol,
			 alarmList -> default alarm list)

	This function returns values as follows:

	node attribute value

	Related functions:

	genericNodeSearch, cacheNodeInfo, nodeIs, nodeIsUp, isIrmNode,
	isLabviewNode, isMoocNode, isOacNode, isAcsysFefNode, nodeStatus,
	nodeType, nodeSoftwareType, nodeHardwareType

-------------------------------------------------------------------------------

	nodeConsolidator : returns the consolidating node(s) for a node

	primaryNode = nodeConsolidator(node [,secondaryNode])

	Arguments:

	node		node to retrieve consolidator node(s) for
	[secondaryNode]	returned secondary consolidator node value

	This function returns values as follows:

	primary consolidator node value

	Related functions:

	nodeAttributeValue, cacheNodeInfo, nodeIs, nodeIsUp, isIrmNode,
	isLabviewNode, isMoocNode, isOacNode, isAcsysFefNode

-------------------------------------------------------------------------------

	nodeCreationDate : returns the creation date for a node

	creationDate = nodeCreationDate(node)

	Arguments:

	node		node of interest

	This function returns values as follows:

	creation date for the node

	Related functions:

	nodeAttributeValue, nodeSoftwareType, nodeHardwareType, nodeStatus,
	node, cacheNodeInfo, nodeIs, nodeIsUp, nodeType, isFrontendNode,
	isCentralNode, isConsoleNode, isAcsysFefNode, isMoocNode, isOacNode,
	isIrmNode, isLabviewNode, oacsOnNode

-------------------------------------------------------------------------------

	nodeDevicesWithProperty : returns devices from a node having a
                                 specified property

	numDevices = nodeDevicesWithProperty(node, property [,devices]
					     [,properties])

	Arguments:

	node		node to retrieve devices for
	property	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
	[devices]	returned matching device names
	[properties]	returned matching device properties

	This function returns values as follows:

	number of matching devices

	Related functions:

	nodeAttributeValue, nodeAlarmList, genericNodeSearch, cacheNodeInfo,
	nodeIs, nodeIsUp, isIrmNode, isLabviewNode, isMoocNode, isOacNode,
	isAcsysFefNode, nodeStatus, nodeType, nodeSoftwareType, nodeHardwareType

-------------------------------------------------------------------------------

	nodeHardwareType : returns the hardware type of an ACNET node

	hardwareType = nodeHardwareType(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	VME
	PC (Intel)
	VME (IRM)
	VME (HRM)
	VME (SRM)
	VME (Power PC)
	VXI
	PXI
	Macintosh

	Related functions:

	nodeAttributeValue, nodeSoftwareType, nodeStatus, node, cacheNodeInfo,
	nodeIs, nodeIsUp, nodeType, isFrontendNode, isCentralNode,
	isConsoleNode, isAcsysFefNode, isMoocNode, isOacNode, isIrmNode,
	isLabviewNode, oacsOnNode

-------------------------------------------------------------------------------

	nodeIs : determines whether or not the specified node has a particular
		 status or type

	boolean = nodeIs(node, attrType, attrValue)

	Arguments:

	node		node to check
	attrType	node attribute type
			(status -> node status,
			 system -> node system type,
			 software -> node software type,
			 hardware -> node hardware type,
			 opsys -> node operating system,
			 area -> node area)
	attrValue	node attribute value

	This function returns values as follows:

	TRUE			node matches the requested attribute value
	FALSE			node doesn't match the requested attribute value

	Related functions:

	nodeIsUp

-------------------------------------------------------------------------------

	nodeIsUp : determines whether or not the specified node is up

	boolean = nodeIsUp(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	TRUE			node is up
	FALSE			node is down

	Related functions:

	nodeIs, acnetPing

-------------------------------------------------------------------------------

	nodeSoftwareType : returns the software type of an ACNET node

	softwareType = nodeSoftwareType(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	MOOC
	ACSys/FEF
	IRM
	Frig MOOC
	Labview
	Java
	Acnet-NG
	Consolidator
	Multicast

	Related functions:

	nodeAttributeValue, nodeHardwareType, nodeStatus, node, cacheNodeInfo,
	nodeIs, nodeIsUp, nodeType, isFrontendNode, isCentralNode,
	isConsoleNode, isAcsysFefNode, isMoocNode, isOacNode, isIrmNode,
	isLabviewNode, oacsOnNode

-------------------------------------------------------------------------------

	nodeStatus : returns the status of an ACNET node

	status = nodeStatus(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	Operational
	Test
	Out of Service
	Out of Service (Tevatron)
	Obsolete

	Related functions:

	nodeAttributeValue, node, cacheNodeInfo, nodeIs, nodeIsUp, nodeType,
	nodeSoftwareType, nodeHardwareType, isFrontendNode, isCentralNode,
	isConsoleNode, isAcsysFefNode, isMoocNode, isOacNode, isIrmNode,
	isLabviewNode, oacsOnNode

-------------------------------------------------------------------------------

	nodeTimeError : returns the current time error for a node

	timeError = nodeTimeError(node)

	Arguments:

	node		node to check

	This function returns values as follows:

	node time error in milliseconds

	Related functions:

	nodeType, isFrontendNode, isCentralNode, isConsoleNode, isAcsysFefNode,
	isMoocNode, isOacNode, isIrmNode, isLabviewNode, nodeAttributeValue,
	node, cacheNodeInfo, nodeStatus, nodeSoftwareType, nodeHardwareType,
	nodeIs, nodeIsUp, oacsOnNode

-------------------------------------------------------------------------------

	nodeToLoggerName : convert a node value to a data logger name

	loggerName = nodeToLoggerName(node)

	Arguments:

	node		node to convert

	This function returns values as follows:

	corresponding logger name

	Related functions:

	loggerNameToNode, allLoggerNodes, loggerIsUp, loggerIsEnabled,
	whereDeviceIsLogged, oldestLoggerTime, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	whereDeviceWasLogged

-------------------------------------------------------------------------------

	nodeToTrunkNode : converts an ACNET node value to its component
                         trunk and node number

	isValidNode = nodeToTrunkNode(node [,trunk] [,nodeNumber])

	Arguments:

	node		ACNET node value
	[trunk]		returned trunk number
	[nodeNumber]	returned node number

	This function returns values as follows:

	TRUE			is valid ACNET node value
	FALSE			is not a valid ACNET node value

	Related functions:

	trunkNodeToNode, node, ipNameToNode, isNodeString, nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	nodeType : returns ACNET node type information

	type = nodeType(node [,subtype])

	Arguments:

	node		node to check
	[subtype]	returned node subtype
			(none
			 MOOC
			 ACSys/FEF
			 IRM
			 Labview
			 DAE)

	This function returns values as follows:

	frontend
	central
	console
	multicast

	Related functions:

	isFrontendNode, isCentralNode, isConsoleNode, isAcsysFefNode,
	isMoocNode, isOacNode, isIrmNode, isLabviewNode,
	nodeAttributeValue, node, cacheNodeInfo, nodeStatus,
	nodeSoftwareType, nodeHardwareType, nodeIs, nodeIsUp,
	oacsOnNode

-------------------------------------------------------------------------------

	nonblankLength : returns the nonblank length of a string

	length = nonblankLength(string [,maxLength])

	Arguments:

	string		string to determine the length of
	[maxLength]	maximum length to return
			(default is infinite)

	This function returns values as follows:

	nonblank string length

	Related functions:

	stringLength, delimitedStringLength, sizeof, sizeofVariable

-------------------------------------------------------------------------------

	numElements : returns the number of elements in a variable or a
		      device specification (dynamic)

	numberOfElements = numElements(object)

	Arguments:

	object		object (device or variable) to determine the number
			of elements of

	This function returns values as follows:

	number of elements

	Related functions:

	sizeof, byteSizeof, sizeofVariable, byteSizeofVariable, variableType,
	variableArrayDimensions

-------------------------------------------------------------------------------

	numQueuedDataEventCallbacks : returns the number of queued
                                     data event callbacks

	numEvents = numQueuedDataEventCallbacks()

	This function returns values as follows:

	number of queued data event callbacks (for debugging purposes)

	Related functions:

	loopLevel, ifLevel, variableType, variableArrayDimensions, valueType

-------------------------------------------------------------------------------

	numReadableProperties : returns the number of readable properties
				for a device (optionally also returns the
				array of properties)

	numProperties = numReadableProperties(device [,properties])

	Arguments:

	device		device of interest
	[properties]	returned array of properties found

	This function returns values as follows:

	number of readable properties found for the requested device

	Related functions:

	numSettableProperties, deviceProperties, hasProperty, hasReading,
	hasSetting, hasStatus, hasControl, hasAnalogAlarm, hasDigitalAlarm,
	deviceDownloadProperties, device

-------------------------------------------------------------------------------

	numSettableProperties : returns the number of settable properties
				for a device (optionally also returns the
				array of properties)

	numProperties = numSettableProperties(device [,properties])

	Arguments:

	device		device of interest
	[properties]	returned array of properties found

	This function returns values as follows:

	number of settable properties found for the requested device

	Related functions:

	numReadableProperties, deviceProperties, hasProperty, hasReading,
	hasSetting, hasStatus, hasControl, hasAnalogAlarm, hasDigitalAlarm,
	deviceDownloadProperties, device

-------------------------------------------------------------------------------

	oacsOnNode : returns the names of OACs running on an ACNET node

	numOacs = oacsOnNode([node] [,oacNames])

	Arguments:

	[node]		node of interest
			(default is local node)
	[oacNames]	returned OAC (Open Access CLient) names

	This function returns values as follows:

	number of OACs found

	Related functions:

	loggersOnNode, coresidentNodes, nodeAcnetTasks, node, nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	octal : returns a value as an octal string

	string = octal(value [,convertLength] [,fillChar] [,dataType])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[fillChar]	fill character
	[dataType]	data type
			(integer,
			 float,
			 double)
			(default is to use the native type of the value)

	This function returns values as follows:

	converted string value

	Synonyms: toOctal

	Related functions:

	hex, binary, decimal, radix, toString, toTrimmedString, rad50ToString

-------------------------------------------------------------------------------

	offsetCharacter : increments a character in a string by a
                         requested amount

	string = offsetCharacter(sourceString [,increment] [,index])

	Arguments:

	sourceString	source string
	[increment]	number of ASCII positions to increment
			(default is 1)
	[index]		index of character to increment
			(default is 0)

	This function returns values as follows:

	modified string

	Related functions:

	stringSetChar, replaceString, toUpper, toLower, capitalize,

-------------------------------------------------------------------------------

	oldestLoggerTime : returns the oldest timestamp for a logged device

	date = oldestLoggerTime(device [,loggerNode] [,dataEvent])

	Arguments:

	device		device to check
	[loggerNode]	logger node to check
			(default is "fastest")
	[dataEvent]	data event string to check for
			(default is null string)

	This function returns values as follows:

	oldest logged timestamp for the requested device

	Related functions:

	newestLoggerTime, loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	loggerIsUp, loggerIsEnabled, whereDeviceIsLogged, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	whereDeviceWasLogged, oldestSrFile, newestSrFile, currentSdaFile,
	dateToSdaFile, sdaFileDate

-------------------------------------------------------------------------------

	oldestSettingLogDate : returns the old and newest setting log
                              entry dates

	date = oldestSettingLogDate([device] [,latestDate])

	Arguments:

	[device]	device to find setting log dates for
			(default is to find the dates for all devices)
	[latestDate]	returned latest setting log entry date

	This function returns values as follows:

	oldest setting log entry date

	Related functions:

	settingsAreEnabled

-------------------------------------------------------------------------------

	oldestSrFile : returns the oldest save/restore file number

	fileNumber = oldestSrFile([category])

	Arguments:

	[category]	desired save/restore category
			(all -> all categories (default),
			 global,
			 linac,
			 booster,
			 mainInjector,
			 externalBeams,
			 tevatron,
			 muon,
			 frig (cryo),
			 electronCooling,
			 archive,
			 recycler,
			 shots,
			 circular,
			 miniboone,
			 numi,
			 pxie,
			 nml,
			 mta,
			 syconfig,
			 cmtf)

	This function returns values as follows:

	oldest save/restore file number for the requested category

	Related functions:

	newestSrFile, saveFileInfo, currentSdaFile, dateToSdaFile, sdaFileDate,
	saveFileDeviceErrors, saveFileDeviceStatus, checkOperatorSaveStatus,
	abortOperatorSave

-------------------------------------------------------------------------------

	openFile : opens a file for reading and/or writing

	fileId = openFile(fileName [,openMode] [,flushFile])

	Arguments:

	fileName	file to open
	[openMode]	file open mode
			(r (default),
			 w,
			 a,
			 r+,
			 w+,
			 a+)
	[flushFile]	flag indicating whether or not to flush the file
			after each write
			(flush,
			 noFlush (default))

	This function returns values as follows:

	file ID for use by future file functions

	Synonyms: fopen, fileOpen

	Related functions:

	closeFile, fileGetString, filePrintf, fscanf, fileRead, fileRewind,
	fileWrite, fileFlush, fileSetPosition, fileGetPosition

-------------------------------------------------------------------------------

	or : bitwise or

	resultValue = or(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	bitwise or of the two arguments

	Related functions:

	xor, and

-------------------------------------------------------------------------------

	pad : pads a string with a specified character to a specified length

	string = pad(sourceString, padLength [,padChar])

	Arguments:

	sourceString	source string
	padLength	length to pad the string to
			(If the length is less than the present length
			 of the string, the string is truncated.)
	[padChar]	pad character
			(default is blank)

	This function returns values as follows:

	modified string

	Related functions:

	pos, trim, leftTrim, rightTrim, toTrimmedString

-------------------------------------------------------------------------------

	pageTitle : returns the title for a page

	title = pageTitle(page)

	Arguments:

	page		page to retrieve title for (ex: 'M4')

	This function returns values as follows:

	page title

	Related functions:

	pageTitleList, programMapping

-------------------------------------------------------------------------------

	pageTitleList : returns the titles for a list of pages

	numTitles = pageTitleList(pages [,numPages] [,titles])

	Arguments:

	pages		pages to retrieve titles for (ex: 'M4')
	[numPages]	number of pages
			(default is the number of elements in "pages")
	[titles]	returned index page titles

	This function returns values as follows:

	number of page titles

	Related functions:

	pageTitle, programMapping

-------------------------------------------------------------------------------

	parameterPageDevices : returns the devices on a parameter page

	numDevices = parameterPageDevices(paramPage [,deviceNames]
					  [,arrayIndices] [,fullNames])

	Arguments:

	paramPage	parameter page subpage
			({page}:{subpage 1}[:{subpage 2}][:{subpage 3}])
	[deviceNames]	returned device names
	[arrayIndices]	returned device array indices
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices found on the parameter page

	Related functions:

	deviceParameterPageMapping, paramPageConfigInfo,
	paramPageSubpageMenuTitles, paramPageSubpageInfo,
	fileDevices, sqlQueryDevices, loggerListDevices,
	userAlarmListDevices, userSaveListDevices

-------------------------------------------------------------------------------

	paramPageConfigInfo : retrieves parameter page configuration
                             information

	numRows = paramPageConfigInfo(pageName [,numLevel1] [,level1Len]
				      [,level1Text] [,numLevel2] [,level2Len]
				      [,level2Text] [,numLevel3] [,level3Len]
				      [,level3Text])

	Arguments:

	pageName	parameter page name
			(e.g. "M4")
	[numLevel1]	returned number of level 1 subpages
	[level1Len]	returned length of a level 1 subpage name
	[level1Text]	returned array of level 1 subpage names
	[numLevel2]	returned number of level 2 subpages
	[level2Len]	returned length of a level 2 subpage name
	[level2Text]	returned array of level 2 subpage names
			(If numLevel3 is 0, there will be numLevel2 strings.
			 Otherwise, there will be numLevel3 * numLevel2
			 strings.)
	[numLevel3]	returned number of level 3 subpages
	[level3Len]	returned length of a level 3 subpage name
	[level3Text]	returned array of level 3 subpage names

	This function returns values as follows:

	number of rows on the parameter page

	Related functions:

	paramPageSubpageMenuTitles, deviceParameterPageMapping,
	parameterPageDevices, paramPageSubpageInfo

-------------------------------------------------------------------------------

	paramPageSubpageInfo : retrieves a parameter page subpage's information

	subpageTitle = paramPageSubpageInfo(paramPage [,lexSaName])

	Arguments:

	paramPage	parameter page subpage
			({page}:{subpage 1}[:{subpage 2}][:{subpage 3}])
	[lexSaName]	returned name of Lex SA mapped to this subpage

	This function returns values as follows:

	subpage title

	Related functions:

	parameterPageDevices, deviceParameterPageMapping,
	paramPageConfigInfo, paramPageSubpageMenuTitles

-------------------------------------------------------------------------------

	paramPageSubpageMenuTitles : retrieves a list of parameter page
                                    subpage titles

	numSubpages = paramPageSubpageMenuTitles(paramPage [,subpageTitles]
						 [,titleLength])

	Arguments:

	paramPage	parameter page subpage
			({page}:{subpage 1}[:{subpage 2}][:{subpage 3}])
			(Note: The subpage 1 value is ignored.)
	[subpageTitles]	returned subpage titles
	[titleLength]	returned title length

	This function returns values as follows:

	number of subpages

	Related functions:

	paramPageConfigInfo, deviceParameterPageMapping,
	parameterPageDevices, paramPageSubpageInfo

-------------------------------------------------------------------------------

	parseFileName : parses a file name into its component pieces

	fileName = parseFileName(fullFileName [,filePath] [,rootFileName]
				 [,fileExt])

	Arguments:

	fullFileName	full file name
	[filePath]	returned file path
	[rootFileName]	returned root file name
	[fileExt]	returned file extension

	This function returns values as follows:

	file name

	Related functions:

	expandFileName, openFile, closeFile, fileGetString, filePrintf, fscanf,
	fileRead, fileRewind, fileWrite, findFileInPath, findInFile

-------------------------------------------------------------------------------

	pidProcessExists : determines if a pid points to an active process

	exists = pidProcessExists(pid [,node])

	Arguments:

	pid		process ID
	[node]		node or console where process is running
			(default is 0 (local node))

	This function returns values as follows:

	TRUE			process exists
	FALSE			process does not exist

	Related functions:

	processExists, processNameToPid, pidToProcessName, findProcesses,
	processInfo, sendPidSignal, sendProcessSignal, taskPidToName,
	taskPid, taskIdToName, taskId, taskExists, isServerTask

-------------------------------------------------------------------------------

	pidToProcessName : retrieves the process name corresponding to a pid

	processName = pidToProcessName(pid [,node])

	Arguments:

	pid		process pid to convert
	[node]		node or console where process is running
			(default is 0 (local node))

	This function returns values as follows:

	process name

	Related functions:

	processNameToPid, pidProcessExists, processExists, findProcesses,
	processInfo, sendPidSignal, sendProcessSignal, taskPidToName,
	taskPid, taskIdToName

-------------------------------------------------------------------------------

	ping : sends a ping request to another computer

	responded = ping(node [,timeout] [,responseTime])

	Arguments:

	ipName		IP name of computer to check
	[timeout]	timeout in seconds
			(default is 1)
	[responseTime]	returned response time in microseconds

	This function returns values as follows:

	TRUE			computer responded to ping
	FALSE			computer did not respond to ping

	Related functions:

	acnetPing, nodeIsUp, nodeIs

-------------------------------------------------------------------------------

	playBeep : plays a beep sound

	status = playBeep([console] [,volume])

	Arguments:

	[console]	console to play beep on
			(default is local console)
	[volume]	beep volume
			(default is 100)

	This function returns values as follows:

	execution status

	Related functions:

	playSound

-------------------------------------------------------------------------------

	playSound : plays an existing sound file

	status = playSound(soundFile [,console])

	Arguments:

	soundFile	sound file name
	[console]	console to play beep on
			(default is local console)

	This function returns values as follows:

	execution status

	Related functions:

	playBeep

-------------------------------------------------------------------------------

	pos : pads with spaces/truncates a string to a specified length

	string = pos(sourceString, padLength)

	Arguments:

	sourceString	source string
	padLength	length to pad the string to
			(If the length is less than the present length
			 of the string, the string is truncated.)

	This function returns values as follows:

	modified string

	Related functions:

	pad, trim, leftTrim, rightTrim, toTrimmedString

-------------------------------------------------------------------------------

	prec : output precision (eg. prec(value,fraction_digits))

	roundedValue = prec(value, numDigits)

	Arguments:

	value		value to round
	numDigits	number of digits to round to

	This function returns values as follows:

	rounded value

	Related functions:

	round, trunc, abs

-------------------------------------------------------------------------------

	previousSibling : returns the device's previous sibling (or 0)

	siblingDevice = previousSibling(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device's previous sibling

	Related functions:

	nextSibling, controllingDevice

-------------------------------------------------------------------------------

	printf : functions like printf with the additional functionality
		 of toString

	numChars = printf(formatString [,arg1] ...)

	Arguments:

	formatString	format string
	[arg1]		first value to format

	This function returns values as follows:

	number of characters output

	Related functions:

	printfNoNewline, sprintf, filePrintf, toString, toTrimmedString,
	formatDateString, stringCopy, toNumeric

-------------------------------------------------------------------------------

	printfNoNewline  : functions like printf with the additional
			   functionality of toString (no newline added)

	numChars = printfNoNewline(formatString [,arg1] ...)

	Arguments:

	formatString	format string
	[arg1]		first value to format

	This function returns values as follows:

	number of characters output

	Related functions:

	printf, sprintf, filePrintf, toString, toTrimmedString,
	formatDateString, stringCopy, toNumeric

-------------------------------------------------------------------------------

	processExists : determines if a process exists

	boolean = processExists(processName [,wildcard] [,searchType]
				[,numPids] [,processNames] [,pids])

	Arguments:

	processName	process name (or pid)
	[wildcard]	flag indicating whether or not the name is wildcarded
			(default is FALSE)
	[searchType]	search type
			(name -> search by process name (default),
			 userName -> search by user name,
			 userId -> search by user ID,
			 groupName -> search by group name,
			 groupId -> search by group ID,
			 parentPid -> search by parent pid)
	[numPids]	returned number of matching pids
	[processNames]	returned matching process names
	[pids]		returned matching pids

	This function returns values as follows:

	TRUE			process exists
	FALSE			process does not exist

	Related functions:

	pidProcessExists, processInfo, findProcesses, processNameToPid,
	pidToProcessName, sendPidSignal, sendProcessSignal, taskExists,
	nodeAcnetTasks, taskId, taskPid, isServerTask, taskIdToName,
	taskPidToName

-------------------------------------------------------------------------------

	processInfo : retrieves information about a process

	name = processInfo(pid [,node] [,commandLine] [,startTime] [,userName]
			   [,userId] [,groupName] [,groupId] [,parentPid]
			   [,state] [,memorySize] [,rss] [,cpuTime]
			   [,numThreads] [,tracerPid] [,startJiffies])

	Arguments:

	pid		process pid
	[node]		node or console where process is running
			(default is 0 (local node))
	[commandLine]	returned command line
	[startTime]	returned process start time
	[userName]	returned process user name
	[userId]	returned process user ID
	[groupName]	returned process group name
	[groupId]	returned process group ID
	[parentPid]	returned parent process' pid
	[state]		returned process state
	[memorySize]	returned process memory size
	[rss]		returned resident set size (memory)
	[cpuTime]	returned total CPU time used (in clock ticks)
	[numThreads]	returned number of process threads
	[tracerPid]	returned tracer pid
	[startJiffies]	returned start time in jiffies

	This function returns values as follows:

	process name

	Related functions:

	processNameToPid, pidToProcessName, findProcesses, pidProcessExists,
	processExists, sendPidSignal, sendProcessSignal, taskExists,
	nodeAcnetTasks, taskId, taskPid, isServerTask, taskIdToName,
	taskPidToName, 

-------------------------------------------------------------------------------

	processNameToPid : retrieves the pid corresponding to a process name

	pid = processNameToPid(processName [,node])

	Arguments:

	processName	process name
	[node]		node or console where process is running
			(default is 0 (local node))

	This function returns values as follows:

	process pid

	Related functions:

	pidToProcessName, pidProcessExists, processExists, findProcesses,
	processInfo, sendPidSignal, sendProcessSignal, taskPidToName,
	taskPid, taskIdToName

-------------------------------------------------------------------------------

	programMapping : returns the pages that a program is mapped to

	numPages = programMapping(program [,pages])

	Arguments:

	program		program to retrieve mapping for
			(ex: 'PA0052', 'M4', 52)
	[pages]		returned array of mapped pages

	This function returns values as follows:

	number of pages found

	Related functions:

	pageTitle

-------------------------------------------------------------------------------

	quoteString : adds beginning and ending quotes to a string

	string = quoteString(sourceString [,quoteChar])

	Arguments:

	sourceString	source string
	[quoteChar]	quote character

	This function returns values as follows:

	modified string

	Related functions:

	stripQuotes, isQuotedString

-------------------------------------------------------------------------------

	rad50ToString : converts a radix 50 value to a string

	string = rad50ToString(rad50Value)

	Arguments:

	rad50Value	rad50 value to convert

	This function returns values as follows:

	converted string

	Synonyms: r50asc

	Related functions:

	stringToRad50, isRad50String, radix, decimal, hex, binary, octal

-------------------------------------------------------------------------------

	radix : returns a value as an arbitrary radix (2-36) string

	string = radix(value, radixValue [,convertLength] [,fillChar]
		       [,dataType])

	Arguments:

	value		value to convert
	radixValue	conversion radix (2-36)
	[convertLength]	converted string length
	[fillChar]	fill character
	[dataType]	data type
			(integer,
			 float,
			 double)
			(default is to use the native type of the value)

	This function returns values as follows:

	converted string value

	Synonyms: toRadix

	Related functions:

	hex, binary, octal, decimal, toString, toTrimmedString, rad50ToString

-------------------------------------------------------------------------------

	rampcardDeviceTableType : returns the table type for a rampcard device

	tableType = rampcardDeviceTableType(device)

	Arguments:

	device		rampcard device of interest

	This function returns values as follows:

	rampcard table type

	Related functions:

	rampcardGetRootDevice

-------------------------------------------------------------------------------

	rampcardGetRootDevice : returns the root name corresponding to a
                               rampcard device

	rootName = rampcardGetRootDevice(device)

	Arguments:

	device		rampcard device of interest

	This function returns values as follows:

	rampcard root device name

	Related functions:

	rampcardDeviceTableType

-------------------------------------------------------------------------------

	random : returns pseudo random numbers from 0 to 2^31 - 1

	value = random([maximum] [,minimum] [,maxPossible])

	Arguments:

	[maximum]	maximum random number to return
			(default is 2^31 - 1)
	[minimum]	minimum random number to return
			(default is 0)
	[maxPossible]	returned maximum possible number returned

	This function returns values as follows:

	pseudo random number

	Synonyms: rand

	Related functions:

	randomSeed, systemRandomNumber

-------------------------------------------------------------------------------

	randomSeed : sets the seed value for the random function

	randomSeed([seedValue])

	Arguments:

	[seedValue]	desired random seed
			(default is a pseudo random number)

	This function returns values as follows:

	0 (return value is meaningless)

	Synonyms: srand

	Related functions:

	random, systemRandomNumber

-------------------------------------------------------------------------------

	range : determines the range of an array of values

	rangeValue = range(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	range of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	rangeValue = range(values[])

	rangeValue = range(value1, value2, value3, value4)

	Related functions:

	range2, minimum, minimum2, maximum, maximum2, mean, mean2,
	median, median2, mode, mode2, sum, sum2, rms, stddev, stddev2,
	variance, variance2, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	range2 : determines the range of an array of values

	rangeValue = range2(values [,numValues] [,minimum] [,maximum]
			    [,retNumValues])

	Arguments:

	values		values to find the range of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to find the range of
	[minimum]	returned minimum value
	[maximum]	returned maximum value
	[retNumValues]	returned number of values used

	This function returns values as follows:

	range value

	Examples:

	declare values double[] = 1, 2, 3, 4
	rangeValue = range2(values[2],2)

	rangeValue = range2(values[])

	Related functions:

	range, minimum2, minimum, maximum2, maximum, mean2, mean,
	median2, median, mode2, mode, sum2, sum, rms, stddev2, stddev,
	variance2, variance, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	readAlarmBlock : reads a requested alarm block

	numBlocks = readAlarmBlock(device [,alarmBlock] [,property]
				   [,dataSource] [,arrayIndex])

	Arguments:

	device		device of interest
	[alarmBlock]	returned alarm block
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[dataSource]	data source
			(default is live reading)
	[arrayIndex]	array index
			(default is 0)

	This function returns values as follows:

	number of alarm blocks read

	Related functions:

	extractAlarmBlockFieldValue, alarmBlockFieldValue,
	extractAlarmHeaderParam, alarmStatus, alarmIsBypassed,
	alarmIsBypassedDb, alarmIsSnoozed, alarmRemainingSnoozeTime,
	analogAlarmLimits, digitalAlarmNominalMask,
	deviceValue, deviceValueText, deviceCalculatedValue

-------------------------------------------------------------------------------

	readLock : retrieves information about a lock

	status = readLock(lockName [,checkLock] [,lockTime] [,owner]
			  [,ipNode] [,pid] [,nodeConsole] [,slot])

	Arguments:

	lockName	desired lock name
	[checkLock]	check to see if the lock is still valid
			(default is FALSE)
	[lockTime]	returned timestamp when lock was acquired
	[owner]		returned owner of the lock
	[ipNode]	returned IP address of the owner of the lock
	[pid]		returned process ID of owner of the lock
	[nodeConsole]	returned ACNET node or console number of lock owner
	[slot]		returned console slot of lock owner

	This function returns values as follows:

	LOCK_OK			lock does not exist
	LOCK_OTHER		another process has the lock
	LOCK_ALREADY		the calling process has the lock

	Related functions:

	readProgramLocks

-------------------------------------------------------------------------------

	readMjyDataFile : reads values from an MJY (scope) data file

	pntsPerTrace = readMjyDataFile(fileName [,channel] [,maxTraces]
				       [,maxPntsPerTrc] [,numTraces]
				       [,values] [,horzIncrement])

	Arguments:

	fileName	file name including path of data file
	[channel]	desired channel to read (1 to 4) (default is 1)
	[maxTraces]	maximum number of traces to return
			(default is 0 which results in returning all traces
			 in the file)
	[maxPntsPerTrc]	maximum number of points per trace to return
			(default is 0 which results in returning all points
			 per trace in the file)
	[numTraces]	returned number of traces returned
	[values]	returned data values
			(numTraces * pntsPerTrace values)
	[horzIncrement]	returned time between points in nanoseconds

	This function returns values as follows:

	number of points per trace

	Synonyms: read_Mjy_Data_File

	Related functions:

	none

-------------------------------------------------------------------------------

	readProgramLocks : retrieves the locks held by a program

	numLocks = readProgramLocks([ownerName] [,node] [,checkLocks]
				    [,lockName] [,lockTime] [,pid]
				    [,console] [,slot])

	Arguments:

	[ownerName]	owner/program name
			(default is the calling program)
	[node]		owner/program name
			(default is the calling program's node)
	[checkLocks]	check to see if the returned locks are still valid
			(default is FALSE)
	[lockName]	returned lock name(s)
	[lockTime]	returned timestamps when locks were acquired
	[pid]		returned process ID of owner of the lock
	[console]	returned console number of lock owner
	[slot]		returned console slot of lock owner

	This function returns values as follows:

	number of locks

	Related functions:

	readLock

-------------------------------------------------------------------------------

	reflectedEvent : retrieves the reflected TCLK event for a
                        beam sync event

	reflected = reflectedEvent(eventType, event)

	Arguments:

	eventType	type of clock event
			(mibs -> MIBS clock event (default),
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event)
	event		beam sync event of interest

	This function returns values as follows:

	reflected TCLK event value

	Related functions:

	eventCount, eventDate, timeSinceEvent, eventOccurred,
	clearEventOccurred, eventInfo, eventTimelineInfo, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	refreshAlarmNodeList : refresh the list of alarmer nodes

	status = refreshAlarmNodeList()

	Arguments:

	none

	This function returns values as follows:

	status of request

	Related functions:

	findAlarmsDaemon

-------------------------------------------------------------------------------

	regexpCompareString : compares a string to a pattern (case sensitive)

	value = regexpCompareString(string, pattern [,case] [,extended])

	Arguments:

	string		string to compare
	pattern		pattern to compare
	[case]		case sensitivity
			(caseSensistive (default),
			 caseInsensitive)
	[extended]	useExtended -> use extended regular expressions
			dontUseExtended -> don't use extended regular
					   expressions (default)

	This function returns values as follows:

	0			strings match
	otherwise		strings don't match

	Related functions:

	regexpCompareStringNocase, stringCompare, stringCompareNocase,
	byteCompare

-------------------------------------------------------------------------------

	regexpCompareStringNocase : compares a string to a pattern
				    (case insensitive)

	value = regexpCompareStringNocase(string, pattern [,extended])

	Arguments:

	string		string to compare
	pattern		regular expression pattern to compare
	[extended]	useExtended -> use extended regular expressions
			dontUseExtended -> don't use extended regular
					   expressions (default)

	This function returns values as follows:

	0			strings match
	otherwise		strings don't match

	Related functions:

	regexpCompareString, stringCompare, stringCompareNocase,
	byteCompare

-------------------------------------------------------------------------------

	regexpFindString : returns the position of one string within another
			   using regular expressions for the search

	position = regexpFindString(searchString, sourceString [,options])

	Arguments:

	searchString	search string
	sourceString	source string
	[options]	regular expression options (values can be combined
			by using the "|" character)
			(none -> no options selected (default),
			 caseSensitive -> make case sensitive searches,
			 extendedRegexp -> use extended regular expressions,
			 treatNlAsSpecial -> treat new lines as special
					     characters in conjunction with
					     "^" and "$" search characters)

	This function returns values as follows:

	0		search string was not found
	otherwise	match position (starts at 1)

	Related functions:

	findString, strstr, findChar, findNotChar, findTagString,
	stringStartsWith, stringEndsWith

-------------------------------------------------------------------------------

	regexpGetValue : returns the next token specified by a regular
			 expression from a string and removes it

	string = regexpGetValue(sourceString, pattern [,maxReturn] [,options]
				[,remainString])

	Arguments:

	sourceString	source string (If this function is successful
			and the "remainString" argument is omitted or
			defaulted, this string is modified by setting
			it to the remaining string after the extracted
			string.)
	pattern		regular expression pattern to extract
	[maxReturn]	maximum number of characters to return
			(default is 8192)
	[options]	regular expression options (values can be combined
			by using the "|" character)
			(none -> no options selected (default),
			 caseSensitive -> make case sensitive searches,
			 extendedRegexp -> use extended regular expressions,
			 treatNlAsSpecial -> treat new lines as special
					     characters in conjunction with
					     "^" and "$" search characters)
	[remainString]	remaining string after the extracted string
			(If this argument is omitted or defaulted,
			 the source string argument will be set to
			 this value.)

	This function returns values as follows:

	extracted string

	Related functions:

	stringGetValue, stringToken, split, regexpSplit, splitByCharSet

-------------------------------------------------------------------------------

	regexpInsertString : inserts a substring before or after a substring
                            matching a regular expression

	modifiedString = regexpInsertString(searchPattern, insertString,
					    sourceString, location,
					    [,options])

	Arguments:

	searchPattern	search pattern
	insertString	string to insert
	sourceString	source string
	location	location to insert string
			(before -> insert before the matched substring
			 after -> insert after the matched substring)
	[options]	regular expression options (values can be combined
			by using the "|" character)
			(none -> no options selected (default),
			 caseSensitive -> make case sensitive searches,
			 extendedRegexp -> use extended regular expressions,
			 treatNlAsSpecial -> treat new lines as special
					     characters in conjunction with
					     "^" and "$" search characters)

	This function returns values as follows:

	modified source string

	Related functions:

	insertString, regexpRemoveString, removeString, replaceString,
	regexpReplaceString, findString, regexpFindString, stringStartsWith,
	stringEndsWith

-------------------------------------------------------------------------------

	regexpRemoveString : removes a substring matching a regular expression
                            from another string

	position = regexpRemoveString(searchPattern, sourceString
				      [,remainString] [,options])

	Arguments:

	searchPattern	search pattern
	sourceString	source string
	[remainString]	resultant string after the removal
			(default is to modify the source string)
	[options]	regular expression options (values can be combined
			by using the "|" character)
			(none -> no options selected (default),
			 caseSensitive -> make case sensitive searches,
			 extendedRegexp -> use extended regular expressions,
			 treatNlAsSpecial -> treat new lines as special
					     characters in conjunction with
					     "^" and "$" search characters)

	This function returns values as follows:

	0		search string was not found
	otherwise	position where string was removed (starts at 1)

	Related functions:

	removeString, replaceString, regexpReplaceString, insertString,
	findString, regexpFindString, stringStartsWith, stringEndsWith

-------------------------------------------------------------------------------

	regexpReplaceString : replaces one string with another string in a
			      string using regular expressions for the search

	string = regexpReplaceString(searchString, replaceString, sourceString
				     [,replaceCount] [,options])

	Arguments:

	searchString	search string
	replaceString	replacement string
	sourceString	source string
	[replaceCount]	number of substrings to replace
			(all -> replace all instances (default),
			 positive integer -> replace the first n occurrences)
	[options]	regular expression options (values can be combined
			by using the "|" character)
			(none -> no options selected (default),
			 caseSensitive -> make case sensitive searches,
			 extendedRegexp -> use extended regular expressions,
			 treatNlAsSpecial -> treat new lines as special
					     characters in conjunction with
					     "^" and "$" search characters)

	This function returns values as follows:

	modified source string

	Related functions:

	replaceString, replaceChar, replaceCharactersWithString,
	replaceCharactersWithStrings, regexpInsertString,
	regexpFindString

-------------------------------------------------------------------------------

	regexpSplit : splits up a string based upon finding a delimiter string
		      which is a regular expression

	numStrings = regexpSplit(sourceString [,delimiter] [,strings])

	Arguments:

	sourceString	source string
	[delimiter]	delimiter string
			(default is a blank)
	[strings]	returned array of substrings

	This function returns values as follows:

	number of substrings

	Related functions:

	split, splitByCharSet

-------------------------------------------------------------------------------

	removeString : removes a substring from another string

	position = removeString(searchString, sourceString [,remainString]
				[,fillChar] [,option1] [,option2] [,option3])

	Arguments:

	searchString	search string
	sourceString	source string
	[remainString]	resultant string after the removal
			(default is to modify the source string)
	[fillChar]	fill character to insert at the end of the
			resultant string (default is 0)
	[option1...3]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default),
			 ignoreSpaces -> ignore spaces while matching,
			 wildcard=c -> specify a wildcard character)

	This function returns values as follows:

	0		search string was not found
	otherwise	position where string was removed (starts at 1)

	Related functions:

	regexpRemoveString, replaceString, regexpReplaceString, insertString,
	findString, regexpFindString, stringStartsWith, stringEndsWith

-------------------------------------------------------------------------------

	repeatString : repeats a substring a number of times

	string = repeatString(copyString, numCopies [,separator])

	Arguments:

	copyString	string to copy multiple times
	numCopies	number of copies to make of the string
	[separator]	separator string to place between adjacent copies
			(default is no separator)

	This function returns values as follows:

	repeated string

	Related functions:

	stringCopy

-------------------------------------------------------------------------------

	replaceBracketedString : replace a bracketed substring

	string = replaceBracketedString(leftBracket, rightBracket,
					replaceString, sourceString
					[,option1] [,option2] [,option3])

	Arguments:

	leftBracket	left bracket string
	rightBracket	right bracket string
	replaceString	replacement string
	sourceString	source string
	[option1...3]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default),
			 ignoreSpaces -> ignore spaces while matching,
			 wildcard=c -> specify a wildcard character,
			 preserveBrackets -> retain the bracket strings)

	This function returns values as follows:

	modified source string

	Related functions:

	replaceString, regexpReplaceString, replaceChar,
	replaceCharactersWithString, replaceCharactersWithStrings

-------------------------------------------------------------------------------

	replaceChar : replaces any of a set of characers with another character

	string = replaceChar(searchChars, replaceChar, sourceString
			     [,option1])

	Arguments:

	searchChars	search characters
	replaceChar	replacement character
	sourceString	source string
	[option1]	optional argument
			(all -> replace all instances (default),
			 n -> replace the first n occurrences)

	This function returns values as follows:

	modified source string

	Related functions:

	replaceCharactersWithString, replaceCharactersWithStrings,
	replaceString, regexpReplaceString, replaceBracketedString

-------------------------------------------------------------------------------

	replaceCharactersWithString : replaces any of a set of characters
                                     with a string

	string = replaceCharactersWithString(sourceString, charsToReplace,
					     replaceString)

	Arguments:

	sourceString	original string
	charsToReplace	list of characters to replace
	replaceString	replacement string

	This function returns values as follows:

	modified string

	Related functions:

	replaceCharactersWithStrings, replaceChar, replaceString,
	regexpReplaceString, replaceBracketedString

-------------------------------------------------------------------------------

	replaceCharactersWithStrings : replaces any of a set of characters
                                      with a corresponding string

	string = replaceCharactersWithStrings(sourceString, charsToReplace,
					      replaceStrings)

	Arguments:

	sourceString	original string
	charsToReplace	list of characters to replace
	replaceStrings	replacement strings (one for each character)

	This function returns values as follows:

	modified string

	Related functions:

	replaceCharactersWithString, replaceChar, replaceString,
	regexpReplaceString, replaceBracketedString

-------------------------------------------------------------------------------

	replaceString : replaces one string with another string in a string

	string = replaceString(searchString, replaceString, sourceString
			       [,option1] [,option2] [,option3] [,option4])

	Arguments:

	searchString	search string
	replaceString	replacement string
	sourceString	source string
	[option1...4]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default),
			 ignoreSpaces -> ignore spaces while matching,
			 wildcard=c -> specify a wildcard character,
			 all -> replace all instances (default),
			 n -> replace the first n occurrences)

	This function returns values as follows:

	modified source string

	Related functions:

	regexpReplaceString, replaceBracketedString, replaceChar,
	replaceCharactersWithString, replaceCharactersWithStrings

-------------------------------------------------------------------------------

	resetRfWatchdog : reset an RF watchdog trip for the requested machine

	machineId = resetRfWatchdog(machine)

	Arguments:

	machine		machine name
			(booster,
			 mainInjector)

	This function returns values as follows:

	machine ID for the RF system reset

	Related functions:

	rfWatchdogTripIsPresent

-------------------------------------------------------------------------------

	reverse : reverses a string

	string = reverse(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	arrayInvert

-------------------------------------------------------------------------------

	rfWatchdogTripIsPresent : determines if there is an RF watchdog trip
                                 for the requested machine

	isTripped = rfWatchdogTripIsPresent(machine)

	Arguments:

	machine		machine name
			(booster,
			 mainInjector)

	This function returns values as follows:

	TRUE			RF watchdog trip is present
	FALSE			no RF watchdog trips are present

	Related functions:

	resetRfWatchdog

-------------------------------------------------------------------------------

	rightJustify : right justify a string

	string = rightJustify(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	justify, leftJustify, center, leftShift, rightShift, strShift, pad

-------------------------------------------------------------------------------

	rightShift : right shift a string

	string = rightShift(sourceString [,numChars])

	Arguments:

	sourceString	source string
	[numChars]	number of characters to shift
			(default is 1)

	This function returns values as follows:

	modified string

	Related functions:

	strShift, leftShift, justify, leftJustify, rightJustify, center, pad

-------------------------------------------------------------------------------

	rightTrim : removes trailing blanks from a string

	string = rightTrim(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	trim, leftTrim, toTrimmedString, pad

-------------------------------------------------------------------------------

	rms : calculates the RMS of an array of values

	rmsValue = rms(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	RMS of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	rmsValue = rms(values[])

	rmsValue = rms(value1, value2, value3, value4)

	Related functions:

	rms2, mean, mean2, median, median2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, stddev, stddev2,
	variance, variance2, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	rms2 : calculates the RMS of an array of values

	rmsValue = rms2(values [,numValues] [,sumOfSquares] [,retNumValues])

	Arguments:

	values		values to find the RMS of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to find the RMS of
	[sumOfSuares]	returned sum of squares value
	[retNumValues]	returned number of values used

	This function returns values as follows:

	RMS of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	rmsValue = rms2(values[2],2)

	rmsValue = rms2(values[])

	Related functions:

	rms, mean2, mean, median2, median, mode2, mode, minimum2, minimum,
	maximum2, maximum, sum2, sum, range2, range, stddev2, stddev,
	variance2, variance, identical2, identical, min, max, histogram

-------------------------------------------------------------------------------

	round : round (to a specified number of digits)

	roundedValue = round(value [,numDigits])

	Arguments:

	value		value to round
	[numDigits]	number of digits to round to
			(default is 0)

	This function returns values as follows:

	rounded value

	Related functions:

	prec, trunc, abs

-------------------------------------------------------------------------------

	rshft : circular right shift

	value = rshft(sourceValue, numShift)

	Arguments:

	sourceValue	value to modify
	numShift	number of bits to shift by

	This function returns values as follows:

	modified value with the bits circularly shifted to the right

	Related functions:

	circularShift, lshft, clearBit, setBit, bit, bitCount, bitField,
	bitComplement

-------------------------------------------------------------------------------

	saveFileDeviceErrors : returns all of the device errors from a save file

	numErrors = saveFileDeviceErrors(fileNumber [,deviceNames]
					 [,properties] [,saveErrors]
					 [,matchError])

	Arguments:

	fileNumber	save file number
	[deviceNames]	returned error device names
	[properties]	returned error properties
	[saveErrors]	returned save errors
	[matchError]	error code to match
			(default is OK which results in returning all
			 errors)

	This function returns values as follows:

	number of errors in the file

	Related functions:

	saveFileDeviceStatus, saveFileInfo, oldestSrFile, newestSrFile,
	checkOperatorSaveStatus, abortOperatorSave

-------------------------------------------------------------------------------

	saveFileDeviceStatus  : returns the save status for a requested device
                               in a save file

	saveStatus = saveFileDeviceStatus(fileNumber, deviceName
					  [,property])

	Arguments:

	fileNumber	save file number
	deviceName	desired device
	[property]	desired property
			(reading,
			 setting,
			 status,
			 analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)

	This function returns values as follows:

	device save status

	Related functions:

	saveFileDeviceErrors, saveFileInfo, oldestSrFile, newestSrFile,
	checkOperatorSaveStatus, abortOperatorSave

-------------------------------------------------------------------------------

	saveFileInfo : returns information about a single save/restore file

	exists = saveFileInfo(fileNumber [,title] [,startDate] [,endDate]
			      [,numProperties] [,numErrors])

	Arguments:

	fileNumber	file number of file to retrieve
	[title]		returned save file title
	[startDate]	returned save starting date
	[endDate]	returned save ending date
	[numProperties]	returned number of saved properties
	[numErrors]	returned number of save errors

	This function returns values as follows:

	TRUE			save file exists
	FALSE			save file does not exist

	Related functions:

	oldestSrFile, newestSrFile, saveFileDeviceErrors, saveFileDeviceStatus,
	checkOperatorSaveStatus, abortOperatorSave

-------------------------------------------------------------------------------

	scondif : returns the second argument as a string if the first has a
		  value of true or the third argument as a string if it has
		  a value of false

	stringValue = scondif(booleanValue, trueStringValue, falseStringValue)

	Arguments:

	booleanValue	 boolean value to test
	trueStringValue	 string value to return if the first argument
			 has a value of TRUE
	falseStringValue string value to return if the first argument
			 has a value of FALSE

	This function returns values as follows:

	selected string value

	Related functions:

	condif

-------------------------------------------------------------------------------

	scriptExecutionTime : returns the script execution system time in
                             milliseconds

	elapsedTime = scriptExecutionTime()

	Arguments:

	<none>

	This function returns values as follows:

	elapsed system time in milliseconds since the script started

	Related functions:

	systemTime, cpuTime, 15HzCount, timer, timeAgo, timeFromDate,
	timeSinceEvent, stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	sdaFileDate : returns the starting or ending date for an SDA file

	date = sdaFileDate([fileNumber] [,sdaUsage] [,whichDate])

	Arguments:

	[fileNumber]	file number to convert
			(current SDA file number)
	[sdaUsage]	desired SDA usage string
			(default is "Collider")
	[whichDate]	which date to return
			(start -> return starting date (default),
			 end -> want ending date)

	This function returns values as follows:

	corresponding SDA file date

	Related functions:

	dateToSdaFile, currentSdaFile, isValidSdaFile, isValidSdaCase,
	isValidSdaSet

-------------------------------------------------------------------------------

	secant : secant

	resultValue = secant(value)

	Arguments:

	value		value to take the secant of in radians

	This function returns values as follows:

	secant value of the argument

	Related functions:

	cosecant, cotan, cotand, tan, tand, tanh, atan, atand, atan2, atan2d,
	atanh, cos, cosd, cosh, sin, sind, sinh, acos, acosd, acosh, asin,
	asind, asinh

-------------------------------------------------------------------------------

	secondsToTodString : converts seconds to a time of day string

	string = secondsToTodString([seconds])

	Arguments:

	[seconds]	seconds into the day
			(default is the current time of day)

	This function returns values as follows:

	converted time of day string (hh:mm:ss)

	Related functions:

	todStringToSeconds, dateToString, timeIntervalToString, stringtoDate,
	convertSeconds, timeAgo, timeFromDate, timeSinceEvent, cpuTime,
	systemTime, 15HzCount, timer, julianDate, julianDateToDate, currentDate,
	currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	sendLlrfCommand : sends a LLRF command

	machineId = sendLlrfCommand(machine, curve, command)

	Arguments:

	machine		machine name
			(booster)
	curve		LLRF curve
			(frequency,
			 bias)
	command		LLRF command
			(resetDsp -> reset the LLRF DSP,
			 loadDsp -> load the program for the LLRF DSP,
			 normalMode -> set LLRF to normal mode,
			 dcMode -> set LLRF to DC mode,
			 resetFreqSource -> reset the frequency source module,
			 reboot -> reboot the LLRF)

	This function returns values as follows:

	machine ID for the LLRF command

	Related functions:

	llrfCurveRootName, llrfCurveMaxLength, llrfCurveCurrentLength

-------------------------------------------------------------------------------

	sendPidSignal : sends a signal to a process specified by its pid

	status = sendPidSignal(pid, signal [,console])

	Arguments:

	pid		process ID
	signal		signal to send
	[console]	console where process is running (default is local)

	This function returns values as follows:

	status of signal send

	Related functions:

	sendProcessSignal, processNameToPid, pidToProcessName,
	pidProcessExists, processExists, findProcesses, processInfo,
	taskPidToName, taskPid, taskIdToName	

-------------------------------------------------------------------------------

	sendProcessSignal : sends a signal to a process specified by its name

	pid = sendProcessSignal(processName, signal [,console])

	Arguments:

	processName	process name
	signal		signal to send
	[console]	console where process is running (default is local)

	This function returns values as follows:

	process pid

	Related functions:

	sendPidSignal, pidToProcessName, processNameToPid, pidProcessExists,
	processExists, findProcesses, processInfo, taskPidToName, taskPid,
	taskIdToName

-------------------------------------------------------------------------------

	setBit : set a bit in a value

	value = setBit(sourceValue, bitNumber)

	Arguments:

	sourceValue	value to modify
	bitNumber	bit number (starts at 1)

	This function returns values as follows:

	modified value with the requested bit set

	Related functions:

	clearBit, bit, bitCount, bitField, circularShift, bitComplement,
	setBitField

-------------------------------------------------------------------------------

	setBitField : sets a bit field value

	value = setBitField(sourceValue, fieldValue, startBit [,numBits])

	Arguments:

	sourceValue	value to modify
	fieldValue	field value to set
	startBit	starting bit number (starts at 1)
	[numBits]	number of bits to set
			(default is 1)

	This function returns values as follows:

	modified value with the requested bit field set

	Related functions:

	setBit, clearBit, bit, bitCount, bitField, circularShift, bitComplement

-------------------------------------------------------------------------------

	setenv : sets an environment variable to a value

	status = setenv(envVariable [,value])

	Arguments:

	envVariable	environment variable name
	[value]		setting value
			(default is null string)

	This function returns values as follows:

	OK

	Related functions:

	getenv, unsetenv, delenv, getLogicalName, setLogicalName,
	deleteLogicalName

-------------------------------------------------------------------------------

	setLogicalName : sets a logical name to a value

	status = setLogicalName(logicalName [,value] [,nameType])

	Arguments:

	logicalName	logical name
	[value]		setting value
			(default is null string)
	[nameType]	type of logical name
			(group (default),
			 process)

	This function returns values as follows:

	OK

	Related functions:

	getLogicalName, deleteLogicalName, getenv, setenv, unsetenv, delenv

-------------------------------------------------------------------------------

	settingsAreEnabled : determines if settings are enabled
			     (supports optional device argument)

	areEnabled = settingsAreEnabled([device])

	Arguments:

	[device]	optional device to check specifically if that
			device can be set

	This function returns values as follows:

	TRUE			settings are enabled
	FALSE			settings are not enabled

	Related functions:

	none

-------------------------------------------------------------------------------

	setUserAlarmListStatus : sets the status of a user alarm list

	status = setUserAlarmListStatus(alarmList, listStatus)

	Arguments:

	alarmList	alarm list name
			({system}\{name})
	listStatus	desired list status
			(bypass -> mark the list as bypassed,
			 enable -> mark the list as enabled)

	This function returns values as follows:

	enabled			alarm list is enabled
	bypassed		alarm list is disabled
	empty			alarm list is empty

	Related functions:

	userAlarmList, userAlarmListDevices, userAlarmListLists

-------------------------------------------------------------------------------

	sin : sine

	resultValue = sin(value)

	Arguments:

	value		value to take the sine of in radians

	This function returns values as follows:

	sine value of the argument

	Related functions:

	sind, asin, asind, asinh, sinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	sind : sine (argument in degrees)

	resultValue = sind(value)

	Arguments:

	value		value to take the sine of in degrees

	This function returns values as follows:

	sine value of the argument

	Related functions:

	sin, asin, asind, asinh, sinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	sinh : hyperbolic sine

	resultValue = sinh(value)

	Arguments:

	value		value to take the hyperbolic sine of

	This function returns values as follows:

	hyperbolic sine value of the argument

	Related functions:

	sin, sind, asin, asind, asinh, acos, acosd, acosh, cos, cosd, cosh 

-------------------------------------------------------------------------------

	sizeof : returns the number of elements in a device, device list, input, or variable

	numElements = sizeof(value)

	Arguments:

	value		value to determine the number of elements of
			(device property, variable, or device list)

	This function returns values as follows:

	number of elements

	Related functions:

	sizeofVariable, byteSizeof, byteSizeofVariable, numElements, exists

-------------------------------------------------------------------------------

	sizeofVariable : returns the number of elements in a variable (dynamic)

	numberOfElements = sizeofVariable(variable)

	Arguments:

	variable	variable to determine the number of elements of

	This function returns values as follows:

	number of elements

	Related functions:

	sizeof, byteSizeof, byteSizeofVariable, numElements, variableType,
	variableArrayDimensions, variableDimensionSize, variableNumReadings,
	variableNumSettings

-------------------------------------------------------------------------------

	snapManagerDataDirectory : returns snapshot manager data file
                                  information

	numFiles = snapManagerDataDirectory(system [,device] [,startTime]
					    [,endTime] [,devices] [,systems]
					    [,dates] [,records] [,errors]
					    [,fullNames])

	Arguments:

	system		detached snapshot manager system
			(all
			 linac,
			 booster,
			 mainInjector
			 tevatron
			 switchyard
			 pbar
			 cryogenics
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 MISCELLANEOUS)
	[device]	device of interest
			(default is all devices)
	[startTime]	start time
			(default is oldest existing date)
	[endTime]	end time
			(default is now)
	[devices]	returned matching device names
	[systems]	returned matching system names
	[dates]		returned matching file dates
	[records]	returned matching file records
	[errors]	returned matching file error status values
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of matching files

	Related functions:

	snapManagerSystemNames, snapManagerSystemFiles,
	snapManagerSystemPlotSetups, deviceSnapManagerFiles,
	snapManagerFindDevice, snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapManagerFindDevice : returns snapshot manager plot setups for
                               a device

	numPlotSetups = snapManagerFindDevice(device [,systemNames]
					      [,armEvents] [,delays]
					      [,rates] [,durations]
					      [,maxPerHours] [,rearmDelays])

	Arguments:

	device		desired device
	[systemNames]	returned detached snapshot manager system names
			(linac,
			 booster,
			 mainInj
			 tevatron
			 switchyard
			 pbar
			 cryo
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 misc)
	[armEvents]	returned arm events (8 per plot setup)
	[delays]	returned delays (in milliseconds)
	[rates]		returned plot rates
	[durations]	returned plot durations
	[maxPerHours]	returned maximum number of plots per hour
	[rearmDelays]	returned rearm delays (in seconds or -1 for one shot)

	This function returns values as follows:

	number of matching plot setups

	Related functions:

	snapManagerSystemPlotSetups, snapManagerSystemFiles,
	deviceSnapManagerFiles, snapManagerSystemNames,
	snapManagerDataDirectory, snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapManagerReinitPlot : reinitializes a snapshot manager plot

	deviceName = snapManagerReinitPlot(system, device)

	Arguments:

	system		detached snapshot manager system
			(linac,
			 booster,
			 mainInjector
			 tevatron
			 switchyard
			 pbar
			 cryogenics
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 MISCELLANEOUS)
	device		device of interest

	This function returns values as follows:

	device name

	Related functions:

	snapManagerSystemNames, snapManagerSystemFiles,
	snapManagerSystemPlotSetups, deviceSnapManagerFiles,
	snapManagerFindDevice, snapManagerDataDirectory, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapManagerSystemFiles : returns snapshot manager data file information
                                for a system

	numFiles = snapManagerSystemFiles(system [,devices] [,records]
					  [,dates] [,errors])

	Arguments:

	system		desired detached snapshot manager system
			(linac,
			 booster,
			 mainInj
			 tevatron
			 switchyard
			 pbar
			 cryo
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 misc)
	[devices]	returned matching devices
	[records]	returned matching file records
	[dates]		returned matching file dates
	[errors]	returned matching file error status values

	This function returns values as follows:

	number of matching files

	Related functions:

	deviceSnapManagerFiles, snapManagerSystemPlotSetups,
	snapManagerFindDevice, snapManagerSystemNames,
	snapManagerDataDirectory, snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapManagerSystemNames : returns snapshot manager system names

	numSystems = snapManagerSystemFiles(systemNames)

	Arguments:

	systemNames	returned detached snapshot manager system names

	This function returns values as follows:

	number of system names

	Related functions:

	snapManagerSystemPlotSetups, snapManagerSystemFiles,
	deviceSnapManagerFiles, snapManagerFindDevice,
	snapManagerDataDirectory, snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapManagerSystemPlotSetups : returns plot setups for a snapshot
                                     manager system

	numPlotSetups = snapManagerSystemPlotSetups(system [,devices]
						    [,armEvents] [,delays]
						    [,rates] [,durations]
						    [,maxPerHours])

	Arguments:

	system		desired detached snapshot manager system
			(linac,
			 booster,
			 mainInj
			 tevatron
			 switchyard
			 pbar
			 cryo
			 cdf
			 recycler
			 store
			 global
			 scratch
			 crew
			 controls
			 numi
			 misc)
	[devices]	returned device names
	[armEvents]	returned arm events (8 per plot setup)
	[delays]	returned delays (in milliseconds)
	[rates]		returned plot rates
	[durations]	returned plot durations
	[maxPerHours]	returned maximum number of plots per hour
	[rearmDelays]	returned rearm delays (in seconds or -1 for one shot)

	This function returns values as follows:

	number of matching plot setups

	Related functions:

	snapManagerFindDevice, snapManagerSystemFiles, snapManagerSystemNames,
	deviceSnapManagerFiles, snapManagerDataDirectory,
	snapManagerReinitPlot, snapshotMaxFreq

-------------------------------------------------------------------------------

	snapshotDefaultFreq : returns the default snapshot plot frequency
                             for a device or plot class

	defaultFreq = snapshotDefaultFreq(device, plotLength [,plotClass])

	Arguments:

	device		device of interest (or plot class)
	plotLength	plot length in seconds
	[plotClass]	returned plot class number

	This function returns values as follows:

	default snapshot plot frequency

	Related functions:

	snapshotMaxFreq, ftpDefaultFreq, ftpMaxFreq 

-------------------------------------------------------------------------------

	snapshotMaxFreq : returns the maximum snapshot plot frequency for a
			  device or plot class and optionally the number of
			  points as well

	maxFreq = snapshotMaxFreq(device [,maxPoints] [,plotClass])

	Arguments:

	device		device of interest (or plot class)
	[maxPoints]	returned maximum number of points
	[plotClass]	returned plot class number

	This function returns values as follows:

	maximum snapshot frequency

	Related functions:

	snapshotDefaultFreq, ftpMaxFreq, ftpDefaultFreq,
	snapManagerDataDirectory, deviceSnapManagerFiles,
	snapManagerFindDevice, snapManagerSystemNames,
	snapManagerSystemPlotSetups, snapManagerSystemFiles

-------------------------------------------------------------------------------

	split : splits up a string based upon finding a delimiter string

	numStrings = split(sourceString [,delimiter] [,strings] [,options...])

	Arguments:

	sourceString	source string
	[delimiter]	delimiter string
			(default is a blank)
	[strings]	returned array of substrings
	[options]	variable number of split options
			(caseSensitive -> make case sensitive string comparions,
			 caseInsensitive -> make case insensitive string comparions (default),
			 trim -> trim leading and trailing spaces (default),
			 noTrim -> don't trim leading or trailing spaces)

	This function returns values as follows:

	number of substrings

	Related functions:

	splitByCharSet, regexpSplit

-------------------------------------------------------------------------------

	splitByCharSet : splits up a string based upon finding any of a set
			 of delimiter characters

	numStrings = splitByCharSet(sourceString [,delimiters] [,strings]
				    [,options...])

	Arguments:

	sourceString	source string
	[delimiters]	delimiter characters
			(default is all white space characters)
	[strings]	returned array of substrings
	[options]	variable number of split options
			(trim -> trim leading and trailing spaces (default),
			 noTrim -> don't trim leading or trailing spaces,
			 handleQuotes -> handle substrings which are quoted
					 strings,
			 handleEmbeddedQuotes -> handle substrings which have
						 quoted strings embedded
						 in them
			 preserveQuotes -> preserve the quote characters
					   in quoted substrings,
			 handleBraces -> handle substrings which are bracketed
					 strings,
			 handleEmbeddedBraces -> handle substrings which have
						 bracketed strings embedded
						 in them,
			 handleParentheses -> handle substrings which are
					      parenthetical strings,
			 handleEmbeddedParentheses -> handle substrings which
						      have parenthetical
						      strings embedded in them)

	This function returns values as follows:

	number of substrings

	Related functions:

	split, regexpSplit

-------------------------------------------------------------------------------

	sprintf : formats output strings like sprintf with the additional
		  functionality of toString

	string = sprintf(formatString [,arg1] ...)

	Arguments:

	formatString	format string
	[arg1]		first value to format

	This function returns values as follows:

	formatted string

	Related functions:

	toString, toTrimmedString, formatDateString, stringCopy, toNumeric

-------------------------------------------------------------------------------

	sqlQueryDevices : returns devices from a SQL query

	numDevices = sqlQueryDevices(server, database, sqlString [,deviceNames]
				     [,allowObsolete] [,fullNames])

	Arguments:

	server		server name
			(default is ADBS)
	database	database name
			(default is appdb)
	sqlString	SQL string to retrieve devices
	[deviceNames]	returned device names
	[allowObsolete]	flag indicating whether or not to allow obsolete devices
			(obsolete -> allow obsolete devices,
			 noObsolete -> don't allow obsolete devices (default))
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices found by the query

	Related functions:

	fileDevices, loggerListDevices, userAlarmListDevices,
	userSaveListDevices, parameterPageDevices

-------------------------------------------------------------------------------

	sqrt : square root

	resultValue = sqrt(value)

	Arguments:

	value		original value

	This function returns values as follows:

	square root of argument

	Related functions:

	none

-------------------------------------------------------------------------------

	sscanf : functions like sscanf with the additional functionality
                of toNumeric

	numConverted = sscanf(inputString, formatString [,arg1] ...)

	Arguments:

	inputString	input string to convert
	formatString	format string
	[arg1]		first value to convert or conversion type

	This function returns values as follows:

	number of values converted

	Synonyms: stringScanf

	Related functions:

	fscanf, openFile, closeFile, filePrintf, sprintf, printf, toNumeric,
	toString, toTrimmedString, formatDateString, stringCopy 

-------------------------------------------------------------------------------

	ssdnToDeviceType : converts an SSDN/node/property combination
			   to its corresponding device type

	deviceType = ssdnToDeviceType(ssdn, node [,property] [,deviceClass]
				      [,returnType])

	Arguments:

	ssdn		SSDN of interest
	node		ACNET node of interest
	[property]	desired property
			(reading,
			 setting,
			 status,
			 control,
			 analogAlarm,
			 digitalAlarm)
			(default is reading)
	[deviceClass]	returned device class value
	[returnType]	type of returned data
			(text -> return short text (default),
			 longText -> return long text,
			 numeric -> return numeric values (ids))

	This function returns values as follows:

	corresponding device type value

	Related functions:

	deviceType, deviceTypeMismatch

-------------------------------------------------------------------------------

	ssdnToString : converts an SSDN value to a standard string

	string = ssdnToString(ssdn)

	Arguments:

	ssdn		SSDN to convert

	This function returns values as follows:

	converted string

	Related functions:

	stringToSsdn, emcToString, deviceSsdn, stringToEmc

-------------------------------------------------------------------------------

	stateOccurrenceHistory : returns the occurrences of a state event in
                                a time period

	numEvents = stateOccurrenceHistory(stateDevice, stateValue, startTime,
					   [,endTime] [,timestamps]
					   [,milliseconds] [,stateValues])

	Arguments:

	stateDevice	state device
	stateValue	desired state value
			(If this argument is defaulted, occurrences for all
			 state values will be returned.)
	startTime	start of time period to search
	[endTime]	end of time period to search
			(default is now)
	[timestamps]	returned array of state event occurrence timestamps
	[milliseconds]	returned array of state event occurrence milliseconds
	[stateValues]	returned array of state values

	This function returns values as follows:

	number of events found

	Related functions:

	stateText, stateTextToNumber, stateTextAll, eventOccurrenceHistory,
	eventSupercycleHistory

-------------------------------------------------------------------------------

	stateText : returns the text for a state of a state device

	string = stateText(stateDevice [,stateNumber] [,noNumber])

	Arguments:

	stateDevice	stateDevice
	[stateNumber]	state number
			(default is the current state number)
	[noNumber]	format flag
			(TRUE -> strip the leading numeric state value,
			 FALSE -> return the string including the state number)
			(default is FALSE)

	This function returns values as follows:

	state text string

	Related functions:

	stateTextToNumber, stateTextAll, stateOccurrenceHistory

-------------------------------------------------------------------------------

	stateTextAll : returns all of the state text for a state device

	numStates = stateTextAll(stateDevice [,statetext] [,stateValues]
				 [,noNumber])

	Arguments:

	stateDevice	stateDevice
	[stateText]	returned array of state text strings
	[stateValues]	returned array of state values (numbers)
	[noNumber]	format flag
			(TRUE -> strip the leading numeric state value,
			 FALSE -> return the string including the state number)
			(default is FALSE)

	This function returns values as follows:

	number of defined states

	Related functions:

	stateText, stateTextToNumber, stateOccurrenceHistory

-------------------------------------------------------------------------------

	stateTextToNumber : returns the state number corresponding to a
                           state text string

	stateNumber = stateTextToNumber(stateDevice, stateText)

	Arguments:

	stateDevice	stateDevice
	stateText	state text to convert

	This function returns values as follows:

	corresponding state number

	Related functions:

	stateText, stateTextAll, stateOccurrenceHistory

-------------------------------------------------------------------------------

	statusAttrToBitInfo : returns bit information corresponding to a
                             device status attribute

	numBits = statusAttrToBitInfo(device, statusAttribute [,bitNumbers]
				      [,text] [,text_if_0] [,text_if_1]
				      [,color_if_0] [,color_if_1])

	Arguments:

	device		device of interest
	statusAttribute	desired status attribute
			(onOff,
			 readyTripped,
			 remoteLocal,
			 positiveNegative,
			 rampDC)
	[bitNumbers]	returned bit numbers
	[text]		returned bit descriptive text
	[text_if_0]	returned data text if the bit value is 0
	[text_if_1]	returned data text if the bit value is 1
	[color_if_0]	returned text color if the bit value is 0
	[color_if_1]	returned text color if the bit value is 1

	This function returns values as follows:

	number of bit descriptions

	Related functions:

	hasStatusAttribute, bitTextAll, bitText, bitDataText, deviceBitField,
	bitField

-------------------------------------------------------------------------------

	statusScalingInfo : returns status scaling info matching
                           a search criteria

	wasFound = statusScalingInfo(device, searchValue [,searchType]
				     [,orderNumber] [,mask] [,match]
				     [,invertData] [,shortText] [,text]
				     [,matchString] [,matchColor] [,matchChar]
				     [,nonmatchString] [,nonmatchColor]
				     [,nonmatchChar])

	Arguments:

	device		device of interest
	searchValue	search value (ex: 'onOff', 0xA)
	[searchType]	search type
			(text -> search text followed by long text (default),
			 longText -> search long attribute text only,
			 stateString -> search state strings,
			 mask -> search mask values,
			 attributeId -> search for a given attribute ID)
	[orderNumber]	returned order number/attribute ID value
	[mask]		returned mask value
	[match]		returned match value
	[invertData]	returned invert raw data flag
	[shortText]	returned short attribute text value 
	[text]		returned long attribute text value
	[matchString]	returned match state string
	[matchColor]	returned match color
	[matchChar]	returned match character
	[nonmatchString] returned nonmatch state string
	[nonmatchColor]	returned nonmatch color
	[nonmatchChar]	returned nonmatch character

	This function returns values as follows:

	TRUE			status entry was found
	FALSE			status entry was not found

	Related functions:

	statusScalingInfoAll, deviceStatusScaling, deviceStatusScalingAll,
	hasStatusAttribute, statusAttrToBitInfo, digitalControlInfo,
	digitalControlInfoAll

-------------------------------------------------------------------------------

	statusScalingInfoAll : returns all status scaling info for a device

	numEntries = statusScalingInfoAll(device [,orderNumbers] [,masks]
					  [,matchValues] [,invertData]
					  [,shortText] [,text]
					  [,matchStrings] [,matchColors]
					  [,matchChars] [,nonmatchStrings]
					  [,nonmatchColors] [,nonmatchChars])

	Arguments:

	device		device of interest
	[orderNumbers]	returned order number/attribute ID value(s)
	[masks]		returned mask value(s)
	[matchValues]	returned match value(s)
	[invertData]	returned invert raw data flag(s)
	[shortText]	returned short attribute text value(s)
	[text]		returned long attribute text value(s)
	[matchStrings]	returned match state string(s)
	[matchColors]	returned match color(s)
	[matchChars]	returned match character(s)
	[nonmatchStrings] returned nonmatch state string(s)
	[nonmatchColors]  returned nonmatch color(s)
	[nonmatchChars]	returned nonmatch character(s)

	This function returns values as follows:

	number of status scaling entries

	Related functions:

	statusScalingInfo, deviceStatusScaling, deviceStatusScalingAll,
	hasStatusAttribute, statusAttrToBitInfo, digitalControlInfo,
	digitalControlInfoAll

-------------------------------------------------------------------------------

	stddev : calculates the standard deviation of an array of values

	stddevValue = stddev(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	standard deviation of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	stddevValue = stddev(values[])

	stddevValue = stddev(value1, value2, value3, value4)

	Related functions:

	stddev2, mean, mean2, median, median2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms, variance, variance2,
	identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	stddev2 : calculates the standard deviation of an array of values

	stddevValue = stddev2(values [,numValues] [,sum] [,mean] [,variance]
			      [,retNumValues])

	Arguments:

	values		values to calculate the standard deviation of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to calculate from
	[sum]		returned sum value
	[mean]		returned mean value
	[variance]	returned variance value
	[retNumValues]	returned number of values used

	This function returns values as follows:

	standard deviation of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	stddevValue = stddev2(values[2],2)

	stddevValue = stddev2(values[])

	Related functions:

	stddev, mean, mean2, median, median2, mode, mode2, minimum, minimum2,
	maximum, maximum2, sum, sum2, range, range2, rms, variance, variance2,
	identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	stepMotorIsMoving : determines whether or not a stepping motor
                           is currently moving

	isMoving = stepMotorIsMoving(device)

	Arguments:

	device		stepper motor device of interest

	This function returns values as follows:

	TRUE			motor is moving
	FALSE			motor is not moving

	Related functions:

	calculateStepMotorSteps

-------------------------------------------------------------------------------

	stringCompare : compares one string to another (case sensitive)

	value = stringCompare(firstString, secondString [,compareLength]
			      [,firstIndex] [,secondIndex] [,case])

	Arguments:

	firstString	first string to compare
	secondString	second string to compare
	[compareLength]	number of characters to compare
			(default is to compare the entire strings)
	[firstIndex]	index in the first string to start comparing
			(starts at 1)
			(default is 1)
	[secondIndex]	index in the second string to start comparing
			(starts at 1)
			(default is 1)
	[case]		case sensitivity
			(caseSensistive (default),
			 caseInsensitive)

	This function returns values as follows:

	0			strings match
	otherwise		strings don't match

	Related functions:

	stringCompareNocase, regexpCompareString, regexpCompareStringNocase,
	stringCopy, stringGetChar, stringSetChar, substring, byteCompare,
	byteCopy

-------------------------------------------------------------------------------

	stringCompareNocase : compares one string to another (case insensitive)

	value = stringCompareNocase(firstString, secondString [,compareLength]
				    [,firstIndex] [,secondIndex])

	Arguments:

	firstString	first string to compare
	secondString	second string to compare
	[compareLength]	number of characters to compare
			(default is to compare the entire strings)
	[firstIndex]	index in the first string to start comparing
			(starts at 1)
			(default is 1)
	[secondIndex]	index in the second string to start comparing
			(starts at 1)
			(default is 1)

	This function returns values as follows:

	0			strings match
	otherwise		strings don't match

	Related functions:

	stringCompare, regexpCompareStringNocase, regexpCompareString,
	stringCopy, stringGetChar, stringSetChar, substring, byteCompare,
	byteCopy

-------------------------------------------------------------------------------

	stringConcatenate : concatenate two strings

	string = stringConcatenate(leftString, rightString)

	Arguments:

	leftString	left string to concatenate
	rightString	right string to concatenate

	This function returns values as follows:

	concatenated string

	Synonyms: strcat, concatenateString

	Related functions:

	stringCopy, stringSetChar, substring, stringGetChar

-------------------------------------------------------------------------------

	stringCopy : copies one string to another

	string = stringCopy(destString, copyString [,copyLength]
			    [,destIndex] [,copyIndex])

	Arguments:

	destString	string to copy to
	copyString	string to copy
	[copyLength]	number of characters to copy
			(default is the length of the copy string and in this
			 case functions like strcpy)
	[destIndex]	index to start copying to (starts at 1)
			(default is 1)
	[copyIndex]	index to start copying (starts at 1)
			(default is 1)

	This function returns values as follows:

	modified string

	Synonyms: strcpy, strncpy, copyString

	Related functions:

	byteCopy, stringSetChar, substring, stringGetChar, byteCompare

-------------------------------------------------------------------------------

	stringEndsWith : determines if a string ends with a substring

	position = stringEndsWith(sourceString, matchString [,option1])

	Arguments:

	sourceString	source string
	matchString	substring to match
	[option1]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default))

	This function returns values as follows:

	0			matching string not found
	otherwise		matching character position (starts at 1)

	Related functions:

	stringStartsWith, stringEndsWithCharType, stringStartsWithCharType,
	getLastChar, getFirstChar, lastCharPos, firstCharPos, findChar,
	findNotChar, findString, regexpFindString

-------------------------------------------------------------------------------

	stringEndsWithCharType : determines if the last character of a
                                string has a given type

	isCharType = stringEndsWithCharType(sourceString, characterType)

	Arguments:

	sourceString	source string
	characterType	character type to check for
			(alphabetic -> alphabetic character,
			 upperCase -> upper case character,
			 lowerCase -> lower case character,
			 alphanumeric -> alphanumeric character,
			 decimalDigit -> decimal digit,
			 hexDigit -> hexadecimal digit,
			 binaryDigit -> binary digit,
			 octalDigit -> octal digit,
			 quote -> quote character,
			 parenthesis -> parenthesis character,
			 brace -> brace character,
			 punctuation -> punctuation character,
			 whiteSpace -> white space character,
			 comparator -> comparator character,
			 control -> control character,
			 printable -> printable character)

	This function returns values as follows:

	TRUE			last character matches requested type
	FALSE			last character does not match requested type

	Related functions:

	stringStartsWithCharType, characterType, stringEndsWith,
	stringStartsWith, getLastChar, getFirstChar, lastCharPos,
	firstCharPos, findChar, findNotChar, findString, regexpFindString

-------------------------------------------------------------------------------

	stringExtractDeviceNames : extract valid ACNET device names from
                                  a string

	numDevices = stringExtractDeviceNames(sourceString [,deviceNames]
					      [option1, ..., optionN])

	Arguments:

	sourceString	source string
	[deviceNames]	returned device name strings
	[option1, ...]	parsing options
			(allowObsolete -> allow obsolete device names
			 fullNames -> want full device names
			 allProperties -> allow all properties
			 includeArrays -> include array indices)

	This function returns values as follows:

	number of device names extracted

	Related functions:

	isDeviceString, stringExtractLine, stringLineInfo

-------------------------------------------------------------------------------

	stringExtractLine : extract a line from a string

	lineString = stringExtractLine(sourceString, lineLength)

	Arguments:

	sourceString	source string (Note: The extracted string is
			removed from this buffer.)
	lineLength	maximum length of one line

	This function returns values as follows:

	extracted string

	Related functions:

	stringLineInfo, stringExtractDeviceNames

-------------------------------------------------------------------------------

	stringGetChar : retrieve a substring from a string
			(similar to substring but with different defaults)

	string = stringGetChar(sourceString [,startChar] [,numChars])

	Arguments:

	sourceString	string to get substring from
	[startChar]	starting character position (starts at 1)
			(default is 1)
	[numChars]	number of characters to copy
			(default is 1)

	This function returns values as follows:

	desired substring

	Related functions:

	substring, stringCopy, stringSetChar, getFirstChar, getLastChar,
	firstCharPos, stringStartsWith, findChar, findNotChar

-------------------------------------------------------------------------------

	stringGetValue : returns the next token of the specified type from
			 a string and removes it from the original string

	string = stringGetValue(sourceString, stringType [,terminators]
				[,options] [,conditions] [,condTerms]
				[,remainString] [,maxReturn])

	Arguments:

	sourceString	source string (If this function is successful
			and the "remainString" argument is omitted or
			defaulted, this string is modified by setting
			it to the remaining string after the extracted
			string.)
	stringType	type of string to extract
			(simpleString -> simple string with no imbedded
					 white space,
			 compoundString -> string with possible imbedded
					   white space,
			 alphanumeric -> simple alphanumeric string,
			 alphabetic -> simple alphabetic string,
			 lowerCase -> simple lower case string,
			 upperCase -> simple upper case string,
			 integer -> signed decimal integer string,
			 integerWithModifiers -> signed decimal integer string
						 (with length modifiers),
			 hex -> hexadecimal string,
			 hexWithModifiers -> hexadecimal string
					     (with length modifiers),
			 binary -> binary string,
			 binaryWithModifiers -> binary string
						(with length modifiers),
			 octal -> octal string,
			 octalWithModifiers -> octal string
					       (with length modifiers),
			 float -> floating point value string,
			 deviceName -> ACNET device name string,
			 deviceFullName -> ACNET device full name string,
			 simpleDeviceName -> ACNET device name string
					     with no property indicators,
			 simpleDeviceFullName -> ACNET device full name string
						 with no property indicators,
			 quotedString -> quoted string (enclosed by either
					 single (') or double (") quotes),
			 textLine -> line of text terminated by either
				     a line feed character or a line feed/
				     carriage return combination,
			 fixedLengthString -> fixed length string,
			 date[String] -> date string)
	[terminators]	terminator characters
	[options]	retrieval options
			(none -> no options selected (default),
			 skipTerminator -> start the string remainder past
					   the terminator character,
			 handleQuotes -> preserve quoted strings,
			 handleParentheses -> preserve parenthetical strings)
	[conditions]	condition flags
			(none -> no conditions selected (default),
			 firstAlphabetic -> first character is alphabetic,
			 firstNotNumeric -> first character is not numeric,
			 isNumericValue -> current value is numeric,
			 notNumericValue -> current value is not numeric,
			 isDeviceValue -> current value is a device,
			 notDeviceValue -> current value is not a device,
			 previousNotNumeric -> previous character is not
					       numeric)
	[condTerms]	condition terminator characters
	[remainString]	remaining string after the extracted string
			(If this argument is omitted or defaulted,
			 the source string argument will be set to
			 this value.)
	[maxReturn]	maximum number of characters to return
			(default is 8192)

	This function returns values as follows:

	extracted string

	Related functions:

	regexpGetValue, stringToken, split, regexpSplit, splitByCharSet

-------------------------------------------------------------------------------

	stringLength : returns the length of a string

	length = stringLength(string [,maxLength])

	Arguments:

	string		string to determine the length of
	[maxLength]	maximum length to return
			(default is infinite)

	This function returns values as follows:

	string length

	Related functions:

	delimitedStringLength, nonblankLength, sizeof, sizeofVariable

-------------------------------------------------------------------------------

	stringLineInfo : determines how many lines are in a string

	numLines = stringLineInfo(sourceString, lineLength [,longestLine])

	Arguments:

	sourceString	source string
	lineLength	maximum length of one line
	[longestLine]	returned length of the longest line

	This function returns values as follows:

	number of lines contained in the string

	Related functions:

	stringExtractLine, stringExtractDeviceNames

-------------------------------------------------------------------------------

	stringSetChar : overwrite a substring of one string with another
			(similar to stringCopy)

	string = stringSetChar(destString, copyIndex, copyString)

	Arguments:

	destString	string to modify
	copyIndex	index to start copying (starts at 1)
	copyString	string to copy

	This function returns values as follows:

	modified string

	Related functions:

	stringCopy, stringGetChar, substring

-------------------------------------------------------------------------------

	stringStartsWith : determines if a string starts/ends with a substring

	position = stringStartsWith(sourceString, matchString [,option1]
				    [,option2])

	Arguments:

	sourceString	source string
	matchString	substring to match
	[option1...2]	optional argument strings
			(caseSensitive -> case sensitive,
			 caseInsensitive -> case insensitive (default),
			 first -> match beginning of the string,
			 last -> match end of the string)

	This function returns values as follows:

	0			matching string not found
	otherwise		matching character position (starts at 1)

	Related functions:

	stringEndsWith, stringStartsWithCharType, stringEndsWithCharType,
	findChar, findNotChar, findString, regexpFindString, strstr

-------------------------------------------------------------------------------

	stringStartsWithCharType : determines if the first character of a
                                  string has a given type

	isCharType = stringStartsWithCharType(sourceString, characterType)

	Arguments:

	sourceString	source string
	characterType	character type to check for
			(alphabetic -> alphabetic character,
			 upperCase -> upper case character,
			 lowerCase -> lower case character,
			 alphanumeric -> alphanumeric character,
			 decimalDigit -> decimal digit,
			 hexDigit -> hexadecimal digit,
			 binaryDigit -> binary digit,
			 octalDigit -> octal digit,
			 quote -> quote character,
			 parenthesis -> parenthesis character,
			 brace -> brace character,
			 punctuation -> punctuation character,
			 whiteSpace -> white space character,
			 comparator -> comparator character,
			 control -> control character,
			 printable -> printable character)

	This function returns values as follows:

	TRUE			first character matches requested type
	FALSE			first character does not match requested type

	Related functions:

	stringEndsWithCharType, characterType, stringStartsWith,
	stringEndsWith, getLastChar, getFirstChar, lastCharPos,
	firstCharPos, findChar, findNotChar, findString, regexpFindString

-------------------------------------------------------------------------------

	stringToColor : converts a string to a color value

	colorValue = stringToColor(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	color value

	Related functions:

	stringToProperty, stringToConvertType, stringToRad50

-------------------------------------------------------------------------------

	stringToConsoleClassMask : converts a string to a console class mask value

	classMask = stringToConsoleClassMask(classString [,joinString])

	Arguments:

	classString	string to convert
	[joinString]	join string between successive class names
			(default is "+")

	This function returns values as follows:

	converted console class mask

	Related functions:

	consoleClassMaskToString, myConsoleClass

-------------------------------------------------------------------------------

	stringToConvertType : converts a string to a convert type value

	convertTypeValue = stringToConvertType(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	convert type value

	Related functions:

	convertTypeToString, stringToColor, stringToProperty, stringToRad50

-------------------------------------------------------------------------------

	stringToDate : converts a string to a date value

	date = stringtoDate(string [,formatString])

	Arguments:

	string		date string to convert
	formatString	format string suitable for use with strptime

	This function returns values as follows:

	date value in seconds

	Related functions:

	dateToString, convertSeconds, timeAgo, timeFromDate, timeSinceEvent,
	cpuTime, systemTime, 15HzCount, timer, julianDate, julianDateToDate,
	currentDate, currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	stringToDeviceName : finds device names matching a search string

	numNames = stringToDeviceName(string [,deviceNames] [,nameType])

	Arguments:

	string		search string
	[deviceNames]	returned matching device name(s)
	[nameType]	type of name to search for
			(name[s] -> search normal names (default),
			 fullName[s] -> search full names)

	This function returns values as follows:

	number of matching device names

	Related functions:

	deviceFullNameToName

-------------------------------------------------------------------------------

	stringToDouble : converts a string to a double precision
                        floating point value

	numericValue = stringToDouble(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	converted double precision floating point value

	Related functions:

	stringToInteger, toNumeric, toString, toTrimmedString

-------------------------------------------------------------------------------

	stringToEmc : converts a string to an EMC value

	emcLongword = stringToEmc(string [,emc])

	Arguments:

	string		string to convert
	[emc]		returned EMC value
			(If this argument has a data type of short,
			 the EMC is returned as 4 shorts.
			 If this argument has a data type of integer,
			 the EMC value is returned as 2 integers.
			 Otherwise, the EMC is returned as 8 bytes.)

	This function returns values as follows:

	first 4 bytes of the EMC

	Related functions:

	emcToString, stringToSsdn, ssdnToString, deviceEmc

-------------------------------------------------------------------------------

	stringToInteger : converts a string to an integer

	numericValue = stringToInteger(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	converted integer value

	Related functions:

	stringToDouble, toNumeric, toString, toTrimmedString

-------------------------------------------------------------------------------

	stringToken : returns the next token from a string and removes it from
		      the original string

	string = stringToken(sourceString [,terminators] [,option])

	Arguments:

	sourceString	source string (If this function is successful,
			this string is modified by removing the extracted
			string.)
	[terminators]	terminator characters
			(default is all white space characters)
	[option]	parsing option
			(none (default),
			 handleQuotes -> handle substrings which are quoted
					 strings,
			 preserveQuotes -> preserve the quote characters
					   in quoted substrings)

	This function returns values as follows:

	extracted string

	Synonyms: stringGetToken

	Related functions:

	stringGetValue, regexpGetValue, split, regexpSplit, splitByCharSet

-------------------------------------------------------------------------------

	stringToProperty : converts a string to a property value

	propertyValue = stringToProperty(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	property value

	Related functions:

	stringToColor, stringToRad50, stringToConvertType

-------------------------------------------------------------------------------

	stringToRad50 : convert a string to a radix 50 value

	rad50Value = stringToRad50(string)

	Arguments:

	string		string to convert

	This function returns values as follows:

	rad50 value

	Synonyms: rad50

	Related functions:

	rad50ToString, isRad50String, stringToColor, stringToProperty,
	stringToConvertType

-------------------------------------------------------------------------------

	stringToSsdn : converts a string to an SSDN value

	ssdnLongword = stringToSsdn(string [,ssdn])

	Arguments:

	string		string to convert
	[ssdn]		returned SSDN value
			(If this argument has a data type of short,
			 the SSDN is returned as 4 shorts.
			 If this argument has a data type of integer,
			 the SSDN value is returned as 2 integers.
			 Otherwise, the SSDN is returned as 8 bytes.)

	This function returns values as follows:

	first 4 bytes of the SSDN

	Related functions:

	ssdnToString, stringToEmc, emcToString, deviceSsdn

-------------------------------------------------------------------------------

	stringType : returns a string describing the argument string's type

	typeString = stringType(string)

	Arguments:

	string		string to determine the type of

	This function returns values as follows:

	unknown			failed to determine the type of the string
	blank			blank string
	alphabetic		alphabetic string
	alphanumeric		alphanumeric string
	numeric			numeric (integer) string
	float			numeric (floating point) string
	hex			hexadecimal string
	date			date string
	device			device specification string
	property		device property string
	node			node string
	error			error name string
	event			clock event string

	Related functions:

	toNumeric, decimal, hex, toString, toTrimmedString

-------------------------------------------------------------------------------

	stripBrackets : strips beginning and ending brackets from a string

	string = stripBrackets(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	isBracketedString, stripQuotes, stripCharacters, stripSpaces,
	stripNonprintables, stripHtml, stripEolCharacters

-------------------------------------------------------------------------------

	stripCharacters : strips a requested set of characters from a string

	string = stripCharacters(sourceString, stripChars)

	Arguments:

	sourceString	source string
	stripChars	characters to strip

	This function returns values as follows:

	modified string

	Related functions:

	stripSpaces, stripNonprintables, stripHtml, stripQuotes,
	stripEolCharacters

-------------------------------------------------------------------------------

	stripEolCharacters : strips end of line characters from the end of
			     a string

	string = stripEolCharacters(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	stripCharacters, stripSpaces, stripNonprintables, stripHtml, stripQuotes

-------------------------------------------------------------------------------

	stripHtml : strips HTML tags from a string

	string = stripHtml(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	stripCharacters, stripSpaces, stripNonprintables, stripQuotes,
	stripEolCharacters

-------------------------------------------------------------------------------

	stripNonprintables : strips nonprintable characters from a string

	string = stripNonprintables(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	makePrintable, isPrintableString, stripCharacters, stripSpaces,
	stripHtml, stripQuotes, stripEolCharacters

-------------------------------------------------------------------------------

	stripQuotes : strips beginning and ending quotes from a string

	string = stripQuotes(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	quoteString, isQuotedString, stripBrackets, stripCharacters,
	stripSpaces, stripNonprintables, stripHtml, stripEolCharacters

-------------------------------------------------------------------------------

	stripSpaces : strips any whitespace from a string

	string = stripSpaces(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	stripCharacters, stripNonprintables, stripHtml, stripQuotes,
	stripEolCharacters

-------------------------------------------------------------------------------

	strncmp : compares the first n characters of two strings

	value = strncmp(firstString, secondString [,compareLength]
			[,firstIndex] [,secondIndex] [,case])

	Arguments:

	firstString	first string to compare
	secondString	second string to compare
	[compareLength]	number of characters to compare
			(default is to compare the entire strings)
	[firstIndex]	index in the first string to start comparing
			(starts at 1)
			(default is 1)
	[secondIndex]	index in the second string to start comparing
			(starts at 1)
			(default is 1)
	[case]		case sensitivity
			(caseSensistive (default),
			 caseInsensitive)

	This function returns values as follows:

	0			strings match
	otherwise		strings don't match

	Related functions:

	stringCompare, stringCompareNocase, stringCopy, stringGetChar,
	stringSetChar, substring, byteCompare, byteCopy

-------------------------------------------------------------------------------

	strShift : left or right shift a string

	string = strShift(sourceString, direction [,numChars])

	Arguments:

	sourceString	source string
	direction	shift direction
			(left or right)
	[numChars]	number of characters to shift
			(default is 1)

	This function returns values as follows:

	modified string

	Related functions:

	leftShift, rightShift, justify, leftJustify, rightJustify, center, pad

-------------------------------------------------------------------------------

	strstr : searches for a substring

	position = strstr(sourceString, searchString [,caseSensitive]
			  [,matchString])

	Arguments:

	sourceString	source string
	searchString	search string
	[caseSensitive]	case sensitivity argument
			(sensistive -> case sensitive search,
			 insensistive -> case insensitive search (default))
	[matchString]	returns source string starting at the match point

	This function returns values as follows:

	0		search string was not found
	otherwise	match position (starts at 1)

	Related functions:

	findString, regexpFindString, findChar, findNotChar, findTagString,
	stringStartsWith, stringEndsWith

-------------------------------------------------------------------------------

	substring : returns a substring of a string

	string = substring(sourceString, startChar [,numChars])

	Arguments:

	sourceString	string to get substring from
	startChar	starting character position (starts at 1)
			(If a negative value is passed, the starting
			 character will be that many characters from
			 the end of the string.)
	numChars	number of characters to copy
			(default is the rest of the string from the
			 starting character)

	This function returns values as follows:

	desired substring

	Related functions:

	stringGetChar, stringCopy, stringSetChar

-------------------------------------------------------------------------------

	sum : calculates the sum of an array of values

	sumValue = sum(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	sum of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	sumValue = sum(values[])

	sumValue = sum(value1, value2, value3, value4)

	Related functions:

	sum2, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, range, range2,
	rms, stddev, stddev2, variance, variance2,
	identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	sum2 : calculates the sum of an array of values

	sumValue = sum2(values [,numValues] [,retNumValues])

	Arguments:

	values		values to sum
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to sum
	[retNumValues]	returned number of values used

	This function returns values as follows:

	sum of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	sumValue = sum2(values[2],2)

	sumValue = sum2(values[])

	Related functions:

	sum, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, range, range2,
	rms, stddev, stddev2, variance, variance2,
	identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	supercycleLength : returns the length of the current supercycle

	length = supercycleLength()

	Arguments:

	none

	This function returns values as follows:

	length of the current supercycle in seconds

	Related functions:

	timeInSupercycle

-------------------------------------------------------------------------------

	switchAttributeValue : returns network switch attribute values

	value = switchAttributeValue(switchName, attribute)

	Arguments:

	switchName	network switch to retrieve value for
	attribute	network switch attribute type
			(ipName -> switch name,
			 description -> switch description,
			 location -> switch location,
			 area -> switch area,
			 status -> switch status,
			 isUp -> whether or not the switch is up,
			 keeper -> switch keeper,
			 keeperEmail -> switch keeper email,
			 backupKeeper -> switch backup keeper,
			 backupKeeperEmail -> switch backup keeper email)

	This function returns values as follows:

	network switch attribute value

	Related functions:

	genericSwitchSearch, nodeAttributeValue

-------------------------------------------------------------------------------

	synopticDevices : returns devices in a Synoptic display

	numDevices = synopticDevices(synopticName, [,deviceNames] [,fullNames])

	Arguments:

	synopticName	Synoptic display name
	[deviceNames]	returned device names
	[fullNames]	flag indicating whether or not to return
			full device names
			(fullNames -> want full device names,
			 normalNames -> want normal device names (default))

	This function returns values as follows:

	number of devices found in the Synoptic display

	Related functions:

	fileDevices, sqlQueryDevices, loggerListDevices, userAlarmListDevices,
	userSaveListDevices, parameterPageDevices, lexSaDevices

-------------------------------------------------------------------------------

	systemRandomNumber : returns random numbers from 0 to 2^31 - 1

	value = systemRandomNumber([maximum] [,minimum] [,maxPossible])

	Arguments:

	[maximum]	maximum random number to return
			(default is 2^31 - 1)
	[minimum]	minimum random number to return
			(default is 0)
	[maxPossible]	returned maximum possible number returned

	This function returns values as follows:

	random number

	Synonyms: systemRandom

	Related functions:

	random, randomSeed

-------------------------------------------------------------------------------

	systemTime : returns system time in milliseconds since ACL
		     was initialized

	elapsedTime = systemTime([prevSysTime])

	Arguments:

	[prevSysTime]	reference time
			(delta -> time in milliseconds since last call,
			 scriptStart -> time in milliseconds since the
					start of the script
			 otherwise -> previous system time in milliseconds)
			(default is 0)

	This function returns values as follows:

	elapsed system time in milliseconds since ACL was initialized

	Related functions:

	cpuTime, 15HzCount, timer, timeAgo, timeFromDate, timeSinceEvent,
	stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	systemUserIdToName : converts a user ID to a system user name

	userName = systemUserIdToName(userId)

	Arguments:

	userId		user ID to convert

	This function returns values as follows:

	corresponding system user name

	Related functions:

	systemUserNameToId, mySystemUserId, consoleUserNameToFullName,
	fullNameToConsoleUserName, userAttributeValue, myUserName

-------------------------------------------------------------------------------

	systemUserNameToId : converts a user name to a system user ID

	userId = systemUserNameToId(userName)

	Arguments:

	userName	user name to convert

	This function returns values as follows:

	corresponding system user ID

	Related functions:

	systemUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, userAttributeValue, myUserName

-------------------------------------------------------------------------------

	tail : returns the end of a string

	string = tail(sourceString, numChars)

	Arguments:

	sourceString	source string
	numChars	length of string to return

	This function returns values as follows:

	end of source string

	Related functions:

	head

-------------------------------------------------------------------------------

	tan : tangent

	resultValue = tan(value)

	Arguments:

	value		value to take the tangent of in radians

	This function returns values as follows:

	tangent value of the argument

	Related functions:

	tand, tanh, atan, atand, atan2, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	tand : tangent (argument in degrees)

	resultValue = tand(value)

	Arguments:

	value		value to take the tangent of in degrees

	This function returns values as follows:

	tangent value of the argument

	Related functions:

	tan, tanh, atan, atand, atan2, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	tanh : hyperbolic tangent

	resultValue = tanh(value)

	Arguments:

	value		value to take the hyperbolic tangent of

	This function returns values as follows:

	hyperbolic tangent value of the argument

	Related functions:

	tan, tand, atan, atand, atan2, atan2d, atanh, cos, cosd, cosh,
	sin, sind, sinh, acos, acosd, acosh, asin, asind, asinh

-------------------------------------------------------------------------------

	taskExists : determines if an ACNET task exists

	boolean = taskExists(taskName [,node] [,wildcard] [,numTasks]
			     [,taskNames])

	Arguments:

	taskName	task name
	[node]		task node
			(default is local machine)
	[wildcard]	flag indicating whether or not the name is wildcarded
			(default is FALSE)
	[numTasks]	returned number of matching ACNET tasks
	[taskNames]	returned matching ACNET task names

	This function returns values as follows:

	TRUE			task exists
	FALSE			task does not exist

	Related functions:

	nodeAcnetTasks, taskId, taskPid, isServerTask, taskIdToName,
	taskPidToName, pidProcessExists, processExists, processInfo,
	isProgramRunning

-------------------------------------------------------------------------------

	taskId : returns an ACNET task ID

	id = taskId(taskName [,node])

	Arguments:

	taskName	task name
	[node]		task node
			(default is local machine)

	This function returns values as follows:

	task ID value

	Related functions:

	taskExists, taskPid, isServerTask, taskIdToName, taskPidToName,
	pidProcessExists

-------------------------------------------------------------------------------

	taskIdToName : converts an ACNET task ID to a name

	taskName = taskIdToName(id [,node])

	Arguments:

	id		task ID
	[node]		task node
			(default is local machine)

	This function returns values as follows:

	task name

	Related functions:

	taskId, taskPidToName, taskPid, taskExists, isServerTask,
	pidProcessExists

-------------------------------------------------------------------------------

	taskPid : returns an ACNET task process ID

	processId = taskPid(taskName [,node])

	Arguments:

	taskName	task name
	[node]		task node
			(default is local machine)

	This function returns values as follows:

	task process ID value

	Related functions:

	taskExists, taskId, isServerTask, taskIdToName, taskPidToName,
	pidProcessExists

-------------------------------------------------------------------------------

	taskPidToName : converts an ACNET task process ID to name(s)

	numTasks = taskPidToName(taskPid [,node] [,taskName])

	Arguments:

	taskPid		task process ID
	[node]		task node
			(default is local machine)
	[taskName]	returned task names

	This function returns values as follows:

	number of returned task names

	Related functions:

	taskPid, taskIdToName, taskId, taskExists, isServerTask,
	pidProcessExists

-------------------------------------------------------------------------------

	tempFileName : returns a unique temporary file name

	fileName = tempFileName([prefix] [,directory])

	Arguments:

	[prefix]	file name prefix (maximum of 5 characters)
			(default is no prefix if a directory is not
			 specified or "acl" if it is)
	[directory]	directory path
			(default is "/tmp")

	This function returns values as follows:

	unique file name

	Related functions:

	openFile, closeFile, fileGetString, filePrintf, fscanf, fileRead,
	fileRewind, fileWrite, fileFlush

-------------------------------------------------------------------------------

	terminalSize : returns the size of the output terminal

	numLines = terminalSize([numColumns] [,yPixelSize] [,xPixelSize])

	Arguments:

	[numColumns]	returned number of columns
	[yPixelSize]	returned Y pixel size
	[xPixelSize]	returned X pixel size

	This function returns values as follows:

	number of lines

	Related functions:

	none

-------------------------------------------------------------------------------

	text : returns a device descriptive text string

	string = text(device)

	Arguments:

	device		device of interest

	This function returns values as follows:

	device descriptive text string

	Synonyms: description, deviceText, deviceDescription

	Related functions:

	fullText, name, fullName

-------------------------------------------------------------------------------

	thisSoftwareBeamSwitchIsOn : determines is the requested local
                                    software beam switch is on

	boolean = thisSoftwareBeamSwitchIsOn(switchName)

	Arguments:

	switchName	beam switch name
			(master,
			 booster,
			 muon,
			 mainInjector,
			 mta,
			 switchyard,
			 recycler,
			 numi,
			 boone)

	This function returns values as follows:

	TRUE			beam switch is on
	FALSE			beam switch is off

	Related functions:

	beamSwitchIsOn, beamPermitIsUp

-------------------------------------------------------------------------------

	timeAgo : returns date which is some number of time units before a
		  base time

	date = timeAgo(timeUnits [,numUnits] [,baseDate])

	Arguments:

	timeUnits	time units
			(sec -> seconds,
			 min -> minutes,
			 hour -> hour,
			 day -> day,
			 week -> week,
			 month -> month,
			 year -> year)
	[numUnits]	number of time units
			(default is 1)
	[baseDate]	base date for calculation
			(default is now)

	This function returns values as follows:

	calculated date in the past

	Related functions:

	timeFromDate, getSpecialDate, systemTime, cpuTime, timer, 15HzCount,
	timeSinceEvent, stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	timeFromDate : returns date which is some number of time units after a
		       base time

	date = timeFromDate(timeUnits [,numUnits] [,baseDate])

	Arguments:

	timeUnits	time units
			(sec -> seconds,
			 min -> minutes,
			 hour -> hour,
			 day -> day,
			 week -> week,
			 month -> month,
			 year -> year)
	[numUnits]	number of time units
			(default is 1)
	[baseDate]	base date for calculation
			(default is now)

	This function returns values as follows:

	calculated date in the future

	Related functions:

	timeAgo, getSpecialDate, systemTime, cpuTime, timer, 15HzCount,
	timeSinceEvent, stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	timeInSupercycle : returns the current time in the supercycle

	time = timeInSupercycle()

	Arguments:

	none

	This function returns values as follows:

	current time in the supercycle in seconds

	Related functions:

	supercycleLength

-------------------------------------------------------------------------------

	timeIntervalToString : converts a time interval into a string

	string = timeIntervalToString(timeInterval [,timeUnits] [,stringFormat])

	Arguments:

	timeInterval	time interval to convert in seconds
	[timeUnits]	maximum time units in output
			(sec -> seconds,
			 min -> minutes,
			 hour -> hour,
			 day -> day,
			 week -> week,
			 year -> year)
			(default is calculated from the time interval)
	[stringFormat]	string format
			(short -> 'Ny Nw Nd Nh Nm Ns' (default),
			 long -> 'N years N weeks N days N hours N minutes N seconds')

	This function returns values as follows:

	time interval string

	Related functions:

	dateToString, secondsToTodString

-------------------------------------------------------------------------------

	timer : returns the current value of a timer

	elapsedTime = timer(timerName [,units])

	Arguments:

	timerName	timer of interest
	[units]		desired time units
			(sec -> seconds,
			 ticks -> 15Hz ticks)

	This function returns values as follows:

	elapsed time since timer was created

	Related functions:

	systemTime, cpuTime, 15HzCount, timeAgo, timeFromDate, timeSinceEvent,
	stringToDate, dateToString, convertSeconds, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime

-------------------------------------------------------------------------------

	timerReadEvents : returns the reference events for a timer device

	numEvents = timerReadEvents(device [,timerEvents])

	Arguments:

	device		timer device of interest
	[timerEvents]	returned timer reference events

	This function returns values as follows:

	number of timer events

	Related functions:

	deviceIsTimerRef, deviceIsTimer

-------------------------------------------------------------------------------

	timeSinceEvent : returns the elapsed time since an event has occurred

	seconds = timeSinceEvent(event [,eventType])

	Arguments:

	event		clock event value
	[eventType]	type of clock event
			(tclk -> TCLK event (default),
			 mibs -> MIBS clock event,
			 rrbs -> RRBS clock event,
			 tvbs -> TVBS clock event,
			 pclk -> PCLK (Project) clock event,
			 nml -> NML clock event,
			 test -> test clock event)

	This function returns values as follows:

	elapsed time in seconds since the requested clock event occurred

	Related functions:

	eventDate, eventOccurred, clearEventOccurred, eventCount,
	eventInfo, eventTimelineInfo, cpuTime, systemTime, 15HzCount,
	timer, convertSeconds, timeAgo, timeFromDate, stringToDate,
	dateToString, julianDate, julianDateToDate, currentDate,
	currentTimeInClinks, currentTime, localtime, clockEventIsEnabled,
	clockEventTriggerIsEnabled

-------------------------------------------------------------------------------

	timeSinceMidnight : returns the number of seconds since midnight

	seconds = timeSinceMidnight([baseDate])

	Arguments:

	[baseDate]	base date
			(default is now)

	This function returns values as follows:

	elapsed time in seconds since midnight from the given date

	Synonyms: getTimeOfDay

	Related functions:

	timeSinceEvent, timeFromDate, getSpecialDate, currentDate,
	currentTimeInClinks, currentTime, localtimecpuTime, systemTime,
	15HzCount, timer, convertSeconds, timeAgo, stringToDate, dateToString,
	secondsToTodString, todStringToSeconds, julianDate, julianDateToDate

-------------------------------------------------------------------------------

	timezoneInfo : returns information about the local timezone

	timezone = timezoneInfo([gmtDifference])

	Arguments:

	[gmtDifference]	number of minutes of local time relative to Greenwich
			(a negative value means that the local location is
			 west of Greenwich)

	This function returns values as follows:

	timezone name

	Related functions:

	localtime, stringToDate, dateToString, currentDate, currentTimeInClinks,
	currentTime, millisecondsNow, convertSeconds, timeAgo, timeFromDate,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, dateIsDst, dateToDayOfWeek, millisecondsToDate,
	dateToMilliseconds

-------------------------------------------------------------------------------

	todStringToSeconds : converts a time of day string to seconds

	seconds = todStringToSeconds(string)

	Arguments:

	string		time of day string to convert

	This function returns values as follows:

	equivalent number of seconds

	Related functions:

	secondsToTodString, timeSinceMidnight, stringtoDate, dateToString,
	convertSeconds, timeAgo, timeFromDate, timeSinceEvent, cpuTime,
	systemTime, 15HzCount, timer, julianDate, julianDateToDate,
	currentDate, currentTimeInClinks, currentTime, localtime

-------------------------------------------------------------------------------

	toLower : converts a string to lower case

	string = toLower(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	toUpper, case, capitalize

-------------------------------------------------------------------------------

	toNumeric : converts a string to its numeric value

	numericValue = toNumeric(value [,convertType])

	Arguments:

	value		value to convert
	[convertType]	optional conversion type

	This function returns values as follows:

	converted numeric value

	Related functions:

	toString, toTrimmedString, stringToDouble, stringToInteger,
	formatDateString, stringCopy, sprintf

-------------------------------------------------------------------------------

	toString : converts a value to its corresponding string

	stringValue = toString(value [,convertLength] [,justify] [,trimType])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[justify]	string justification
			(none -> no justification,
			 left -> left justification,
			 right -> right justification,
			 center -> center justification)
	[trimType]	trim type
			(none -> don't trim spaces (default),
			 both -> trim leading and trailing spaces,
			 left/beginning -> trim leading spaces,
			 right/ending -> trim trailing spaces)

	This function returns values as follows:

	converted string value

	Related functions:

	toTrimmedString, toNumeric, formatDateString, stringCopy, sprintf

-------------------------------------------------------------------------------

	totalNumberOfDevices : returns the total number of devices in the
                              control system

	numDevices = totalNumberOfDevices([minDeviceIndex] [,maxDeviceIndex]
					  [,options...])

	Arguments:

	[minDeviceIndex]	returned minimum device index
	[maxDeviceIndex]	returned maximum active device index
	[options...]		query options
				(obsolete -> include obsolete devices,
				 deleted -> include deleted devices)

	This function returns values as follows:

	number of active devices in the control system

	Related functions:

	maximumDeviceIndex

-------------------------------------------------------------------------------

	toTrimmedString : converts a value to a string with no spaces

	stringValue = toTrimmedString(value [,convertLength] [,justify])

	Arguments:

	value		value to convert
	[convertLength]	converted string length
	[justify]	string justification
			(none -> no justification,
			 left -> left justification,
			 right -> right justification,
			 center -> center justification)

	This function returns values as follows:

	converted string value

	Related functions:

	toString, toNumeric, formatDateString, stringCopy, sprintf

-------------------------------------------------------------------------------

	toUpper : converts a string to upper case

	string = toUpper(sourceString)

	Arguments:

	sourceString	source string

	This function returns values as follows:

	modified string

	Related functions:

	toLower, case, capitalize

-------------------------------------------------------------------------------

	translateSymbolicLink : translates a symbolic link

	valueString = translateSymbolicLink(symbolicLink)

	Arguments:

	symbolicLink	symbolic link to translate

	This function returns values as follows:

	value of symbolic link

	Related functions:

	<none>

-------------------------------------------------------------------------------

	trim : removes leading and trailing blanks from a string

	string = trim(sourceString [,trimType])

	Arguments:

	sourceString	source string
	[trimType]	trim type
			(both -> trim leading and trailing spaces (default),
			 left/beginning -> trim leading spaces,
			 right/ending -> trim trailing spaces)

	This function returns values as follows:

	modified string

	Related functions:

	leftTrim, rightTrim, toTrimmedString, pad

-------------------------------------------------------------------------------

	trunc : truncate

	truncatedValue = trunc(value)

	Arguments:

	value		value to truncate

	This function returns values as follows:

	truncated value

	Related functions:

	round, prec, abs

-------------------------------------------------------------------------------

	trunkNodeToNode : converts a trunk and node number into a node value

	nodeValue = trunkNodeToNode(trunk, nodeNumber)

	Arguments:

	trunk		trunk number
	nodeNumber	node number

	This function returns values as follows:

	node value

	Related functions:

	nodeToTrunkNode, node, ipNameToNode, isNodeString, nodeIs, nodeIsUp

-------------------------------------------------------------------------------

	unescapeString : replaces escape characters in a string with their
			 original characters

	string = unescapeString(sourceString, escapeType [,handleQuotes])

	Arguments:

	sourceString	original string
	escapeType	type of escape characters
			(C,
			 URL,
			 HTML,
			 bash)
	[handleQuotes]	preserve characters enclosed in a quoted string

	This function returns values as follows:

	modified string

	Related functions:

	escapeString, escapeQuotesInSqlString

-------------------------------------------------------------------------------

	units : returns a device units string

	string = units(device [,property] [,scalingType])

	Arguments:

	device		device of interest
	[property]	desired property
			(reading,
			 setting)
			(default is the implicit property from the device
			 argument)
	[scalingType]	scaling type
			(common -> engineering units (default),
			 primary -> primary units)

	This function returns values as follows:

	units text string

	Related functions:

	deviceReadSetScaling, deviceScalingLength, name, fullName, text,
	fullText

-------------------------------------------------------------------------------

	unmaskAbortInput : unmasks an abort input

	boolean = unmaskAbortInput(system, module, input)

	Arguments:

	system		abort system of interest
			(Booster,
			 Recycler,
			 MainInjector,
			 Switchyard,
			 p1Line,
			 p2Line,
			 BooNE,
			 NuMI,
			 Muon,
			 Test)
	module		name of the module to unmask
	input		abort input number to unmask (1-8)

	This function returns values as follows:

	TRUE			abort input was unmasked

	Related functions:

	maskAbortInput, abortLoopIsUp, abortSystemReset, beamPermitIsUp,
	beamSwitchIsOn, thisSoftwareBeamSwitchIsOn

-------------------------------------------------------------------------------

	unsetenv : deletes an environment variable

	status = unsetenv(envVariable)

	Arguments:

	envVariable	environment variable name

	This function returns values as follows:

	OK

	Related functions:

	setenv, getenv, delenv, getLogicalName, setLogicalName,
	deleteLogicalName

-------------------------------------------------------------------------------

	userAlarmList : returns the state of a user alarm list
			(enabled, bypassed, or empty)

	status = userAlarmList(alarmList)

	Arguments:

	alarmList	alarm list name

	This function returns values as follows:

	enabled			alarm list is enabled
	bypassed		alarm list is disabled
	empty			alarm list is empty

	Related functions:

	setUserAlarmListStatus, userAlarmListDevices, userAlarmListLists

-------------------------------------------------------------------------------

	userAlarmListDevices : returns the devices in a user alarm list

	numDevices = userAlarmListDevices(alarmList [,deviceNames])

	Arguments:

	alarmList	user alarm list
			({system}[\{list name}])
	[deviceNames]	returned device names

	This function returns values as follows:

	number of devices in the user alarm list

	Related functions:

	userAlarmListLists, userAlarmList, setUserAlarmListStatus, fileDevices,
	sqlQueryDevices, loggerListDevices, userSaveListDevices,
	parameterPageDevices

-------------------------------------------------------------------------------

	userAlarmListLists : returns the user alarm lists referenced
			     by a user alarm list

	numLists = userAlarmListLists(alarmList [,listNames] [,listIds])

	Arguments:

	alarmList	user alarm list
			({system}[\{list name}])
	[listNames]	returned list names
	[listIds]	returned list IDs

	This function returns values as follows:

	number of other lists referenced by the user alarm list

	Related functions:

	userAlarmListDevices, userAlarmList, setUserAlarmListStatus

-------------------------------------------------------------------------------

	userAttributeValue : returns user attribute values

	value = userAttributeValue(userName, attribute [,dataType])

	Arguments:

	userName	user name to retrieve value for
	attribute	user attribute type
			(name -> console user name (same as first argument),
			 fullName -> user full name,
			 email -> user email,
			 phone -> phone extension,
			 phone2 -> phone extension 2,
			 phone3 -> phone extension 3,
			 pager -> pager number,
			 location -> user office location,
			 affiliation -> user's affiliation (usually department),
			 mailStation -> mail station,
			 userId -> lab user ID,
			 isNonuser -> flag indicating is this is a nonuser,
			 isInactive -> flag indicating if this user is inactive,
			 isDabbelUser -> flag indicating if this is a DABBEL user,
			 isAclUser -> flag indicating if this is an ACL user,
			 aclPrivClass -> ACL privilege class,
			 aclPrivLevel -> ACL privilege level,
			 aclEditLevel -> ACL edit privilege level,
			 comment -> user status comment,
			 permissions -> user permissions,
			 classes -> user console classes,
			 keyValue -> user key value,
			 hasPassword -> flag indicating if password set,
			 addDate -> date user was add to the system,
			 modifyDate -> date user information was last modified)
	[dataType]	returned data type (presently only used for class and
			permissions fields)
			(string -> return string values (default),
			 numeric -> return numeric values)

	This function returns values as follows:

	user attribute value

	Related functions:

	genericUserSearch, consoleUserNameToFullName, fullNameToConsoleUserName,
	myUserName, systemUserNameToId, systemUserIdToName

-------------------------------------------------------------------------------

	userIsaPerson : determines if a user name represents an actual person

	isPerson = userIsaPerson(userName)

	Arguments:

	userName	user name to check

	This function returns values as follows:

	TRUE			user name represents a person
	FALSE			user name does not represent a person

	Related functions:

	isValidUserName, isAclUser, isDabbelUser, consoleUserNameToId,
	consoleUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserId, myUserName, systemUserNameToId,
	systemUserIdToName, userAttributeValue

-------------------------------------------------------------------------------

	userMonitorContacts : retrieves the monitor contacts registered
                             for a user

	numContacts = userMonitorContacts(userName [,contacts] [,contactTypes])

	Arguments:

	userName	user name to check
	[contacts]	returned contact strings
	[contactTypes]	returned contact types

	This function returns values as follows:

	number of registered contacts

	Related functions:

	userIsaPerson, isValidUserName, isAclUser, isDabbelUser,
	consoleUserNameToId, consoleUserIdToName, consoleUserNameToFullName,
	fullNameToConsoleUserName, myUserId, myUserName, systemUserNameToId,
	systemUserIdToName, userAttributeValue

-------------------------------------------------------------------------------

	userSaveListDevices : returns the devices in a user save list

	numDevices = userSaveListDevices(saveList [,deviceNames])

	Arguments:

	saveList	user save list
			({system}[\{category name}][\{list name}])
	[deviceNames]	returned device names

	This function returns values as follows:

	number of devices in the user save list

	Related functions:

	fileDevices, sqlQueryDevices, loggerListDevices,
	userAlarmListDevices, parameterPageDevices

-------------------------------------------------------------------------------

	usersMonitoringAlarm : returns the user who are monitoring a
                              particular alarm

	numUsers = usersMonitoringAlarm(device [,property] [,userNames])

	Arguments:

	device		device of interest
	[property]	desired property
			(analogAlarm,
			 digitalAlarm)
			(default is the implicit property from the device
			 argument)
	[userNames]	returned user names of users monitoring this alarm

	This function returns values as follows:

	number of users monitoring this alarm

	Related functions:

	none

-------------------------------------------------------------------------------

	utcSecondsToDate : converts a UTC time in seconds to a date value

	date = utcSecondsToDate([utcSeconds])

	Arguments:

	[utcSeconds]	UTC seconds
			(default is now)

	This function returns values as follows:

	corresponding date value

	Related functions:

	convertSeconds, timeAgo, timeFromDate, stringToDate, dateToString,
	timeSinceEvent, cpuTime, systemTime, 15HzCount, timer, julianDate,
	julianDateToDate, currentDate, currentTimeInClinks, currentTime,
	localtime, mdatCurrentDate

-------------------------------------------------------------------------------

	utilityGetDate : retrieves the current date and time from a utility process

	boolean = utilityGetDate(console [,milliseconds])

	Arguments:

	console		console nummber or node
	[milliseconds]	current date and time in milliseconds

	This function returns values as follows:

	current date and time according to the utility process

	Related functions:

	utilityPing

-------------------------------------------------------------------------------

	utilityPing : pings a utility process

	boolean = utilityPing(console)

	Arguments:

	console		console nummber or node

	This function returns values as follows:

	TRUE			utility process responded
	FALSE			utility process did not respond

	Related functions:

	utilityGetDate

-------------------------------------------------------------------------------

	validateDeviceName : checks to see if a string would be a
                            valid device name

	isValid = validateDeviceName(nameString [,machineName] [,nameType])

	Arguments:

	nameString	name string to validate
	[machineName]	corresponding machine name
			(default is none)
	[nameType]	type of device name to validate
			(classicName (default),
			 fullName)

	This function returns values as follows:

	TRUE			string is a valid device name
	FALSE			string is not a valid device name

	Related functions:

	isDeviceString, name, fullName

-------------------------------------------------------------------------------

	valueToLogicalArray : converts bit values into a logical array

	numBitsTested = valueToLogicalArray(sourceValue, logicalArray
					    [,startBit] [,numBits])

	Arguments:

	sourceValue	value to convert
	logicalArray	returned logical array
			(There will be one entry for each bit tested.
			 If necessary, the variable will be resized.)
	[startBit]	starting bit number (starts at 1)
			(default is 1)
	[numBits]	number of bits to test
			(default is all)

	This function returns values as follows:

	number of bits actually tested

	Related functions:

	bit, bitCount, lowestBit, highestBit, bitField, deviceBitField, bitText,
	bitDataText

-------------------------------------------------------------------------------

	valueType : returns the type of a value as a string

	type = valueType(value)

	Arguments:

	value		value to determine the type of

	This function returns values as follows:

	type of value as a string

	Related functions:

	variableType, variableArrayDimensions, variableNumReadings,
	variableNumSettings, ifLevel, loopLevel

-------------------------------------------------------------------------------

	variableArrayDimensions : returns the array dimensions of a variable

	numDimensions = variableArrayDimensions(variable [,dimensionSizes])

	Arguments:

	variable	 requested variable name
	[dimensionSizes] returned array dimension size(s)

	This function returns values as follows:

	number of array dimensions

	Related functions:

	variableDimensionSize, variableType, variableNumReadings,
	variableNumSettings, valueType, sizeofVariable, byteSizeofVariable,
	numElements, variableIsInitialized, variableIsConstant,
	variableIsDynamic

-------------------------------------------------------------------------------

	variableDimensionSize : returns the size of one dimension of a variable

	size = variableDimensionSize(variable, dimension)

	Arguments:

	variable	requested variable name
	dimension	desired dimension (starts at 0)

	This function returns values as follows:

	size of requested array dimension

	Related functions:

	variableArrayDimensions, variableType, variableNumReadings,
	variableNumSettings, valueType, sizeofVariable, byteSizeofVariable,
	numElements, variableIsInitialized, variableIsConstant,
	variableIsDynamic

-------------------------------------------------------------------------------

	variableIsConstant : determines whether or not a variable
                            is a constant

	isConstant = variableIsConstant(variable)

	Arguments:

	variable	variable to check

	This function returns values as follows:

	TRUE			variable is a constant
	FALSE			variable is not a constant

	Related functions:

	variableIsDynamic, variableIsInitialized, variableType,
	variableArrayDimensions, variableDimensionSize,
	variableNumReadings, variableNumSettings, variableIsConstant,
	valueType, sizeofVariable, byteSizeofVariable, numElements

-------------------------------------------------------------------------------

	variableIsDynamic : determines whether or not a variable
                           is dynamically resizable

	isDynamic = variableIsDynamic(variable)

	Arguments:

	variable	variable to check

	This function returns values as follows:

	TRUE			variable is dynamically resizable
	FALSE			variable is not dynamically resizable

	Related functions:

	variableIsConstant, variableIsInitialized, variableType,
	variableArrayDimensions, variableDimensionSize,
	variableNumReadings, variableNumSettings, variableIsConstant,
	valueType, sizeofVariable, byteSizeofVariable, numElements

-------------------------------------------------------------------------------

	variableIsInitialized : determines whether or not a variable has been
                               initialized

	isInitialized = variableIsInitialized(variable)

	Arguments:

	variable	variable to check

	This function returns values as follows:

	TRUE			variable has been initialized
	FALSE			variable has not been initialized

	Related functions:

	variableType, variableIsConstant, variableIsDynamic,
	variableArrayDimensions, variableDimensionSize,
	variableNumReadings, variableNumSettings, valueType,
	sizeofVariable, byteSizeofVariable, numElements

-------------------------------------------------------------------------------

	variableNumReadings : returns the number of times a variable
                             has been read

	numReadings = variableNumReadings(variable)

	Arguments:

	variable	variable to get the number of readings for

	This function returns values as follows:

	number of times that the variable has been read

	Related functions:

	variableNumSettings, variableType, variableArrayDimensions,
	variableDimensionSize, valueType, sizeofVariable, byteSizeofVariable,
	numElements, ifLevel, loopLevel, variableIsInitialized,
	variableIsConstant, variableIsDynamic

-------------------------------------------------------------------------------

	variableNumSettings : returns the number of times a variable
                             has been set

	numSettings = variableNumSettings(variable)

	Arguments:

	variable	variable to get the number of settings for

	This function returns values as follows:

	number of times that the variable has been set

	Related functions:

	variableNumReadings, variableType, variableArrayDimensions,
	variableDimensionSize, valueType, sizeofVariable, byteSizeofVariable,
	numElements, ifLevel, loopLevel, variableIsInitialized,
	variableIsConstant, variableIsDynamic

-------------------------------------------------------------------------------

	variableType : returns the type of a variable as a string

	type = variableType(variable)

	Arguments:

	variable	variable to determine the type of

	This function returns values as follows:

	type of variable as a string

	Related functions:

	variableArrayDimensions, variableDimensionSize, variableNumReadings,
	variableNumSettings, valueType, sizeofVariable, byteSizeofVariable,
	numElements, ifLevel, loopLevel, variableIsInitialized,
	variableIsConstant, variableIsDynamic

-------------------------------------------------------------------------------

	variance : calculates the variance of an array of values

	varianceValue = variance(value [,value2...])

	Arguments:

	value		first value (This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[value2...]	subsequent values (These must be single values.)

	This function returns values as follows:

	variance of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	varianceValue = variance(values[])

	varianceValue = variance(value1, value2, value3, value4)

	Related functions:

	variance2, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, sum, sum2, range, range2,
	rms, stddev, stddev2, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	variance2 : calculates the variance of an array of values

	varianceValue = variance2(values [,numValues] [,sum] [,mean]
				  [,retNumValues])

	Arguments:

	values		values to calculate the variance of
			(This argument can be an array value.
			To indicate a range of array values, use the
			value[m:n] notation.  To indicate the entire
			array, use the value[] notation.)
	[numValues]	number of values to calculate the variance of
	[sum]		returned sum value
	[mean]		returned mean value
	[retNumValues]	returned number of values used

	This function returns values as follows:

	variance of the values

	Examples:

	declare values double[] = 1, 2, 3, 4
	varianceValue = variance2(values[2],2)

	varianceValue = variance2(values[])

	Related functions:

	variance, mean, mean2, median, median2, mode, mode2,
	minimum, minimum2, maximum, maximum2, sum, sum2, range, range2,
	rms, stddev, stddev2, identical, identical2, min, max, histogram

-------------------------------------------------------------------------------

	virtualMachineDevices : returns the devices belonging to a
                               virtual machine

	numDevices = virtualMachineDevices(device [,machineDevices])

	Arguments:

	device			device of interest
	[machineDevices]	returned devices which are members of
				this virtual machine

	This function returns values as follows:

	number of devices which are members of this virtual machine

	Related functions:

	deviceVirtualMachine, controlledDevices, deviceInCompositeDevices,
	deviceInFamilies

-------------------------------------------------------------------------------

	whereDeviceIsLogged : returns where a device is logged

	numLogged = whereDeviceIsLogged(device [,dataEvent] [,loggerNodes]
					[,loggerLists] [,loggerEvents]
					[,deviceNames])

	Arguments:

	device		device of interest
	[dataEvent]	retrieval data event (default is null data event)
	[loggerNodes]	returned logger nodes
	[loggerLists]	returned logger list numbers (0-17)
	[loggerEvents]	returned data events
	[deviceNames]	returned device names

	This function returns values as follows:

	number of locations where the device is being logged

	Related functions:

	whereDeviceWasLogged, deviceLoggerDataEvents, loggerListInfo,
	loggerListDevices, loggerListDeviceStats, loggerListWrapTime,
	oldestLoggerTime, loggerNameToNode, nodeToLoggerName, allLoggerNodes,
	loggerIsUp, loggerIsEnabled

-------------------------------------------------------------------------------

	whereDeviceWasLogged : returns where a device was logged in the past

	numLogged = whereDeviceWasLogged(device [,dataEvent] [,options]
					 [,startDate] [,endDate]
					 [,loggerNodes] [,loggerLists]
					 [,loggerEvents] [,deviceNames]
					 [,deleteDates] [,userNames])

	Arguments:

	device		device of interest
	[dataEvent]	retrieval data event (default is null data event)
	[options]	search option
			(all -> match all device requests (default),
			 exact -> match the specific device elements specified)
	[startDate]	starting deletion date
			(default is 01-JAN-1972 00:00:00)
	[endDate]	ending deletion date
			(default is now)
	[loggerNodes]	returned logger nodes
	[loggerLists]	returned logger list numbers (0-17)
	[loggerEvents]	returned data events
	[deviceNames]	returned device names
	[deleteDates]	returned deletion dates
	[userNames]	returned user names who deleted the device

	This function returns values as follows:

	number of locations where the device was previously being logged

	Related functions:

	whereDeviceIsLogged, loggerListInfo, loggerListDevices,
	loggerListDeviceStats, loggerListWrapTime, oldestLoggerTime,
	loggerNameToNode, nodeToLoggerName, allLoggerNodes, loggerIsUp,
	loggerIsEnabled

-------------------------------------------------------------------------------

	wordCount : returns the number of words in a string

	numWords = wordCount(sourceString, [,words] [,option])

	Arguments:

	sourceString	source string
	[words]		returned array of words
	[option]	parsing options
			(handleQuotes -> observe quoted strings)

	This function returns values as follows:

	number of words

	Related functions:

	characterCount, split, splitByCharSet, regexpSplit

-------------------------------------------------------------------------------

	xor : bitwise exclusive or

	resultValue = xor(value, value2)

	Arguments:

	value		first value
	value2		second value

	This function returns values as follows:

	bitwise exclusive or of the two arguments

	Synonyms: exclusiveOr

	Related functions:

	or, and

-------------------------------------------------------------------------------