DUPTERM parameter: Difference between revisions

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.

@@ Line 15: / Line 15: @@
 ==Description==
-The <var>[[IODEV_parameter|IODEV]]</var> 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:Parameters]]