NUSERS parameter: Difference between revisions
Jump to navigation
Jump to search
m (misc formatting) |
m (misc formatting) |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 16: | Line 16: | ||
==Description== | ==Description== | ||
<p> | <p> | ||
The total number of | 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 204</var>. </p> | ||
< | |||
The algorithm to determine if <var>[[NSERVS parameter|NSERVS]]</var>, <var>NUSERS</var>, and <var>[[NSUBTKS parameter|NSUBTKS]]</var> are too large is: | ==Usage notes== | ||
<ul> | |||
<li>The algorithm to determine if <var>[[NSERVS parameter|NSERVS]]</var>, <var>NUSERS</var>, and <var>[[NSUBTKS parameter|NSUBTKS]]</var> are too large is: | |||
<p class="code">IF NUSERS=NSERVS | <p class="code">IF NUSERS=NSERVS | ||
NUSERS + NSUBTKS + 1 > 32767 | NUSERS + NSUBTKS + 1 > 32767 | ||
| Line 31: | Line 33: | ||
Each server, user, pseudo subtask, and the Scheduler has a process control block. There may not be more than 32767 process control blocks.</p> | Each server, user, pseudo subtask, and the Scheduler has a process control block. There may not be more than 32767 process control blocks.</p> | ||
<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> | 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> | ||
<li><var>NUSERS</var> affects the return code set by <code>M204.</code> and <code>MSIR.</code> messages: | |||
<ul> | |||
<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> | |||
<p class="code">M204.2489: IODEV parameter expected.</p> | |||
<p> | |||
If the number of <var>IODEV</var> lines exceeds <var>NUSERS</var>: </p> | |||
<ul> | |||
<li>If <var>[[DUPTERM parameter|DUPTERM]]</var> is not used, the extra <var>IODEV</var> lines are ignored. </li> | |||
<li>If <var>DUPTERM</var> is used, you are notified that not all the threads for a specified <var>IODEV</var> are processed. </li> | |||
<li>If <var>DUPTERM</var> and <var>[[FUNTSKN parameter|FUNTSKN]]</var> are specified, the extra <var>IODEV</var> lines are used for Fast/Unload tasks, and you are notified if some other threads do not open. </li> | |||
</ul></li> | |||
</ul> | |||
[[Category:System parameters]] | [[Category:System parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
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.andMSIR.messages:- If
NUSERS=1, the Batch return code for the message is set. - If
NUSERS>1, the Online return code is set, unlessCUSTOM=22is 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.
- If
NUSERS-1should 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.