1.0 Overview

This document describes changes included within:

Note SysConf is used by TPS, PORF, Targetter, WinUtil, PLI and PTE.

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

WinUtil is 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

1.1.1 System Configuration – None.

1.1.2 TYX Programming Support - None.

1.1.3 PAWS Output Report Formatter - None.

1.1.4 ATLAS Program Targetter - None.

1.1.5 TYX Windows Utilities - None.

1.1.6 PAWS LAPS Interpreter - None.

1.1.7 PAWS Test Executive - Major.

RTS-to-CEM Statement Information Message:

Current Noun and Measured Characteristic.

CEM Group Modifiers.

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 PAWS Output Report Formatter - None.

2.1.4 ATLAS Program Targetter - None.

2.1.5 TYX Windows Utilities - None.

2.1.6 PAWS LAPS Interpreter - None.

2.1.7 PAWS Test Executive - Major.

2.1.7.1 RTS-to-CEM Statement Information Message.

Prior to this release, the RTS-to-CEM Statement Information Message did not contain the Current Noun and Measured Characteristic. The CEM Kernel acquired the Current Noun and Measured Characteristic from the RTS-to-CEM FNC Message and retained it for subsequent use by a CEM Device Driver. However, RTS-to-CEM FNC Messages are not generated for several Single Action ATLAS Statements (e.g., CONNECT, REMOVE, etc.), which resulted, under certain conditions, in an incorrect Current Noun and/or Measured Characteristic being returned to the CEM Device Driver.

With this release, the RTS-to-CEM Statement Information Message contains the Current Noun and Measured Characteristic.

2.1.7.2 CEM Group Modifiers.

Note Although CEM Group Modifier capability is and will be available to all CEM Device Drivers, Group Modifiers themselves are "defined" by a particular ATLAS Compiler and are peculiar to a specific ATLAS Subset / Station. Therefore, this section provides only a very general description of the CEM Group Modifier capability. For those Customers whose ATLAS Compiler "defines" Group Modifiers, a full description will be provided in a separate document. For all other Customers, this section contains no relevant information for CEM Device Drivers.

Prior to this release, the CEM Kernel did not support Group Modifiers.

With this release, the CEM Kernel supports Group Modifiers. This capability has been provided to allow ATLAS Compilers and CEM Device Drivers to more easily deal with ATLAS Statements that contain multiple references to the same Modifier within a single ATLAS Statement.

A Group Modifier is a Modifier that has one or more lists of other Modifiers attached to it. These lists are called Group Modifier Lists. In addition, Group Modifiers may be nested (i.e., a Group Modifier List may itself contain one or more Group Modifiers). As currently implemented:

• There is no limit on the number of Group Modifier Lists that a Group Modifier may have.

• The maximum level of Group Modifier nesting is three.

To support Group Modifiers:

• Modifier Data Structure MODDAT has been expanded to hold Group Modifier information.

• New CEM Macro Group (Group Modifiers) containing eight Group Modifier CEM Macros has been added to allow CEM Device Drivers to access Group Modifier data. Refer to Section 3.0 for a full description of these new CEM Macros.

• CEM User Stub Functions have been enhanced to print Group Modifier information.

2.2 Problem Reports - None.

3.0 CEM Help

Name: SetGroupModsON

Type: Group Modifiers

Result Current Group Modifier = M_XXXX

• M_XXXX not valid.
• No Current Device / Channel.
• Group Modifiers capability not available.
• No Group Modifiers defined.

• Group #1 at Group Level 1 for Modifier M_XXXX not found.

Usage: int nStatus;

Description: This Macro advances Group Modifiers processing to the next Group Level for Group #1 of Group Modifier M_XXXX. If the operation is successfully completed (and until otherwise directed), all GetDatum() requests will search for Datums in the first Group Modifier List of Group Modifier M_XXXX at the new Group Level.

Result Current Group Modifier = M_XXXX

• M_XXXX not valid.
• No Current Device / Channel.
• Group Modifiers capability not available.

• Group Modifiers processing not enabled.
• Group #1 at next Group Level for Modifier M_XXXX not found.

Usage: int nStatus;

Usage: int nStatus;

Usage: int nStatus;

Note that, if Macro SetGroupModsON() returned a Good Status, so will this Macro. As currently implemented, there is no need to check nStatus.

Usage: int nModCode;

Description: This Macro returns the Modifier Code (M_XXXX) of the Current Group Modifier.

Usage: int nGrpModLevel;

Usage: int nGrpModGroup;