1.0 Overview

This document describes changes included within:

Note SysConf is used by TPS, Targetter, WinUtil, PLI and PTE.
TPS is used by Targetter, WinUtil, 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

1.1.1 System Configuration - None.

1.1.2 TYX Programming Support - None.

1.1.3 ATLAS Program Retargetter - None.

1.1.4 TYX Windows Utilities - None.

1.1.5 PAWS LAPS Interpreter - None.

1.1.6 PAWS Test Executive - Major.

PTE allowed to default Boolean Operator Input to TRUE.
CEM Error Message Buffer Size increased.
CEM-to-RTS Decimal Values edited to remove trailing zeros.
CEM Model changed from Model 1 to Model 2 for:
CEM-to-RTS Text Data Values delimited by DEL Character.
RTS-to-CEM Information Messages:
Device Addresses Information Message.
ATLAS Statement Information Message.

1.2 Problem Reports.- None.

2.0 Detailed Description

2.1 Enhancements

2.1.1 System Configuration - None.

2.1.2 TYX Programming Support - None.

2.1.3 Targetter - None.

2.1.4 TYX Windows Utilities - None.

2.1.5 PAWS LAPS Interpreter - None.

2.1.6 PAWS Test Executive - Major.

2.1.6.1 PTE allowed to default Boolean Operator Input to TRUE.

Prior to this Release, when an ATLAS Test Program requested Boolean Input from the Operator, the Operator was required to enter a valid Boolean Value (e.g., "true", "false", "t", "f", etal.) before clicking "OK".

With this Release, PTE supports a new Miscellaneous Flag called "Default Boolean Operator Input to TRUE". When this Flag is set AND the ATLAS Test Program requests Boolean Input from the Operator AND the Operator clicks "OK" without entering any Data, PTE returns a TRUE Boolean Response to the ATLAS Test Program.

This Flag is set by specifying the following Arguments to PTE when PTE is activated:

where:
-x requests PTE to set its 32-Bit Miscellaneous Flags Variable to the value specified by the next Argument.

0100000 is an Octal String specifying the "Default Boolean Operator Input to True" Miscellaneous Flag Bit. (PTE Users already specifying the -x Argument must Inclusive-OR the 0100000 Octal Value into the User's existing Octal String.)

2.1.6.2 CEM Error Message Buffer Size increased.

Prior to this Release, the CEM Error Message Buffer limited Error Messages to 40 Characters. Additionally, the CEM Kernel did not check for overflow when copying an Error Message into the Buffer.

With this Release, the CEM Error Message Buffer limits Error Messages to 79 Characters. Additionally, the CEM Kernel copies only the first 79 Characters of an Error Message into the Buffer.

2.1.6.3 CEM-to-RTS Decimal Values edited to remove trailing zeros.

Prior to this Release, CEM-to-RTS Messages containing Decimal Data Values with trailing zeros were formatted as (for example) "12.340000000".

With this Release, CEM-to-RTS Messages containing Decimal Data Values with trailing zeros are formatted as (for example) "12.34".

2.1.6.4 CEM Model changed from Model 1 to Model 2.

2.1.6.5 CEM Model 2 - CEM-to-RTS Text Data Values delimited by DEL Character.

Prior to this Release, CEM-to-RTS Messages (responding to RTS-to-CEM Fetch Requests) containing Text Data Values used ASCII Space (SP) Characters as Value Delimiters. To allow the Value itself to contain SP's, PTE read all Characters up to the LF. This design worked correctly only when a single Text Data Value was requested.

With this Release, CEM-to-RTS Messages containing Text Data Values use ASCII Delete (DEL) Characters as Value Delimiters.

Note DEL's are currently (and were previously) used to delimit Text Data Values in RTS-to-CEM Messages.

2.1.6.6 CEM Model 2 - RTS-to-CEM Information Messages.

Prior to this Release, there was no defined general purpose syntax for RTS-to-CEM Messages that could be used to transfer information from the RTS to the CEM Kernel in a backwards-compatible manner.

With this Release, the syntax of an RTS-to-CEM Miscellaneous Information Message is defined as follows:

where:
MI is a literal that identifies a Miscellaneous Information Message.

KeyWord represents a string that identifies the type of information.

: (colon) is a literal and separates KeyWord and Label.

Label represents a string that identifies the type of data.

= (equal sign) is a literal that separates Label and Data.

Data represents a string that defines the data value.

{ and } (braces) are not physically within the Message; they are only used for grouping within the syntax definition.

... (ellipsis) is not physically within the Message; it is used to indicate "one or more times" within the syntax definition.

If the CEM Kernel receives an MI Message that contains an unrecognizable KeyWord (as would happen if the RTS was a later version than the CEM Module), the CEM Kernel will quietly ignore the Message.

2.1.6.7 CEM Model 2 - RTS-to-CEM Device Addresses Information Message.

Syntax MI { KeyWord:DeviceName:DeviceAddress } ...

where:
KeyWord is MTA, MLA or MSA.

DeviceName is the name of the Device as it appears in the Bus Configuration File.

DeviceAddress is the address of the Device as it appears in the Bus Configuration File.

This Message is sent to the CEM Kernel immediately after the CEM Kernel has responded to the RTS request for the CEM Module Version String. The CEM Kernel transfers the information to all appropriate entries in the DevDat[] Table. The CEM Module thus has all Device Addresses whenever an INTERFACECLEAR Non-ATLAS Action occurs and whenever a RESET ATLAS Action occurs, regardless of whether or not a particular Device / Channel has been addressed to talk or listen.

Note Controller Addresses are not yet available. This limitation is expected to be addressed in the not too distant future.

2.1.6.8 CEM Model 2 - RTS-to-CEM ATLAS Statement Information Message.

Syntax MI { STM:Label=Data } ...

where Label and Data are one of the following for the ATLAS Statement:

Label is MN and Data is the ATLAS Module Name.

Label is LN and Data is the Line Number.

Label is SN and Data is the Statement Number.

Label is VB and Data is the ATLAS Verb.

This Message is sent every time the RTS interprets a DEV AIL.

Note This information is not currently available to the CEM Drivers. This limitation is expected to be removed in the next RTS Release.

2.2 Problem Reports - None.