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 ChannelSystem
protected boolean
hold connection statusprotected ConnectionListener
Notify listeners when connection is made or droppedprotected double
pend event timeoutprotected double
pend IO timeoutprotected static MessageCenter
One MessageCenter for all Channel eventsprotected String
channel name -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
addConnectionListener
(ConnectionListener listener) Add a listener of connection changesabstract Monitor
addMonitorValStatus
(IEventSinkValStatus listener, int intMaskFire) Setup a value-status monitor on this channelabstract Monitor
addMonitorValTime
(IEventSinkValTime listener, int intMaskFire) Setup a value-status-timestamp monitor on this channelabstract Monitor
addMonitorValue
(IEventSinkValue listener, int intMaskFire) Setup a value monitor on this channelReturns EPICS channel name for process variablevoid
Checks for process variable channel connection and throws a ConnectionException if absent.protected void
checkConnection
(String methodName) Checks for process variable channel connection and throws a ConnectionException if absent after attempting a connection if necessary.protected void
checkConnection
(String methodName, boolean attemptConnection) Checks for process variable channel connection and throws a ConnectionException if absent.boolean
Connect and wait the default timeout.abstract boolean
connectAndWait
(double timeout) Request a new connection and wait for it no longer than the timeout.abstract void
Terminate the network channel connection and clear all events associated with process variableabstract int
Return size of value array associated with process variableabstract Class<?>
get the Java class associated with the native type of this channelstatic void
flushIO()
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 void
getArrByteCallback
(IEventSinkArrByte listener) Get the value of the process variable via a callback to the specified listener.double[]
final void
getArrDblCallback
(IEventSinkArrDbl listener) Get the value of the process variable via a callback to the specified listener.float[]
final void
getArrFltCallback
(IEventSinkArrFlt listener) Get the value of the process variable via a callback to the specified listener.int[]
final void
getArrIntCallback
(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 PVsdouble
Get 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 Channel
getInstance
(String signalName) From the default channel factory, get a channel for the specified signal name.static Channel
getInstance
(String signalName, ValueTransform transform) From the default channel factory, get a channel for the specified signal name and value transform.double
Get the channel access Pend IO timeoutabstract String[]
Get the lower and upper operation limit PVsabstract ChannelStatusRecord
Return a rawChannelStatusRecord
representing the fetched record for the native type of this channel.protected abstract ChannelStatusRecord
Get aChannelStatusRecord
representing the fetched record for the specified type.protected abstract ChannelTimeRecord
Get aChannelTimeRecord
representing the fetched record for the specified type.protected abstract ChannelRecord
Get aChannelRecord
representing the fetched record for the specified type.abstract ChannelTimeRecord
Return a rawChannelTimeRecord
representing the fetched record for the native type of this channel.protected abstract void
getRawValueCallback
(IEventSinkValue listener) Handle a callback for getting the raw value for the channel.protected abstract void
getRawValueCallback
(IEventSinkValue listener, boolean attemptConnection) Handle a callback for getting the raw value for the channel.abstract ChannelRecord
Return a rawChannelRecord
representing the fetched record for the native type of this channel.abstract void
getRawValueTimeCallback
(IEventSinkValTime listener, boolean attemptConnection) Submit a non-blocking Get request with callbackfinal ChannelStatusRecord
Return aChannelStatusRecord
representing the fetched record for the native type of this channel.final ChannelRecord
Get aChannelStatusRecord
representing the fetched record for the native type of this channel.final ChannelRecord
Get aChannelTimeRecord
representing the fetched record for the native type of this channel.final ChannelRecord
Get aChannelRecord
representing the fetched record for the native type of this channel.final ChannelTimeRecord
Return aChannelTimeRecord
representing the fetched record for the native type of this channel.abstract String
getUnits()
Convenience method which returns the units for this channel.byte
Get channel valuefinal void
getValByteCallback
(IEventSinkValByte listener) Get the value of the process variable via a callback to the specified listener.double
final void
getValDblCallback
(IEventSinkValDbl listener) Get the value of the process variable via a callback to the specified listener.int
float
final void
getValFltCallback
(IEventSinkValFlt listener) Get the value of the process variable via a callback to the specified listener.int
final void
getValIntCallback
(IEventSinkValInt listener) Get the value of the process variable via a callback to the specified listener.long
short
final void
getValueCallback
(IEventSinkValue listener) Get the value of the process variable via a callback to the specified listener.final void
getValueCallback
(IEventSinkValue listener, boolean attemptConnection) Get the value of the process variable via a callback to the specified listener.final ChannelRecord
Return aChannelRecord
representing the fetched record for the native type of this channel.final void
getValueTimeCallback
(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 PVsboolean
Checks if channel is connected to process variableboolean
isValid()
determine whether this channel is validfinal Number
Convenience method which returns the lower alarm limit.final Number
Convenience method which returns the lower control limit.final Number
Convenience method which returns the lower display limit.final Number
Convenience method which returns the lower warning limit.static void
pendEvent
(double timeout) Flush the EPICS Channel Access request buffer and wait for asynchronous event.static boolean
pendIO
(double timeout) Flush the EPICS Channel Access request buffer and return as soon as complete or timeout has expired.abstract void
putRawValCallback
(byte[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(byte newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(double[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(double newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(float[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(float newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(int[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(int newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(long[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(long newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(short[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(short newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(String[] newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.abstract void
putRawValCallback
(String newVal, PutListener listener) Asynchronously put a raw value to the channel process variable.void
putVal
(byte newVal) Synchronously put a value to the channel process variable.void
putVal
(byte[] newVal) Synchronously put a value to the channel process variable.void
putVal
(double newVal) Synchronously put a value to the channel process variable.void
putVal
(double[] newVal) Synchronously put a value to the channel process variable.void
putVal
(float newVal) Synchronously put a value to the channel process variable.void
putVal
(float[] newVal) Synchronously put a value to the channel process variable.void
putVal
(int newVal) Synchronously put a value to the channel process variable.void
putVal
(int[] newVal) Synchronously put a value to the channel process variable.void
putVal
(long newVal) Synchronously put a value to the channel process variable.void
putVal
(long[] newVal) Synchronously put a value to the channel process variable.void
putVal
(short newVal) Synchronously put a value to the channel process variable.void
putVal
(short[] newVal) Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.void
Synchronously put a value to the channel process variable.final void
putValCallback
(byte[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(byte newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(double[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(double newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(float[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(float newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(int[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(int newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(long[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(long newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(short[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(short newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(Object newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(String[] newVal, PutListener listener) Asynchronously put a value to the channel process variable.final void
putValCallback
(String newVal, PutListener listener) Asynchronously put a value to the channel process variable.abstract Number
Convenience method which returns the lower alarm limit.abstract Number
Convenience method which returns the lower control limit.abstract Number
Convenience method which returns the lower display limit.abstract Number
Convenience method which returns the lower warning limit.abstract Number
Convenience method which returns the upper alarm limit.abstract Number
Convenience method which returns the upper control limit.abstract Number
Convenience method which returns the upper display limit.abstract Number
Convenience method which returns the upper warning limit.abstract boolean
Determine if channel has read access to process variablevoid
removeConnectionListener
(ConnectionListener listener) Remove a listener of connection changesabstract void
Request that the channel be connected.void
setChannelName
(String strNameChan) Set the EPICS channel name for the connectionstatic void
setDebugMode
(boolean bDebug) void
setEventTimeout
(double dblTm) Set the channel access Pend Event timeoutvoid
setIoTimeout
(double dblTm) Set the channel access Pend IO timeoutvoid
setValid
(boolean valid) set whether this channel is validfinal Number
Convenience method which returns the upper alarm limit.final Number
Convenience method which returns the upper control limit.final Number
Convenience method which returns the upper display limit.final Number
Convenience method which returns the upper warning limit.abstract boolean
Determine 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 rawChannelRecord
representing 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 aChannelRecord
representing the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getRawStringStatusRecord
Get aChannelStatusRecord
representing the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getRawStringTimeRecord
Get aChannelTimeRecord
representing the fetched record for the specified type.- Returns:
- the channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getRawStatusRecord
Return a rawChannelStatusRecord
representing 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 rawChannelTimeRecord
representing 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 aChannelRecord
representing 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 aChannelRecord
representing the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getStringStatusRecord
Get aChannelStatusRecord
representing the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getStringTimeRecord
Get aChannelTimeRecord
representing the fetched record for the native type of this channel.- Returns:
- channel record
- Throws:
ConnectionException
- accordinglyGetException
- accordingly
-
getStatusRecord
Return aChannelStatusRecord
representing 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 aChannelTimeRecord
representing 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
-