Package xal.ca
Class Channel
java.lang.Object
xal.ca.Channel
- Direct Known Subclasses:
Epics7Channel
Channel is an abstract high level XAL wrapper for a native process variable (PV) channel. Subclasses provide native
implementations.
- Version:
- 1.1
- Author:
- Christopher K. Allen, Tom Pelaia
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static ChannelSystemprotected booleanhold connection statusprotected ConnectionListenerNotify listeners when connection is made or droppedprotected doublepend event timeoutprotected doublepend IO timeoutprotected static MessageCenterOne MessageCenter for all Channel eventsprotected Stringchannel name -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddConnectionListener(ConnectionListener listener) Add a listener of connection changesabstract MonitoraddMonitorValStatus(IEventSinkValStatus listener, int intMaskFire) Setup a value-status monitor on this channelabstract MonitoraddMonitorValTime(IEventSinkValTime listener, int intMaskFire) Setup a value-status-timestamp monitor on this channelabstract MonitoraddMonitorValue(IEventSinkValue listener, int intMaskFire) Setup a value monitor on this channelReturns EPICS channel name for process variablevoidChecks for process variable channel connection and throws a ConnectionException if absent.protected voidcheckConnection(String methodName) Checks for process variable channel connection and throws a ConnectionException if absent after attempting a connection if necessary.protected voidcheckConnection(String methodName, boolean attemptConnection) Checks for process variable channel connection and throws a ConnectionException if absent.booleanConnect and wait the default timeout.abstract booleanconnectAndWait(double timeout) Request a new connection and wait for it no longer than the timeout.abstract voidTerminate the network channel connection and clear all events associated with process variableabstract intReturn size of value array associated with process variableabstract Class<?>get the Java class associated with the native type of this channelstatic voidflushIO()flush IO requestsabstract String[]Get the lower and upper alarm limit PVsFetch the data value for the channel and return it as an ArrayValue.byte[]Get channel value as arrayfinal voidgetArrByteCallback(IEventSinkArrByte listener) Get the value of the process variable via a callback to the specified listener.double[]final voidgetArrDblCallback(IEventSinkArrDbl listener) Get the value of the process variable via a callback to the specified listener.float[]final voidgetArrFltCallback(IEventSinkArrFlt listener) Get the value of the process variable via a callback to the specified listener.int[]final voidgetArrIntCallback(IEventSinkArrInt listener) Get the value of the process variable via a callback to the specified listener.long[]short[]String[]abstract String[]Get the lower and upper drive limit PVsdoubleGet the channel access Pend Event timeoutgetId()Return a unique identifier of this channel so as to distinguish channels which share the same PV but have different transforms.static ChannelgetInstance(String signalName) From the default channel factory, get a channel for the specified signal name.static ChannelgetInstance(String signalName, ValueTransform transform) From the default channel factory, get a channel for the specified signal name and value transform.doubleGet the channel access Pend IO timeoutabstract String[]Get the lower and upper operation limit PVsabstract ChannelStatusRecordReturn a rawChannelStatusRecordrepresenting the fetched record for the native type of this channel.protected abstract ChannelStatusRecordGet aChannelStatusRecordrepresenting the fetched record for the specified type.protected abstract ChannelTimeRecordGet aChannelTimeRecordrepresenting the fetched record for the specified type.protected abstract ChannelRecordGet aChannelRecordrepresenting the fetched record for the specified type.abstract ChannelTimeRecordReturn a rawChannelTimeRecordrepresenting the fetched record for the native type of this channel.protected abstract voidgetRawValueCallback(IEventSinkValue listener) Handle a callback for getting the raw value for the channel.protected abstract voidgetRawValueCallback(IEventSinkValue listener, boolean attemptConnection) Handle a callback for getting the raw value for the channel.abstract ChannelRecordReturn a rawChannelRecordrepresenting the fetched record for the native type of this channel.abstract voidgetRawValueTimeCallback(IEventSinkValTime listener, boolean attemptConnection) Submit a non-blocking Get request with callbackfinal ChannelStatusRecordReturn aChannelStatusRecordrepresenting the fetched record for the native type of this channel.final ChannelRecordGet aChannelStatusRecordrepresenting the fetched record for the native type of this channel.final ChannelRecordGet aChannelTimeRecordrepresenting the fetched record for the native type of this channel.final ChannelRecordGet aChannelRecordrepresenting the fetched record for the native type of this channel.final ChannelTimeRecordReturn aChannelTimeRecordrepresenting the fetched record for the native type of this channel.abstract StringgetUnits()Convenience method which returns the units for this channel.byteGet channel valuefinal voidgetValByteCallback(IEventSinkValByte listener) Get the value of the process variable via a callback to the specified listener.doublefinal voidgetValDblCallback(IEventSinkValDbl listener) Get the value of the process variable via a callback to the specified listener.intfloatfinal voidgetValFltCallback(IEventSinkValFlt listener) Get the value of the process variable via a callback to the specified listener.intfinal voidgetValIntCallback(IEventSinkValInt listener) Get the value of the process variable via a callback to the specified listener.longshortfinal voidgetValueCallback(IEventSinkValue listener) Get the value of the process variable via a callback to the specified listener.final voidgetValueCallback(IEventSinkValue listener, boolean attemptConnection) Get the value of the process variable via a callback to the specified listener.final ChannelRecordReturn aChannelRecordrepresenting the fetched record for the native type of this channel.final voidgetValueTimeCallback(IEventSinkValTime listener, boolean attemptConnection) Get the value time record of the process variable via a callback to the specified listener.Get the value transform applied to this channel.abstract String[]Get the lower and upper warning limit PVsbooleanChecks if channel is connected to process variablebooleanisValid()determine whether this channel is validfinal NumberConvenience method which returns the lower alarm limit.final NumberConvenience method which returns the lower control limit.final NumberConvenience method which returns the lower display limit.final NumberConvenience method which returns the lower warning limit.static voidpendEvent(double timeout) Flush the EPICS Channel Access request buffer and wait for asynchronous event.static booleanpendIO(double timeout) Flush the EPICS Channel Access request buffer and return as soon as complete or timeout has expired.abstract voidputRawValCallback(byte[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(byte newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(double[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(double newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(float[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(float newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(int[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(int newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(long[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(long newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(short[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(short newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(String[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract voidputRawValCallback(String newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.voidputVal(byte newVal) Synchronously put a value to the channel process variable.voidputVal(byte[] newVal) Synchronously put a value to the channel process variable.voidputVal(double newVal) Synchronously put a value to the channel process variable.voidputVal(double[] newVal) Synchronously put a value to the channel process variable.voidputVal(float newVal) Synchronously put a value to the channel process variable.voidputVal(float[] newVal) Synchronously put a value to the channel process variable.voidputVal(int newVal) Synchronously put a value to the channel process variable.voidputVal(int[] newVal) Synchronously put a value to the channel process variable.voidputVal(long newVal) Synchronously put a value to the channel process variable.voidputVal(long[] newVal) Synchronously put a value to the channel process variable.voidputVal(short newVal) Synchronously put a value to the channel process variable.voidputVal(short[] newVal) Synchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.voidSynchronously put a value to the channel process variable.final voidputValCallback(byte[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(byte newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(double[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(double newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(float[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(float newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(int[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(int newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(long[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(long newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(short[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(short newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(Object newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(String[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final voidputValCallback(String newVal, PutListener listener) Asynchronously put a value to the channel process variable.abstract NumberConvenience method which returns the lower alarm limit.abstract NumberConvenience method which returns the lower control limit.abstract NumberConvenience method which returns the lower display limit.abstract NumberConvenience method which returns the lower warning limit.abstract NumberConvenience method which returns the upper alarm limit.abstract NumberConvenience method which returns the upper control limit.abstract NumberConvenience method which returns the upper display limit.abstract NumberConvenience method which returns the upper warning limit.abstract booleanDetermine if channel has read access to process variablevoidremoveConnectionListener(ConnectionListener listener) Remove a listener of connection changesabstract voidRequest that the channel be connected.voidsetChannelName(String strNameChan) Set the EPICS channel name for the connectionstatic voidsetDebugMode(boolean bDebug) voidsetEventTimeout(double dblTm) Set the channel access Pend Event timeoutvoidsetIoTimeout(double dblTm) Set the channel access Pend IO timeoutvoidsetValid(boolean valid) set whether this channel is validfinal NumberConvenience method which returns the upper alarm limit.final NumberConvenience method which returns the upper control limit.final NumberConvenience method which returns the upper display limit.final NumberConvenience method which returns the upper warning limit.abstract booleanDetermine if channel has write access to process variable
-
Field Details
-
channelSystem
-
strId
channel name -
dblTmIO
protected double dblTmIOpend IO timeout -
dblTmEvt
protected double dblTmEvtpend event timeout -
connectionProxy
Notify listeners when connection is made or dropped -
messageCenter
One MessageCenter for all Channel events -
connectionFlag
protected volatile boolean connectionFlaghold connection status
-
-
Constructor Details
-
Channel
protected Channel()Creates empty Channel -
Channel
Creates new Channel- Parameters:
name- EPICS channel name
-
Channel
Create a new Channel- Parameters:
name- The EPICS PV nameaTransform- The transform to apply to PV values
-
-
Method Details
-
flushIO
public static void flushIO()flush IO requests -
pendIO
public static boolean pendIO(double timeout) Flush the EPICS Channel Access request buffer and return as soon as complete or timeout has expired. Must use a pendX() function if synchronous request queuing is on! Requests include Channel.connect() and Channel.getVal()- Parameters:
timeout- time to wait before giving up- Returns:
- false if time out occurs
-
pendEvent
public static void pendEvent(double timeout) Flush the EPICS Channel Access request buffer and wait for asynchronous event. This function blocks until the time out has expired! Neither will it return until the channel access queue has been processed. Must use a pendX() function if synchronous request queuing is on! Requests include Channel.connectCallback Channel.getValCallback(), Channel.putValCallback and all monitor events.- Parameters:
timeout- time to wait before giving up
-
getInstance
From the default channel factory, get a channel for the specified signal name.- Parameters:
signalName- the PV for which to get the channel- Returns:
- a channel for the specified PV
-
getInstance
From the default channel factory, get a channel for the specified signal name and value transform.- Parameters:
signalName- the PV for which to get the channeltransform- to transform the value between raw and physical- Returns:
- a channel for the specified PV
-
setValid
public void setValid(boolean valid) set whether this channel is valid- Parameters:
valid- marks whether the channel is valid (true) or not (false)
-
isValid
public boolean isValid()determine whether this channel is valid- Returns:
- true if it the channel is valid and false if not
-
getValueTransform
Get the value transform applied to this channel.- Returns:
- The value transform applied to this channel.
-
addConnectionListener
Add a listener of connection changes- Parameters:
listener- to register for connection events
-
removeConnectionListener
Remove a listener of connection changes- Parameters:
listener- to remove from receiving connection events
-
getId
Return a unique identifier of this channel so as to distinguish channels which share the same PV but have different transforms.- Returns:
- A channel identifier built from the PV and value transform
-
channelName
Returns EPICS channel name for process variable- Returns:
- string descriptor for EPICS channel
-
setChannelName
Set the EPICS channel name for the connection- Parameters:
strNameChan- EPICS channel name
-
setDebugMode
public static void setDebugMode(boolean bDebug) -
setIoTimeout
public void setIoTimeout(double dblTm) Set the channel access Pend IO timeout- Parameters:
dblTm- I/O timeout
-
setEventTimeout
public void setEventTimeout(double dblTm) Set the channel access Pend Event timeout- Parameters:
dblTm- event timeout
-
getIoTimeout
public double getIoTimeout()Get the channel access Pend IO timeout- Returns:
- I/O timeout
-
getEventTimeout
public double getEventTimeout()Get the channel access Pend Event timeout- Returns:
- event timeout
-
connectAndWait
public boolean connectAndWait()Connect and wait the default timeout.- Returns:
- true if the connection was made within the timeout and false if not
-
connectAndWait
public abstract boolean connectAndWait(double timeout) Request a new connection and wait for it no longer than the timeout.- Parameters:
timeout- seconds to wait for a connection before giving up- Returns:
- true if the connection was made within the timeout and false if not
-
requestConnection
public abstract void requestConnection()Request that the channel be connected. Connections are made in the background so this method returns immediately upon making the request. The connection will be made in the future as soon as possible. A connection event will be sent to registered connection listeners when the connection has been established. -
disconnect
public abstract void disconnect()Terminate the network channel connection and clear all events associated with process variable -
isConnected
public boolean isConnected()Checks if channel is connected to process variable- Returns:
- true if connected
-
checkConnection
Checks for process variable channel connection and throws a ConnectionException if absent.- Throws:
ConnectionException- accordingly
-
checkConnection
Checks for process variable channel connection and throws a ConnectionException if absent after attempting a connection if necessary.- Parameters:
methodName- name of method using connection- Throws:
ConnectionException- accordingly
-
checkConnection
protected void checkConnection(String methodName, boolean attemptConnection) throws ConnectionException Checks for process variable channel connection and throws a ConnectionException if absent.- Parameters:
methodName- name of method using connectionattemptConnection- indicates whether or not to attempt a blocking connection request- Throws:
ConnectionException- accordingly
-
elementType
get the Java class associated with the native type of this channel- Returns:
- the native element type
- Throws:
ConnectionException- accordingly
-
elementCount
Return size of value array associated with process variable- Returns:
- number of values in process variable
- Throws:
ConnectionException- accordingly
-
readAccess
Determine if channel has read access to process variable- Returns:
- true if channel has read access
- Throws:
ConnectionException- channel not connected
-
writeAccess
Determine if channel has write access to process variable- Returns:
- true if channel has write access
- Throws:
ConnectionException- channel not connected
-
getUnits
Convenience method which returns the units for this channel.- Returns:
- the units
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getOperationLimitPVs
Get the lower and upper operation limit PVs- Returns:
- two element array of PVs with the lower and upper limit PVs
-
getWarningLimitPVs
Get the lower and upper warning limit PVs- Returns:
- two element array of PVs with the lower and upper limit PVs
-
getAlarmLimitPVs
Get the lower and upper alarm limit PVs- Returns:
- two element array of PVs with the lower and upper limit PVs
-
getDriveLimitPVs
Get the lower and upper drive limit PVs- Returns:
- two element array of PVs with the lower and upper limit PVs
-
rawUpperDisplayLimit
Convenience method which returns the upper display limit.- Returns:
- the raw upper display limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawLowerDisplayLimit
Convenience method which returns the lower display limit.- Returns:
- the raw lower display limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawUpperAlarmLimit
Convenience method which returns the upper alarm limit.- Returns:
- the raw upper alarm limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawLowerAlarmLimit
Convenience method which returns the lower alarm limit.- Returns:
- the raw lower alarm limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawUpperWarningLimit
Convenience method which returns the upper warning limit.- Returns:
- the raw upper warning limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawLowerWarningLimit
Convenience method which returns the lower warning limit.- Returns:
- the raw lower warning limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawUpperControlLimit
Convenience method which returns the upper control limit.- Returns:
- the raw upper control limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
rawLowerControlLimit
Convenience method which returns the lower control limit.- Returns:
- the raw lower control limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
upperDisplayLimit
Convenience method which returns the upper display limit.- Returns:
- the upper display limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
lowerDisplayLimit
Convenience method which returns the lower display limit.- Returns:
- the lower display limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
upperAlarmLimit
Convenience method which returns the upper alarm limit.- Returns:
- the upper alarm limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
lowerAlarmLimit
Convenience method which returns the lower alarm limit.- Returns:
- the lower alarm limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
upperWarningLimit
Convenience method which returns the upper warning limit.- Returns:
- the upper warning limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
lowerWarningLimit
Convenience method which returns the lower warning limit.- Returns:
- the lower warning limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
upperControlLimit
Convenience method which returns the upper control limit.- Returns:
- upper control limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
lowerControlLimit
Convenience method which returns the lower control limit.- Returns:
- the lower control limit
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getValByte
Get channel value- Returns:
- value of the PV
- Throws:
ConnectionException- channel not connectedGetException- general channel access PV get failure
-
getValEnum
- Throws:
GetException
-
getValShort
- Throws:
GetException
-
getValInt
- Throws:
GetException
-
getValLong
- Throws:
GetException
-
getValFlt
- Throws:
GetException
-
getValDbl
- Throws:
GetException
-
getValString
- Throws:
GetException
-
getArrByte
Get channel value as array- Returns:
- value array of the PV
- Throws:
ConnectionException- channel not connectedGetException- general channel access PV get failure
-
getArrInt
- Throws:
GetException
-
getArrLong
- Throws:
GetException
-
getArrShort
- Throws:
GetException
-
getArrFlt
- Throws:
GetException
-
getArrDbl
- Throws:
GetException
-
getArrString
- Throws:
GetException
-
getArrayValue
Fetch the data value for the channel and return it as an ArrayValue.- Returns:
- channel's array value
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawValueRecord
Return a rawChannelRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV.- Returns:
- raw channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawStringValueRecord
Get aChannelRecordrepresenting the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawStringStatusRecord
Get aChannelStatusRecordrepresenting the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawStringTimeRecord
Get aChannelTimeRecordrepresenting the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawStatusRecord
Return a rawChannelStatusRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV along with status.- Returns:
- raw channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawTimeRecord
Return a rawChannelTimeRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV along with status and timestamp.- Returns:
- raw channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getValueRecord
Return aChannelRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getStringValueRecord
Get aChannelRecordrepresenting the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getStringStatusRecord
Get aChannelStatusRecordrepresenting the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getStringTimeRecord
Get aChannelTimeRecordrepresenting the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getStatusRecord
Return aChannelStatusRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV along with status.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getTimeRecord
Return aChannelTimeRecordrepresenting the fetched record for the native type of this channel. This is a convenient way to get the value of the PV along with status and timestamp.- Returns:
- channel record
- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawValueCallback
Handle a callback for getting the raw value for the channel.- Parameters:
listener- The receiver of the callback.- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawValueCallback
protected abstract void getRawValueCallback(IEventSinkValue listener, boolean attemptConnection) throws GetException Handle a callback for getting the raw value for the channel.- Parameters:
listener- The receiver of the callback.attemptConnection- indicates whether or not to attempt a blocking connection if this channel is not connected- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getRawValueTimeCallback
public abstract void getRawValueTimeCallback(IEventSinkValTime listener, boolean attemptConnection) throws GetException Submit a non-blocking Get request with callback- Parameters:
listener- to receive callback upon completionattemptConnection- true to attempt connection and false not to attempt connection- Throws:
ConnectionException- accordinglyGetException- accordingly
-
getValueCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValueCallback
public final void getValueCallback(IEventSinkValue listener, boolean attemptConnection) throws GetException Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.attemptConnection- indicates whether or not to attempt a blocking connection if this channel is not connected- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValueTimeCallback
public final void getValueTimeCallback(IEventSinkValTime listener, boolean attemptConnection) throws GetException Get the value time record of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.attemptConnection- indicates whether or not to attempt a blocking connection if this channel is not connected- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValByteCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValIntCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValFltCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getValDblCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getArrByteCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getArrIntCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getArrFltCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
getArrDblCallback
Get the value of the process variable via a callback to the specified listener.- Parameters:
listener- receiver of the callback event.- Throws:
ConnectionException- channel is not connectedGetException- general channel access failure
-
addMonitorValTime
public abstract Monitor addMonitorValTime(IEventSinkValTime listener, int intMaskFire) throws MonitorException Setup a value-status-timestamp monitor on this channel- Parameters:
listener- interface to data sinkintMaskFire- code specifying when the monitor is fired or'ed combination of {Monitor.VALUE, Monitor.LOG, Monitor.ALARM}- Returns:
- A new monitor
- Throws:
ConnectionException- channel is not connectedMonitorException- general monitor failure
-
addMonitorValStatus
public abstract Monitor addMonitorValStatus(IEventSinkValStatus listener, int intMaskFire) throws MonitorException Setup a value-status monitor on this channel- Parameters:
listener- interface to data sinkintMaskFire- code specifying when the monitor is fired or'ed combination of {Monitor.VALUE, Monitor.LOG, Monitor.ALARM}- Returns:
- A new monitor
- Throws:
ConnectionException- channel is not connectedMonitorException- general monitor failure
-
addMonitorValue
public abstract Monitor addMonitorValue(IEventSinkValue listener, int intMaskFire) throws MonitorException Setup a value monitor on this channel- Parameters:
listener- interface to data sinkintMaskFire- code specifying when the monitor is fired or'ed combination of {Monitor.VALUE, Monitor.LOG, Monitor.ALARM}- Returns:
- A new monitor
- Throws:
ConnectionException- channel is not connectedMonitorException- general monitor failure
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putVal
Synchronously put a value to the channel process variable.- Parameters:
newVal- value sent to process variable- Throws:
ConnectionException- channel is not connectedPutException- channel access failure, including
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putValCallback
Asynchronously put a value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-
putRawValCallback
Asynchronously put a raw value to the channel process variable. Fire the specified callback when put is complete.- Parameters:
newVal- value sent to process variablelistener- The receiver of the callback event- Throws:
ConnectionException- channel is not connectedPutException- general put failure
-