DUPTERM parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (misc formatting)
m (add note re NUSERS and IODEV lines)
Line 15: Line 15:


==Description==
==Description==
The <var>[[IODEV parameter|IODEV]]</var> parameter supports duplication within a single device type. The DUPTERM parameter indicates the number of duplications.  
The <var>[[IODEV parameter|IODEV]]</var> parameter supports duplication within a single device type. The <var>DUPTERM</var> parameter indicates the number of duplications.  


==Usage notes==
<ul>
<li>As of version 7.4, if <var>DUPTERM</var> is specified on the first <var>IODEV</var> parameter line of a particular type, then the <var>[[NOTERM parameter|NOTERM]]</var> parameter must also be present. Otherwise, the <var>IODEV</var> line is rejected with the following message, and the Online terminates:
<p class="code">M204.2651: NOT ALL THREADS PROCESSED FOR IODEV <var class="term">x</var></p></li>
<li><var>NUSERS</var> should equal the number of <var>IODEV</var> lines defined.
<p>
<p>
As of version 7.4, if <var>DUPTERM</var> is specified on the first <var>IODEV</var> parameter line of a particular type, then the <var>[[NOTERM parameter|NOTERM]]</var> parameter must also be present. Otherwise, the <var>IODEV</var> line is rejected with the message:</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>


<p class="code">M204.2651: NOT ALL THREADS PROCESSED FOR IODEV <var class="term">x</var></p>
<li>If <var>DUPTERM</var> is used, you are notified that not all the threads for a specified <var>IODEV</var> are processed. </li>


<p>and the Online will terminate.</p>
<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>


==Example==
==Example==
Line 36: Line 50:
</ul>
</ul>
<p>
<p>
Notice that <var>NOTERM</var> must be defined on the first <var>IODEV</var> line, and it must indicate the total number of similar devices to be defined. In addition, <var>POLLNO</var> is no longer required. (It increments from 1 for each new <var>IODEV</var>.)</p>
Notice that <var>NOTERM</var> must be defined on the first <var>IODEV</var> line, and it must indicate the total number of similar devices to be defined. In addition, <var>POLLNO</var> is no longer required. (It increments from 1 for each new <var>IODEV</var>.) </p>


<p class="code">NOTERM=3,IODEV=43
<p class="code">NOTERM=3,IODEV=43

Revision as of 20:22, 12 May 2017

Number of duplicate terminals

Summary

Default value
0
Parameter type
User
Where set
On user's parameter line
Related products
All
Introduced
Model 204 V4.2

Description

The IODEV parameter supports duplication within a single device type. The DUPTERM parameter indicates the number of duplications.

Usage notes

  • As of version 7.4, if DUPTERM is specified on the first IODEV parameter line of a particular type, then the NOTERM parameter must also be present. Otherwise, the IODEV line is rejected with the following message, and the Online terminates:

    M204.2651: NOT ALL THREADS PROCESSED FOR IODEV x

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

Example

In the following example:

  • NUSERS=15 represents User 0, three IODEV43s, seven IODEV41s, and four IODEV7s.
  • IODEV=43 is defined without using the DUPTERM parameter.
  • IODEV=41 is defined using the DUPTERM parameter by specifying the DUPTERM=nnn, where nnn is the number of times a terminal is duplicated.

Notice that NOTERM must be defined on the first IODEV line, and it must indicate the total number of similar devices to be defined. In addition, POLLNO is no longer required. (It increments from 1 for each new IODEV.)

NOTERM=3,IODEV=43 IODEV=43,SERVSIZE=100000 IODEV=43,POLLNO=3,SERVSIZE=50000 <- POLLNO verified NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000 <- plus 2 identical devices IODEV=41,SERVSIZE=75000 IODEV=41,DUPTERM=2,SERVSIZE=100000 <- plus 2 identical devices NOTERM=4,IODEV=7,DUPTERM=3 <- plus 3 identical devices

The following CCAPRINT change occurs when DUPTERM is used:

USER 4 NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000 NOTERM 7 NUMBER OF TERMINALS ON LINE IODEV 41 TYPE OF I/O DEVICE DUPTERM 2 NUMBER OF DUPLICATE TERMINALS <- different SERVSIZE 50000 MAXIMUM SIZE OF THIS SERVER USER 5 DUPLICATED <- different USER 6 DUPLICATED <- different USER 7 IODEV=41,SERVSIZE=75000 IODEV 41 TYPE OF I/O DEVICE SERVSIZE 75000 MAXIMUM SIZE OF THIS SERVER

Note: The text following each <- marker is a documentation comment.