DUPTERM parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(adding Usage section and text that seems to have been missed during wiki conversion)
m (trim note re NUSERS and IODEV lines)
 
(2 intermediate revisions by the same user not shown)
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.  


<p>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:</p>
==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>
<p class="code">M204.2651: NOT ALL THREADS PROCESSED FOR IODEV <var class="term">x</var></p></li>


<p>and the ONLINE will terminate.</p>
<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==
==Example==
<p>In the following example NUSERS=15 represents User 0, three IODEV43, seven IODEV41,
<p>
and four IODEV7. In the following example, IODEV=43 is defined without using the
In the following example: </p>
DUPTERM parameter. IODEV=41 is defined using the DUPTERM parameter by specifying the
<ul>
DUPTERM=<var class="term">nnn</var>, where <var class="term">nnn</var> is the number of times a terminal is duplicated.</p>
<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>


<p>Notice that NOTERM must be defined on the first IODEV card and 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.)</p>
<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
<p class="code">NOTERM=3,IODEV=43
         IODEV=43,SERVSIZE=100000
         IODEV=43,SERVSIZE=100000
         IODEV=43,POLLNO=3,SERVSIZE=50000   <- POLLNO verified
         IODEV=43,POLLNO=3,SERVSIZE=50000   <- POLLNO verified
NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000 <- plus 2 identical
NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000   <- plus 2 identical devices
                                            <- devices
         IODEV=41,SERVSIZE=75000
         IODEV=41,SERVSIZE=75000
         IODEV=41,DUPTERM=2,SERVSIZE=100000 <- plus 2 identical
         IODEV=41,DUPTERM=2,SERVSIZE=100000 <- plus 2 identical devices
                                            <- devices
NOTERM=4,IODEV=7,DUPTERM=3                   <- plus 3 identical devices</p>
NOTERM=4,IODEV=7,DUPTERM=3                 <- plus 3 identical
<p>
                                            <- devices</p>
The following CCAPRINT change occurs when <var>DUPTERM</var> is used:</p>
<p>The following CCAPRINT change occurs when DUPTERM is used:</p>
<p class="code">USER 4
<p class="code">USER 4
NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000
NOTERM=7,IODEV=41,DUPTERM=2,SERVSIZE=50000
NOTERM    7      NUMBER OF TERMINALS ON LINE
NOTERM    7      NUMBER OF TERMINALS ON LINE
IODEV    41      TYPE OF I/O DEVICE
IODEV    41      TYPE OF I/O DEVICE
DUPTERM  2      NUMBER OF DUPLICATE TERMINALS <- different
DUPTERM  2      NUMBER OF DUPLICATE TERMINALS <- different
SERVSIZE  50000  MAXIMUM SIZE OF THIS SERVER
SERVSIZE  50000  MAXIMUM SIZE OF THIS SERVER
USER 5 DUPLICATED <- different
USER 5 DUPLICATED                               <- different
USER 6 DUPLICATED <- different
USER 6 DUPLICATED                               <- different
USER 7
USER 7
IODEV=41,SERVSIZE=75000
IODEV=41,SERVSIZE=75000
Line 55: Line 69:
SERVSIZE  75000      MAXIMUM SIZE OF THIS SERVER</p>
SERVSIZE  75000      MAXIMUM SIZE OF THIS SERVER</p>


<p class="note"><b>Note:</b> The text following each <- is only a documentation comment and not part of the IODEV definition or processing.</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.