SCRNSTBL parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(3 intermediate revisions by 3 users not shown)
Line 5: Line 5:
<dd>6144
<dd>6144
<dt>Parameter type
<dt>Parameter type
<dd>User
<dd>System
<dt>Where set
<dt>Where set
<dd>System manager resettable
<dd>System manager resettable
Line 18: Line 18:
<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.
<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.


An application that exceeds its screen STBL allocation is cancelled, usually with a message like:
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 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.
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>
<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>

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.