NUSERS parameter: Difference between revisions
m (add note re NUSERS and IODEV lines) |
m (misc formatting) |
||
| (2 intermediate revisions by one other user 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> | ||
==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> | ||
<li><var>NUSERS</var> should equal the number of <var>IODEV</var> lines defined. | <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> | <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.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.