SNAPLIMD parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 34: Line 34:


To capture additional snaps for those which have already reached the value of <var>SNAPLIMD</var>, you can increase its value, for example:
To capture additional snaps for those which have already reached the value of <var>SNAPLIMD</var>, you can increase its value, for example:
<p class="code">RESET SNAPLIMD +3</p> (See the [[??]].)
<p class="code">RESET SNAPLIMD +3</p>
(This example uses the feature described in [[Relative values for Model 204 numeric parameters|"Relative values for Model 204 numeric parameters"]].)
[[Category:System parameters]]
[[Category:System parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Revision as of 03:44, 12 September 2012

0 or max number of occurrences of any particular snap

Summary

Default value
3
Parameter type
System
Where set
System manager resettable
Related products
All
Introduced
Sirius Mods 8.1 (and by zap in 8.0)

Description

This parameter limits the number of snaps which can be issued with any given snap title. That is, it prevents some bug from using up the snaps available as specified by the SNAPLIM parameter.

The *SNAP snap title is not subject to SNAPLIMD, thus:

  • When the *SNAP command is issued, each snap thus created is considered unique, and will not be suppressed due to SNAPLIMD.
  • When the BUMPSNAP command is issued, each snap thus created is considered unique, and will not be suppressed due to SNAPLIMD.

Note that

  • When a snap is suppressed due to exceeding the SNAPLIM parameter, the SNAPID parameter is incremented.
  • If that is not the case (that is, if the SNAPLIM parameter is less than the SNAPID parameter), if there have already been at least as many snaps actually produced for the given snap title as the value of the SNAPLIMD parameter:
    • The snap is suppressed and the SNAPID parameter is not incremented (otherwise, the purpose of SNAPLIMD would be circumvented).

To suppress the action due to SNAPLIMD, set it to 0. Note that when it is 0 it does not prevent snaps from occurring, but it still counts snaps for each snap title, so if you subsequently change it to a positive value, the next snap for any given snap title will be suppressed if the number of occurrences of that snap had already been as large as the new SNAPLIMD.

To capture additional snaps for those which have already reached the value of SNAPLIMD, you can increase its value, for example:

RESET SNAPLIMD +3

(This example uses the feature described in "Relative values for Model 204 numeric parameters".)