CEM User
Release Notes
Release 20020701
Version 3.9.25
Purpose
The purpose of this document is to provide information pertaining to the release of the CEM Kernel and user interface. This document is divided into three sections:
Enhancements Describes changes that enhance the capability of the CEM Kernel.
Problem Reports Describes changes that correct errors reported in problem reports.
CEM Help Describes changes made to the user interface that will eventually be added to the CEM On-Line Help.
Enhancements
CEM Kernel - New Current State Macro IsOkCurDevAddr()
Prior to this release, CEM Users were unable to determine if the CEM Kernel had received Address Information from the RTS for the Current Device.
With this release, CEM Users can determine if the CEM Kernel has received Address Information from the RTS for the Current Device. See the CEM Help Section below for a full description of this Macro.
CEM Kernel - New Current State Macro SetCurDev()
Prior to this release, CEM Users were restricted to accessing only the Current Device/Channel set by the CEM Kernel. This restriction made it impossible for CEM Modules to perform specialized device-dependent processing using only those interfaces provided within the TYX-supplied CEM Library and Header Files.
With this release, CEM Users can set the Current Device/Channel. See the CEM Help Section below for a full description of this Macro.
Problem Reports
None.
CEM Help
The purpose of this Section is to describe changes made to the CEM User Interface that will eventually be added to the CEM On-Line Help.
Update to Current State CEM Macro Group
IsOkCurDevAddr()
SetCurDev()
Name: IsOkCurDevAddr
Type: Current State
Usage: if( IsOkCurDevAddr() )
{ /* Address Information available for Current Device */
}
else
{ /* No Address Information for Current Device */
}
Description: This Macro returns: YES/TRUE (currently plus one (1)) if the CEM Kernel has received Address Information for the Current Device from the RTS; or NO/FALSE (currently zero (0)) if the CEM Kernel has not received Address Information for the Current Device from the RTS.
Note The RTS sends Address Information for only those Devices that are used by the currently-loaded ATLAS Program and by the CEM Module. Therefore, a CEM Module could use this Macro to determine, for example, if the Current Device required initialization, testing, etc. prior to starting execution of the currently-loaded ATLAS Program.
See Also: CEM Macro SetCurDev().
Name: SetCurDev
Type: Current State
Usage: char * pcDevChan;
int nStatus;
pcDevChan = "acps:CH0"; /* For Example */
nStatus = SetCurDev( pcDevChan );
Description: This Macro requests the CEM Kernel to set the Current Device/Channel to the Device/Channel specified by the Device/Channel Name String pointed to by the Character Pointer pcDevChan.
When the action in which this macro is invoked, either directly or indirectly, returns then the CurrentDevice/Channel is restored to what it was when the users action function was invoked.
A Device/Channel Name String has the form:
DeviceName:CHChannelNumber
where: DeviceName is the Device Name;
:CH is a literal; and
ChannelNumber is the Channel Number.
If pcDevChan is a Null Character Pointer, the CEM Kernel will restore the Current Device/Channel to what it was when the current User’s action Function was invoked.
Returns: Integer == OSRSOK = Current Device/Channel set as requested.
== OSRSERR = Error detected.
See Also: CEM Macro IsOkCurDevAddr().
|
