SCRNSTBL parameter: Difference between revisions
No edit summary |
|||
| Line 17: | Line 17: | ||
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 | 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 | ||
<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. | ||
While SCRNSTBL can be set higher than LSTBL, 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 as well as the other STBL-resident strings in the procedure. | |||
An application that exceeds its screen STBL allocation is cancelled, usually with a message like: | An application that exceeds its screen STBL allocation is cancelled, usually with a message like: | ||
| Line 22: | Line 24: | ||
</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 SIRIUS MINOBJECTS 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> | ||
Revision as of 16:03, 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.
While SCRNSTBL can be set higher than LSTBL, 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 as well as the other STBL-resident strings in the procedure.
An application that exceeds its screen STBL 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.