SERVGA parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
 
(23 intermediate revisions by 8 users not shown)
Line 13: Line 13:
<dd><var class="product">Model 204 V7.5</var>
<dd><var class="product">Model 204 V7.5</var>
</dl>
</dl>
==Description==
==Description==
<p>The <var>SERVGSA</var> parameter, along with the <var>SERVGSZ</var> parameter, control swappable server areas that are placed above the 2G bar.</p>
<p>
Each server table to be allocated in the above-the-bar swappable area is controlled by a bit in <var>SERVGSA</var>; if the bit is on, the corresponding server table is allocated in the above-the-bar swappable area.
The <var>SERVGA</var> parameter controls which server tables are allocated in the ATB-swappable-server area.</p>
In Model 204 version 7.5, only <var>[[LNTBL_parameter|NTBL]]</var> and <var>[[LQTBL_parameter|QTBL]]</var> can be placed above-the-bar in a swappable area.<br>
Each server table to be allocated in that area is controlled by a bit in <var>SERVGA</var>. If the bit is on, the corresponding server table is allocated in the ATB-swappable-server area.


The bits are:
The bits are:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>Bit</th><th>Server table placed above the bar</th></tr>
<tr><th>Bit</th><th>Server table placed above the bar</th><th>Required version of Model 204</th></tr>
<tr><td><code>X'00004000'</code></td><td>NTBL</td></tr>
<tr><td><code>X'02000000'</code></td><td><var>[[LFTBL_parameter|FTBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00002000'</code></td><td>QTBL</td></tr>
<tr><td><code>X'01000000'</code></td><td><var>[[LXTBL_parameter|XTBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00800000'</code></td><td><var>[[LGTBL_parameter|GTBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00400000'</code></td><td><var>[[LITBL_parameter|ITBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00200000'</code></td><td><var>[[LPDLST_parameter|PDL]]</var></td><td>7.9 or later</td></tr>
<tr><td><code>X'00100000'</code></td><td><var>[[LFSCB_parameter|FSCB]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00080000'</code></td><td><var>[[LSTBL_parameter|STBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00040000'</code></td><td><var>[[LVTBL_parameter|VTBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00020000'</code></td><td><var>[[LTTBL_parameter|TTBL]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00010000'</code></td><td><var>[[HTBFRS]]</var></td><td>7.6 or later</td></tr>
<tr><td><code>X'00004000'</code></td><td><var>[[LNTBL_parameter|NTBL]]</var> </td><td>7.5 or later</td></tr>
<tr><td><code>X'00002000'</code></td><td><var>[[LQTBL_parameter|QTBL]]</var></td><td>7.5 or later</td></tr>
<tr><td><code>X'00001000'</code></td><td>Server-swap table</td><td>7.9 or later</td></tr>
</table>
</table>
<var>[[SERVGSZ parameter|SERVGSZ]]</var> is the amount of space in bytes required for the swappable above-the-bar server tables per server. The total amount of storage allocated for swappable above-the-bar server areas equals <var>SERVGSZ</var> rounded to 4K and multiplied by [[NSERVS parameter|NSERVS]].
When sizing <var>SERVGSZ</var>, it should accomodate the largest swappable above-the-bar table sizes that might be needed.


QTBL and NTBL can alternatively be placed above-the-bar in a non-swappable area. This can be indicated with the [[SERVNSA parameter|SERVNSA]] and [[SERVNSSZ parameter|SERVNSSZ]] parameters. The bits corresponding to NTBL and QTBL should not be set in both SERVNSA and SERVGA &mdash; if they are, an error message will be issued and the online will fail to come up. 


While it might seem odd to have above-the-bar swappable server areas, especially if swapping to above-the-bar memory, placing NTBL and QTBL in a swappable area can save quite a bit of real memory. This is especially true if the [[RESPAGE parameter]] is set to a non-zero value and there are significantly more users ([[NUSERS parameter|NUSERS]]) than servers (NSERVS). In such a case, most swapped out users would either be using a resident (shared) NTBL and QTBL or would be logged out and only using a single 4K page. As such, reserving the amount of space required for NTBL and QTBL (which can typically get quite large) in the non-swappable above-the-bar area for all the swapped out users can waste a significant amount of real storage.
<p class="note"><b>Note:</b> These bits can also be set in <var>[[SERVNSA_parameter|SERVNSA]]</var> but should not be set in both <var>SERVGA</var> and <var>SERVNSA</var> &mdash; if they are, an error message is issued and the Online fails to come up.</p>
<var>[[SERVGSZ parameter|SERVGSZ]]</var> is the amount of space in bytes required for the swappable above-the-bar server tables per server. The total amount of storage allocated for swappable above-the-bar server areas equals <var>SERVGSZ</var> rounded to 4K and multiplied by <var>[[NSERVS parameter|NSERVS]]</var>.
When sizing <var>SERVGSZ</var>, it should accommodate the largest swappable above-the-bar table sizes that might be needed.
 
Some server tables can alternatively be placed above-the-bar in a non-swappable area. This can be indicated with the <var>[[SERVNSA parameter|SERVNSA]]</var> and <var>[[SERVNSSZ parameter|SERVNSSZ]]</var> parameters.  
In Model 204 7.9 and later, if PDL is placed above-the-bar it is recommended that LPDLST be set to its maximum value of 65536.
 
{{Template:SERVGA/SERVGSZ common}}
 
==See also==
<ul>
<li><var>[[ZPAGEOPT parameter|ZPAGEOPT]]</var></li>
</ul>
 


[[Category:System parameters]]
[[Category:System parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 21:21, 25 March 2022

Above the bar server areas

Summary

Default value
0
Parameter type
System
Where set
On User 0's parameter line
Related products
All
Introduced
Model 204 V7.5

Description

The SERVGA parameter controls which server tables are allocated in the ATB-swappable-server area.

In Model 204 version 7.5, only NTBL and QTBL can be placed above-the-bar in a swappable area.
Each server table to be allocated in that area is controlled by a bit in SERVGA. If the bit is on, the corresponding server table is allocated in the ATB-swappable-server area.

The bits are:

BitServer table placed above the barRequired version of Model 204
X'02000000'FTBL7.6 or later
X'01000000'XTBL7.6 or later
X'00800000'GTBL7.6 or later
X'00400000'ITBL7.6 or later
X'00200000'PDL7.9 or later
X'00100000'FSCB7.6 or later
X'00080000'STBL7.6 or later
X'00040000'VTBL7.6 or later
X'00020000'TTBL7.6 or later
X'00010000'HTBFRS7.6 or later
X'00004000'NTBL 7.5 or later
X'00002000'QTBL7.5 or later
X'00001000'Server-swap table7.9 or later


Note: These bits can also be set in SERVNSA but should not be set in both SERVGA and SERVNSA — if they are, an error message is issued and the Online fails to come up.

SERVGSZ is the amount of space in bytes required for the swappable above-the-bar server tables per server. The total amount of storage allocated for swappable above-the-bar server areas equals SERVGSZ rounded to 4K and multiplied by NSERVS. When sizing SERVGSZ, it should accommodate the largest swappable above-the-bar table sizes that might be needed.

Some server tables can alternatively be placed above-the-bar in a non-swappable area. This can be indicated with the SERVNSA and SERVNSSZ parameters. In Model 204 7.9 and later, if PDL is placed above-the-bar it is recommended that LPDLST be set to its maximum value of 65536.

While it might seem odd to have above-the-bar swappable server areas, especially if swapping to above-the-bar memory, placing NTBL and QTBL in a swappable area can save quite a bit of real memory. This is especially true if the RESPAGE parameter is set to a non-zero value and there are significantly more users (NUSERS) than servers (NSERVS). In such a case, most swapped out users would either be using a resident (shared) NTBL and QTBL, or they would be logged out and only using a single 4K page. As such, reserving the amount of space required for NTBL and QTBL (which can typically get quite large) in the non-swappable above-the-bar area for all the swapped out users can waste a significant amount of real storage.

See also