NUSERS parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Moved the paragraph about return codes up above the line about IODEV lines)
m (misc formatting)
 
Line 16: Line 16:
==Description==
==Description==
<p>
<p>
The total number of User Language users and Host Language Interface [[Using HLI and batch configurations#IFAM2|IFAM2]] or [[Using HLI and batch configurations#IFAM4 for z/OS|IFAM4]] threads to be supported by <var class="product">Model&nbsp;204</var>. </p>
The total number of SOUL users and Host Language Interface [[Using HLI and batch configurations#IFAM2|IFAM2]] or [[Using HLI and batch configurations#IFAM4 for z/OS|IFAM4]] threads to be supported by <var class="product">Model&nbsp;204</var>. </p>


==Usage notes==
==Usage notes==
Line 35: Line 35:
If you receive the M204.0021 message, adjust the combination of <var>NUSERS</var>, <var>NSERVS</var>, and <var>NSUBTKS</var> + 1 so that it does not exceed 32767.</p></li>
If you receive the M204.0021 message, adjust the combination of <var>NUSERS</var>, <var>NSERVS</var>, and <var>NSUBTKS</var> + 1 so that it does not exceed 32767.</p></li>


<p><li><var>NUSERS</var> affects the return code set by M204. and MSIR. messages.  When <var>NUSERS=1</var>, the Batch return code for the message is set.  When <var>NUSERS>1</var>, the Online return code is set unless <var>CUSTOM=22</var> has been specified in CCAIN.  In that, case, the Batch return code is set. The return code is not changed if the message specifies a return code less than the current setting of the return code for the run.</p></li>   
<li><var>NUSERS</var> affects the return code set by <code>M204.</code> and <code>MSIR.</code> messages:
 
<ul>
<p><li><var>NUSERS-1</var> should equal the number of <var>IODEV</var> lines defined.</p></li>
<li>If <code>NUSERS=1</code>, the Batch return code for the message is set. </li>
   
<li>If <code>NUSERS>1</code>, the Online return code is set, unless <code>CUSTOM=22</code> is specified in CCAIN (in which case, the Batch return code is set). </li>
</ul>
<p>
The return code is not changed if the message specifies a return code less than the current setting of the return code for the run.</p></li>   


<li><code>NUSERS-1</code> should equal the number of <var>IODEV</var> lines defined.
<p>
If <var>NUSERS</var> is set to a number greater than the number of <var>IODEV</var> lines, the next input line receives an error: </p>
If <var>NUSERS</var> is set to a number greater than the number of <var>IODEV</var> lines, the next input line receives an error: </p>
<p class="code">M204.2489: IODEV parameter expected.</p>
<p class="code">M204.2489: IODEV parameter expected.</p>
 
<p>
<p>If the number of <var>IODEV</var> lines exceeds <var>NUSERS</var>: </p>
If the number of <var>IODEV</var> lines exceeds <var>NUSERS</var>: </p>
<ul>
<ul>
<li>If <var>[[DUPTERM parameter|DUPTERM]]</var> is not used, the extra <var>IODEV</var> lines are ignored. </li>
<li>If <var>[[DUPTERM parameter|DUPTERM]]</var> is not used, the extra <var>IODEV</var> lines are ignored. </li>

Latest revision as of 18:41, 21 September 2017

Number of users

Summary

Default value
1
Parameter type
System
Where set
On User 0's parameter line
Related products
All
Introduced
Model 204 V2.1 or earlier

Description

The total number of SOUL users and Host Language Interface IFAM2 or IFAM4 threads to be supported by Model 204.

Usage notes

  • The algorithm to determine if NSERVS, NUSERS, and NSUBTKS are too large is:

    IF NUSERS=NSERVS NUSERS + NSUBTKS + 1 > 32767 ELSE NSERVS + NUSERS + NSUBTKS + 1 > 32767

    If too many process control blocks are requested, the user receives the following message:

    M204.0021: NSERVS+NUSERS(IF SWAPPING)+NSUBTKS+1 > 32767

    Each server, user, pseudo subtask, and the Scheduler has a process control block. There may not be more than 32767 process control blocks.

    If you receive the M204.0021 message, adjust the combination of NUSERS, NSERVS, and NSUBTKS + 1 so that it does not exceed 32767.

  • NUSERS affects the return code set by M204. and MSIR. messages:
    • If NUSERS=1, the Batch return code for the message is set.
    • If NUSERS>1, the Online return code is set, unless CUSTOM=22 is specified in CCAIN (in which case, the Batch return code is set).

    The return code is not changed if the message specifies a return code less than the current setting of the return code for the run.

  • NUSERS-1 should equal the number of IODEV lines defined.

    If NUSERS is set to a number greater than the number of IODEV lines, the next input line receives an error:

    M204.2489: IODEV parameter expected.

    If the number of IODEV lines exceeds NUSERS:

    • If DUPTERM is not used, the extra IODEV lines are ignored.
    • If DUPTERM is used, you are notified that not all the threads for a specified IODEV are processed.
    • If DUPTERM and FUNTSKN are specified, the extra IODEV lines are used for Fast/Unload tasks, and you are notified if some other threads do not open.