SOCKMAX parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
Line 13: Line 13:
</dl>
</dl>
==Description==
==Description==
This parameter specifies the maximum total number of sockets a user may use at any
The <var>SOCKMAX</var> system parameter specifies the maximum total number
time (one of these is reserved for the server socket number 1, whether the user is a
of sockets a user may use at any time (one of these is reserved for the
server socket program or not). The default for SOCKMAX is 10, which allows 9 client
server socket number 1, whether the user is a server socket program or not).
socket numbers to be in use.
The default for <var>SOCKMAX</var> is 10, thus allowing 9 client socket numbers to be
The minimum value for SOCKMAX is 2, and the maximum value is 88.
in use.
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
The minimum value for <var>SOCKMAX</var> is 2, and the maximum value is 88.
addition, each open socket over a <var class="product">[[Janus Sockets]]</var> or <var class="product">[[Debugger|Sirius Debugger]]</var> port increases the storage requirement
<var>SOCKMAX</var> affects storage allocation for each user who is using any sockets:
by 960 bytes plus the value of the [[IBSIZE]] and [[OBSIZE]] parameters.
each such user has allocated <code>6 + (6 * SOCKMAX)</code> bytes (rounded up to a multiple of 4).
Note the distinction between this Model 204 system parameter and [[SOCKPMAX]].
In addition to this storage requirement are
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
960 bytes plus the value of the <var>IBSIZE</var> and <var>OBSIZE</var> parameters.
<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
parameter and the <var>SOCKPMAX</var> parameter on the <var>[[JANUS DEFINE]]</var> command:
<ul>
<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.
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.
A <var>RESET</var> socket ''is included'' in this total if the application has
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>
sockets a user may have at any time for the ''particular'' <var>CLSOCK</var> port.
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.
</ul>


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

Revision as of 19:20, 14 February 2012

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 - 1 sockets available to each user to make connections on CLSOCK 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 port. A RESET socket is not included in this total, even if the application has not issued the $Sock_Close function for it.