From 4e0ccb1009ea28560b6013f1403243fc02e6e017 Mon Sep 17 00:00:00 2001
From: Bjorn Kisbye Engsig
END
fi
+if test $cstormwidth -gt 0
+then
+ cat <Ash data * $svgash ${runnumber}_ash.png
+END
+fi
if test $oercount -gt 0
then
@@ -932,6 +939,46 @@ else
fi
echo "proccount=$proccount" >> $awrdirectory$subdir$runnumber/index.html
+if test $cstormwidth -gt 0
+then
+ cat $resultsdir$subdir$runnumber/cstorm.html >> $awrdirectory$subdir$runnumber/index.html
+ cat > $resultsdir$subdir${runnumber}/cstorm.plot <Extra connection storm ${runnumber}_cstorm.svg ${runnumber}_cstorm.png Plots for $titletext at $rundate
Please note that $ followed by lower case are directives, so you cannot diff --git a/docs/refman/conditional.html b/docs/refman/conditional.html index 41343142..445570e7 100644 --- a/docs/refman/conditional.html +++ b/docs/refman/conditional.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/connping.html b/docs/refman/connping.html index 8247b489..b68fbaa4 100644 --- a/docs/refman/connping.html +++ b/docs/refman/connping.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/constant.html b/docs/refman/constant.html index 3db2cfc1..49a7111a 100644 --- a/docs/refman/constant.html +++ b/docs/refman/constant.html @@ -1,5 +1,5 @@ - + @@ -234,10 +234,11 @@
Please note that $ followed by lower case are directives, so you cannot diff --git a/docs/refman/controlloop.html b/docs/refman/controlloop.html index d66b7447..21ace433 100644 --- a/docs/refman/controlloop.html +++ b/docs/refman/controlloop.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/cqnthread.html b/docs/refman/cqnthread.html index 0d4c7e02..3372b17f 100644 --- a/docs/refman/cqnthread.html +++ b/docs/refman/cqnthread.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/cursor.html b/docs/refman/cursor.html index 6cbd735d..7478898a 100644 --- a/docs/refman/cursor.html +++ b/docs/refman/cursor.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/cursorloop.html b/docs/refman/cursorloop.html index b161f8ae..e6d665ed 100644 --- a/docs/refman/cursorloop.html +++ b/docs/refman/cursorloop.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/databasedeclaration.html b/docs/refman/databasedeclaration.html index 57df9189..efd4e576 100644 --- a/docs/refman/databasedeclaration.html +++ b/docs/refman/databasedeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/databasestatement.html b/docs/refman/databasestatement.html index 7563c27e..4f7d0355 100644 --- a/docs/refman/databasestatement.html +++ b/docs/refman/databasestatement.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/declaration.html b/docs/refman/declaration.html index 3e1c5dbc..53c6775b 100644 --- a/docs/refman/declaration.html +++ b/docs/refman/declaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/directive.html b/docs/refman/directive.html index 40ce318d..952695bc 100644 --- a/docs/refman/directive.html +++ b/docs/refman/directive.html @@ -1,5 +1,5 @@ - + @@ -549,7 +549,7 @@
$musymbol:<text>
+$musymbol:<text>
When using the m or M conversion specifier in a printf statement, the @@ -557,7 +557,7 @@
$connecterror:accept
+ +By default, errors during +connection marks the database as unavailable, such that +further use of it is prevented. With this directive errors +during connection are handled like any other error. It +should not normally be used as it can have several +unwanted side effects including connection storms and +further errors later on.
+ +$useroption:name
$userswitch:name
diff --git a/docs/refman/directives.html b/docs/refman/directives.html
index 4b6f874c..aedda185 100644
--- a/docs/refman/directives.html
+++ b/docs/refman/directives.html
@@ -1,5 +1,5 @@
-
+
@@ -549,7 +549,7 @@ DIRECTIVES
starts after the calculated time.
$musymbol:<text>
+$musymbol:<text>
When using the m or M conversion specifier in a printf statement, the @@ -557,7 +557,7 @@
$connecterror:accept
+ +By default, errors during +connection marks the database as unavailable, such that +further use of it is prevented. With this directive errors +during connection are handled like any other error. It +should not normally be used as it can have several +unwanted side effects including connection storms and +further errors later on.
+ +$useroption:name
$userswitch:name
diff --git a/docs/refman/double.html b/docs/refman/double.html
index 68bee347..70b4706c 100644
--- a/docs/refman/double.html
+++ b/docs/refman/double.html
@@ -1,5 +1,5 @@
-
+
diff --git a/docs/refman/executionblock.html b/docs/refman/executionblock.html
index b0074803..7478898a 100644
--- a/docs/refman/executionblock.html
+++ b/docs/refman/executionblock.html
@@ -1,5 +1,5 @@
-
+
diff --git a/docs/refman/expression.html b/docs/refman/expression.html
index 379ada62..098b5826 100644
--- a/docs/refman/expression.html
+++ b/docs/refman/expression.html
@@ -1,5 +1,5 @@
-
+
@@ -234,10 +234,11 @@ CONSTANTS
potentially followed by uppercase, underscore or digits are
also string constants. Except when used in the $if
$then directive, attempts at using non existing
-environment variables cause a warning to be displayed. Due
-to the fact that expressions are always calculated as all
-three simple types, you can assign such environment
-variables to integers and doubles.
Please note that $ followed by lower case are directives, so you cannot diff --git a/docs/refman/file.html b/docs/refman/file.html index a6cb8069..af34905e 100644 --- a/docs/refman/file.html +++ b/docs/refman/file.html @@ -1,5 +1,5 @@ - + @@ -98,14 +98,10 @@
v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)Please note that $ followed by lower case are directives, so you cannot diff --git a/docs/refman/functiondeclaration.html b/docs/refman/functiondeclaration.html index f61b26c4..ffcd2d25 100644 --- a/docs/refman/functiondeclaration.html +++ b/docs/refman/functiondeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/histogram.html b/docs/refman/histogram.html index 802bb85e..f5c34c14 100644 --- a/docs/refman/histogram.html +++ b/docs/refman/histogram.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/histogram_a.html b/docs/refman/histogram_a.html index 32362a9c..b4484fe3 100644 --- a/docs/refman/histogram_a.html +++ b/docs/refman/histogram_a.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/identifier.html b/docs/refman/identifier.html index 97d64303..63940ca7 100644 --- a/docs/refman/identifier.html +++ b/docs/refman/identifier.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/if.html b/docs/refman/if.html index b0074803..9ed863da 100644 --- a/docs/refman/if.html +++ b/docs/refman/if.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/ifstatement.html b/docs/refman/ifstatement.html index 408e233f..9ed863da 100644 --- a/docs/refman/ifstatement.html +++ b/docs/refman/ifstatement.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/include.html b/docs/refman/include.html index bbdb6671..8efaa914 100644 --- a/docs/refman/include.html +++ b/docs/refman/include.html @@ -1,5 +1,5 @@ - + @@ -74,9 +74,10 @@
If the filename is embedded within the characters < and > instead of diff --git a/docs/refman/integer.html b/docs/refman/integer.html index 5d204497..7b88c5a2 100644 --- a/docs/refman/integer.html +++ b/docs/refman/integer.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/lobdeclaration.html b/docs/refman/lobdeclaration.html index 1a2d5842..b8f806d7 100644 --- a/docs/refman/lobdeclaration.html +++ b/docs/refman/lobdeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/longoption.html b/docs/refman/longoption.html index d2d4e0be..dafdb95e 100644 --- a/docs/refman/longoption.html +++ b/docs/refman/longoption.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/loop.html b/docs/refman/loop.html index 408e233f..9ed863da 100644 --- a/docs/refman/loop.html +++ b/docs/refman/loop.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/multiprocess.html b/docs/refman/multiprocess.html index 4c418549..f0b16bf4 100644 --- a/docs/refman/multiprocess.html +++ b/docs/refman/multiprocess.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/netthroughput.html b/docs/refman/netthroughput.html index 41c34107..9755ee65 100644 --- a/docs/refman/netthroughput.html +++ b/docs/refman/netthroughput.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/ociping.html b/docs/refman/ociping.html index d95f45b9..e2473a7e 100644 --- a/docs/refman/ociping.html +++ b/docs/refman/ociping.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oerstats.html b/docs/refman/oerstats.html index 85d9c671..a3292cb2 100644 --- a/docs/refman/oerstats.html +++ b/docs/refman/oerstats.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltp.html b/docs/refman/oltp.html index fbe6d902..9f59d81b 100644 --- a/docs/refman/oltp.html +++ b/docs/refman/oltp.html @@ -1,5 +1,5 @@ - + @@ -276,7 +276,7 @@
oltpcheckkey(2rwl), oltpcore(2rwl), oltpcreate(2rwl), oltpday(2rwl), oltpdrop(2rwl), oltpfilloe(2rwl), oltpforever(2rwl), -oltpforever2(2rwl), oltpparams(2rwl), oltpplot(2rwl), +oltpforever2(2rwl), oltpparams(2rwl), oltpplot(2rwl), oltprun(2rwl), oltpscale(2rwl), oltpscalereport(2rwl), oltpsetup(2rwl), oltpverify(2rwl), oltpplus(2rwl), rwloadsim(1rwl), oltpdirectory(2rwl), diff --git a/docs/refman/oltpdirectory.html b/docs/refman/oltpdirectory.html index d787cc53..68354f00 100644 --- a/docs/refman/oltpdirectory.html +++ b/docs/refman/oltpdirectory.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltpforever.html b/docs/refman/oltpforever.html index fb353e62..9a11c16f 100644 --- a/docs/refman/oltpforever.html +++ b/docs/refman/oltpforever.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltpplot.html b/docs/refman/oltpplot.html index e2528c90..9fd0b3f8 100644 --- a/docs/refman/oltpplot.html +++ b/docs/refman/oltpplot.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltpsetup.html b/docs/refman/oltpsetup.html index 2fb00260..8f6ea154 100644 --- a/docs/refman/oltpsetup.html +++ b/docs/refman/oltpsetup.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltpxc.html b/docs/refman/oltpxc.html index 650a5d6c..c0ce9d63 100644 --- a/docs/refman/oltpxc.html +++ b/docs/refman/oltpxc.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/oltpxcset.html b/docs/refman/oltpxcset.html index 9a8d8a4d..2b34a2cc 100644 --- a/docs/refman/oltpxcset.html +++ b/docs/refman/oltpxcset.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/percentiles.html b/docs/refman/percentiles.html index 835f42e8..4b2fcf30 100644 --- a/docs/refman/percentiles.html +++ b/docs/refman/percentiles.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/persec.html b/docs/refman/persec.html index 3eab0922..c8f511ca 100644 --- a/docs/refman/persec.html +++ b/docs/refman/persec.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/persec_a.html b/docs/refman/persec_a.html index 51dd7102..2bc8477a 100644 --- a/docs/refman/persec_a.html +++ b/docs/refman/persec_a.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/printfstatement.html b/docs/refman/printfstatement.html index 30cb1571..68bcc4b2 100644 --- a/docs/refman/printfstatement.html +++ b/docs/refman/printfstatement.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/printline.html b/docs/refman/printline.html index 0591f53e..af34905e 100644 --- a/docs/refman/printline.html +++ b/docs/refman/printline.html @@ -1,5 +1,5 @@ - + @@ -98,14 +98,10 @@
v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)Each such file provided to rwloadsim (including implicitly using -x) must diff --git a/docs/refman/rwlprogram.html b/docs/refman/rwlprogram.html index edd81c6b..21ecb00f 100644 --- a/docs/refman/rwlprogram.html +++ b/docs/refman/rwlprogram.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/rwlrun.html b/docs/refman/rwlrun.html index 02fb54bc..16dc307e 100644 --- a/docs/refman/rwlrun.html +++ b/docs/refman/rwlrun.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/scalardeclaration.html b/docs/refman/scalardeclaration.html index 3cbd6640..6a95e7da 100644 --- a/docs/refman/scalardeclaration.html +++ b/docs/refman/scalardeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/simpledeclaration.html b/docs/refman/simpledeclaration.html index 1fcd2b56..c5b00a33 100644 --- a/docs/refman/simpledeclaration.html +++ b/docs/refman/simpledeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqldeclaration.html b/docs/refman/sqldeclaration.html index 8c35ede1..117920d0 100644 --- a/docs/refman/sqldeclaration.html +++ b/docs/refman/sqldeclaration.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlexecution.html b/docs/refman/sqlexecution.html index 71a01618..8120d74e 100644 --- a/docs/refman/sqlexecution.html +++ b/docs/refman/sqlexecution.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlid2file.html b/docs/refman/sqlid2file.html index 6fb6b4d9..6eb5ec65 100644 --- a/docs/refman/sqlid2file.html +++ b/docs/refman/sqlid2file.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlmonitor.html b/docs/refman/sqlmonitor.html index 3068eaa0..f38d75bc 100644 --- a/docs/refman/sqlmonitor.html +++ b/docs/refman/sqlmonitor.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlmonitorawr.html b/docs/refman/sqlmonitorawr.html index 5a4e2281..a064168f 100644 --- a/docs/refman/sqlmonitorawr.html +++ b/docs/refman/sqlmonitorawr.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlreport.html b/docs/refman/sqlreport.html index 2398f0f0..9aa0252e 100644 --- a/docs/refman/sqlreport.html +++ b/docs/refman/sqlreport.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sqlstatement.html b/docs/refman/sqlstatement.html index 8877e5c4..4132cdd0 100644 --- a/docs/refman/sqlstatement.html +++ b/docs/refman/sqlstatement.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/statement.html b/docs/refman/statement.html index d5f10e11..cafb42ed 100644 --- a/docs/refman/statement.html +++ b/docs/refman/statement.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/statementlist.html b/docs/refman/statementlist.html index 1997da8f..ebd58fc1 100644 --- a/docs/refman/statementlist.html +++ b/docs/refman/statementlist.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/statistics.html b/docs/refman/statistics.html index 607fde38..587bb81e 100644 --- a/docs/refman/statistics.html +++ b/docs/refman/statistics.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/string.html b/docs/refman/string.html index 7b5947ec..1c7e7952 100644 --- a/docs/refman/string.html +++ b/docs/refman/string.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/sysres.html b/docs/refman/sysres.html index f2790670..0e8cca30 100644 --- a/docs/refman/sysres.html +++ b/docs/refman/sysres.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/thread.html b/docs/refman/thread.html index 6d2f03b4..fd92c645 100644 --- a/docs/refman/thread.html +++ b/docs/refman/thread.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/threadexecution.html b/docs/refman/threadexecution.html index 1040593c..1aceb058 100644 --- a/docs/refman/threadexecution.html +++ b/docs/refman/threadexecution.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/threads.html b/docs/refman/threads.html index 3afabd3a..fd92c645 100644 --- a/docs/refman/threads.html +++ b/docs/refman/threads.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/userhelp.html b/docs/refman/userhelp.html index c6da5c2b..8d2ca8d9 100644 --- a/docs/refman/userhelp.html +++ b/docs/refman/userhelp.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/useroption.html b/docs/refman/useroption.html index 995641d6..db003244 100644 --- a/docs/refman/useroption.html +++ b/docs/refman/useroption.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/userswitch.html b/docs/refman/userswitch.html index c6da5c2b..8d2ca8d9 100644 --- a/docs/refman/userswitch.html +++ b/docs/refman/userswitch.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/utilities.html b/docs/refman/utilities.html index 9abb6eb5..2d421283 100644 --- a/docs/refman/utilities.html +++ b/docs/refman/utilities.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/variable.html b/docs/refman/variable.html index 57bb23b0..8225d381 100644 --- a/docs/refman/variable.html +++ b/docs/refman/variable.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/while.html b/docs/refman/while.html index 723e43b3..8251226c 100644 --- a/docs/refman/while.html +++ b/docs/refman/while.html @@ -1,5 +1,5 @@ - + diff --git a/docs/refman/writeline.html b/docs/refman/writeline.html index 3fd2361f..969e97ae 100644 --- a/docs/refman/writeline.html +++ b/docs/refman/writeline.html @@ -1,5 +1,5 @@ - + @@ -98,14 +98,10 @@
v := e
-
-v >= e
v >= +e
-Open a file for writing. The -first operator, which will be deprecated and eventually -desupported, is kept for legacy reasons, and it is suggested -that new code uses the second.
+Open a file for writing.
v >>= e
@@ -145,7 +141,9 @@If the concatenation is null the file will be closed or the @@ -174,6 +172,9 @@
For more +advanced output, use printfstatement(1rwl).
+fflush v
@@ -288,15 +289,15 @@In previous -versions of rwloadsim, only the := assignment -operator existed and the contents of the concatenation was +versions of rwloadsim, the := assignment operator +existed and the contents of the concatenation was interpreted to open for read, write, append or as pipelines. The actual operation was chosen by having an initial "<", ">>", "|" or a -final "|" in the concatenation. There is a -security concern with this, and it is therefore deprecated -and will be desupported in release 3.1. As of version 3.0.6 -you will get a warning for the deprecated usage.
+final "|" in the concatenation. Without any of +these, the file would be opened for writing. There is a +security concern with this, and it is therefore desupported +in release 3.1.variable(1rwl), statement(1rwl), threadexecution(1rwl), expression(1rwl), -readloop(1rwl), compoundstatement(1rwl)
+readloop(1rwl), compoundstatement(1rwl), +printfstatement(1rwl), regex(1rwl)%4d | succesful logons |
%4d | %s |
The keyword can be prefixed with either "queue" or @@ -187,6 +188,11 @@
You can +overwrite the everyuntil variable if your programming +has a requirement to use a different expected time to start +the next loop.
+The following -lists predefined variables that all are read only.
+lists predefined variables that are read only except when +explicitly noted.
- A double variable that is used in control loop. For -every loop, it is calculated as the expected time-stamp to -start the next loop. |
+|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -305,7 +307,8 @@ SEE ALSOsimpledeclaration(1rwl), -statement(1rwl), declaration(1rwl) expression(1rwl) +statement(1rwl), declaration(1rwl) expression(1rwl), +controlloop(1rwl)diff --git a/docs/refman/variable.html b/docs/refman/variable.html index 8225d381..af31db84 100644 --- a/docs/refman/variable.html +++ b/docs/refman/variable.html @@ -1,5 +1,5 @@ - + @@ -73,7 +73,8 @@ PREDEFINED VARIABLESThe following -lists predefined variables that all are read only. +lists predefined variables that are read only except when +explicitly noted.
The following +parameters control connection storms: + + +cstorm_start
+ The first parameter sets the +time when the connection storm will start. The next two +parameters sets the count of threads that will block a +session and for how long that block will take place. If +cstorm_threads has its default value of zero, there +will be no storm from blocking sessions. The two last +parameters set the number of extra logons to establish, and +the rate in logons per second. If cstorm_xtra_logons +has its default value of zero, not extra logons will be +started. + +You can combine +the connection storm with the first type of burst mentioned +above. + +Note that this +is an experimental feature that may change in a future +release. +24H SIMULATIONdiff --git a/man/man2rwl/oltpsetup.2rwl b/man/man2rwl/oltpsetup.2rwl index d93214b7..786d8991 100644 --- a/man/man2rwl/oltpsetup.2rwl +++ b/man/man2rwl/oltpsetup.2rwl @@ -539,6 +539,41 @@ The two first parameters (double) set the time to start and the length of the de the two latter parameter (integer) are the min and max number of sessions in the normal pool during the delay. If \fBdelay_length\fR is zero, no delay will take place. .RE +.SH "CONNECTION STORMS" +You can emulate connection storms starting a certain timestamp during the run. +The storm can come from two souces: +.TP 4 +1. +Having a subset of worker threads that block a session while otherwise doing nothing. +At the same time, an other set of worker threads will get active and as a consequence +the session pool will increase its size, while the expected arrival rate stays the same. +.TP 4 +2. +Making a number of database logons that are kept open but without doing any actual activity. +.P +The following parameters control connection storms: +.P +.nf +\fBcstorm_start\fR +\fBcstorm_threads\fR +\fBcstorm_period\fR +\fBcstorm_xtra_logons\fR +\fBcstorm_xtra_rate\fR +.fi +.RS 4 +The first parameter sets the time when the connection storm will start. +The next two parameters sets the count of threads that will block a session and for how long +that block will take place. +If \fBcstorm_threads\fR has its default value of zero, there will be no storm from blocking sessions. +The two last parameters set the number of extra logons to establish, and the rate +in logons per second. +If \fBcstorm_xtra_logons\fR has its default value of zero, not extra logons will be started. +.RE +.P +You can combine the connection storm with the first type of burst mentioned above. +.P +Note that this is an experimental feature that may change in a future release. +.P .SH "24H SIMULATION" You can use oltprun to simulate a full day workload with variation over time (day/night) and with inclusion of variout types of "issues" at intervals during the run. diff --git a/oltp/cstorm_implementation.rwl b/oltp/cstorm_implementation.rwl index 5dfc5c8c..4b708696 100644 --- a/oltp/cstorm_implementation.rwl +++ b/oltp/cstorm_implementation.rwl @@ -2,6 +2,7 @@ # Licensed under the Universal Permissive License v 1.0 # as shown at https://oss.oracle.com/licenses/upl/ +# bengsig 26-mar-2024 - Various fixes # bengsig 19-mar-2024 - Created # # Implement a connection storm @@ -26,8 +27,7 @@ database storm_results username results_username password results_password connect results_connect - sessionpool 1..5 - default; + sessionpool 1..5; # time logon completed (or failed) # and when we did logoff @@ -48,7 +48,7 @@ private procedure trylogon(double bt) nostatistics # If logon was succesfull, do a simple ociping ociping; end if; - wait cstorm_start - logonend + cstorm_period; + wait cstorm_period; logofftime := runseconds(); end; @@ -74,7 +74,7 @@ run for start cstorm_start + threadnumber / cstorm_xtra_rate count 1 loop double btim := runseconds(); trylogon(btim) at rwl_run_storm; - saveres(btim, logonend, logofftime, oraerror, oraerrortext); + saveres(btim, logonend, logofftime, oraerror, oraerrortext) at storm_results; end loop; end threads; end run; diff --git a/oltp/run.rwl b/oltp/run.rwl index 904135a9..0da3ecbc 100644 --- a/oltp/run.rwl +++ b/oltp/run.rwl @@ -2,6 +2,7 @@ # Licensed under the Universal Permissive License v 1.0 # as shown at https://oss.oracle.com/licenses/upl/ +# bengsig 26-mar-2024 - cstorm fixes # bengsig 19-mar-2024 - cstorm # bengsig 5-mar-2024 - dtime, atime # bengsig 24-jan-2024 - batch start depends on rampfactor @@ -132,37 +133,48 @@ random procedure array call_real procedure grab_session() ociping; - wait cstorm_period; + wait cstorm_period - (runseconds() - cstorm_start); end; -procedure doeither() +procedure call_real_or_timeout() +# nofail set to non-zero implies a silent fail without +# call to call_failure, which is used to drain below $if time_out is not null $then if runseconds() > everyuntil+time_out then call_failure(""); else + call_real(); + end if; +$else + call_real(); $endif +end call_real_or_timeout; + +procedure doeither() $if cstorm_threads $then + # we need to make sure there are threadcount active threads both inside + # and outside the cstorm period, but also that is is a different set + # of threads that get active if runseconds() between cstorm_start and cstorm_start + cstorm_period then - if threadnumber between threadcount+1 and threadcount + cstorm_threads then - call_real(); - else - null; - end if; + # inside the storm period if threadnumber between threadcount-cstorm_threads+1 and threadcount then grab_session(); + everyuntil := runseconds(); # flushes the queue else - call_real(); + call_real_or_timeout(); end if; else - call_real(); + # outside storm + if threadnumber <= threadcount or threadnumber > threadcount + cstorm_threads then + # The 3 seconds drain here is just taken randomly and it implies the threads + # that we did the grab_session() on get drained rather than showing a huge + # call_failure amount. + call_real_or_timeout(); + end if; end if; $else - call_real(); -$endif - -$if time_out is not null $then - end if; + call_real_or_timeout(); $endif end; From a681eb96130c1111984c820c815ccdaff912155e Mon Sep 17 00:00:00 2001 From: Bjorn Kisbye EngsigAsh data * | $svgash | ${runnumber}_ash.png | Extra connection storm | ${runnumber}_cstorm.svg | ${runnumber}_cstorm.png | ORA errors * |
+ ${runnumber}_oerpivot.svg |
+ ${runnumber}_oerpivot.png |
+ ORA errors * | ${runnumber}_oerpivot.svg | ${runnumber}_oerpivot.png | Extra connection storm by initiated |
+ ${runnumber}_cstormbeg.svg |
+ ${runnumber}_cstormbeg.png |
+ Extra connection storm by logged on |
+ ${runnumber}_cstormend.svg |
+ ${runnumber}_cstormend.png |
+ Fractiles of execution times | ${runnumber}_fractiles.svg | ${runnumber}_fractiles.png | End-to-end times for make_order | ${runnumber}_mo_waitexec.svg | ${runnumber}_mo_waitexec.png | SEE ALSO
oltpforever2(2rwl), oltpparams(2rwl), oltpplot(2rwl),
oltprun(2rwl), oltpscale(2rwl), oltpscalereport(2rwl),
oltpsetup(2rwl), oltpverify(2rwl), oltpplus(2rwl),
-rwloadsim(1rwl), oltpdirectory(2rwl),
-oltprunnumber(2rwl)
+rwloadsim(1rwl), oltpdirectory(2rwl), oltprunnumber(2rwl),
+oltpping(2rwl)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database cpu and time | ${runnumber}.svg | ${runnumber}.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sessions and instances | ${runnumber}_instdist.svg | ${runnumber}_instdist.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Throughput | ${runnumber}_tp.svg | ${runnumber}_tp.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End2end timing (ms) | ${runnumber}_e2e.svg | ${runnumber}_e2e.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -751,9 +752,15 @@ EXAMPLES
# Print a line telling if this is executed by root or not
printline access("/root","dw") ? "you are root" : "you are not root";
-
# Print the value of a, then a :, then the value of d.
-printline a ":" d;
+printline a ":" d;
+
+
+# Use of the conditional operator
+string ss :=
+ a = 1 ? "one" :
+ a = 2 ? "two" :
+ "something else";
OPERATORS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -751,9 +752,15 @@ EXAMPLES
# Print a line telling if this is executed by root or not
printline access("/root","dw") ? "you are root" : "you are not root";
-
# Print the value of a, then a :, then the value of d.
-printline a ":" d;
+printline a ":" d;
+
+
+# Use of the conditional operator
+string ss :=
+ a = 1 ? "one" :
+ a = 2 ? "two" :
+ "something else";
OPERATORS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -751,9 +752,15 @@ EXAMPLES
# Print a line telling if this is executed by root or not
printline access("/root","dw") ? "you are root" : "you are not root";
-
# Print the value of a, then a :, then the value of d.
-printline a ":" d;
+printline a ":" d;
+
+
+# Use of the conditional operator
+string ss :=
+ a = 1 ? "one" :
+ a = 2 ? "two" :
+ "something else";
OPERATORS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -751,9 +752,15 @@ EXAMPLES
# Print a line telling if this is executed by root or not
printline access("/root","dw") ? "you are root" : "you are not root";
-
# Print the value of a, then a :, then the value of d.
-printline a ":" d;
+printline a ":" d;
+
+
+# Use of the conditional operator
+string ss :=
+ a = 1 ? "one" :
+ a = 2 ? "two" :
+ "something else";
DESCRIPTION (approximately) the same time, and unless the start time is explicitly set to non-zero, this means starting at the same time. The actual time with reference to this common start -time is returned by the predefined variable runseconds. In -order to ensure reasonable ramp-up to e.g. start database +time is returned by the function call runseconds(). In order +to ensure reasonable ramp-up to e.g. start database connections in session pools, or to actually start operating system threads, rwloadsim has a built-in delay from the clock time it is called until this 0s time when control loops really start processing; the default is 5s. If you use -the value of runseconds before this common control loop -start time, it will have a negative value. +call runseconds() before this common control loop start +time, it will return a negative value.There is no requirement to use a control loop, but if you do not, diff --git a/docs/refman/rwlcpu.html b/docs/refman/rwlcpu.html index 19cd1fb3..683d79f3 100644 --- a/docs/refman/rwlcpu.html +++ b/docs/refman/rwlcpu.html @@ -1,5 +1,5 @@ - + @@ -114,9 +114,10 @@ COLUMNSsecond You must arrange for your -rwloadsim program to insert the value of the runseconds -variable into this column. In the aggregate view, rwlcpu_a, -the values will be rounded to a whole second. +rwloadsim program to insert the value returned by the +runseconds() function into this column. In the aggregate +view, rwlcpu_a, the values will be rounded to a whole +second.cliusr diff --git a/docs/refman/rwlcpu_a.html b/docs/refman/rwlcpu_a.html index ca8f5538..579dc64a 100644 --- a/docs/refman/rwlcpu_a.html +++ b/docs/refman/rwlcpu_a.html @@ -1,5 +1,5 @@ - + @@ -114,9 +114,10 @@COLUMNSsecond You must arrange for your -rwloadsim program to insert the value of the runseconds -variable into this column. In the aggregate view, rwlcpu_a, -the values will be rounded to a whole second. +rwloadsim program to insert the value returned by the +runseconds() function into this column. In the aggregate +view, rwlcpu_a, the values will be rounded to a whole +second.cliusr diff --git a/docs/refman/rwloadsim.html b/docs/refman/rwloadsim.html index 924ac0b7..a03de422 100644 --- a/docs/refman/rwloadsim.html +++ b/docs/refman/rwloadsim.html @@ -1,5 +1,5 @@ - + @@ -455,7 +455,8 @@OPTIONS --errortimeAugment all execution time -errors with the value of the runseconds variable. +errors with the value returned by the runseconds() +function.-T --vi-tags filename diff --git a/docs/refman/statement.html b/docs/refman/statement.html index d2558d61..a355db44 100644 --- a/docs/refman/statement.html +++ b/docs/refman/statement.html @@ -1,5 +1,5 @@ - + @@ -205,8 +205,8 @@SIMPLE STATEMENTSgetrusage Call the getrusage function -filling in values for the usrseconds and sysseconds -variables. +filling in values for the usrseconds and +sysseconds variables.abort diff --git a/docs/refman/statementlist.html b/docs/refman/statementlist.html index e2949085..a355db44 100644 --- a/docs/refman/statementlist.html +++ b/docs/refman/statementlist.html @@ -1,5 +1,5 @@ - + @@ -205,8 +205,8 @@SIMPLE STATEMENTSgetrusage Call the getrusage function -filling in values for the usrseconds and sysseconds -variables. +filling in values for the usrseconds and +sysseconds variables.abort diff --git a/docs/refman/sysres.html b/docs/refman/sysres.html index 0e8cca30..4e39e914 100644 --- a/docs/refman/sysres.html +++ b/docs/refman/sysres.html @@ -1,5 +1,5 @@ - + @@ -97,8 +97,8 @@COLUMNSsecond You must arrange for your -rwloadsim program to insert the value of runseconds into -this column. +rwloadsim program to insert the value returned by +runseconds() into this column.resname diff --git a/man/man1rwl/controlloop.1rwl b/man/man1rwl/controlloop.1rwl index 6152d3ed..c2ad1f96 100644 --- a/man/man1rwl/controlloop.1rwl +++ b/man/man1rwl/controlloop.1rwl @@ -37,14 +37,14 @@ All control loops (in all threads) have their timings coordinated at (approximately) the same time, and unless the start time is explicitly set to non-zero, this means starting at the same time. The actual time with reference to this common start time is -returned by the predefined variable runseconds. +returned by the function call runseconds(). In order to ensure reasonable ramp-up to e.g. start database connections in session pools, or to actually start operating system threads, rwloadsim has a built-in delay from the clock time it is called until this 0s time when control loops really start processing; the default is 5s. -If you use the value of runseconds before this common control loop start time, -it will have a negative value. +If you use call runseconds() before this common control loop start time, +it will return a negative value. .P There is no requirement to use a control loop, but if you do not, execution in threads will start as soon as the thread is created. diff --git a/man/man1rwl/rwlcpu.1rwl b/man/man1rwl/rwlcpu.1rwl index adfd0528..622737ce 100644 --- a/man/man1rwl/rwlcpu.1rwl +++ b/man/man1rwl/rwlcpu.1rwl @@ -62,7 +62,7 @@ In the aggregate view, rwlcpu_a, the total process count is in the pcount column .P \fBsecond\fR .RS 4 -You must arrange for your rwloadsim program to insert the value of the runseconds variable +You must arrange for your rwloadsim program to insert the value returned by the runseconds() function into this column. In the aggregate view, rwlcpu_a, the values will be rounded to a whole second. .RE diff --git a/man/man1rwl/rwloadsim.1rwl b/man/man1rwl/rwloadsim.1rwl index b2b145e1..f9830f76 100644 --- a/man/man1rwl/rwloadsim.1rwl +++ b/man/man1rwl/rwloadsim.1rwl @@ -320,7 +320,7 @@ This is the default and is therefore a no-op. .PP .B -W --errortime .RS 4 -Augment all execution time errors with the value of the runseconds variable. +Augment all execution time errors with the value returned by the runseconds() function. .RE .PP .B -T --vi-tags filename diff --git a/man/man1rwl/statement.1rwl b/man/man1rwl/statement.1rwl index aa2b2181..fcd0cc17 100644 --- a/man/man1rwl/statement.1rwl +++ b/man/man1rwl/statement.1rwl @@ -141,7 +141,7 @@ if you need the return value, use the system function in stead. .PP \fBgetrusage\fR .RS 4 -Call the getrusage function filling in values for the usrseconds and sysseconds variables. +Call the getrusage function filling in values for the \fBusrseconds\fR and \fBsysseconds\fR variables. .RE .PP \fBabort\fR diff --git a/man/man1rwl/sysres.1rwl b/man/man1rwl/sysres.1rwl index 5f2c8bd2..cf404047 100644 --- a/man/man1rwl/sysres.1rwl +++ b/man/man1rwl/sysres.1rwl @@ -41,7 +41,7 @@ into this column. .P \fBsecond\fR .RS 4 -You must arrange for your rwloadsim program to insert the value of runseconds +You must arrange for your rwloadsim program to insert the value returned by runseconds() into this column. .RE .P From 0ee7b0260e2715baf46f149547b44eac6b82ece5 Mon Sep 17 00:00:00 2001 From: Bjorn Kisbye EngsigThroughput | ${runnumber}_tp.svg | ${runnumber}_tp.png | End2end timing (ms) | ${runnumber}_e2e.svg | ${runnumber}_e2e.png | ' + cat >> $awrdirectory$subdir$runnumber/index.html < Database server cpu * |
+ ${runnumber}_osstat.svg |
+ ${runnumber}_osstat.png |
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Individual throughput | ${runnumber}_tp.svg | ${runnumber}_tp.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ping rates * | ${runnumber}_ping.svg | ${runnumber}_ping.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database server cpu * | +${runnumber}_osstat.svg | +${runnumber}_osstat.png | +|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fractiles of execution times | ${runnumber}_fractiles.svg | ${runnumber}_fractiles.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
$fracttext | ${runnumber}_fractiles.svg | ${runnumber}_fractiles.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End-to-end times for make_order | ${runnumber}_mo_waitexec.svg | ${runnumber}_mo_waitexec.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End-to-end times for query_order | ${runnumber}_qo_waitexec.svg | ${runnumber}_qo_waitexec.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End-to-end times for search_products | ${runnumber}_sp_waitexec.svg | ${runnumber}_sp_waitexec.png | Database server cpu * | +Database server cpu (per instance) * | ${runnumber}_osstat.svg | ${runnumber}_osstat.png | +|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database server cpu (total) * | +${runnumber}_osstatg.svg | +${runnumber}_osstatg.png | +|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database server cpu * | +Database server cpu (per instance) * | ${runnumber}_osstat.svg | ${runnumber}_osstat.png | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database server cpu (total) | +${runnumber}_osstatg.svg | +${runnumber}_osstatg.png | +|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Awr report(s) | ${runnumber}_awr.html | $xtraawrs||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Throughput and resources * | ${runnumber}.svg | ${runnumber}.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
$sesinsttext * | ${runnumber}_instdist.svg | ${runnumber}_instdist.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Buffer cache/shared pool | ${runnumber}_bcache.svg | ${runnumber}_bcache.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Database memory | ${runnumber}_memory.svg | ${runnumber}_memory.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Buffer cache | ${runnumber}_bcache.svg | ${runnumber}_bcache.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shared pool | ${runnumber}_sharedp.svg | ${runnumber}_sharedp.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PGA | ${runnumber}_pga.svg | ${runnumber}_pga.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Individual throughput | ${runnumber}_tp.svg | ${runnumber}_tp.png | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ping rates * | ${runnumber}_ping.svg | ${runnumber}_ping.png |
- Output using X-Windows when DISPLAY is properly set. |
+||
@@ -77,7 +78,7 @@ SYNOPSIS
Create an image file in png format. | ||
@@ -88,8 +89,8 @@ SYNOPSIS
Create an image file in svg format potentially with the -svgmouse option. |
All output is @@ -148,10 +149,10 @@
--fromminutes=n
+--fromminutes=N
Output will be limited to only -include data from at most n minutes ago. If you use this +include data from at most N minutes ago. If you use this option together with either of the previous two, time limits from all will apply.
@@ -178,11 +179,11 @@--svgmouse
+--no-svgmouse
If an svg file is being output, -embed mouse javascript code in the file; this allows -clicking the file when shown in a browser.
+do not include mouse javascript code in the file. This is +only relevant if your gnuplot version is older than 4.6.--include-sys
@@ -224,6 +225,25 @@--autoupdate=N
+
+--maxautoupdate=N
When using X-Windows or +Microsoft Windows to output the graph, you can use the +--autoupdate option to make the graph updated every so +often. As a result you will see a continuously updated +window similar to how performance tools do it. The display +will finish after 3600s, unless a different value is set +using --maxautoupdate or it is terminated by pressing +ctrl-c.
+ +When using auto +update, --output-X and --fromminutes=5 are set by default, +and none of the options --fromtime, --totime, --dbid and +those handling image file output are used.
+title text
diff --git a/docs/refman/directive.html b/docs/refman/directive.html index 91dc7546..df2c1e12 100644 --- a/docs/refman/directive.html +++ b/docs/refman/directive.html @@ -1,5 +1,5 @@ - + @@ -320,7 +320,9 @@$ora01013:continue
-$ora01013:stop
Normally, ctrl-c leads to a controlled stop of the executing rwloadsim process although @@ -329,6 +331,15 @@
The two last +directives are used to allow some clean-up to be done after +issuing ctrl-c: The third directive implies ctrl-c will +break any procedure, including anonymous procedures +executing directly in your main program, but your rwl +program will otherwise continue. To allow subsequent +procedures to be executed, use the fourth directive. For an +example, see ashplot(2rwl).
+$bindoffset:0
diff --git a/docs/refman/directives.html b/docs/refman/directives.html index 3e530f8a..df2c1e12 100644 --- a/docs/refman/directives.html +++ b/docs/refman/directives.html @@ -1,5 +1,5 @@ - + @@ -320,7 +320,9 @@$ora01013:continue
-$ora01013:stop
Normally, ctrl-c leads to a controlled stop of the executing rwloadsim process although @@ -329,6 +331,15 @@
The two last +directives are used to allow some clean-up to be done after +issuing ctrl-c: The third directive implies ctrl-c will +break any procedure, including anonymous procedures +executing directly in your main program, but your rwl +program will otherwise continue. To allow subsequent +procedures to be executed, use the fourth directive. For an +example, see ashplot(2rwl).
+$bindoffset:0
diff --git a/docs/refman/oltpconnect.html b/docs/refman/oltpconnect.html new file mode 100644 index 00000000..4918077e --- /dev/null +++ b/docs/refman/oltpconnect.html @@ -0,0 +1,185 @@ + + + + + + + + + +oltpconnect +− Provide credentials to some other utility
+ +oltpconnect +[-H|--help]
+ + +$(oltpconnect +[-2] [-p|--pool] [-b|--batch] [-A|--awr] [-S|--system] +[-R|--results] [-r|--run] [-a|--aw] [-o|--oe])
+ +-H
+ +Show short help.
+ + +-A|--awr
+ +Return credentials for the user +doing awr snapshots and reporting.
+ + +-S|--system
+ +Return credentials for the +system user used to run v$ queries etc.
+ + +-C|--cruser
+ +Return credentials for the +system user used to create schemas.
+ + +-R|--results
+ +Return credentials for your +repository user.
+ + +-r|--run
+ +Return credentials for your +normal runtime user. This is the default when no other +options are provided.
+ + +-a|--aw
+ +Return credentials for the user +who owns the artificial workload schema.
+ + +-o|--oe
+ +Return credentials for the user +who owns the order entry schema.
+ +-2
+ +If you are using -r or -a, use +the side 2 version of the schema (as used by +oltpforever2).
+ + +-p|--pool
+ +If you are using -r, -a or -o, +use the pool_connect connect string, otherwise use +normal_connect.
+ + +-b|--batch
+ +If you are using -r, -a or -o, +use the batch_connect connect string, otherwise use +normal_connect.
+ +The +oltpconnect command is used to provide credentials in +the form username/{password}@service such that they can be +provided to some other tool. Note that if stdout is a +terminal, the password will be blank and that the preferred +usage is via your shells command substitution. The primary +usage of the oltpconnect command is to allow you to +show how various tools can be used without revealing +passwords on the screen.
+ +The +oltpconnect command takes no ordinary arguments and +returns the credentials for the rwlrun1 user unless one of +the other schemas is selected using the appropriate +option(s).
+ +Call ashplot +connecting to your system user without the need to show or +type password:
+ +ashplot -l +$(oltpconnect -S) --autoupdate=5
+ +The following +is equivalent to typing oltpplus -r:
+ +sqlplus +$(oltpconnect)
+ +Copyright
+© 2023 Oracle Corporation
+Licensed under the Universal Permissive License v 1.0 as
+shown at https://oss.oracle.com/licenses/upl
oltp(2rwl), +oltpsetup(2rwl), oltpparams(2rwl), oltpplus(2rwl)
+The +oltpconnect(2rwl) command can be used if you want to start +some other tool without showing the password on the +terminal.
+oltp(2rwl), -oltpsetup(2rwl), oltpparams(2rwl)
+oltpsetup(2rwl), oltpparams(2rwl), oltpconnect(2rwl)The rwloadsim +command is a shell script that searches for the Oracle +client library in LD_LIBRARY_PATH and then attemps calling +the actual rwloadsimNN executable where NN is a major +version number such as 19 or 23. This ensures the correct +executable is called with the appropriate Oracle client +library and also allows error reporting in case of +mismatches. You can alternatively call rwloadsimNN directly, +which bypasses these checks.
+Normally, ctrl-c leads to a controlled stop of the executing rwloadsim process although -the exact details of how clean-up is done cannot by +the exact details of how clean-up is done cannot be guaranteed. If you want rwloadsim to continue after receiving an ORA-01013, use the first directive. The second, which is the default, undoes this.
@@ -521,28 +521,34 @@$pre31fileassign:on +
$pre31fileassign:warn
-$pre31fileassign:warn
+$pre31fileassign:on
$pre31fileassign:off
These directives control how -file assignment using the := operator behave. When -the directive is set to on, you can use re-direction +
In previous versions of +rwloadsim, file assignment worked by having redirection characters such as "<", ">>", "|" as part of the name of the file causing the -file to be opened for read, append or as a pipeline. When -set to warn, you will get a runtime warning about -such use, and if set to off, no special character -interpretation will take place. In the current release -(3.0.6), the default is warn; it will be set to -off in release 3.1.
- -It is -recommended that you run your rwloadsim code with -warn, e.g. by putting it in your .rwloadsim.rwl file -and use the generated warnings to modify your code to use -the newer file assignment operators.
+file to be opened for read, append or as a pipeline. +Starting with version 3.1, file assignment can only be done +using the proper assignment operator such as <= to open +for reading. + +If you have +code that uses the previous behavior where the redirection +is part of the string, you can use the first of these +directives. This causes such usage to be accepted but with a +warning that allows you to correct your code.
+ +The second +directive makes the previous behavior accepted +without printing a warning; doing so is not +recommended and the possibility will be removed in a later +release.
+ +The current +behavior can be reset using the third directive.
$niceabort:on
diff --git a/docs/refman/directives.html b/docs/refman/directives.html
index df2c1e12..776978c7 100644
--- a/docs/refman/directives.html
+++ b/docs/refman/directives.html
@@ -1,5 +1,5 @@
-
+
@@ -326,7 +326,7 @@ DIRECTIVES
Normally, ctrl-c leads to a controlled stop of the executing rwloadsim process although -the exact details of how clean-up is done cannot by +the exact details of how clean-up is done cannot be guaranteed. If you want rwloadsim to continue after receiving an ORA-01013, use the first directive. The second, which is the default, undoes this.
@@ -521,28 +521,34 @@$pre31fileassign:on +
$pre31fileassign:warn
-$pre31fileassign:warn
+$pre31fileassign:on
$pre31fileassign:off
These directives control how -file assignment using the := operator behave. When -the directive is set to on, you can use re-direction +
In previous versions of +rwloadsim, file assignment worked by having redirection characters such as "<", ">>", "|" as part of the name of the file causing the -file to be opened for read, append or as a pipeline. When -set to warn, you will get a runtime warning about -such use, and if set to off, no special character -interpretation will take place. In the current release -(3.0.6), the default is warn; it will be set to -off in release 3.1.
- -It is -recommended that you run your rwloadsim code with -warn, e.g. by putting it in your .rwloadsim.rwl file -and use the generated warnings to modify your code to use -the newer file assignment operators.
+file to be opened for read, append or as a pipeline. +Starting with version 3.1, file assignment can only be done +using the proper assignment operator such as <= to open +for reading. + +If you have +code that uses the previous behavior where the redirection +is part of the string, you can use the first of these +directives. This causes such usage to be accepted but with a +warning that allows you to correct your code.
+ +The second +directive makes the previous behavior accepted +without printing a warning; doing so is not +recommended and the possibility will be removed in a later +release.
+ +The current +behavior can be reset using the third directive.
$niceabort:on
diff --git a/docs/refman/sqlmonitor.html b/docs/refman/sqlmonitor.html
index f38d75bc..7ae7e895 100644
--- a/docs/refman/sqlmonitor.html
+++ b/docs/refman/sqlmonitor.html
@@ -1,5 +1,5 @@
-
+
@@ -35,7 +35,7 @@ NAME
-
sqlmonitor.rwl +
sqlmonitor − Create sql monitor from gv$sql views
rwloadsim -[options] -u -l u/p@c sqlmonitor.rwl sqlid
+sqlmonitor +[options] -l u/p@c sqlid
For the -provided sqlid, the sqlmonitor.rwl utility creates sql -monitor from the shared pool of the database using +provided sqlid, the sqlmonitor utility creates a sql monitor +from the shared pool of the database using dbms_sql_monitor.report_sql_monitor. The output is written to a file named with the sqlid and a suffix of .html unless the --output-file option is provided. Use --output-directory @@ -58,19 +58,14 @@
The dbms_sql_monitor.report_sql_monitor has several ways to provide information about which of potentially many sql -monitors to output and some of these are available using -sqlmonitor.rwl
+monitors to output and some of these are available as +options to sqlmonitor.-u
- -Compulsory option to find the -sqlmonitor.rwl script in the public directory.
--l u/p
@@ -138,7 +133,7 @@rwloadsim -ul system/{password} sqlmonitor.rwl 07rw9znc8g7aj+
sqlmonitor -l system/{password} 07rw9znc8g7aj
will create a diff --git a/docs/refman/sqlreport.html b/docs/refman/sqlreport.html index 9aa0252e..84df3b05 100644 --- a/docs/refman/sqlreport.html +++ b/docs/refman/sqlreport.html @@ -1,5 +1,5 @@ - + @@ -35,7 +35,7 @@
sqlreport.rwl +
sqlreport − Create a complete sql report
rwloadsim -[options] -u -l u/p@c sqlreport.rwl sqlid
+sqlreport +[options] -l u/p@c sqlid
For the -provided sqlid, the sqlreport.rwl utility creates sql a full +provided sqlid, the sqlreport utility creates sql a full report by calling dbms_sql_tune.report_sql_detail, using all default options except report_level which is set to ’ALL’. The output is written to a file named @@ -61,11 +61,6 @@
-u
- -Compulsory option to find the -sqlreport.rwl script in the public directory.
--l u/p
@@ -103,7 +98,7 @@rwloadsim -ul system/{password} sqlreport.rwl 07rw9znc8g7aj+
sqlreport -l system/{password} 07rw9znc8g7aj
will create a
diff --git a/man/man1rwl/directive.1rwl b/man/man1rwl/directive.1rwl
index 0602500e..2b3da9fb 100644
--- a/man/man1rwl/directive.1rwl
+++ b/man/man1rwl/directive.1rwl
@@ -263,7 +263,7 @@ The second directive turns this extra error detail off.
.B $ora01013:reset
.RS 4
Normally, ctrl-c leads to a controlled stop of the executing rwloadsim process
-although the exact details of how clean-up is done cannot by guaranteed.
+although the exact details of how clean-up is done cannot be guaranteed.
If you want rwloadsim to continue after receiving an ORA-01013, use the first
directive.
The second, which is the default, undoes this.
@@ -456,24 +456,32 @@ Be default, the flag OCI_SPC_NO_RLB is set, to not set this flag, use the second
directive before the database using a session pool is declared.
.RE
.P
-.B $pre31fileassign:on
-.br
.B $pre31fileassign:warn
.br
+.B $pre31fileassign:on
+.br
.B $pre31fileassign:off
.RS 4
-These directives control how file assignment using the \fB:=\fR operator behave.
-When the directive is set to \fBon\fR, you can use re-direction characters
+In previous versions of rwloadsim, file assignment worked by
+having redirection characters
such as "<", ">>", "|" as part of the name of the file causing the file to
be opened for read, append or as a pipeline.
-When set to \fBwarn\fR, you will get a runtime warning about such use,
-and if set to \fBoff\fR, no special character interpretation will take place.
-In the current release (3.0.6), the default is \fBwarn\fR; it will be set
-to \fBoff\fR in release 3.1.
-.P
-It is recommended that you run your rwloadsim code with \fBwarn\fR, e.g.
-by putting it in your .rwloadsim.rwl file and use the
-generated warnings to modify your code to use the newer file assignment operators.
+Starting with version 3.1, file assignment can only be done using the
+proper assignment operator such as <= to open for reading.
+.P
+If you have code that uses the previous behavior where the
+redirection is part of the string, you can use
+the first of these directives.
+This causes such usage to be accepted but with a warning that
+allows you to correct your code.
+.P
+The second directive makes the previous behavior accepted
+.I without
+printing a warning; doing so is
+.I not
+recommended and the possibility will be removed in a later release.
+.P
+The current behavior can be reset using the third directive.
.P
.RE
.B $niceabort:on
diff --git a/man/man2rwl/sqlmonitor.2rwl b/man/man2rwl/sqlmonitor.2rwl
index 53330148..5f5f2e0c 100644
--- a/man/man2rwl/sqlmonitor.2rwl
+++ b/man/man2rwl/sqlmonitor.2rwl
@@ -1,10 +1,10 @@
.TH sqlmonitor "2rwl" "July 2022" "RWP*Load Simulator" "Utilities Syntax"
.SH NAME
-sqlmonitor.rwl \- Create sql monitor from gv$sql views
+sqlmonitor \- Create sql monitor from gv$sql views
.SH SYNOPSIS
-\fBrwloadsim [options] -u -l u/p@c sqlmonitor.rwl sqlid \fR
+\fBsqlmonitor [options] -l u/p@c sqlid \fR
.P
-For the provided sqlid, the sqlmonitor.rwl utility creates sql monitor from
+For the provided sqlid, the sqlmonitor utility creates a sql monitor from
the shared pool of the database using dbms_sql_monitor.report_sql_monitor.
The output is written to a file named with the sqlid and a suffix of .html
unless the --output-file option is provided.
@@ -13,13 +13,8 @@ the current.
.P
The dbms_sql_monitor.report_sql_monitor has several ways to provide information
about which of potentially many sql monitors to output and some of these
-are available using sqlmonitor.rwl
+are available as options to sqlmonitor.
.SH OPTIONS
-\fB-u\fR
-.RS 4
-Compulsory option to find the sqlmonitor.rwl script in the public directory.
-.RE
-.P
.B -l u/p
.P
.B -l u/p@c
@@ -73,7 +68,7 @@ Exactly one sqlid must be provided.
.SH EXAMPLE
.nf
\fC
-rwloadsim -ul system/{password} sqlmonitor.rwl 07rw9znc8g7aj
+sqlmonitor -l system/{password} 07rw9znc8g7aj
\fR
.fi
.P
diff --git a/man/man2rwl/sqlreport.2rwl b/man/man2rwl/sqlreport.2rwl
index 9bc551c2..8b4471f7 100644
--- a/man/man2rwl/sqlreport.2rwl
+++ b/man/man2rwl/sqlreport.2rwl
@@ -1,10 +1,10 @@
.TH sqlreport "2rwl" "January 2022" "RWP*Load Simulator" "Utilities Syntax"
.SH NAME
-sqlreport.rwl \- Create a complete sql report
+sqlreport \- Create a complete sql report
.SH SYNOPSIS
-\fBrwloadsim [options] -u -l u/p@c sqlreport.rwl sqlid \fR
+\fBsqlreport [options] -l u/p@c sqlid \fR
.P
-For the provided sqlid, the sqlreport.rwl utility creates sql a full report by
+For the provided sqlid, the sqlreport utility creates sql a full report by
calling dbms_sql_tune.report_sql_detail, using all default options
except report_level which is set to 'ALL'.
The output is written to a file named with the sqlid and a suffix of .html
@@ -13,11 +13,6 @@ The file is created in your current directory unless the --output-directory
option is provided.
.P
.SH OPTIONS
-\fB-u\fR
-.RS 4
-Compulsory option to find the sqlreport.rwl script in the public directory.
-.RE
-.P
.B -l u/p
.P
.B -l u/p@c
@@ -49,7 +44,7 @@ Exactly one sqlid must be provided.
.SH EXAMPLE
.nf
\fC
-rwloadsim -ul system/{password} sqlreport.rwl 07rw9znc8g7aj
+sqlreport -l system/{password} 07rw9znc8g7aj
\fR
.fi
.P
diff --git a/oltp/maketags.sh b/oltp/maketags.sh
index 9171825b..879fe8b3 100755
--- a/oltp/maketags.sh
+++ b/oltp/maketags.sh
@@ -8,6 +8,7 @@
#
# History
#
+# bengsig 19-jun-2024 refer relatively to ovid2.rwl
# bengsig 12-oct-2022 run.rwl needs -i wburst_count:=1
# bengsig 10-jan-2022 Creation
@@ -19,6 +20,8 @@
#
# Consider this script EXPERIMENTAL!
+export RWLOADSIM_PATH=../public
+
# Simply loop through all
for x in *.rwl
do
@@ -39,7 +42,8 @@ do
done
# Sort them
-env LC_ALL=C sort -u *.tags > tags
+omit=$(pwd -P | sed 's/oltp$/public/')
+env LC_ALL=C sort -u *.tags | grep -v $omit > tags
# And remove the intermediate files
rm -f *.tags
diff --git a/oltp/tags b/oltp/tags
index de2dd449..d85a4874 100644
--- a/oltp/tags
+++ b/oltp/tags
@@ -28,10 +28,10 @@ a9 col_averages.rwl 18
a9cnt col_averages.rwl 36
a9sum col_averages.rwl 27
above3 csvdata.rwl 791
-aburst_post_factor parameters.rwl 184
-aburst_pre_factor parameters.rwl 183
-aburst_start parameters.rwl 185
-aburst_workers parameters.rwl 182
+aburst_post_factor parameters.rwl 185
+aburst_pre_factor parameters.rwl 184
+aburst_start parameters.rwl 186
+aburst_workers parameters.rwl 183
actbatch csvdata.rwl 265
actbatch mtitrun.rwl 83
actbatch run.rwl 561
@@ -42,14 +42,14 @@ actpool mtitrun.rwl 83
actpool run.rwl 561
add_inventory oe_handle_products.rwl 57
affinity xcchange.rwl 44
-affinratio mtit_declarations.rwl 208
+affinratio mtit_declarations.rwl 220
ai_atim csvdata.rwl 433
ai_cnt plotrunwetim.rwl 45
ai_dtim csvdata.rwl 433
ai_et plotrunwetim.rwl 45
ai_exec csvdata.rwl 431
-ai_sleep_avg parameters.rwl 360
-ai_sleep_fac parameters.rwl 364
+ai_sleep_avg parameters.rwl 361
+ai_sleep_fac parameters.rwl 365
ai_wait csvdata.rwl 431
ai_wt plotrunwetim.rwl 45
al1 oe_fillcustomers.rwl 11
@@ -73,35 +73,35 @@ avge csvmtit.rwl 274
avgw histdata.rwl 89
avgw scalefract.rwl 33
aw_atim csvdata.rwl 433
-aw_cols_256MB_doublings parameters.rwl 147
+aw_cols_256MB_doublings parameters.rwl 148
aw_cols_dbl aw_cols.rwl 19
aw_cols_mb_qry aw_cols.rwl 236
-aw_cols_query_factor parameters.rwl 156
+aw_cols_query_factor parameters.rwl 157
aw_cols_size aw_cols.rwl 235
aw_cols_size aw_sizeinfo.rwl 17
-aw_cols_skew parameters.rwl 154
+aw_cols_skew parameters.rwl 155
aw_dtim csvdata.rwl 433
aw_exec csvdata.rwl 431
aw_instances aw_declarations.rwl 123
-aw_instances parameters.rwl 167
+aw_instances parameters.rwl 168
aw_myinst aw_declarations.rwl 125
-aw_sleep_avg parameters.rwl 360
-aw_sleep_fac parameters.rwl 363
+aw_sleep_avg parameters.rwl 361
+aw_sleep_fac parameters.rwl 364
aw_stats aw_cols.rwl 228
aw_transaction aw_declarations.rwl 131
-aw_transaction_weight parameters.rwl 112
+aw_transaction_weight parameters.rwl 113
aw_transactions_made aw_declarations.rwl 22
aw_truncate aw_truncate.rwl 13
-aw_verbose parameters.rwl 160
+aw_verbose parameters.rwl 161
aw_wait csvdata.rwl 431
awc_parallel aw_cols.rwl 189
awindex_query aw_declarations.rwl 324
-awindex_query_weight parameters.rwl 113
+awindex_query_weight parameters.rwl 114
awlen aw_declarations.rwl 322
awqry aw_declarations.rwl 333
awrbb_tim runsys.rwl 182
awrbe_tim runsys.rwl 182
-awrdirectory parameters.rwl 278
+awrdirectory parameters.rwl 279
awreb_tim runsys.rwl 182
awree_tim runsys.rwl 182
awrinfo oltpawr.rwl 112
@@ -115,8 +115,8 @@ b_rwnum aw_declarations.rwl 25
b_tokid aw_declarations.rwl 24
b_val aw_declarations.rwl 27
badplan xcchange.rwl 29
-batch_connect parameters.rwl 299
-batch_type parameters.rwl 300
+batch_connect parameters.rwl 300
+batch_type parameters.rwl 301
bb csvdata.rwl 182
bb csvmtit.rwl 157
bb oltpawr.rwl 228
@@ -135,10 +135,10 @@ bgcpu timemodel.rwl 111
bt cstorm_implementation.rwl 46
btim cstorm_implementation.rwl 76
bucktim histdata.rwl 30
-burst_factor parameters.rwl 173
-burst_length parameters.rwl 172
-burst_repeat parameters.rwl 174
-burst_start parameters.rwl 171
+burst_factor parameters.rwl 174
+burst_length parameters.rwl 173
+burst_repeat parameters.rwl 175
+burst_start parameters.rwl 172
c aw_declarations.rwl 328
calf csvdata.rwl 280
call_failure run_user.rwl 17
@@ -186,7 +186,7 @@ cntl oe_handle_orders.rwl 694
comment aw_cols.rwl 29
complex_count oe_handle_orders.rwl 686
complex_query oe_handle_orders.rwl 688
-complex_query_weight parameters.rwl 110
+complex_query_weight parameters.rwl 111
complex_sum oe_handle_orders.rwl 685
con oltp.rwl 41
cone aw_declarations.rwl 327
@@ -218,23 +218,23 @@ cq_exec csvdata.rwl 430
cq_wait csvdata.rwl 431
create_aw_cols aw_cols.rwl 55
create_aw_seq aw_cols.rwl 51
-cruser_connect parameters.rwl 284
-cruser_password parameters.rwl 286
+cruser_connect parameters.rwl 285
+cruser_password parameters.rwl 287
cruser_username command line 1
-cruser_username parameters.rwl 285
+cruser_username parameters.rwl 286
cruserdb cruserdb.rwl 8
-cstorm_period parameters.rwl 233
-cstorm_start parameters.rwl 232
-cstorm_threads parameters.rwl 231
-cstorm_xtra_logons parameters.rwl 234
-cstorm_xtra_period parameters.rwl 237
-cstorm_xtra_rate parameters.rwl 235
-cstorm_xtra_start parameters.rwl 236
+cstorm_period parameters.rwl 234
+cstorm_start parameters.rwl 233
+cstorm_threads parameters.rwl 232
+cstorm_xtra_logons parameters.rwl 235
+cstorm_xtra_period parameters.rwl 238
+cstorm_xtra_rate parameters.rwl 236
+cstorm_xtra_start parameters.rwl 237
csvline csvdata.rwl 574
csvline csvmtit.rwl 17
csvname scalefract.rwl 21
ctwo aw_declarations.rwl 327
-cursor_cache_size parameters.rwl 68
+cursor_cache_size parameters.rwl 69
cursorleak xcchange.rwl 23
customer_id oe_handle_orders.rwl 383
customer_id oe_handle_orders.rwl 623
@@ -267,29 +267,29 @@ ddl aw_cols.rwl 29
ddl create_schemas.rwl 19
ddl drop_schemas.rwl 15
debug_products oe_handle_products.rwl 12
-default_tablespace parameters.rwl 290
-delay_length parameters.rwl 189
-delay_max_pool parameters.rwl 192
-delay_min_pool parameters.rwl 191
-delay_start parameters.rwl 190
+default_tablespace parameters.rwl 291
+delay_length parameters.rwl 190
+delay_max_pool parameters.rwl 193
+delay_min_pool parameters.rwl 192
+delay_start parameters.rwl 191
deltmpitem oepartalloc.rwl 43
deltmpord oepartalloc.rwl 37
descl oe_handle_orders.rwl 752
-dfac mtit_create.rwl 128
+dfac mtit_create.rwl 129
disable_bloom oltpawr.rwl 48
dist_count runsys.rwl 50
dist_inst runsys.rwl 50
dist_usrn runsys.rwl 51
do_hardparse oe_handle_orders.rwl 194
-doawr parameters.rwl 226
+doawr parameters.rwl 227
doeither run.rwl 153
-dontdo_batch1 parameters.rwl 423
-dontdo_batch2 parameters.rwl 424
-dontdo_batch3 parameters.rwl 425
-dontdo_batch4 parameters.rwl 426
-dontdolong parameters.rwl 97
+dontdo_batch1 parameters.rwl 425
+dontdo_batch2 parameters.rwl 426
+dontdo_batch3 parameters.rwl 427
+dontdo_batch4 parameters.rwl 428
+dontdolong parameters.rwl 98
doociping run.rwl 264
-doosstat parameters.rwl 228
+doosstat parameters.rwl 229
drop_aw_cols aw_cols.rwl 41
drop_aw_seq aw_cols.rwl 46
dropuser drop_schemas.rwl 13
@@ -344,11 +344,11 @@ filnam x2range.rwl 24
finishtime prepare.rwl 21
first1530 aw_cols.rwl 83
first_instances oerhtmlday.rwl 25
-fix_cursorleak parameters.rwl 340
-fix_hardparse parameters.rwl 339
-fix_logoffrate parameters.rwl 341
+fix_cursorleak parameters.rwl 341
+fix_hardparse parameters.rwl 340
+fix_logoffrate parameters.rwl 342
fna oe_fillcustomers.rwl 9
-forever_proccount parameters.rwl 80
+forever_proccount parameters.rwl 81
forg plotinfo.rwl 41
found kommentops.rwl 17
fulldate checkepoch.rwl 18
@@ -372,13 +372,13 @@ getrdate prepare.rwl 29
getres_sql csvmtit.rwl 234
getres_sql mtitplotwe.rwl 43
getres_sql plotrunwetim.rwl 48
-globalawr parameters.rwl 227
-gnuplotjs parameters.rwl 269
+globalawr parameters.rwl 228
+gnuplotjs parameters.rwl 270
goodcount plotinfo.rwl 42
grab_session run.rwl 134
grp check_directories.rwl 10
hadit oerhtmlday.rwl 92
-halfperiod parameters.rwl 429
+halfperiod parameters.rwl 431
hardparse xcchange.rwl 26
heartbeat run.rwl 256
highcount csvdata.rwl 667
@@ -390,7 +390,7 @@ htmlline csvdata.rwl 764
htmlxtra oltpawr.rwl 81
htmlxtrawrap oltpawr.rwl 82
human parameters2shell.rwl 25
-i /home/bengsig/rwloadsim/public/ovid2.rwl 7077
+i ../public/ovid2.rwl 7077
i aw_cols.rwl 210
i1 csvdata.rwl 242
i1 csvmtit.rwl 200
@@ -431,10 +431,10 @@ ientries plotfigures.rwl 29
ientries plotruntp.rwl 25
ientries plotrunwetim.rwl 25
ignore_parsefailure xcchange.rwl 28
-iii mtit_declarations.rwl 208
+iii mtit_declarations.rwl 220
inacdist runsys.rwl 46
inacdistfile runsys.rwl 42
-index_name mtit_create.rwl 23
+index_name mtit_create.rwl 24
input col_averages.rwl 17
ins_awrtim oltpawr.rwl 232
ins_customer oe_fillcustomers.rwl 20
@@ -496,13 +496,13 @@ iusr8 timemodel.rwl 243
key check_for_key.rwl 12
key oerhtmlday.rwl 11
key scalefract.rwl 16
-key_to_show parameters.rwl 39
+key_to_show parameters.rwl 40
keyring_password oltp.rwl 41
killmsg xc_implementation.rwl 310
kom check_for_key.rwl 15
komment kommentops.rwl 18
komment oerhtmlday.rwl 11
-l /home/bengsig/rwloadsim/public/ovid2.rwl 7090
+l ../public/ovid2.rwl 7090
l_afty xc_implementation.rwl 52
l_afty xcdefault.rwl 20
l_afty xcvalues.rwl 30
@@ -566,7 +566,7 @@ l_stop xcvalues.rwl 31
l_wsec xc_implementation.rwl 52
l_wsec xcdefault.rwl 20
l_wsec xcvalues.rwl 30
-largeashok parameters.rwl 252
+largeashok parameters.rwl 253
lastsec mtitrun.rwl 81
lastsec run.rwl 559
lastsys mtitrun.rwl 81
@@ -576,7 +576,7 @@ lastusr run.rwl 559
lc csvdata.rwl 631
lc csvmtit.rwl 370
lcsec xcdefault.rwl 20
-leaf_blocks mtit_create.rwl 143
+leaf_blocks mtit_create.rwl 144
li oe_handle_orders.rwl 260
line_item_id oe_handle_orders.rwl 116
line_item_id oe_handle_orders.rwl 383
@@ -603,30 +603,30 @@ make_invoices oe_handle_orders.rwl 623
make_order oe_handle_orders.rwl 83
makeawr oltpawr.rwl 223
makeinvoices run.rwl 87
-makeinvoices_weight parameters.rwl 109
+makeinvoices_weight parameters.rwl 110
makeorder run.rwl 83
-makeorder_weight parameters.rwl 106
+makeorder_weight parameters.rwl 107
markerfile csvdata.rwl 40
markerfile csvmtit.rwl 19
markerfile mtitrun.rwl 25
markerfile run.rwl 77
markerfile xc_implementation.rwl 31
markrunning run.rwl 268
-max_customer parameters.rwl 125
+max_customer parameters.rwl 126
max_item oe_handle_orders.rwl 207
max_order_id oe_handle_orders.rwl 24
max_order_ship oe_handle_orders.rwl 25
-max_product parameters.rwl 124
-max_sessionwait parameters.rwl 65
-max_warehouse parameters.rwl 123
+max_product parameters.rwl 125
+max_sessionwait parameters.rwl 66
+max_warehouse parameters.rwl 124
maxactpool csvdata.rwl 324
maxdbcpu csvdata.rwl 99
maxesum csvdata.rwl 582
maxesum csvmtit.rwl 321
-maxl /home/bengsig/rwloadsim/public/ovid2.rwl 7085
+maxl ../public/ovid2.rwl 7085
maxo oe_handle_orders.rwl 556
maxpool xcchange.rwl 33
-maxseq mtit_declarations.rwl 208
+maxseq mtit_declarations.rwl 220
maxsessions aw_declarations.rwl 115
maxsql oe_handle_orders.rwl 41
maxtot run.rwl 224
@@ -656,8 +656,8 @@ mo_cnt plotrunwetim.rwl 43
mo_dtim csvdata.rwl 432
mo_et plotrunwetim.rwl 43
mo_exec csvdata.rwl 430
-mo_sleep_avg parameters.rwl 360
-mo_sleep_fac parameters.rwl 361
+mo_sleep_avg parameters.rwl 361
+mo_sleep_fac parameters.rwl 362
mo_wait csvdata.rwl 430
mo_wt plotrunwetim.rwl 43
mpri oe_fillproducts.rwl 14
@@ -674,24 +674,25 @@ msping timemodel.rwl 112
mtim csvdata.rwl 152
mtim csvmtit.rwl 127
mtit xcvalues.rwl 23
-mtit_affinity parameters.rwl 373
-mtit_array_size parameters.rwl 371
-mtit_count_ins_rows mtit_declarations.rwl 72
-mtit_get_seq mtit_declarations.rwl 140
-mtit_initialize mtit_declarations.rwl 61
-mtit_ins_rows mtit_declarations.rwl 132
-mtit_ins_sql mtit_declarations.rwl 144
-mtit_instance mtit_declarations.rwl 60
-mtit_max_payload mtit_declarations.rwl 58
-mtit_rev_double parameters.rwl 376
-mtit_rows_per_exec parameters.rwl 370
-mtit_seq mtit_declarations.rwl 76
-mtit_set_type mtit_declarations.rwl 78
-mtit_tab mtit_declarations.rwl 76
-mtit_threads parameters.rwl 369
-mtit_type parameters.rwl 372
-mtit_type_text parameters.rwl 377
-mtit_xc parameters.rwl 375
+mtit_affinity parameters.rwl 374
+mtit_array_size parameters.rwl 372
+mtit_count_ins_rows mtit_declarations.rwl 81
+mtit_get_seq mtit_declarations.rwl 149
+mtit_initialize mtit_declarations.rwl 70
+mtit_ins_rows mtit_declarations.rwl 141
+mtit_ins_sql mtit_declarations.rwl 153
+mtit_instance mtit_declarations.rwl 69
+mtit_max_payload mtit_declarations.rwl 67
+mtit_partitions parameters.rwl 378
+mtit_rev_double parameters.rwl 377
+mtit_rows_per_exec parameters.rwl 371
+mtit_seq mtit_declarations.rwl 85
+mtit_set_type mtit_declarations.rwl 87
+mtit_tab mtit_declarations.rwl 85
+mtit_threads parameters.rwl 370
+mtit_type parameters.rwl 373
+mtit_type_text parameters.rwl 379
+mtit_xc parameters.rwl 376
mtittype xcchange.rwl 41
mtxt csvdata.rwl 152
mtxt csvmtit.rwl 127
@@ -733,10 +734,10 @@ nextdouble aw_cols.rwl 132
no_awr_interval csvdata.rwl 43
nopool xcchange.rwl 37
nopool xccoreparam.rwl 17
-normal_connect parameters.rwl 296
-normal_stddev parameters.rwl 350
+normal_connect parameters.rwl 297
+normal_stddev parameters.rwl 351
notused csvdata.rwl 502
-num_rows mtit_create.rwl 143
+num_rows mtit_create.rwl 144
nvlstring csvdata.rwl 497
o1 oe_handle_orders.rwl 694
o2 oe_handle_orders.rwl 694
@@ -786,7 +787,7 @@ order_total oe_handle_orders.rwl 695
order_total oe_handle_orders.rwl 754
order_total oe_handle_orders.rwl 89
orderby latest.rwl 21
-orders_hashcount parameters.rwl 133
+orders_hashcount parameters.rwl 134
orders_made oe_handle_orders.rwl 81
ordid oepartalloc.rwl 21
osstat_getres timemodel.rwl 203
@@ -795,16 +796,16 @@ otherterm timemodel.rwl 40
out create_schemas.rwl 15
out_order_id oe_handle_orders.rwl 86
outf scalefract.rwl 24
-ovid2load mtit_declarations.rwl 136
-ovidarray /home/bengsig/rwloadsim/public/ovid2.rwl 69
-ovidstring /home/bengsig/rwloadsim/public/ovid2.rwl 7073
-ovidstring2 /home/bengsig/rwloadsim/public/ovid2.rwl 7085
+ovid2load mtit_declarations.rwl 145
+ovidarray ../public/ovid2.rwl 69
+ovidstring ../public/ovid2.rwl 7073
+ovidstring2 ../public/ovid2.rwl 7085
p_pass create_schemas.rwl 17
p_user create_schemas.rwl 17
p_user drop_schemas.rwl 13
parsefailure xcchange.rwl 27
passwords parameters2shell.rwl 22
-payload mtit_declarations.rwl 135
+payload mtit_declarations.rwl 144
pcnt oe_fillproducts.rwl 15
pcode oe_fillcustomers.rwl 14
pcount runtrunc.rwl 40
@@ -848,7 +849,7 @@ plotruntp plotruntp.rwl 22
plotweres mtitplotwe.rwl 25
plotweres plotrunwetim.rwl 22
pna oe_fillproducts.rwl 9
-pool_connect parameters.rwl 298
+pool_connect parameters.rwl 299
pool_mb1 runsys.rwl 92
pool_mb2 runsys.rwl 92
pool_mb3 runsys.rwl 92
@@ -859,13 +860,13 @@ pool_mb7 runsys.rwl 93
pool_mb8 runsys.rwl 93
pool_name runsys.rwl 94
pool_rs runsys.rwl 92
-pool_size_interval parameters.rwl 274
-pool_type parameters.rwl 297
+pool_size_interval parameters.rwl 275
+pool_type parameters.rwl 298
prefinst oltpawr.rwl 123
probystat oe_fillproducts.rwl 64
-proccount parameters.rwl 76
-procminus1 mtit_declarations.rwl 208
-procnumber parameters.rwl 75
+proccount parameters.rwl 77
+procminus1 mtit_declarations.rwl 220
+procnumber parameters.rwl 76
prod_id oe_long_session.rwl 11
product_description oe_handle_orders.rwl 649
product_description oe_handle_orders.rwl 696
@@ -910,8 +911,8 @@ qo_cnt plotrunwetim.rwl 44
qo_dtim csvdata.rwl 433
qo_et plotrunwetim.rwl 44
qo_exec csvdata.rwl 431
-qo_sleep_avg parameters.rwl 360
-qo_sleep_fac parameters.rwl 362
+qo_sleep_avg parameters.rwl 361
+qo_sleep_fac parameters.rwl 363
qo_wait csvdata.rwl 431
qo_wt plotrunwetim.rwl 44
qry_awrtim csvdata.rwl 183
@@ -926,20 +927,20 @@ quantity oe_handle_orders.rwl 758
quantity oe_handle_products.rwl 60
quantity_on_hand oe_handle_orders.rwl 383
quantity_on_hand oe_handle_products.rwl 62
-query_factor parameters.rwl 102
+query_factor parameters.rwl 103
query_order oe_handle_orders.rwl 751
query_order_count oe_handle_orders.rwl 747
query_order_items oe_handle_orders.rwl 748
-query_order_max_limit parameters.rwl 140
+query_order_max_limit parameters.rwl 141
queryorder run.rwl 103
-queryorder_weight parameters.rwl 107
+queryorder_weight parameters.rwl 108
r_key prepare.rwl 23
-rampfactor parameters.rwl 57
+rampfactor parameters.rwl 58
rampup parameters2shell.rwl 78
-ratefactor parameters.rwl 45
-ratefactor_divisor parameters.rwl 403
-ratefactor_multiplier parameters.rwl 401
-rategradient parameters.rwl 52
+ratefactor parameters.rwl 46
+ratefactor_divisor parameters.rwl 405
+ratefactor_multiplier parameters.rwl 403
+rategradient parameters.rwl 53
rcnt xcdefault.rwl 46
rda check_for_key.rwl 16
rdate kommentops.rwl 18
@@ -949,19 +950,20 @@ repchg xc_implementation.rwl 51
rescre create_schemas.rwl 51
resname csvdata.rwl 345
resok timemodel.rwl 114
-results_connect parameters.rwl 293
-results_in_test parameters.rwl 291
-results_password parameters.rwl 295
-results_username parameters.rwl 294
-resultsdir parameters.rwl 279
+results_connect parameters.rwl 294
+results_in_test parameters.rwl 292
+results_password parameters.rwl 296
+results_username parameters.rwl 295
+resultsdir parameters.rwl 280
retval csvdata.rwl 51
retval csvmtit.rwl 29
-rixd mtit_create.rwl 128
+rixd mtit_create.rwl 129
rn runping.rwl 41
rno check_for_key.rwl 14
rno csvdata.rwl 790
rno latest.rwl 30
-rno mtit_declarations.rwl 133
+rno mtit_declarations.rwl 142
+rno2 mtit_declarations.rwl 194
rowspins xcchange.rwl 42
run cstorm_implementation.rwl 73
run mtitrun.rwl 65
@@ -985,66 +987,66 @@ runno plotrunwetim.rwl 18
runno scalefract.rwl 18
runno subdir.rwl 6
runno x2range.rwl 21
-runperiod parameters.rwl 130
-runplot_width parameters.rwl 242
+runperiod parameters.rwl 131
+runplot_width parameters.rwl 243
runrun run.rwl 293
runrunping runping.rwl 81
runrunsys runsys.rwl 181
runruntrunc runtrunc.rwl 58
-runsecmul mtit_declarations.rwl 208
+runsecmul mtit_declarations.rwl 220
rwl_aw aw_user.rwl 14
rwl_aw1 aw_sizeinfo.rwl 11
-rwl_aw1_password parameters.rwl 302
-rwl_aw1_username parameters.rwl 301
-rwl_aw2_password parameters.rwl 304
-rwl_aw2_username parameters.rwl 303
+rwl_aw1_password parameters.rwl 303
+rwl_aw1_username parameters.rwl 302
+rwl_aw2_password parameters.rwl 305
+rwl_aw2_username parameters.rwl 304
rwl_aw_create aw_cols.rwl 13
-rwl_daily_html parameters.rwl 84
-rwl_heading parameters.rwl 82
-rwl_max_batch parameters.rwl 93
-rwl_max_pool parameters.rwl 63
-rwl_min_batch parameters.rwl 92
-rwl_min_pool parameters.rwl 62
-rwl_oe_password parameters.rwl 306
+rwl_daily_html parameters.rwl 85
+rwl_heading parameters.rwl 83
+rwl_max_batch parameters.rwl 94
+rwl_max_pool parameters.rwl 64
+rwl_min_batch parameters.rwl 93
+rwl_min_pool parameters.rwl 63
+rwl_oe_password parameters.rwl 307
rwl_oe_pool oe_user.rwl 8
-rwl_oe_username parameters.rwl 305
+rwl_oe_username parameters.rwl 306
rwl_ping runping.rwl 24
-rwl_pool_release parameters.rwl 64
+rwl_pool_release parameters.rwl 65
rwl_run run_user.rwl 122
rwl_run1 checkepoch.rwl 11
-rwl_run1_password parameters.rwl 308
-rwl_run1_username parameters.rwl 307
-rwl_run2_password parameters.rwl 310
-rwl_run2_username parameters.rwl 309
+rwl_run1_password parameters.rwl 309
+rwl_run1_username parameters.rwl 308
+rwl_run2_password parameters.rwl 311
+rwl_run2_username parameters.rwl 310
rwl_run_batch run_user.rwl 164
-rwl_run_like parameters.rwl 311
+rwl_run_like parameters.rwl 312
rwl_run_mtit mtit_user.rwl 11
rwl_run_pool run_user.rwl 129
rwl_run_storm cstorm_implementation.rwl 18
-rwl_title parameters.rwl 312
+rwl_title parameters.rwl 313
rwloadsim results.rwl 8
-rwloadsimdir parameters.rwl 292
-s /home/bengsig/rwloadsim/public/ovid2.rwl 7089
+rwloadsimdir parameters.rwl 293
+s ../public/ovid2.rwl 7089
s run.rwl 114
-s24h_hard_avg parameters.rwl 212
-s24h_hard_beg parameters.rwl 214
-s24h_hard_end parameters.rwl 215
-s24h_hard_prb parameters.rwl 217
-s24h_hard_skp parameters.rwl 216
-s24h_hard_std parameters.rwl 213
-s24h_high_beg parameters.rwl 204
-s24h_high_end parameters.rwl 205
-s24h_high_std parameters.rwl 206
-s24h_load_hi parameters.rwl 207
-s24h_load_lo parameters.rwl 208
-s24h_load_std parameters.rwl 209
-s24h_scan_avg parameters.rwl 219
-s24h_scan_beg parameters.rwl 221
-s24h_scan_end parameters.rwl 222
-s24h_scan_prb parameters.rwl 224
-s24h_scan_skp parameters.rwl 223
-s24h_scan_std parameters.rwl 220
-s24hour parameters.rwl 198
+s24h_hard_avg parameters.rwl 213
+s24h_hard_beg parameters.rwl 215
+s24h_hard_end parameters.rwl 216
+s24h_hard_prb parameters.rwl 218
+s24h_hard_skp parameters.rwl 217
+s24h_hard_std parameters.rwl 214
+s24h_high_beg parameters.rwl 205
+s24h_high_end parameters.rwl 206
+s24h_high_std parameters.rwl 207
+s24h_load_hi parameters.rwl 208
+s24h_load_lo parameters.rwl 209
+s24h_load_std parameters.rwl 210
+s24h_scan_avg parameters.rwl 220
+s24h_scan_beg parameters.rwl 222
+s24h_scan_end parameters.rwl 223
+s24h_scan_prb parameters.rwl 225
+s24h_scan_skp parameters.rwl 224
+s24h_scan_std parameters.rwl 221
+s24hour parameters.rwl 199
s24line csvdata.rwl 212
s24markerfile csvdata.rwl 211
s24markers run.rwl 196
@@ -1056,11 +1058,11 @@ savecaches runsys.rwl 91
saveres cstorm_implementation.rwl 56
savtim oltpawr.rwl 230
scount csvmtit.rwl 275
-script_ramp parameters.rwl 71
+script_ramp parameters.rwl 72
search_products oe_handle_products.rwl 15
searches_made oe_handle_products.rwl 9
searchproduct run.rwl 99
-searchproduct_weight parameters.rwl 108
+searchproduct_weight parameters.rwl 109
searchtext oe_handle_products.rwl 15
sec eatcpu.rwl 9
sec mtitrun.rwl 82
@@ -1120,21 +1122,21 @@ seltimm_sql plotfigures.rwl 88
seltps_sql csvdata.rwl 281
seltps_sql plotruntp.rwl 45
selvkdat scalefract.rwl 35
-seq mtit_declarations.rwl 138
-seqplace mtit_declarations.rwl 79
+seq mtit_declarations.rwl 147
+seqplace mtit_declarations.rwl 88
ses_parallel aw_cols.rwl 193
sessionleak xcchange.rwl 25
setdbname prepare.rwl 93
ship_many_orders oe_handle_orders.rwl 556
ship_order oe_handle_orders.rwl 381
-shiporder_weight parameters.rwl 117
+shiporder_weight parameters.rwl 118
shiporders run.rwl 91
shipped_items oe_handle_orders.rwl 499
-show_changed_values parameters.rwl 163
+show_changed_values parameters.rwl 164
showall latest.rwl 18
showstart run.rwl 185
showthem oe_fillcustomers.rwl 71
-simulatebatch parameters.rwl 99
+simulatebatch parameters.rwl 100
skipnegative col_averages.rwl 11
sltp oe_handle_orders.rwl 695
snap oltpawr.rwl 19
@@ -1146,7 +1148,7 @@ sp_wait csvdata.rwl 430
space create_schemas.rwl 17
sqlddl create_schemas.rwl 20
sqlddl drop_schemas.rwl 16
-sqrt_query_factor parameters.rwl 477
+sqrt_query_factor parameters.rwl 479
src_products oe_handle_products.rwl 25
starttime ashstep1.rwl 31
starttime csvdata.rwl 41
@@ -1156,19 +1158,19 @@ stock_added oe_handle_products.rwl 54
stock_increased oe_handle_products.rwl 53
stocks run.rwl 114
stockup run.rwl 112
-stockup_weight parameters.rwl 111
+stockup_weight parameters.rwl 112
stopnow xcchange.rwl 36
stopnow xccoreparam.rwl 16
storm_results cstorm_implementation.rwl 27
-str /home/bengsig/rwloadsim/public/ovid2.rwl 7076
-str /home/bengsig/rwloadsim/public/ovid2.rwl 7088
-subdir parameters.rwl 280
+str ../public/ovid2.rwl 7076
+str ../public/ovid2.rwl 7088
+subdir parameters.rwl 281
success csvdata.rwl 849
suggest check_directories.rwl 12
sumdbtime csvdata.rwl 99
sumdbtime csvmtit.rwl 77
sume oe_handle_orders.rwl 695
-svgmouse parameters.rwl 739
+svgmouse parameters.rwl 741
sys mtitrun.rwl 82
sys run.rwl 560
sys1 csvosstat.rwl 14
@@ -1187,15 +1189,15 @@ sys7 csvosstat.rwl 14
sys7 timemodel.rwl 198
sys8 csvosstat.rwl 14
sys8 timemodel.rwl 198
-sysawr_connect parameters.rwl 287
-sysawr_password parameters.rwl 289
-sysawr_username parameters.rwl 288
+sysawr_connect parameters.rwl 288
+sysawr_password parameters.rwl 290
+sysawr_username parameters.rwl 289
sysawrdb systemdb.rwl 14
sysres scalefract.rwl 95
-syssave_interval parameters.rwl 245
-system_connect parameters.rwl 281
-system_password parameters.rwl 283
-system_username parameters.rwl 282
+syssave_interval parameters.rwl 246
+system_connect parameters.rwl 282
+system_password parameters.rwl 284
+system_username parameters.rwl 283
systemdb systemdb.rwl 8
t_dbsystim timemodel.rwl 37
t_name timemodel.rwl 35
@@ -1212,7 +1214,7 @@ termdist timemodel.rwl 304
termdist_query timemodel.rwl 61
termdist_query_gv timemodel.rwl 89
test_aw_transaction aw_declarations.rwl 293
-testdebug parameters.rwl 159
+testdebug parameters.rwl 160
thissec mtitrun.rwl 81
thissec run.rwl 559
thissys mtitrun.rwl 81
@@ -1220,14 +1222,14 @@ thissys run.rwl 559
thisterm timemodel.rwl 40
thisusr mtitrun.rwl 81
thisusr run.rwl 559
-threadcount parameters.rwl 95
-threadcount_divisor parameters.rwl 404
-threadcount_multiplier parameters.rwl 402
+threadcount parameters.rwl 96
+threadcount_divisor parameters.rwl 406
+threadcount_multiplier parameters.rwl 404
thrid csvdata.rwl 788
tim1 runping.rwl 34
tim2 runping.rwl 34
tim3 runping.rwl 34
-time_out parameters.rwl 48
+time_out parameters.rwl 49
timemodel_getres timemodel.rwl 117
timemodel_insert timemodel.rwl 309
timemodel_save timemodel.rwl 302
@@ -1238,7 +1240,7 @@ tit3 csvdata.rwl 793
tmatch csvdata.rwl 50
tmatch csvmtit.rwl 28
to_be_shipped oe_handle_orders.rwl 559
-tot /home/bengsig/rwloadsim/public/ovid2.rwl 7090
+tot ../public/ovid2.rwl 7090
tot aw_cols.rwl 212
tot runsys.rwl 50
tot_orders oe_handle_orders.rwl 559
@@ -1295,7 +1297,7 @@ usr8 csvosstat.rwl 13
usr8 timemodel.rwl 197
usrsystim timemodel.rwl 201
ustsdif timemodel.rwl 245
-val mtit_declarations.rwl 134
+val mtit_declarations.rwl 143
val1 csvdata.rwl 280
val2 csvdata.rwl 280
val3 csvdata.rwl 280
@@ -1313,14 +1315,14 @@ warehouse_id run.rwl 113
warehouse_received run.rwl 108
was_shipped oe_handle_orders.rwl 379
wburst_count command line 1
-wburst_count parameters.rwl 177
-wburst_length parameters.rwl 179
+wburst_count parameters.rwl 178
+wburst_length parameters.rwl 180
wburst_run run.rwl 237
-wburst_start parameters.rwl 178
+wburst_start parameters.rwl 179
wburst_wait run.rwl 230
-wcount /home/bengsig/rwloadsim/public/ovid2.rwl 7073
+wcount ../public/ovid2.rwl 7073
whereclause aw_declarations.rwl 369
-wholeaffin mtit_declarations.rwl 133
+wholeaffin mtit_declarations.rwl 142
wid oe_fillwarehouses.rwl 5
withdesc oe_handle_orders.rwl 751
withdml oe_long_session.rwl 9
@@ -1336,35 +1338,35 @@ wna oe_fillwarehouses.rwl 7
wrapfetch runping.rwl 42
writeping runping.rwl 48
wtime csvmtit.rwl 274
-xc_badplan parameters.rwl 330
-xc_cpusec parameters.rwl 332
-xc_cursorcache parameters.rwl 325
-xc_cursorleak parameters.rwl 326
-xc_enabled parameters.rwl 316
-xc_hardparse parameters.rwl 321
-xc_ignore_parsefailure parameters.rwl 336
+xc_badplan parameters.rwl 331
+xc_cpusec parameters.rwl 333
+xc_cursorcache parameters.rwl 326
+xc_cursorleak parameters.rwl 327
+xc_enabled parameters.rwl 317
+xc_hardparse parameters.rwl 322
+xc_ignore_parsefailure parameters.rwl 337
xc_kill xc_implementation.rwl 310
-xc_loadfactor parameters.rwl 320
-xc_logoffrate parameters.rwl 329
+xc_loadfactor parameters.rwl 321
+xc_logoffrate parameters.rwl 330
xc_marker xc_implementation.rwl 39
-xc_maxpool parameters.rwl 324
-xc_minpool parameters.rwl 323
-xc_nopool parameters.rwl 334
-xc_parsefailure parameters.rwl 322
-xc_proccount parameters.rwl 333
-xc_ratefactor parameters.rwl 319
+xc_maxpool parameters.rwl 325
+xc_minpool parameters.rwl 324
+xc_nopool parameters.rwl 335
+xc_parsefailure parameters.rwl 323
+xc_proccount parameters.rwl 334
+xc_ratefactor parameters.rwl 320
xc_read xc_implementation.rwl 51
-xc_refresh parameters.rwl 318
+xc_refresh parameters.rwl 319
xc_run_dedicated run.rwl 25
-xc_sessionleak parameters.rwl 327
-xc_sessionwait parameters.rwl 335
-xc_stopnow parameters.rwl 328
-xc_waitsec parameters.rwl 331
+xc_sessionleak parameters.rwl 328
+xc_sessionwait parameters.rwl 336
+xc_stopnow parameters.rwl 329
+xc_waitsec parameters.rwl 332
xcolor csvdata.rwl 42
xcolor csvmtit.rwl 21
-xeqpsec parameters.rwl 511
-xeqpshi parameters.rwl 517
-xeqpslo parameters.rwl 516
+xeqpsec parameters.rwl 513
+xeqpshi parameters.rwl 519
+xeqpslo parameters.rwl 518
xhi x2range.rwl 23
xlo x2range.rwl 22
xseconds csvdata.rwl 49
diff --git a/public/ashplot.rwl b/public/ashplot.rwl
index e1f5e0ac..71c5cb45 100644
--- a/public/ashplot.rwl
+++ b/public/ashplot.rwl
@@ -20,6 +20,7 @@
# bengsig 19-oct-2020 Added -d option for awr query
# bengsig 23-mar-2019 Improved comments
# bengsig 20-mar-2019 Created
+$alwaysmute:206
# options to this script
$longoption:file-count=1
diff --git a/public/awrdump.rwl b/public/awrdump.rwl
index adf046fe..a9390219 100644
--- a/public/awrdump.rwl
+++ b/public/awrdump.rwl
@@ -10,6 +10,7 @@
# bengsig 22-nov-2022 - Creation
# Dump awr data to a directory and potentially cloud bucket
+$alwaysmute:206
# If we didn't connect, don't do anything
$if not defined(default database) $then
diff --git a/public/awrreport.rwl b/public/awrreport.rwl
index 047a7504..228153af 100644
--- a/public/awrreport.rwl
+++ b/public/awrreport.rwl
@@ -11,6 +11,7 @@
# bengsig 24-nov-2022 - Better argument handling
# bengsig 11-may-2022 - Rename to awreport.rwl
# bengsig 13-apr-2022 - Creation
+$alwaysmute:206
# Generate awr reports or list awr snapshots available
diff --git a/public/netthroughput.rwl b/public/netthroughput.rwl
index 5ce67a0b..730f9b6f 100644
--- a/public/netthroughput.rwl
+++ b/public/netthroughput.rwl
@@ -48,6 +48,7 @@
# after expected start time
#
# --verbosetest Make the output more verbose
+$alwaysmute:206
# If we didn't connect, don't do anything
$if not defined(default database) $then
diff --git a/public/sqlmonitor.rwl b/public/sqlmonitor.rwl
index 0f8d7f32..92700b90 100644
--- a/public/sqlmonitor.rwl
+++ b/public/sqlmonitor.rwl
@@ -1,11 +1,12 @@
-# sqlid2mon.rwl
+# sqlmonitor.rwl
#
-# Copyright (c) 2022 Oracle Corporation
+# Copyright (c) 2022, 2024 Oracle Corporation
# Licensed under the Universal Permissive License v 1.0
# as shown at https://oss.oracle.com/licenses/upl/
#
# History
#
+# bengsig 13-jun-2024 - modernize, call from shell script
# bengsig 27-jun-2023 - Fix _, mute
# bengsig 28-apr-2022 - Exit on connect error
# bengsig 13-apr-2022 - Change output's to use hyphen
@@ -14,41 +15,49 @@
#
# usage:
#
-# rwloadsim -ul system/{password}@//host/database sqlid2mon.rwl sqlid
+# rwloadsim -ul system/{password}@//host/database sqlmonitor.rwl sqlid
#
# output: sqlid.html
+$alwaysmute:206
# If we didn't connect, don't do anything
-if oraerror is not null and oraerror then
+$if not defined(default database) $then
+ writeline stderr, "Missing or incorrect -l option; use -h to get help";
exit 1;
-end if;
+$endif
$longoption:file-count=1
string sql_exec_start;
-$useroption:sql-exec-start:"--sql-exec-start=YYYY.MM.DDTHH24:MI:SS : provide sql-exec-start"
integer sql_exec_id;
-$useroption:sql-exec-id:"--sql-exec-id=N : provide sql-exec-id"
integer sql_plan_hash_value;
-$useroption:sql-plan-hash-value:"--sql-plan-hash-value=N : provide sql-plan-hash-value"
string con_name;
-$useroption:con-name:"--con-name=con-name : provide the con-name"
string(4100) output_file;
-$useroption:output-file:"--output-file=filename : use specified filename in stead of sqlid.html"
string(4100) output_directory := "." ;
-$useroption:output-directory:"--output-directory=directory : put output file in this directory"
+
+ $userhelp:"Create a sql monitor by calling dbms_sql_monitor.report_sql_monitor"
+ $userhelp:"-l usr/pwd@con : required option to give database logon"
+ $userhelp:"sqlid : exactly one sqlid must be given"
+ $useroption:sql-exec-id:"--sql-exec-id=N : provide sql_exec_id"
+ $useroption:sql-exec-start:"--sql-exec-start="
+ $userhelp:" YYYY.MM.DDTHH24:MI:SS : provide sql_exec_start"
+$useroption:sql-plan-hash-value:"--sql-plan-hash-value=N : provide sql_plan_hash_value"
+ $useroption:con-name:"--con-name=con-name : provide con_name"
+ $useroption:output-file:"--output-file=filename : write to filename in stead of sqlid.html"
+ $useroption:output-directory:"--output-directory="
+ $userhelp:" directory : put file in directory in stead of current"
$oraerror:stop
string(13) sqlid;
if $# != 1 then
- writeline stderr, "\nusage: rwloadsim [--userhelp] [options] -ul system/{password}@//host/database sqlmonitor.rwl sqlid";
+ writeline stderr, "\nusage: sqlmonitor [--help] [options] -l system/{password}@//host/database sqlid";
exit 1;
end if;
@@ -58,8 +67,6 @@ sqlid := $1;
string(10000000) txt;
-clob res;
-
sql rep_sql
begin
:1 := dbms_sql_monitor.report_sql_monitor
@@ -72,7 +79,7 @@ sql rep_sql
, report_level => 'ALL');
end;
/
- bindout 1 res;
+ bindout 1 txt;
bind 2 sqlid, 3 sql_exec_id, 4 sql_exec_start;
bind 5 sql_plan_hash_value, 6 con_name;
end;
@@ -80,18 +87,18 @@ end;
rep_sql;
file out;
-execute
-
- readlob res, txt;
-
- if output_file = "" then
- out := output_directory "/" sqlid || ".html";
- else
- out := output_directory "/" output_file;
- end if;
+if output_file = "" then
+ out := output_directory "/" sqlid || ".html";
+else
+ out := output_directory "/" output_file;
+end if;
- writeline out, txt;
- out := null;
-end;
+writeline out, txt;
+out := null;
+if output_file = "" then
+ printline "Created " output_directory "/" sqlid ".html" ;
+else
+ printline "Created " output_directory "/" output_file;
+end if;
diff --git a/public/sqlreport.rwl b/public/sqlreport.rwl
index df4ac834..5af1c55e 100644
--- a/public/sqlreport.rwl
+++ b/public/sqlreport.rwl
@@ -6,6 +6,7 @@
#
# History
#
+# bengsig 13-jun-2024 - Modernize
# bengsig 28-apr-2022 - Exit on connect error
# bengsig 13-apr-2022 - Change output's to use hyphen
# bengsig 2018 - Creation
@@ -16,37 +17,39 @@
# rwloadsim -ul system/{password}@//host/database sqlreport.rwl sqlid
#
# output: sqlid.html
+$alwaysmute:206
# If we didn't connect, don't do anything
-if oraerror is not null and oraerror then
+$if not defined(default database) $then
+ writeline stderr, "Missing or incorrect -l option; use -h to get help";
exit 1;
-end if;
+$endif
$longoption:file-count=1
string(4100) output_file;
-$useroption:output-file:"--output-file=filename : use specified filename in stead of sqlid.html"
string(4100) output_directory := "." ;
-$useroption:output-directory:"--output-directory=directory : put output file in this directory"
+ $userhelp:"Create a sql report by calling dbms_sqltune.report_sql_detail"
+ $userhelp:"-l usr/pwd@con : required option to give database logon"
+ $userhelp:"sqlid : exactly one sqlid must be given"
+ $useroption:output-file:"--output-file=filename : write to filename in stead of sqlid.html"
+ $useroption:output-directory:"--output-directory="
+ $userhelp:" directory : put file in directory in stead of current"
$oraerror:stop
string(13) sqlid;
if $# != 1 then
- writeline stderr, "\nusage: rwloadsim [--userhelp] [options] -ul system/{password}@//host/database sqlreport.rwl sqlid";
+ writeline stderr, "\nusage: sqlreport [--help] [options] -l system/{password}@//host/database sqlid";
exit 1;
end if;
sqlid := $1;
-$mute:46
-
string(10000000) txt;
-clob res;
-
sql rep_sql
begin
:1 := dbms_sqltune.report_sql_detail
@@ -55,24 +58,25 @@ sql rep_sql
, report_level => 'ALL');
end;
/
- bindout 1 res;
+ bindout 1 txt;
bind 2 sqlid;
end;
rep_sql;
file out;
-execute
-
- readlob res, txt;
- if output_file = "" then
- out := output_directory "/" sqlid || ".html";
- else
- out := output_directory "/" output_file;
- end if;
+if output_file = "" then
+ out := output_directory "/" sqlid || ".html";
+else
+ out := output_directory "/" output_file;
+end if;
- writeline out, txt;
- out := null;
-end;
+writeline out, txt;
+out := null;
+if output_file = "" then
+ printline "Created " output_directory "/" sqlid ".html" ;
+else
+ printline "Created " output_directory "/" output_file;
+end if;
From 9588cdc78770ff24be34270da1cb23245b328225 Mon Sep 17 00:00:00 2001
From: Bjorn Kisbye Engsig oltpxcrun
-[-H] [-g|-G] [-a] [-k key] [-R file] [-r runperiod]
+[-H] [-g|-G] [-a] [-2] [-k key] [-R file] [-r runperiod]
[--no-awr] [--default] [komment text ...] Continuously
@@ -118,6 +118,11 @@ SYNOPSIS
OPTIONS
the run. Only use this if the automatic allocation via
interval partitions appears to cause trouble
-2
+ +Use side 2 of the +aw_transaction workload - needed in special cases only.
+netthroughput --u -l u/p@c [--rampup=N] [--concurrency=N] [--verbosetest] +-l u/p@c [--rampup=N] [--concurrency=N] [--verbosetest] [--interval=N] [--fetcharray=N] [--mbperquery=M] [--period=N] [--csvoutput=file] [--csvappend=file] [--csvexcel]
@@ -247,7 +247,7 @@The example shows the estimated throughput from the database to the -client using 2 concurrent streams is 1.574 logical (and +client using ten concurrent streams is 1.574 logical (and physical) Gigabytes per second.
The following @@ -286,7 +286,7 @@
Copyright
-© 2023 Oracle Corporation
+© 2024 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
rategradient
- -This is a double value that can -be used to make the overall workload increase gradually -during a run. If the value is 0 (or is unset), the arrival -rate will be constant during the run; this is the default -behavior. If the value is set higher than 0 and at most to -1, the arrival rate will initially be lower than -specified via ratefactor, half way through the run it -will be what ratefactor specifies and at the finish -of the run, it will be higher. Effectively, the rate -will gradually increase from 100*rategradient percent below -normal to 100*rategradient percent above normal. Values -outside the range [0;1] will be adjusted to either 0 or -1.
+rategradient
+
+rategradientstep
These are double values, and if +the first set set, the overall workload increases gradually +during a run. If the value of rategradient is 0 (or +is unset), the arrival rate will be constant during the run; +this is the default behavior. If the value is set higher +than 0 and at most to 1, the arrival rate will initially be +lower than specified via ratefactor, half way +through the run it will be what ratefactor specifies +and at the finish of the run, it will be higher. +Effectively, the rate will gradually increase from +100*rategradient percent below normal to 100*rategradient +percent above normal. Values outside the range [0;1] will be +adjusted to either 0 or 1.
+ +If the second +parameter is set to a value of 10 or higher, the increase +will be stepwise rather than gradual and the increase will +take place every rategradientstep seconds.
threadcount
diff --git a/man/man2rwl/oltpsetup.2rwl b/man/man2rwl/oltpsetup.2rwl index 062f86df..8f94958c 100644 --- a/man/man2rwl/oltpsetup.2rwl +++ b/man/man2rwl/oltpsetup.2rwl @@ -329,10 +329,12 @@ You can very approximately assume that with the default value together with the .RE .P \fBrategradient\fR +.br +\fBrategradientstep\fR .RS 4 -This is a double value that can be used to make the overall workload increase gradually during +These are double values, and if the first set set, the overall workload increases gradually during a run. -If the value is 0 (or is unset), the arrival rate will be constant during the run; +If the value of \fBrategradient\fR is 0 (or is unset), the arrival rate will be constant during the run; this is the default behavior. If the value is set higher than 0 and at most to 1, the arrival rate will initially be \fIlower\fR than specified via \fBratefactor\fR, half way through the run it will be @@ -340,6 +342,9 @@ what \fBratefactor\fR specifies and at the finish of the run, it will be \fIhigh Effectively, the rate will gradually increase from 100*rategradient percent below normal to 100*rategradient percent above normal. Values outside the range [0;1] will be adjusted to either 0 or 1. +.P +If the second parameter is set to a value of 10 or higher, the increase will be stepwise +rather than gradual and the increase will take place every \fBrategradientstep\fR seconds. .RE .P \fBthreadcount\fR From 89615d8aec70525a13e8cf3bfbfa47c565a79bc6 Mon Sep 17 00:00:00 2001 From: Bjorn Kisbye Engsig$queue:on
-$queue:off
The first two directives +control queueing simulation using a backlog in the same way +the -Q and -N options do. The default is that +queueing simulation is off.
-These have the same effect as -the -Q and -N options; the default is that -queuing simulation using a backlog is off.
+By default, +whenever you have a control loop with queueing simulation +enabled, the time that is registered for waiting for a +session and saved in the wtime column of the runres and +persec tables, is the time actually spent in the +OCISessionGet() call. However, as the queue every +option is emulating an actual queue, the wait time does not +include the time for the thread to wait in the emulated +queue. If you use the $queueeverytiming:on directive, +this time is included in the waiting time. The waiting time +therefore more correctly represent the waiting time that an +emulated end user would have seen. This is also the case if +your database is dedicated where some execution inside a +control loop starts after the calculated time.
$errortime:on
@@ -467,26 +485,6 @@ DIRECTIVES
directive in the first file named with a .rwl suffix.
$dbfailures:<integer>
- -If there is a temporary failure -during declaration of a database, rwloadsim will normally -consider the database to be unavailable and not continue -processing. By using this directive, which must be found -before your database declaration, a temporary failure will -cause a re-attempt at creating the database connection. The -integer value of the directive is limit to the number of -connect attempts.
- -Using this -directive will cause session pool databases to have a -minimum size of at least one.
- -The list of -errors that are considered temporary is found in -rwlerror.c.
- -$embeddedqueryarray:<integer>
$embeddeddmlarray:<integer>
$queueeverytiming:on
-
-$queueeverytiming:off
By default, whenever you have a -control loop that include the queue every option, the -time that is registered for waiting for a session and saved -in the wtime column of the runres and persec tables, is the -time actually spent in the OCISessionGet() call. However, as -the queue every option is emulating an actual queue, -the wait time does not include the time for the thread to -wait in the emulated queue. If you use the -$queueeverytiming:on directive, this time is included -in the waiting time. The waiting time therefore more -correctly represent the waiting time that an emulated end -user would have seen. This is also the case if your database -is dedicated where some execution inside a control loop -starts after the calculated time.
- -$musymbol:<text>
$musymbolfromstring:stringvar
$connecterror:accept
+$dbfailures:<integer>
+ +If there is a temporary failure +during declaration of a database, rwloadsim will normally +consider the database to be unavailable and not continue +processing. By using this directive, which must be found +before your database declaration, a temporary failure will +cause a re-attempt at creating the database connection. The +integer value of the directive is the limit to the number of +connect attempts.
+ +Using this +directive will cause session pool databases to have a +minimum size of at least one.
+ +The list of +errors that are considered temporary is found in +rwlerror.c.
+ + +$connecterror:accept
+
+$connecterror:fail
By default, errors during connection marks the database as unavailable, such that -further use of it is prevented. With this directive errors -during connection are handled like any other error. It -should not normally be used as it can have several -unwanted side effects including connection storms and -further errors later on.
+further use of it is prevented. If the first directive is in +effect, errors during connection are handled like any other +error. It should only be used in special cases as it can +have several unwanted side effects including connection +storms and further errors later on. The directive takes +precedence over the $dbfailures directive, and is +reset using the second version.$useroption:name
diff --git a/docs/refman/directives.html b/docs/refman/directives.html
index 8f4ae65a..ad11a62d 100644
--- a/docs/refman/directives.html
+++ b/docs/refman/directives.html
@@ -1,5 +1,5 @@
-
+
@@ -428,11 +428,29 @@ DIRECTIVES
$queue:on
-$queue:off
The first two directives +control queueing simulation using a backlog in the same way +the -Q and -N options do. The default is that +queueing simulation is off.
-These have the same effect as -the -Q and -N options; the default is that -queuing simulation using a backlog is off.
+By default, +whenever you have a control loop with queueing simulation +enabled, the time that is registered for waiting for a +session and saved in the wtime column of the runres and +persec tables, is the time actually spent in the +OCISessionGet() call. However, as the queue every +option is emulating an actual queue, the wait time does not +include the time for the thread to wait in the emulated +queue. If you use the $queueeverytiming:on directive, +this time is included in the waiting time. The waiting time +therefore more correctly represent the waiting time that an +emulated end user would have seen. This is also the case if +your database is dedicated where some execution inside a +control loop starts after the calculated time.
$errortime:on
@@ -467,26 +485,6 @@ DIRECTIVES
directive in the first file named with a .rwl suffix.
$dbfailures:<integer>
- -If there is a temporary failure -during declaration of a database, rwloadsim will normally -consider the database to be unavailable and not continue -processing. By using this directive, which must be found -before your database declaration, a temporary failure will -cause a re-attempt at creating the database connection. The -integer value of the directive is limit to the number of -connect attempts.
- -Using this -directive will cause session pool databases to have a -minimum size of at least one.
- -The list of -errors that are considered temporary is found in -rwlerror.c.
- -$embeddedqueryarray:<integer>
$embeddeddmlarray:<integer>
$queueeverytiming:on
-
-$queueeverytiming:off
By default, whenever you have a -control loop that include the queue every option, the -time that is registered for waiting for a session and saved -in the wtime column of the runres and persec tables, is the -time actually spent in the OCISessionGet() call. However, as -the queue every option is emulating an actual queue, -the wait time does not include the time for the thread to -wait in the emulated queue. If you use the -$queueeverytiming:on directive, this time is included -in the waiting time. The waiting time therefore more -correctly represent the waiting time that an emulated end -user would have seen. This is also the case if your database -is dedicated where some execution inside a control loop -starts after the calculated time.
- -$musymbol:<text>
$musymbolfromstring:stringvar
$connecterror:accept
+$dbfailures:<integer>
+ +If there is a temporary failure +during declaration of a database, rwloadsim will normally +consider the database to be unavailable and not continue +processing. By using this directive, which must be found +before your database declaration, a temporary failure will +cause a re-attempt at creating the database connection. The +integer value of the directive is the limit to the number of +connect attempts.
+ +Using this +directive will cause session pool databases to have a +minimum size of at least one.
+ +The list of +errors that are considered temporary is found in +rwlerror.c.
+ + +$connecterror:accept
+
+$connecterror:fail
By default, errors during connection marks the database as unavailable, such that -further use of it is prevented. With this directive errors -during connection are handled like any other error. It -should not normally be used as it can have several -unwanted side effects including connection storms and -further errors later on.
+further use of it is prevented. If the first directive is in +effect, errors during connection are handled like any other +error. It should only be used in special cases as it can +have several unwanted side effects including connection +storms and further errors later on. The directive takes +precedence over the $dbfailures directive, and is +reset using the second version.$useroption:name
diff --git a/man/man1rwl/directive.1rwl b/man/man1rwl/directive.1rwl
index 2b3da9fb..cf7aff64 100644
--- a/man/man1rwl/directive.1rwl
+++ b/man/man1rwl/directive.1rwl
@@ -368,13 +368,33 @@ to set the maximum number of errors saved (per thread); the default is 50.
.B $queue:on
.br
.B $queue:off
+.br
+.B $queueeverytiming:on
+.br
+.B $queueeverytiming:off
.RS 4
-These have the same effect as the
+The first two directives control queueing simulation using a backlog
+in the same way the
.B -Q
and
.B -N
-options;
-the default is that queuing simulation using a backlog is off.
+options do.
+The default is that queueing simulation is off.
+.P
+By default, whenever you have a control loop with queueing simulation enabled,
+the time that is registered for waiting for a session and saved in the
+wtime column of the runres and persec tables, is the time actually spent in the
+OCISessionGet() call.
+However, as the \fBqueue every\fR option is emulating an actual queue, the wait
+time does not include the time for the thread to wait in the emulated queue.
+If you use the \fB$queueeverytiming:on\fR directive, this time is included in the
+waiting time.
+The waiting time therefore more correctly represent the waiting time that an
+emulated end user would have seen.
+This is also the case if your database is dedicated where some execution inside
+a control loop starts
+.I after
+the calculated time.
.RE
.P
.B $errortime:on
@@ -412,20 +432,6 @@ These are only available in the start-up file or via $longoption
directive in the first file named with a .rwl suffix.
.RE
.P
-.B $dbfailures:SYNTAX
SYNTAX
unary_expression ::=
primary_expression [ is [ not ] null ]
-| ( - | ! | not ) multiplication
+| ( - | ! | not | ~) multiplication
multiplication ::=
unary_expression
@@ -89,18 +90,34 @@
Strings are implicitly converted to integer or double without error -handling similar to how atoi(3) or atof(3) do it. If -complete control of this is needed, it is recommended to -only use variables and functions of one specific type in the +handling somewhat similar to how atoi(3) or atof(3) do it. +When a string is implicitly converted to an integer, a +leading 0x (or 0X) will cause the conversion to use +hexadecimal characters, except when the string is retrieved +from a database using define or bindout. In +rare cases, this implicit conversion may change existing +code that was written before hexadecimal input was added. +This handling of hexadecimal conversion from string can be +turned off using the $stringhexadecimal:off +directive.
+ +If complete +control of data types is needed, it is recommended to only +use variables and functions of one specific type in the expression.
In rwloadsim, you can have constants of type integer, double or string and the additional constant null. Integer constants are -sequences of digits, double constants are sequences of +sequences of digits or 0x (or 0X) followed by a sequence of +hexadecimal digits, double constants are sequences of digits, a decimal dot, and potentially another sequence of digits. Double constants can additionally have an exponent which is the letter e (or E), potentially followed by + or - @@ -261,7 +295,11 @@
Similar to their equivalents in +the SQL language; these are monadic and post-fix.
- is null |
-- | - | -||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
- |
-
-
- is not null |
-- |
-
-
- Similar to their equivalents in the SQL language; these -are monadic and post-fix. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
- |
-
-
- - ! not |
+
These monadic prefix operators are respectively numeric -negative and two synonyms for boolean not. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
@@ -336,6 +353,19 @@ OPERATORS
<< >> Bitwise left and right shift. Note that both arguments +must have integer values and the right argument must be in +the range [0;63]. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+ |
+
+
< <= > >= |
@@ -363,6 +393,40 @@ OPERATORS
& Bitwise and; both operands must have integer values. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+ |
+
+
+ ^ |
++ |
+
+
+ Bitwise exclusive or; both operands must have integer +values. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+ |
+
+
+ | |
++ |
+
+
+ Bitwise or; both operands must have integer values. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+ |
+
+
= <> != |
@@ -651,6 +715,22 @@ FUNCTIONS resolution is normally microseconds, but it depends on the resolution of the gettimeofday(2) system call. +dbseconds() +ociseconds() + +These functions return the +cumulative number of seconds that has been spent on +respectively the database side and the client side of a +subset of OCI calls such as OCIStmtExecute. The value is a +double and typically has microsecond resolution. You need to +enable collecting the times using respectively +$statsdbtime:on and $statsapptime:on, +otherwise the return values will be zero. Please note that +only a subset of OCI calls are timed, the details are at +runres(1rwl). The absolute values returned by these calls +should not be used, always use the difference between two +calls to either function. +
|