SCRNSTBL parameter: Difference between revisions
m (→Description) |
mNo edit summary |
||
| (7 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:SCRNSTBL parameter subtitle}} | |||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 4: | Line 5: | ||
<dd>6144 | <dd>6144 | ||
<dt>Parameter type | <dt>Parameter type | ||
<dd> | <dd>System | ||
<dt>Where set | <dt>Where set | ||
<dd>System manager resettable | <dd>System manager resettable | ||
| Line 10: | Line 11: | ||
<dd>All | <dd>All | ||
<dt>Introduced | <dt>Introduced | ||
<dd><var class="product">Sirius Mods</var> 7.1 | <dd><var class="product">[[Sirius Mods]]</var> 7.1 | ||
</dl> | </dl> | ||
==Description== | ==Description== | ||
This is a numeric parameter (with valid values 0 or greater) that indicates the maximum amount of STBL space available to | This is a numeric parameter (with valid values 0 or greater) that indicates the maximum amount of <var>[[LSTBL_parameter|STBL]]</var> space available to <var class="product">Janus SOAP</var> [[Screen class|Screen objects]]. <var>Screen</var> objects use STBL space and not <var>[[LFSCB_parameter|FSCB]]</var> space, and any instance of a | ||
Screen object must allocate the maximum allowable STBL space, even if some of this space may not be used by a particular application. | <var>Screen</var> object must allocate the maximum allowable STBL space, even if some of this space may not be used by a particular application. | ||
SCRNSTBL can be set higher than LSTBL. However, at the time a procedure containing a screen object is compiled, LSTBL must be set to a value that accommodates both the largest screen object in the procedure and the other STBL-resident strings in the procedure. | |||
A procedure using a screen object that exceeds its SCRNSTBL allocation is cancelled, usually with a message like: | |||
<p class="code">MSIR.0750: Class Screen, function AddField: no more space for screen field data ... | <p class="code">MSIR.0750: Class Screen, function AddField: no more space for screen field data ... | ||
</p> | </p> | ||
Some Sirius | Some Sirius RKTools products, like [[SirScan]] and [[SirPro]], also make use of <var>Screen</var> objects. The <var>SCRNSTBL</var> default value is sufficient for those products for Model 2 terminals. However, the default <var>SCRNSTBL</var> might not be sufficient for other terminal models, especially Model 4 or [[SIRTERM_parameter|Model 6]] terminals. | ||
If no [[Screen class|Screen objects]] are used in the Model 204 region, SCRNSTBL can be set to zero. If [[Screen class|Screen objects]] are used, calculating the correct value is complicated by performance issues related to object swapping. See the discussion at [[Managing server space for objects]], especially the discussion of the <var>[[Managing server space for objects#Using compiler directives to modify object allocation|Sirius MinObjects]]</var> compiler directive. | |||
<p class="note"><b>Note:</b> The <var>SCRNSTBL</var> parameter affects the space allocated for <var>Screen</var> objects at compilation time. As such, increasing <var>SCRNSTBL</var> does not increase the amount of space available to pre-compiled requests unless those requests are re-compiled after resetting <var>SCRNSTBL</var>. </p> | |||
[[Category:System parameters]] | [[Category:System parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Latest revision as of 19:43, 25 May 2017
STBL size for Screen objects
Summary
- Default value
- 6144
- Parameter type
- System
- Where set
- System manager resettable
- Related products
- All
- Introduced
- Sirius Mods 7.1
Description
This is a numeric parameter (with valid values 0 or greater) that indicates the maximum amount of STBL space available to Janus SOAP Screen objects. Screen objects use STBL space and not FSCB space, and any instance of a Screen object must allocate the maximum allowable STBL space, even if some of this space may not be used by a particular application.
SCRNSTBL can be set higher than LSTBL. However, at the time a procedure containing a screen object is compiled, LSTBL must be set to a value that accommodates both the largest screen object in the procedure and the other STBL-resident strings in the procedure.
A procedure using a screen object that exceeds its SCRNSTBL allocation is cancelled, usually with a message like:
MSIR.0750: Class Screen, function AddField: no more space for screen field data ...
Some Sirius RKTools products, like SirScan and SirPro, also make use of Screen objects. The SCRNSTBL default value is sufficient for those products for Model 2 terminals. However, the default SCRNSTBL might not be sufficient for other terminal models, especially Model 4 or Model 6 terminals.
If no Screen objects are used in the Model 204 region, SCRNSTBL can be set to zero. If Screen objects are used, calculating the correct value is complicated by performance issues related to object swapping. See the discussion at Managing server space for objects, especially the discussion of the Sirius MinObjects compiler directive.
Note: The SCRNSTBL parameter affects the space allocated for Screen objects at compilation time. As such, increasing SCRNSTBL does not increase the amount of space available to pre-compiled requests unless those requests are re-compiled after resetting SCRNSTBL.