Release notes for Sirius Mods V8.1: Difference between revisions
mNo edit summary |
|||
| Line 11: | Line 11: | ||
==Changes to classes and methods== | ==Changes to classes and methods== | ||
= | |||
<h3 class="relno">Daemon class changes</h3> | |||
====New subroutine: ReturnToMaster==== | ====New subroutine: ReturnToMaster==== | ||
<var>[[ReturnToMaster (Daemon_subroutine)|ReturnToMaster]]</var> returns control from a daemon thread to its master thread inside a <var class="product">User Language</var> request. | <var>[[ReturnToMaster (Daemon_subroutine)|ReturnToMaster]]</var> returns control from a daemon thread to its master thread inside a <var class="product">User Language</var> request. | ||
| Line 31: | Line 32: | ||
The <var>[[New (Daemon constructor)|New]]</var> method's optional, named parameter, <var>OpenAll</var> opens in the daemon thread all the files and groups that are open on the master thread. | The <var>[[New (Daemon constructor)|New]]</var> method's optional, named parameter, <var>OpenAll</var> opens in the daemon thread all the files and groups that are open on the master thread. | ||
= | <h3 class="relno">New class: ScreenReadError</h3> | ||
The <var>[[ScreenReadError class|ScreenReadError]]</var> class [[??]] | The <var>[[ScreenReadError class|ScreenReadError]]</var> class [[??]] | ||
= | <h3 class="relno">New exception class: RecordLockingConflict</h3> | ||
The <var>[[RecordLockingConflict class|RecordLockingConflict]]</var> exception class catches record locking conflict errors thrown by methods in the [[File classes|file classes]]. | The <var>[[RecordLockingConflict class|RecordLockingConflict]]</var> exception class catches record locking conflict errors thrown by methods in the [[File classes|file classes]]. | ||
= | <h3 class="relno">New enumeration methods: FromOrdinal and NumberOfValues</h3> | ||
The <var>[[Enumerations#Using_the_FromOrdinal_and_NumberOfValues_methods|FromOrdinal]]</var> and <var>[[Enumerations#Using_the_FromOrdinal_and_NumberOfValues_methods|NumberOfValues]]</var> methods make it easy to enumerate all the values in an enumeration class without having to maintain code that has a list of all the values. | The <var>[[Enumerations#Using_the_FromOrdinal_and_NumberOfValues_methods|FromOrdinal]]</var> and <var>[[Enumerations#Using_the_FromOrdinal_and_NumberOfValues_methods|NumberOfValues]]</var> methods make it easy to enumerate all the values in an enumeration class without having to maintain code that has a list of all the values. | ||
==Other feature changes== | ==Other feature changes== | ||
= | <h3 class="relno">User Language enhancements</h3> | ||
====Implicit concatenation supported for $functions==== | ====Implicit concatenation supported for $functions==== | ||
$functions not preceded by an operator are now concatenated with the preceding expression. This is known as [[Implicit concatenation|implicit concatenation]]. For example the following concatenates the value of two global variables returned by <code>$getg</code> with the string "and" in the middle: | $functions not preceded by an operator are now concatenated with the preceding expression. This is known as [[Implicit concatenation|implicit concatenation]]. For example the following concatenates the value of two global variables returned by <code>$getg</code> with the string "and" in the middle: | ||
<p class="code">%foo = $getg('GLOBALA') " and " $getg('GLOBALB')</p> | <p class="code">%foo = $getg('GLOBALA') " and " $getg('GLOBALB')</p> | ||
= | <h3 class="relno">Model 204 command and parameter changes</h3> | ||
====New system parameter: RECLOCKO==== | ====New system parameter: RECLOCKO==== | ||
The <var>[[RECLOCKO parameter|RECLOCKO]]</var> (RECord LOCKing Options) parameter specifies the information messages that are issued for some or all record locking conflicts. The messages always include user, file, and record number, and they optionally include locking level, time lock obtained, original user number, whether its a pending update lock, etc. | The <var>[[RECLOCKO parameter|RECLOCKO]]</var> (RECord LOCKing Options) parameter specifies the information messages that are issued for some or all record locking conflicts. The messages always include user, file, and record number, and they optionally include locking level, time lock obtained, original user number, whether its a pending update lock, etc. | ||
| Line 51: | Line 52: | ||
====New system parameter: SNAPLIMD==== | ====New system parameter: SNAPLIMD==== | ||
The <var>[[SNAPLIMD parameter|SNAPLIMD]]</var> parameter specifies the maximum number of snaps to generate for any particular zap title. The default is 3. The purpose of this parameter is to allow <var>SNAPLIM</var> to be set to a higher value than previously, without concern that some bug might repeatedly cause snaps and consume output resources. | The <var>[[SNAPLIMD parameter|SNAPLIMD]]</var> parameter specifies the maximum number of snaps to generate for any particular zap title. The default is 3. The purpose of this parameter is to allow <var>SNAPLIM</var> to be set to a higher value than previously, without concern that some bug might repeatedly cause snaps and consume output resources. | ||
==Compatibility and fixes== | ==Compatibility and fixes== | ||
= | <h3 class="relno">Model 204 support</h3> | ||
<var class="product">Sirius Mods</var> version 8.1 supports <var class="product">Model 204</var> V7R1, V7R2, and V7R4. | <var class="product">Sirius Mods</var> version 8.1 supports <var class="product">Model 204</var> V7R1, V7R2, and V7R4. | ||
= | <h3 class="relno">Backwards compatibility with Sirius Mods 8.0 and Sirius Mods 8.1</h3> | ||
<!-- *** No incompatibilities, so none listed, and no zaps: *** | <!-- *** No incompatibilities, so none listed, and no zaps: *** | ||
This section lists any differences in processing that result from execution with Sirius Mods version 8.1, as compared with the same inputs to Sirius Mods version 8.0 at current maintenance levels. | This section lists any differences in processing that result from execution with Sirius Mods version 8.1, as compared with the same inputs to Sirius Mods version 8.0 at current maintenance levels. | ||
| Line 67: | Line 68: | ||
''No incompatibilies have been introduced'' in <var class="product">Sirius Mods</var> version 8.1. | ''No incompatibilies have been introduced'' in <var class="product">Sirius Mods</var> version 8.1. | ||
= | <h3 class="relno">Fixes in Sirius Mods 8.1 but not in 8.0</h3> | ||
<!--As of the date of the release of version 8.1 of the <var class="product">Sirius Mods</var>, there are no fixes to functionality existing in version 8.0 which have not fixed in that version. | <!--As of the date of the release of version 8.1 of the <var class="product">Sirius Mods</var>, there are no fixes to functionality existing in version 8.0 which have not fixed in that version. | ||
--> | --> | ||
This section lists fixes to functionality existing in the Sirius Mods version 8.0 but which, | This section lists fixes to functionality existing in the Sirius Mods version 8.0 but which, | ||
due to the absence of customer problems, have not, as of the date of the release, been | due to the absence of customer problems, have not, as of the date of the release, been | ||
| Line 77: | Line 78: | ||
====UnicodeReplace if no replacement table==== | ====UnicodeReplace if no replacement table==== | ||
The <var>[[UnicodeReplace (Unicode function)|UnicodeReplace]]</var> function can produce unpredictable results (snap, clobber storage, etc.) if called and there is no Unicode replacement table, that is, there are no replacements as specified by the [[Unicode#unicrep|Rep]] subcommand of the <var>UNICODE</var> command. | The <var>[[UnicodeReplace (Unicode function)|UnicodeReplace]]</var> function can produce unpredictable results (snap, clobber storage, etc.) if called and there is no Unicode replacement table, that is, there are no replacements as specified by the [[Unicode#unicrep|Rep]] subcommand of the <var>UNICODE</var> command. | ||
====UnicodeUntranslatablePosition unpredictable results==== | ====UnicodeUntranslatablePosition unpredictable results==== | ||
The <var>[[UnicodeUntranslatablePosition (Unicode function)|UnicodeUntranslatablePosition]]</var> function formerly could produce unpredictable results. | The <var>[[UnicodeUntranslatablePosition (Unicode function)|UnicodeUntranslatablePosition]]</var> function formerly could produce unpredictable results. | ||
<!-- Uncomment if this section has any contents | <!-- Uncomment if this section has any contents | ||
= | <h3 class="relno">Version corequisites</h3> | ||
This section lists any restrictions on usage of various products | This section lists any restrictions on usage of various products | ||
(including <var class="product">Sirius Mods</var> itself) that will be imposed by use of version 7.8 | (including <var class="product">Sirius Mods</var> itself) that will be imposed by use of version 7.8 | ||
Revision as of 16:55, 10 October 2012
These release notes list the enhancements and other changes contained in Sirius Mods version 8.1, which is still in development. Until the the commercial release of the software, Sirius reserves the right to remove or change anything described herein.
The immediately preceding version of the Sirius Mods is:
- Version 8.0, available in April, 2012 — Release notes
Changes to classes and methods
Daemon class changes
New subroutine: ReturnToMaster
ReturnToMaster returns control from a daemon thread to its master thread inside a User Language request.
New functions to continue processing in a daemon
- Continue tells a daemon that did a ReturnToMaster Daemon class call to continue processing at the point of the call.
- ContinueAsynchronously tells a daemon to continue processing asynchronously.
- ContinueIndependently tells a daemon to continue processing independently.
New property: State
State returns the state (the new DaemonState enumeration) of the specified daemon thread.
New exception class: IncorrectDaemonState
The IncorrectDaemonState exception class indicates that the state of the daemon thread was not correct for a method.
New option for New constructor
The New method's optional, named parameter, OpenAll opens in the daemon thread all the files and groups that are open on the master thread.
New class: ScreenReadError
The ScreenReadError class ??
New exception class: RecordLockingConflict
The RecordLockingConflict exception class catches record locking conflict errors thrown by methods in the file classes.
New enumeration methods: FromOrdinal and NumberOfValues
The FromOrdinal and NumberOfValues methods make it easy to enumerate all the values in an enumeration class without having to maintain code that has a list of all the values.
Other feature changes
User Language enhancements
Implicit concatenation supported for $functions
$functions not preceded by an operator are now concatenated with the preceding expression. This is known as implicit concatenation. For example the following concatenates the value of two global variables returned by $getg with the string "and" in the middle:
%foo = $getg('GLOBALA') " and " $getg('GLOBALB')
Model 204 command and parameter changes
New system parameter: RECLOCKO
The RECLOCKO (RECord LOCKing Options) parameter specifies the information messages that are issued for some or all record locking conflicts. The messages always include user, file, and record number, and they optionally include locking level, time lock obtained, original user number, whether its a pending update lock, etc.
New system parameter: SNAPLIMD
The SNAPLIMD parameter specifies the maximum number of snaps to generate for any particular zap title. The default is 3. The purpose of this parameter is to allow SNAPLIM to be set to a higher value than previously, without concern that some bug might repeatedly cause snaps and consume output resources.
Compatibility and fixes
Model 204 support
Sirius Mods version 8.1 supports Model 204 V7R1, V7R2, and V7R4.
Backwards compatibility with Sirius Mods 8.0 and Sirius Mods 8.1
In general, backwards incompatibility means that an operation which was previously performed without any indication of error, now operates, given the same inputs and conditions, in a different manner. We may not list as backwards incompatibilities those cases in which the previous behaviour, although not indicating an error, was "clearly and obviously" incorrect, and which are introduced as normal bug fixes (whether or not they had been fixed with previous maintenance).
No incompatibilies have been introduced in Sirius Mods version 8.1.
Fixes in Sirius Mods 8.1 but not in 8.0
This section lists fixes to functionality existing in the Sirius Mods version 8.0 but which, due to the absence of customer problems, have not, as of the date of the release, been fixed in that version.
UnicodeReplace if no replacement table
The UnicodeReplace function can produce unpredictable results (snap, clobber storage, etc.) if called and there is no Unicode replacement table, that is, there are no replacements as specified by the Rep subcommand of the UNICODE command.
UnicodeUntranslatablePosition unpredictable results
The UnicodeUntranslatablePosition function formerly could produce unpredictable results.