NUSERS parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Added a blurb about how NUSERS affects return codes)
(Moved the paragraph about return codes up above the line about IODEV lines)
Line 34: Line 34:
<p>
<p>
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> 


<p><li><var>NUSERS-1</var> should equal the number of <var>IODEV</var> lines defined.</p></li>
<p><li><var>NUSERS-1</var> should equal the number of <var>IODEV</var> lines defined.</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> 


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>

Revision as of 16:27, 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 User Language 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. When NUSERS=1, the Batch return code for the message is set. When NUSERS>1, the Online return code is set unless CUSTOM=22 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.

  • 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.