Simplify netthroughput

Author: bengsig

docs/NEWS30.md

@@ -36,7 +36,13 @@ will now generate an error about incorrect integer declaration
 since ```audit``` is taken as initial keyword to start scanning
 for SQL.
 
-## New in version 3.0.2 of the RWP\*Load Simulator
+## News in version 3.0.3 of the RWP\*Load Simulator
+
+The three utilities ociping.rwl, connping.rwl and netthroughput.rwl are
+shipped as standalone, generated binaries, and they can therefore be
+used without a full install of the RWP\*Load Simulator.
+
+## News in version 3.0.2 of the RWP\*Load Simulator
 
 ### Generating an executable
 

docs/ORACLENET.md

@@ -29,27 +29,28 @@ connect mean=206.14 stddev=113.75
 ociping mean=0.09 stddev=0.02
 dualping mean=0.12 stddev=0.02
 ```
-The third script, nettest.rwl, does a similar measurement of OCIPing rates
-and additionally estimates the total available throughput from the database 
-to the client.
-Some lines from a sample output are:
+The third script, netthroughput.rwl estimates the total available throughput
+from the database to the client.
+A sample call and output is:
 ```
-Performing ping test for 30 s
-connect mean 288.61 ms, stddev 303.95
-ociping mean 0.09 ms, stddev 0.02
-dualping mean 0.13ms, stddev 0.02
+rwloadsim --concurrency=10 -ul username/{password}@//host/db --period=20 netthroughput.rwl
 
-Actual throughput test now running 30 s
-Throughput estimate 2.65 GB/s
+RWP*Load Simulator Release 3.0.2.20 Development on Mon, 19 Sep 2022 08:44:52 UTC
+Connected default database to:
+Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Production
+Connecting sessions
+All threads connected
+Throughput test now running 20 s
+Throughput estimate 1.574 GB/s logical, 1.574 GB/s physical
 ```
 All are documented using ```rwlman ociping``` ```rwlman connping``` 
 or ```rwlman nettest```.
 
 ### Stand alone executables
 
-The two utilities ociping, and connping, are distributed as completely stand alone
-executables in the file generated-linux-x86_64-bin-3.0.2.tgz.
-It only contains the two files, and they can be used without a complete installation
+The three utilities are distributed as completely stand alone
+executables in the file generated-linux-x86_64-bin-3.0.3.tgz.
+It only contains the three files, and they can be used without a complete installation
 of rwloadsim, as long as there is an Oracle client environment that can be an ordinary
 installation or an Instant Client installation.
 The version must be 19 or later, and you must have LD_LIBRARY_PATH include
@@ -59,7 +60,7 @@ with Instant Client it is the top directory of the installation.
 
 After download, simply execute
 ```
-tar -zxvf generated-linux-x86_64-bin-3.0.2.tgz
+tar -zxvf generated-linux-x86_64-bin-3.0.3.tgz
 ```
 and possibly move the executables to one of the directories in your PATH.
 To get help for either, call it with the -h option.

docs/refman/netthroughput.html

@@ -117,24 +117,20 @@ In that case, make a new run with the suggested rampup time.
 .SH EXAMPLE
 .P
 .nf
-rwloadsim -ul username/{password}@//host/db --period=20 --concurrency=2 netthroughput.rwl
+rwloadsim --concurrency=10 -ul username/{password}@//host/db --period=20 netthroughput.rwl
 
-RWP*Load Simulator Release 3.0.2.11 Development on Wed, 14 Sep 2022 09:36:56 UTC
+RWP*Load Simulator Release 3.0.2.20 Development on Mon, 19 Sep 2022 08:44:52 UTC
 Connected default database to:
 Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Production
-
-Preparations taking up to 15 s
-Pure database time per throughput query: mean 1.42 ms, stddev 0.00
-Network and database time for throughput query: mean 7.81 ms, stddev 0.14
 Connecting sessions
 All threads connected
-Actual throughput test now running 20 s
-Throughput estimate 0.248 GB/s logical, 0.248 GB/s physical
+Throughput test now running 20 s
+Throughput estimate 1.574 GB/s logical, 1.574 GB/s physical
 .fi
 .PP
 The example shows the 
 estimated throughput from the database to the client
-using 2 concurrent streams is 0.248 logical (and physical) Gigabytes per second.
+using 2 concurrent streams is 1.574 logical (and physical) Gigabytes per second.
 .P
 The following example:
 .P
@@ -146,7 +142,10 @@ do
 done
 .fi
 .P
-will create the file tp.csv with five lines for 1 until 5 concurrent streams.
+will create the file tp.csv with five lines for 1 until 5 concurrent streams; it can
+be used as input to gnuplot.
+If you alternatively want to use typical office software on a laptop, use the --csvexcel option
+and copy the csv file to your laptop.
 .SH COPYRIGHT
 Copyright \(co 2022 Oracle Corporation
 .br