1.0 Overview

This document describes changes included within:

Note: SysConf is used by TPS, PORF, Targetter, XUtil, WinUtil, PLI, PTE and CEM

TPS is used by PORF, Targetter, XUtil, WinUtil, PLI, PTE and CEM.

XUtil and WinUtil are used by PLI and PTE.

PTE means both the Run-Time System (RTS) and the Simulator (SIM).

PTE, RTS, CEM and SIM mean all Platforms.

UPTE, URTS, UCEM and USIM mean UNIX Platforms only.

WPTE, WRTS, WCEM and WSIM mean MS-Windows Platforms only.

XPTE, XRTS and XSIM mean X-Window Platforms only.

This version of the RTS is compatible with CEM Modules built with CEM Files distributed with RTS Version 19980714 3.9.7 and later. You may install this version of the RTS without rebuilding your CEM Module. However, in order to make use of the new CEM capabilities, you MUST install this version of the RTS, and then you MUST recompile and relink your CEM Module(s) with the TYX-supplied CEM Files distributed with this version of the RTS.

As time goes on, RTS/CEM testing to provide error-free backwards-compatibility becomes increasingly difficult. Therefore, TYX Corporation very strongly recommends that CEM Users recompile and relink their CEM Modules after installing a new version of the RTS.

1.1 Enhancements

Prior to this release, the "Re-Origin the Scan Buffer on J" Machine Language Function (ml2.c/mlreoj()) unconditionally performed its actions using the current position in the Scan Buffer.

With this release, this Function accepts an optional Argument specifying the position in the Scan Buffer to use.

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.

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.

1.2 Problem Reports

PLI - PR 02-061 - Virtual Memory Lock Overflow

Prior to this release, the "Find String In String" Machine Language Function (ml3.c/mlsins()) was failing to release its String Arguments. For Permanent Strings, this resulted in the failure to unlock the Virtual Memory Page containing the String (which at times resulted in an overflow of the Virtual Memory Page Lock Count, followed by a PLI Abnormal Termination). For Temporary Strings, this resulted in the failure of PLI to detect erroneous multiple usage of the Temporary String.

With this release, this problem has been fixed.

1.3 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.

Name: IsOkCurDevAddr

Type: Current State

Usage: if( IsOkCurDevAddr() )

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 As currently implemented (and with no plans to change), 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;

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.

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 called.

Returns: Integer == OSRSOK = Current Device/Channel set as requested.

== OSRSERR = Error detected.

See Also: CEM Macro IsOkCurDevAddr().