SOCKMAX parameter: Difference between revisions
Jump to navigation
Jump to search
m (→Description) |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:SOCKMAX parameter subtitle}} | |||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 10: | Line 11: | ||
<dd>[[Janus Sockets]] | <dd>[[Janus Sockets]] | ||
<dt>Introduced | <dt>Introduced | ||
<dd>Before | <dd>Before <var class="product">Sirius Mods</var> 6.7 | ||
</dl> | </dl> | ||
==Description== | ==Description== | ||
| Line 26: | Line 27: | ||
storage requirements | storage requirements | ||
for each open socket over a <var class="product">Janus Sockets</var> or <var class="product">[[Debugger|Sirius Debugger]]</var> port, which increases the storage requirement by | for each open socket over a <var class="product">Janus Sockets</var> or <var class="product">[[Debugger|Sirius Debugger]]</var> port, which increases the storage requirement by | ||
960 bytes plus the value of the <var>IBSIZE</var> and <var>OBSIZE</var> parameters. | 960 bytes plus the value of the <var>[[IBSIZE_(JANUS_DEFINE_parameter)|IBSIZE]]</var> and <var>[[OBSIZE_(JANUS_DEFINE_parameter)|OBSIZE]]</var> parameters. | ||
<var>SOCKMAX</var> may be reset on the <code>EXEC</code> JCL statement or on user zero's parameter line. | <var>SOCKMAX</var> may be reset on the <code>EXEC</code> JCL statement or on user zero's parameter line. | ||
Note the distinction between this <var class="product">Model 204</var> system | Note the distinction between this <var class="product">Model 204</var> system | ||
parameter and the <var>SOCKPMAX</var> parameter on the <var>[[JANUS DEFINE]]</var> command: | parameter and the <var>[[SOCKPMAX_(JANUS_DEFINE_parameter)|SOCKPMAX]]</var> parameter on the <var>[[JANUS DEFINE]]</var> command: | ||
<ul> | <ul> | ||
<li>The <var>SOCKMAX</var> <i><b>system</b></i> parameter specifies the number of '''in-use''' | <li>The <var>SOCKMAX</var> <i><b>system</b></i> parameter specifies the number of '''in-use''' | ||
sockets a user may have at any time. | sockets a user may have at any time. | ||
One of these is reserved for the server socket number 1, so there are <code>SOCKMAX - 1</code> sockets available to each user to make connections on <var>[[JANUS DEFINE#type|CLSOCK]]</var> ports. | One of these is reserved for the server socket number 1, so there are <code>SOCKMAX - 1</code> sockets available to each user to make connections on <var>[[JANUS DEFINE#type|CLSOCK]]</var> and <var>[[JANUS DEFINE#type|DEBUGGERCLIENT]]</var> ports. | ||
A <var>RESET</var> socket ''is included'' in this total if the application has | A <var>RESET</var> socket ''is included'' in this total if the application has | ||
not issued the <var>[[$Sock_Close]]</var> function for it. | not issued the <var>[[$Sock_Close]]</var> function for it. | ||
<li>The <var>SOCKPMAX</var> <i><b>port</b></i> parameter specifies the number of <var>OPEN</var> | <li>The <var>SOCKPMAX</var> <i><b>port</b></i> parameter specifies the number of <var>OPEN</var> | ||
sockets a user may have at any time for the ''particular'' <var>CLSOCK</var> port. | sockets a user may have at any time for the ''particular'' <var>CLSOCK</var> or <var>DEBUGGERCLIENT</var> port. | ||
A <var>RESET</var> socket is '''not''' included in this total, even if the application has | A <var>RESET</var> socket is '''not''' included in this total, even if the application has | ||
not issued the <var>$Sock_Close</var> function for it. | not issued the <var>$Sock_Close</var> function for it. | ||
Latest revision as of 14:00, 6 September 2017
Maximum sockets per user
Summary
- Default value
- 10
- Parameter type
- System
- Where set
- User 0 CCAIN parameters
- Related products
- Janus Sockets
- Introduced
- Before Sirius Mods 6.7
Description
The SOCKMAX system parameter specifies the maximum total number of sockets a user may use at any time (one of these is reserved for the server socket number 1, whether the user is a server socket program or not). The default for SOCKMAX is 10, thus allowing 9 client socket numbers to be in use.
The minimum value for SOCKMAX is 2, and the maximum value is 88.
SOCKMAX affects storage allocation for each user who is using any sockets:
each such user has allocated 6 + (6 * SOCKMAX) bytes (rounded up to a multiple of 4).
In addition to this storage requirement are storage requirements for each open socket over a Janus Sockets or Sirius Debugger port, which increases the storage requirement by 960 bytes plus the value of the IBSIZE and OBSIZE parameters.
SOCKMAX may be reset on the EXEC JCL statement or on user zero's parameter line.
Note the distinction between this Model 204 system parameter and the SOCKPMAX parameter on the JANUS DEFINE command:
- The SOCKMAX system parameter specifies the number of in-use
sockets a user may have at any time.
One of these is reserved for the server socket number 1, so there are
SOCKMAX - 1sockets available to each user to make connections on CLSOCK and DEBUGGERCLIENT ports. A RESET socket is included in this total if the application has not issued the $Sock_Close function for it. - The SOCKPMAX port parameter specifies the number of OPEN sockets a user may have at any time for the particular CLSOCK or DEBUGGERCLIENT port. A RESET socket is not included in this total, even if the application has not issued the $Sock_Close function for it.