DUPTERM parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (trim note re NUSERS and IODEV lines)
 
(4 intermediate revisions by 3 users not shown)
Line 15: Line 15:


==Description==
==Description==
The IODEV parameter supports duplication within a single device type. The DUPTERM parameter indicates the number of duplications. From V7.4 onwards, 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 will be rejected with the message
The <var>[[IODEV parameter|IODEV]]</var> parameter supports duplication within a single device type. The <var>DUPTERM</var> parameter indicates the number of duplications.  


M204.2651: NOT ALL THREADS PROCESSED FOR IODEV x
==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:


and the ONLINE will terminate.
<p class="code">M204.2651: NOT ALL THREADS PROCESSED FOR IODEV <var class="term">x</var></p></li>


<li>If the number of <var>IODEV</var> lines exceeds <var>[[NUSERS parameter|NUSERS]]</var>:
<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>
==Example==
<p>
In the following example: </p>
<ul>
<li><code>NUSERS=15</code> represents User 0, three IODEV43s, seven IODEV41s, and four IODEV7s. </li>
<li><code>IODEV=43</code> is defined without using the
<var>DUPTERM</var> parameter. </li>
<li><code>IODEV=41</code> is defined using the <var>DUPTERM</var> parameter by specifying the <code>DUPTERM=<i>nnn</i></code>, where <var class="term">nnn</var> is the number of times a terminal is duplicated.</li>
</ul>
<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
        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</p>
<p>
The following CCAPRINT change occurs when <var>DUPTERM</var> is used:</p>
<p class="code">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</p>
<p class="note"><b>Note:</b> The text following each <b><tt><-</tt></b> marker is a documentation comment.</p>


[[Category:User parameters]]
[[Category:User parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 20:48, 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

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