OASIS-CC VERSION V02.05.04 RELEASE NOTES 6/5/92 These release notes describe version V02.05.04 of OASIS-CC. A copy of these notes can be found in ODIST:[release_notes]oasis_v2.0504 or in $ODIST/release_notes/oasis_v2.0504. Information on previous OASIS-CC releases can be obtained from the OASIS project at LASP (electronic mail address oasisa@aquila.colorado.edu on INTERNET or aquila::oasisa on SPAN). Starting with this release, only the TAE+ versions of OASIS-CC are supported. Supported hosts are VAX under VMS and Sun SparcStation under SunOs. 1 Compatibility Information 1.1 SunOS version This release of OASIS-CC has been tested under the following conditions: SparcStation IPC SunOs 4.1.1 X X11R4 with fixes 1 to 18 MOTIF 1.1 TAE+ 5.1 The Ada distributions require Sun Ada 1.0 Note that this release of OASIS-CC is not compatible with SOLARIS 2.0 (aka SunOS 5.0) and X11R5. 1.2 VMS version This release of OASIS-CC has been tested under the following conditions: VaxStation 3100 VMS 5.4-1 (5.5 tests are in progress) TAE+ 5.1 X as supplied with DECW$MOTIF MOTIF as supplied with DECW$MOTIF DECW$MOTIF 1.0 2 Installation Procedure 2.1 SunOs version Refer to the OASIS-CC Unix Version Installation Guide. There is a new version of this document that describes the installation of the "Ada Extendable Object Distribution." 2.2 VMS version Refer to the OASIS-CC VMS Version Installation Guide. There is an addendum document that corrects some errors and omissions in the installation guide and in the OASIS-CC VMS version Application Developer Guide document. 3 Setup Changes For V02.05.03 And V02.05.04a Applications There are changes in the OASIS-CC V02.05.04 code that makes this release incompatible with applications running versions V02.05.03 or V02.05.04a (alpha release of V02.05.04). The changes are: (1) A new field has been added to the display_descriptions table (see paragraph 4.1 below); (2) In the Unix version, two database filenames (procedures.dat and user_privileges.dat) were incorrectly spelled; and (3) The format of the macro resource files (i.e., the xxx_m.res files) has been changed to prevent problems when using the res2rfg and rfg2res programs. The distribution tape contains a command procedure (v020503to04.csh for the SunOs version or v020503to04.com for the VMS version) that can be executed to make a v02.05.03 or a v02.05.04a application compatible with this release. 3.1 SunOs version The conversion is done by executing the following steps: (1) log in the application account (2) set up all the environment variables (3) execute the command procedure by typing: $ODIST/bin/v020503to04.csh 3.2 VMS version The conversion in done by executing the following steps: (1) log in the application account (2) set up all the logical variables (3) execute the command procedure by typing: @ODIST:[bin]v020503to04.com 4 New Features Or Code Fixes The following new features and major code fixes are included in this release. New features and code fixes have associated Test Report Numbers (TRNs) or Change Request Numbers (CRNs) that provide a means of tracking changes to the OASIS-CC code. TRNs are generated by LASP during internal software and functional testing, CRNs are generated by LASP and the general OASIS-CC user community. The pertinent TRNs and CRNs are shown for each enhancement or correction included in this new version of OASIS-CC. 4.1 OASIS-CC Page Name To TAE+ Panel Name Translation (TRN 44) TAE+ panel names are constrained to 8 characters which can limit the readability of Cstol statements that reference the panel (DISPLAY, CLEAR and SNAP). This release provides a mechanism to associate a 16 character name with a TAE+ panel during an OASIS-CC run. The new field TAE_PANEL_NAME in DISPLAY_DESCRIPTIONS provides this translation: TAE_PANEL_NAME Stores the actual TAE+ panel name as specifed in the AWB. When a display is called in the Cstol 'DISPLAY page', 'CLEAR page', or 'SNAP page' directives, OASIS-CC looks for a DISPLAY_DESCRIPTIONS record where PAGE_NAME is 'page' and PAGE_KIND is FOR_DISPLAY. If a record exists, the actual TAE+ panel is named by TAE_PANEL_NAME. Otherwise, the TAE+ panel is named by the 'page' in the calling Cstol directive. TAE_PANEL_NAME is only applicable when PAGE_KIND is FOR_DISPLAY. When PAGE_KIND is FOR_DISPLAY, all other fields in the record (except for PAGE_NAME) are ignored. NON KEY Protection Class: DB_MANAGER Data_Type: TAE_PANEL_NAME_TYPE (i.e. STRING(1..8)) Default_Value It is recommended that all TAE+ panels created in the AWB have a DISPLAY_DESCRIPTIONS record so that their names can be accessed by the Cstol Query language (REPORT, UPDATE etc.) 4.2 Delta Limit Checking Improvement (TRN 20 and TRN 26) In previous releases, only changes in the delta limit status were reported. Starting with this release, delta red limit warnings are always reported even if the delta limit status of the measurement is already red. The following describes how delta limits are now reported. It assumes a delta limit of 0.0. previous V02.05.04 releases value at time t1 10.0 value at t2 10.10 red high red high value at t3 10.15 no report red high value at t4 10.15 green green value at t5 10.10 red low red low value at t6 10.00 no report red low value at t7 10.00 green green 4.3 Snap capability This capability was included in all v02.05.04a versions. The SNAP Cstol statement can be used to snap any TAE+ panel. It creates a resource file (placed in OASIS_SNAP) that can be reviewed using AWB. The filename that contains the "snapped" panel is in the form of: fyy_mm_dd_hh_mm.. 4.4 Query On Large Database (TRN 34. Mostly a SunOs version) In previous releases, OASIS-CC would crash during the execution of a query to a large database table (4000 records or so). This is now fixed. 4.5 Re-Compilation Slows OASIS-CC (TRN 33. SunOs version only) In previous releases, after large compilations or multiple compile/decompile/compile sequences OASIS-CC would slow considerably. This is now fixed. 4.6 TAE "NOTED" Panel Hangs OASIS-CC Output (TRN 39) This change was included in all v02.05.04a versions distributed after 01/21/92. Whenever a TAE "NOTED" panel came up (either after pressing a help button, or after entering a bad value), the output to all other panels was hung (i.e., no panel was updated) until the user clicked on the "NOTED" panel. Starting with this release, an error message is simply output in the event message window. 4.7 New Database Report Code (CRN 194) This change was included in all v02.05.04a versions. The code used to report the contents of the database tables has been modified. The main reason for the modification is to be able to re-use the memory allocated when a query is executed. From the user's point of view the only change is that he/she is no longer asked how many records out of the retrieved records he/she wants to see. He/she is now asked if he/she wants to see all the retrieved records. He/she can cancel the report request. This allows the user to re-enter his/her query with narrower search criteria. 4.8 Bit Reversal In ASCII Command (CRN 199. SunOs version only) This change was included in all v02.05.04a versions. In previous SunOs releases, ASCII commands were incorrectly generated (msb and lsb were swapped in each character). 4.9 OASIS Can Be Either A Client Or A Server Node (CRN 198. SunOs version only) This change was included in all v02.05.04a versions. In previous SunOs releases, OASIS-CC could only be a server node when using the IP protocol. Starting with this release, it can be either a server or a client node. This allows multiple OASIS-CCs to communicate using stream sockets. 5 Change Requests Or Test Reports Closed With This Release Change Requests Number: 168 (SunOs only), 190, 191, 194, 198, 199, 201 and 203 (SunOs only). Test Reports Number: 1, 2, 6, 7, 8, 11, 12, 13, 17, 18, 20, 21, 23, 24, 26, 29, 30, 32, 33, 34, 35, 37, 39, 40, 42, 43 (partially), 44, 45 and 46. 6 Principal Known Problems And Limitations 6.1 Decomposition Shortcomings (TRN 25) The current decomposition code presents several shortcomings, mainly when dealing with measurements that are not on byte-boundary and are spanning bytes. 6.2 Problem Inserting Records In Commands Database Table (SunOs version) Because of a problem with the Sun Ada pre-linker, inserting a record in the commands table from the CSTOL prompt or from a CSTOL procedure without specifying all the field values gives incorrect results. 6.3 Filename Length Limitation In OASIS-CC filenames can be up to 60 characters long. In the SunOs version, the length of the pathname (not the length of the environment variable that translates into the pathname) is included in the filename length. Therefore, the 60 characters limit can be easily reached. In the VMS version, the length of the logical name, not of its translation, is included in the filename length. 7 Anomaly or Enhancement Request Reporting The mechanism previously used with the VMS version since 1988 to report OASIS-CC anomalies or to suggest enhancements to the OASIS-CC functionality has been extended to the SunOs version. The report generated using this mechanism can be sent to the OASIS project office by electronic mail (the preferred way) or by regular mail. Each report is assigned a Change Request Number (CRN) and is acknowledged to the originator. The CRN can be used to track progress on the report. 7.1 SunOs version To report an anomaly enter: $ODIST/bin/report.sh 7.2 VMS version To report an anomaly enter: @ODIST:[bin]report.com