- |
-
-
-
oraerror |
|
@@ -313,13 +285,12 @@ NOTES
-Both
-runseconds and epochseconds behave as read
-only variables, but they are syntactically function calls.
-They can therefore not be used to do SQL bind. If preferred,
-you can use the syntax runseconds() or
-epochseconds() in your code to clearly identify them
-as function calls.
+You can write
+runseconds and epochseconds as if these two
+were variables containing the same values as the functions
+of the same name; this is deprecated and will be desupported
+in some future release. Since they really are functions,
+they cannot be used to do SQL bind.
COPYRIGHT
@@ -327,7 +298,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/include.html b/docs/refman/include.html
index 82677d7e..ee96e4c8 100644
--- a/docs/refman/include.html
+++ b/docs/refman/include.html
@@ -1,5 +1,5 @@
-
+
@@ -74,7 +74,9 @@ DESCRIPTION
$include directive. Unless -no-nameexpand option or
the $nameexpand:off directive is used, environment names in
either $NAME or ${NAME} syntax will be expanded before
-opening the include file.
+opening the include file. You can also use $n where n is a
+single digit beteen 1 and 9 to expand the value of a
+positional argument to rwloadsim.
If the filename
is embedded within the characters < and > instead of
@@ -145,7 +147,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/integer.html b/docs/refman/integer.html
index bf92ae9c..a54a9342 100644
--- a/docs/refman/integer.html
+++ b/docs/refman/integer.html
@@ -1,5 +1,5 @@
-
+
@@ -60,7 +60,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/lob.html b/docs/refman/lob.html
index 1d42770e..e1cd3c89 100644
--- a/docs/refman/lob.html
+++ b/docs/refman/lob.html
@@ -1,5 +1,5 @@
-
+
@@ -46,7 +46,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/lobdeclaration.html b/docs/refman/lobdeclaration.html
index ca16eacc..400887de 100644
--- a/docs/refman/lobdeclaration.html
+++ b/docs/refman/lobdeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -119,7 +119,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/multiprocess.html b/docs/refman/multiprocess.html
index 83382756..348bc59e 100644
--- a/docs/refman/multiprocess.html
+++ b/docs/refman/multiprocess.html
@@ -1,5 +1,5 @@
-
+
@@ -167,7 +167,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/nettest.html b/docs/refman/nettest.html
index 802c054d..183a43e7 100644
--- a/docs/refman/nettest.html
+++ b/docs/refman/nettest.html
@@ -1,5 +1,5 @@
-
+
@@ -51,7 +51,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/netthroughput.html b/docs/refman/netthroughput.html
index e795eca7..bdb18a5f 100644
--- a/docs/refman/netthroughput.html
+++ b/docs/refman/netthroughput.html
@@ -1,5 +1,5 @@
-
+
@@ -292,7 +292,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/ociping.html b/docs/refman/ociping.html
index af5cf671..35c3613f 100644
--- a/docs/refman/ociping.html
+++ b/docs/refman/ociping.html
@@ -1,5 +1,5 @@
-
+
@@ -143,8 +143,8 @@ USAGE
it will show timestamp (unless --no-timestamp is provided)
and the time to perform an OCIPing until the run period is
over, and at the end show averages, standard deviation, min
-and max values. You can kill execution prematurely by typing
-ctrl-c.
+and max values. The output is in ms. You can kill execution
+prematurely by typing ctrl-c.
EXAMPLE
@@ -170,7 +170,8 @@ EXAMPLE
0.051 7.0
0.064 8.0
0.048 9.0
-ociping mean=0.066, stddev=0.043, min=0.048, max=0.196
+ociping (ms) mean=0.066, stddev=0.043, min=0.048,
+max=0.196
You could
subsequently plot the results using gnuplot with an input
@@ -200,7 +201,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oerstats.html b/docs/refman/oerstats.html
index 405cb810..ff53fe80 100644
--- a/docs/refman/oerstats.html
+++ b/docs/refman/oerstats.html
@@ -1,5 +1,5 @@
-
+
@@ -128,7 +128,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/oltp.html b/docs/refman/oltp.html
index 9c0bb664..5d9b19c7 100644
--- a/docs/refman/oltp.html
+++ b/docs/refman/oltp.html
@@ -1,5 +1,5 @@
-
+
@@ -263,7 +263,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpawcols.html b/docs/refman/oltpawcols.html
index ff23853a..4e0ed472 100644
--- a/docs/refman/oltpawcols.html
+++ b/docs/refman/oltpawcols.html
@@ -1,5 +1,5 @@
-
+
@@ -63,7 +63,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpcheckkey.html b/docs/refman/oltpcheckkey.html
index 708a6fa6..300068e6 100644
--- a/docs/refman/oltpcheckkey.html
+++ b/docs/refman/oltpcheckkey.html
@@ -1,5 +1,5 @@
-
+
@@ -55,8 +55,9 @@ USAGE
oltpcheckkey command that take one or more keys as
arguments and runs a query to see if these keys already
exist in the repository from runs made from the same host.
-If they do, the latest entry with that key will be
-shown.
+If they do, the latest entry with that key will be shown,
+and the command exits with the exit code 1. If not, the exit
+code will be 0.
You typically
use this before running oltpscale which requires a
@@ -68,7 +69,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpcore.html b/docs/refman/oltpcore.html
index 1c14545b..b71929dc 100644
--- a/docs/refman/oltpcore.html
+++ b/docs/refman/oltpcore.html
@@ -1,5 +1,5 @@
-
+
@@ -44,7 +44,7 @@ SYNOPSIS
-[-H] [-g]
+ [-H] [-g|-G]
[-a] [-n processes] [-k key] [-r runperiod] [-b] [-R
runfile] [-W] [-K nn] [-p file] [-s file] [-o file] komment
text ...
@@ -102,7 +102,7 @@ OPTIONS
In stead of the normal
simulation of an average arrival rate, run everything in a
-busy loop without any waiting/queueing taking place. You
+busy loop without any waiting/queuing taking place. You
typically do this with much fewer threads (and/or processes)
as each thread in each process constantly will be executing
emulated business transactions.
@@ -116,11 +116,12 @@ OPTIONS
acquired and released.
--g|--graphs
+-g|--graphs|-G|--qegraphs
Show graphs during the run
using gnuplot’s output to X-Windows. This requires a
-properly set DISPLAY environment variable.
+properly set DISPLAY environment variable. The two latter
+options causes an alternative graph; see oltprun(2rwl).
-p|--runnumberfile
@@ -236,7 +237,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpcreate.html b/docs/refman/oltpcreate.html
index 5605090f..0c9881ce 100644
--- a/docs/refman/oltpcreate.html
+++ b/docs/refman/oltpcreate.html
@@ -1,5 +1,5 @@
-
+
@@ -62,7 +62,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpday.html b/docs/refman/oltpday.html
index 9d7105a9..a51ac332 100644
--- a/docs/refman/oltpday.html
+++ b/docs/refman/oltpday.html
@@ -1,5 +1,5 @@
-
+
@@ -134,7 +134,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpdirectory.html b/docs/refman/oltpdirectory.html
new file mode 100644
index 00000000..5a72155e
--- /dev/null
+++ b/docs/refman/oltpdirectory.html
@@ -0,0 +1,141 @@
+
+
+
+
+
+
+
+
+
+oltpdirecotry
+
+
+
+
+oltpdirecotry
+
+NAME
+SYNOPSIS
+OPTIONS
+USAGE
+EXAMPLE
+COPYRIGHT
+SEE ALSO
+
+
+
+
+NAME
+
+
+
+
+oltpdirectory
+− Print the name of a directory
+
+SYNOPSIS
+
+
+
+
+
+oltpdirectory
+[-a|--awrdirectory] [-h|-H|--help] [-s|--scalekey key]
+[-l|--latest] [-r|--runnumber N]
+
+OPTIONS
+
+
+
+
+
+-a|--awrdirectory
+
+By default, the name of the
+results directory will be output, use this option to output
+the name of the directory where html and generated graphics
+is stored.
+
+
+-s|--scalekey
+key
+
+Output the name of the
+directory where gnuplot input, csv files, etc. for some
+specific scale run is found.
+
+
+-r|--runnumber
+NNN
+
+Output the name of the
+directory where gnuplot input, csv files, etc. for some
+specific run is found.
+
+
+-l|--latest
+
+Output the name of the
+directory where gnuplot input, csv files, etc. for the
+latest run from the current host is found.
+
+
+-h|-H|--help
+
+Only output a short help.
+
+USAGE
+
+
+
+
+The
+oltpdirectory command will output nothing but the
+name of a directory and is typically used to provide an
+argument for the cd command. By default, the directory
+output will be the top level results directory, but
+providing the -a option, the top level awr directory will be
+output. If you provide either of the -r option with a
+runnumber as argument or the -s option with a key used for
+oltpscale, the complete directory name where the actual
+files are stored will be output.
+
+EXAMPLE
+
+
+
+
+If you did an
+oltpscale with a key of ’myscale1’ you can
+change your current directory to the directory where all
+input for e.g. gnuplot is by doing:
+
+cd
+‘oltpdirectory -s myscale1‘
+
+COPYRIGHT
+
+
+
+
+Copyright
+© 2023 Oracle Corporation
+Licensed under the Universal Permissive License v 1.0 as
+shown at https://oss.oracle.com/licenses/upl
+
+SEE ALSO
+
+
+
+
+
+oltpparams(2rwl)
+
+
+
diff --git a/docs/refman/oltpdrop.html b/docs/refman/oltpdrop.html
index f07dec0e..473e47b7 100644
--- a/docs/refman/oltpdrop.html
+++ b/docs/refman/oltpdrop.html
@@ -1,5 +1,5 @@
-
+
@@ -63,7 +63,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpfilloe.html b/docs/refman/oltpfilloe.html
index 525bbd78..01d0b4fc 100644
--- a/docs/refman/oltpfilloe.html
+++ b/docs/refman/oltpfilloe.html
@@ -1,5 +1,5 @@
-
+
@@ -63,7 +63,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpforever.html b/docs/refman/oltpforever.html
index 03965fd2..a79969c7 100644
--- a/docs/refman/oltpforever.html
+++ b/docs/refman/oltpforever.html
@@ -1,5 +1,5 @@
-
+
@@ -44,8 +44,8 @@ SYNOPSIS
oltpforever
-[-H] [-g] [-a] [-k key] [-R file] [-K n] [-W] [komment text
-...]
+[-H] [-g|-G] [-a] [-k key] [-R file] [-K n] [-W] [komment
+text ...]
oltpforever2
@@ -69,11 +69,13 @@ OPTIONS
when storing results in the repository database. The default
is the same as the project name.
--g
+
+-g|-G
Show graphs during the runs
using gnuplot’s output to X-Windows. This requires a
-properly set DISPLAY environment variable.
+properly set DISPLAY environment variable. For the -G
+option, see oltprun(2rwl).
-R
file
@@ -141,7 +143,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpkomment.html b/docs/refman/oltpkomment.html
new file mode 100644
index 00000000..456e8acf
--- /dev/null
+++ b/docs/refman/oltpkomment.html
@@ -0,0 +1,116 @@
+
+
+
+
+
+
+
+
+
+oltpkomment
+
+
+
+
+oltpkomment
+
+NAME
+SYNOPSIS
+OPTIONS
+USAGE
+NOTES
+COPYRIGHT
+SEE ALSO
+
+
+
+
+NAME
+
+
+
+
+oltpkomment
+− Show or change the komment for an oltp run
+
+SYNOPSIS
+
+
+
+
+oltpkomment
+[-H|--help] runnumber [--newkomment ’ ...
+’]
+
+OPTIONS
+
+
+
+
+
+-H|--help
+
+Show short help.
+
+
+--newkomment
+’ ... ’
+
+Set a new komment for the
+runnumber provided; the new komment must be a single shell
+argument and therefore typically embedded within quotes.
+
+USAGE
+
+
+
+
+The
+oltpkomment will output the current komment for some
+oltprun done from the host where the command is called from;
+the actual runnumber must be provide as the first argument
+to the oltpkomment command.
+
+If you also
+provide the --newkomment option, the komment will be set to
+a new value in both the repository and in the results
+directory, where it is contained in a text file. After
+changing the komment, you will typically call oltpplot to
+regenerate the output in the awr directory.
+
+NOTES
+
+
+
+
+This command
+exists as it is not sufficient to change the value of the
+KOMMENT column of the RWLRUN table, as the komment is also
+found in a text file in the results directory.
+
+COPYRIGHT
+
+
+
+
+Copyright
+© 2023 Oracle Corporation
+Licensed under the Universal Permissive License v 1.0 as
+shown at https://oss.oracle.com/licenses/upl
+
+SEE ALSO
+
+
+
+
+oltprun(2rwl),
+oltpplot(2rwl), oltpdirectory(2rwl)
+
+
+
diff --git a/docs/refman/oltpparams.html b/docs/refman/oltpparams.html
index 3b7c9fb8..03499fe7 100644
--- a/docs/refman/oltpparams.html
+++ b/docs/refman/oltpparams.html
@@ -1,5 +1,5 @@
-
+
@@ -99,7 +99,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -107,8 +107,10 @@ SEE ALSO
-
-oltp(2rwl)
+
+
+oltpdirectory(2rwl),
+oltp(2rwl)
diff --git a/docs/refman/oltpplot.html b/docs/refman/oltpplot.html
index 2544abd8..199698f7 100644
--- a/docs/refman/oltpplot.html
+++ b/docs/refman/oltpplot.html
@@ -1,5 +1,5 @@
-
+
@@ -25,6 +25,7 @@ oltpplot
OPTIONS
USAGE
EXAMPLES
+NOTES
COPYRIGHT
SEE ALSO
@@ -45,8 +46,9 @@ SYNOPSIS
oltpplot
-[-x|-X|--xmarker|--xline ’time text’]
-[-c|--xcolor rgbname] runnumber
+[--xfile|--Xfile filename] [-x|-X|--xmarker|--xline
+’time text’] [-c|--xcolor rgbname]
+[-l|--latest|[-r] runnumber]
Recreate the
report that was created using oltprun potentially
@@ -89,8 +91,23 @@ OPTIONS
a vertical line spanning the whole range of the y-axis is
printed.
+
+--xfile|--Xfile
+filename
+
+In stead of providing the time
+and the text as a shell argument, you can have a number of
+these combinations stored on individual lines in a text
+file. Each line must have a time per the above (seconds or
+UTC) followed by a blank and the wanted text. No other
+contents may be in the file.
+
+The difference
+between --xfile and --Xfile is like the difference between
+--xmarker and --xline.
+
You can use
-either of the two options repeatedly.
+either of the four options repeatedly.
-c|--xcolor
rgbname
@@ -100,6 +117,13 @@ OPTIONS
’blue’; you can use this option to choose any
other valid rgb name.
+
+-l|--latest
+
+You can provide this option as
+an alternative to an actual runnumber, which causes the
+latest run from the current host to be used.
+
USAGE
@@ -135,14 +159,27 @@ EXAMPLES
12345
If you know
-that 110s and 140s into a run with runnumber 54321 there
-were some external events and you want those external event
-to be shown on the graphs in red, you can recreate graphs
+that 110s and 140s into the last run you did, there were
+some external events and you want those external event to be
+shown on the graphs in red, you can recreate graphs
using
-oltpplus -x
+ oltpplot -x
’110 Something happened’ -x ’140 Something
-else’ -c red 54321
+else’ -c red -l
+
+The previous
+example could alternatively be created via a file named
+m.txt with just these two lines:
+
+110 Something
+happened
+140 Something else
+
+and running
+
+oltpplot -xfile
+m.txt -c red -l
If you are
using srvctl to relocate a service during a run, and you
@@ -161,13 +198,23 @@ EXAMPLES
from the two calls to date in your shell script as the time
in the --xmarker options to oltprun.
+NOTES
+
+
+
+
+If you want to
+provide an actual runnumber, this can be done either using
+the -r option or simply as (the only) non option
+argument.
+
COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -177,7 +224,7 @@ SEE ALSO
oltp(2rwl),
-oltprun(2rwl)
+oltprun(2rwl), oltpkomment(2rwl)
diff --git a/docs/refman/oltpplus.html b/docs/refman/oltpplus.html
index d7e532e0..8c45007c 100644
--- a/docs/refman/oltpplus.html
+++ b/docs/refman/oltpplus.html
@@ -1,5 +1,5 @@
-
+
@@ -147,7 +147,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltprun.html b/docs/refman/oltprun.html
index 37d7541e..d4697b67 100644
--- a/docs/refman/oltprun.html
+++ b/docs/refman/oltprun.html
@@ -1,5 +1,5 @@
-
+
@@ -44,8 +44,9 @@ SYNOPSIS
oltprun [-H]
-[-g] [-a] [-2] [-k key] [-r runperiod] [-R file] [-n procs]
-[-x script] [-o file] [-K n] [-W] [komment text ...]
+[-g|-G] [-a] [-2] [-k key] [-r runperiod] [-R file] [-n
+procs] [-x script] [-o file] [-K n] [-W] [komment text
+...]
Execute one run
using the oltp workload, saving intermediate results in the
@@ -98,7 +99,7 @@ OPTIONS
In stead of the normal
simulation of an average arrival rate, run everything in a
-busy loop without any waiting/queueing taking place. You
+busy loop without any waiting/queuing taking place. You
typically do this with much fewer threads (and/or processes)
as each thread in each process constantly will be executing
emulated business transactions.
@@ -114,9 +115,23 @@ OPTIONS
-g|--graphs
-Show graphs during the run
-using gnuplot’s output to X-Windows. This requires a
-properly set DISPLAY environment variable.
+Show two graphs during the run
+using gnuplot’s output to X-Windows; this requires a
+properly set DISPLAY environment variable. One graph will
+show distribution of sessions on database instances together
+with counts of open and active sessions when a session pool
+is in use. The other graph will show the throughput of the
+various emulated business transactions.
+
+
+-G|--gegraphs
+
+An alternative to the previous,
+where the second running graph will show total throughput
+and queue time respectively total time per transaction for a
+few selected emulated business transactions. This is
+particularly useful when using external control to
+immediately see the effect of any changes.
-2
@@ -192,7 +207,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -202,7 +217,8 @@ SEE ALSO
oltp(2rwl),
-oltpcore(2rwl), oltpscale(2rwl), oltpforever(2rwl)
+oltpcore(2rwl), oltpscale(2rwl), oltpforever(2rwl),
+oltpkomment(2rwl)
diff --git a/docs/refman/oltpscale.html b/docs/refman/oltpscale.html
index 78f3ad70..47245b69 100644
--- a/docs/refman/oltpscale.html
+++ b/docs/refman/oltpscale.html
@@ -1,5 +1,5 @@
-
+
@@ -44,8 +44,8 @@ SYNOPSIS
oltpscale
-[-H] [-g] [-a] [-A] [-k key] [-r runperiod] [-b] [-l lo] [-h
-hi] [-i int] [-K n] [-W] [-R file] [komment text
+[-H] [-g|-G] [-a] [-A] [-k key] [-r runperiod] [-b] [-l lo]
+[-h hi] [-i int] [-K n] [-W] [-R file] [komment text
...]
Execute a
@@ -120,7 +120,7 @@ OPTIONS
In stead of the normal
simulation of an average arrival rate, run everything in a
-busy loop without any waiting/queueing taking place. You
+busy loop without any waiting/queuing taking place. You
typically do this with much fewer threads (and/or processes)
as each thread in each process constantly will be executing
emulated business transactions.
@@ -133,15 +133,16 @@ OPTIONS
if you do use e.g. sessionpool, sessions will constantly be
acquired and released.
--g
---graphs
+
+-g|--graphs|-G|--qegraphs
Show graphs during the run
using gnuplot’s output to X-Windows. This requires a
-properly set DISPLAY environment variable.
+properly set DISPLAY environment variable. The two latter
+options causes an alternative graph; see oltprun(2rwl).
+
--a
---preallocate
+-a|--preallocate
If your orders and order_items
tables are partitioned, you can use the -a option to make
@@ -188,7 +189,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpscalereport.html b/docs/refman/oltpscalereport.html
index f6fd2e11..d35c784f 100644
--- a/docs/refman/oltpscalereport.html
+++ b/docs/refman/oltpscalereport.html
@@ -1,5 +1,5 @@
-
+
@@ -112,7 +112,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpsetup.html b/docs/refman/oltpsetup.html
index 26fcdad3..662efded 100644
--- a/docs/refman/oltpsetup.html
+++ b/docs/refman/oltpsetup.html
@@ -1,5 +1,5 @@
-
+
@@ -28,6 +28,7 @@ oltpsetup
PARAMETERS
BURSTS
VERIFICATION
+UNDOCUMENTED PARAMETERS
BUGS
COPYRIGHT
SEE ALSO
@@ -488,6 +489,59 @@ PARAMETERS
processes.
+time_out
+
+When time_out is set to an
+actual value of 0 or more, any transaction that is delayed
+by more than the value of time_out seconds will be
+dropped in stead of being actually executed. When a
+transaction is dropped, no database session will be
+acquired, and the transaction is not executed. In stead, the
+drop count will be increased by 1. This is only likely to
+happen when the datbase is under pressure and when the
+actual time to get a database session and execute a
+transaction is higher than the inverse of the arrival rate.
+The drop count is visible in the persec table with a vname
+of ’call_failure’.
+
+The following
+parameters with names starting with fix_ have effect when
+the execution is fixed at starttime, i.e. when external
+control is not used.
+
+
+fix_logoffrate
+
+This is a double value that can
+be set to increase the logon activity by causing session
+release to also disconnect. By default, this does not
+happen, but if set to a value in the range ]0;1], the value
+sets the proportion of sessions doing the make_order
+transaction that will disconnect during session release. The
+parameter only has effect when the normal pool is a session
+pool.
+
+
+fix_cursorleak
+
+This is a double value that can
+be set to make the application leak cursors at a certain
+rate. By default, this does not happen, but if set to a
+value in the range ]0;1], the value sets the proportion of
+cursors that will be leaked. If you want to experiment with
+the, start with very low values such as 0.001 and be
+prepared that you will receive ORA-01000 errors.
+
+
+fix_hardparse
+
+This is a double value that can
+be set to make hard parse take place. By default, no hard
+parse takes place, but if the parameter is set to a value
+higher than zero, hard parse will take place. The valid
+range is [0;1].
+
+
orders_hashcount
If your database does not have
@@ -496,6 +550,14 @@ runplot_width
+
+If you are using -g or -G to
+show running graphs, they will by default show the latest
+60s of activity, unless this parameter is set to a different
+value.
+
+
gnuplotjs
To generate clickable svg
@@ -514,11 +576,15 @@ BURSTS
You can include
-three different types of "bursts" in your run; one
+four different types of "bursts" in your run; one
does a burst using a higher average transaction arrival
rate, the other does a burst using a higher number of worker
-threads, and the third is an implicit burst being the result
-of a period with reduced session pool sizes. For the first,
+threads, the third does an activity burst by changing
+(logged on) sessions from being idle to being active, and
+the last is an implicit burst being the result of a period
+with reduced session pool sizes.
+
+For the first,
you must provide a factor, by which the arrival rate
increases, and for the second, you must provide the count of
extra worker threads. For both, you provide the time in
@@ -535,7 +601,7 @@ BURSTS
burst_factor
The two first parameters set
-the time to start and length of the burst, and the second
+the time to start and length of the burst, and the third
parameter is the factor that is applied to the arrival rate
during the burst.
@@ -550,16 +616,51 @@ BURSTS
wburst_count
The two first parameters set
-the time to start and length of the burst, and the second
+the time to start and length of the burst, and the third
parameter is the number of extra worker threads during the
-burst.
+burst. To prevent all processes from increasing the worker
+thread count at the same time, you can include procnumber in
+your calculation for wburst_start. As an example, if you set
+wburst_start to 200+procnumber, the increase in worker
+threads will be at 200s for process 1, 201s for process 2,
+etc.
All parameters
are double except wburst_count that is an integer, and you
can very well include both types of burst.
-Third type of
-bursts comes due to a backlog of transactions that are
+ The third type
+of burst is provided by spedifying a point in time during
+the run where the activity changes. All workers are
+connected (assuming no pooling is in place), but before that
+point in time, only some workers are active. When the point
+in time for the change is reached, all workers get active,
+which will cause an activity burst, which results in e.g.
+many cursors being (soft) parsed at the same time. The four
+parameters controlling this are:
+
+
+aburst_workers
+
+aburst_pre_factor
+aburst_post_factor
+aburst_start
+
+In the period until
+aburst_start, only aburst_workers do actual work while the
+remaining (i.e. threadcount-aburst_workers) are connected
+but are idle. The arrival rate in the active workers during
+this period is a factor aburst_pre_factor higher than
+normal. If the value
+aburst_pre_factor*aburst_workes/threadcount is 1.0, the
+effective arrival rate during this period is the same as it
+would have been without an activity burst. In the period
+after aburst_start, all workers are active, in the arrival
+rate of these is the normal arrival rate multiplied by
+aburst_post_factor. The default for both factors is 1.0.
+
+The last type
+of bursts comes due to a backlog of transactions that are
delayed during a period with reduced sessions in the normal
pool. It only has effect when using session pools.
@@ -602,6 +703,17 @@ VERIFICATION
To verify
schemas are properly created, run oltpverify -u.
+UNDOCUMENTED PARAMETERS
+
+
+
+
+There are some
+extra parameters, that you can set in either your
+key.rwl file or using -i or -d on the oltprun command
+line. To get documentation for these, you need to look at
+the parameters.rwl file in the oltp directory.
+
BUGS
@@ -627,7 +739,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -638,7 +750,8 @@ SEE ALSO
oltp(2rwl),
oltpcreate(2rwl), oltpdrop(2rwl), oltpawcols(2rwl),
-oltprun(2rwl), oltpforever(2rwl), oltpday(2rwl)
+oltprun(2rwl), oltpforever(2rwl), oltpday(2rwl),
+oltxcrun(2rwl)
diff --git a/docs/refman/oltpverify.html b/docs/refman/oltpverify.html
index 1b7b10a2..c0e5d0b9 100644
--- a/docs/refman/oltpverify.html
+++ b/docs/refman/oltpverify.html
@@ -1,5 +1,5 @@
-
+
@@ -44,41 +44,83 @@ SYNOPSIS
oltpverify
-[-H] [-u] [-u] [-s] [-d]
+[-H|--help] [-a|--all] [-d|--directories] [-u|--runuser]
+[--awuser] [--oeuser] [-r|--repository] [-s] [--system]
+[--cruser] [-2]
OPTIONS
--H
+
+-H|--help
Show short help
--d
+
+-d|--directories
Verify results and awr
directories are fine.
-s
-Verify system databases can
+ Verify all system databases can
connect.
--r
+
+--system
+
+Verify the system and awr
+databases can connect.
+
+
+--cruser
+
+Verify the system database used
+for schema creation can connect.
+
+
+-r|--repository
Verify repository database can
connect.
--u
+-2
+
+For the relevant tests, verify
+side 2.
+
+
+--awuser
+
+Verify the aw schema user
+database can connect.
+
+
+--oeuser
+
+Verify the oe schema user
+database can connect.
+
+
+-u|--runuser
Verify the run user database
can connect.
--a
+
+-a|--all
Perform all verifications
+
+-q|--quiet
+
+Do not output banners from
+invocations of rwloadsim.
+
USAGE
@@ -87,7 +129,11 @@ USAGE
The
oltpverify command is used while you prepare your
parameter file to verify settings are correct for your oltp
-workload.
+workload. When executed before running oltpcreate, suggested
+options are -d -s -r to verify directories, system
+and repository databases can connect. After oltpcreate has
+been executed, you should run oltpverify twice with
+respectively -a and -a -2 options.
COPYRIGHT
@@ -95,7 +141,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/oltpxc.html b/docs/refman/oltpxc.html
index b94c0f89..f5507eee 100644
--- a/docs/refman/oltpxc.html
+++ b/docs/refman/oltpxc.html
@@ -1,5 +1,5 @@
-
+
@@ -169,7 +169,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/oltpxcrun.html b/docs/refman/oltpxcrun.html
index d76a1b62..0e6429c8 100644
--- a/docs/refman/oltpxcrun.html
+++ b/docs/refman/oltpxcrun.html
@@ -1,5 +1,5 @@
-
+
@@ -24,6 +24,7 @@ oltpxcrun
SYNOPSIS
OPTIONS
USAGE
+NOTES
COPYRIGHT
SEE ALSO
@@ -44,8 +45,8 @@ SYNOPSIS
oltpxcrun
-[-H] [-g] [-a] [-k key] [-R file] [-r runperiod] [--no-awr]
-[--default] [komment text ...]
+[-H] [-g|-G] [-a] [-k key] [-R file] [-r runperiod]
+[--no-awr] [--default] [komment text ...]
Continuously
make long runs with external control.
@@ -93,11 +94,13 @@ OPTIONS
Do not generate awr snapshots,
awr report and other run results.
--g
+
+-g|-G
Show graphs during the runs
using gnuplot’s output to X-Windows. This requires a
-properly set DISPLAY environment variable.
+properly set DISPLAY environment variable. For -G, see
+oltprun(2rwl).
-R
file
@@ -132,13 +135,26 @@ USAGE
recommended that you redirect stderr from oltpxcrun to a
file that you show using tail -f.
+NOTES
+
+
+
+
+External
+control primarily exists for use internally by Oracle
+Corporation, and it is on purpose vaguely documented. It is
+not guaranteed that external control will be
+consistent over time, nor that it will continue to be
+available. Further, it may impact other parts of the oltp
+workload, and such impact may change in the future.
+
COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -148,7 +164,7 @@ SEE ALSO
oltp(2rwl),
-oltpcore(2rwl), oltpxset(2rwl)
+oltpcore(2rwl), oltpxcset(2rwl)
diff --git a/docs/refman/oltpxcset.html b/docs/refman/oltpxcset.html
index 20c797b8..3ea9d3b6 100644
--- a/docs/refman/oltpxcset.html
+++ b/docs/refman/oltpxcset.html
@@ -1,5 +1,5 @@
-
+
@@ -249,7 +249,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/ovid2.html b/docs/refman/ovid2.html
index b475a769..73b82d92 100644
--- a/docs/refman/ovid2.html
+++ b/docs/refman/ovid2.html
@@ -1,5 +1,5 @@
-
+
@@ -111,7 +111,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/percentiles.html b/docs/refman/percentiles.html
index 048e0711..603cdb49 100644
--- a/docs/refman/percentiles.html
+++ b/docs/refman/percentiles.html
@@ -1,5 +1,5 @@
-
+
@@ -116,7 +116,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/persec.html b/docs/refman/persec.html
index 85956ac7..3d02b56d 100644
--- a/docs/refman/persec.html
+++ b/docs/refman/persec.html
@@ -1,5 +1,5 @@
-
+
@@ -153,7 +153,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/printfstatement.html b/docs/refman/printfstatement.html
index b99ec618..f087812a 100644
--- a/docs/refman/printfstatement.html
+++ b/docs/refman/printfstatement.html
@@ -1,5 +1,5 @@
-
+
@@ -24,6 +24,7 @@ printfstatement
SYNTAX
DESCRIPTION
USAGE
+ENGINEERING NOTATION
NULL
EXAMPLES
COPYRIGHT
@@ -105,9 +106,43 @@ USAGE
specific argument.
Only a limited
-set of conversion specifiers are useful: d, i
-or x for integers, e, f, g for
-doubles and s for strings.
+set of standard conversion specifiers are useful: d,
+i or x for integers, e, f,
+g for doubles and s for strings.
+
+ENGINEERING NOTATION
+
+
+
+
+You can output
+double values using engineering notation, i.e. with an SI
+prefix such as k for kilo, n for nano, etc. This is done
+using the m or M conversion specifier, and is
+useful when the absolute value is in the range
+[1.0e-30;9.99e+32] or is exactly zero. The precision has the
+same effect as for the standard e conversion implying
+the output will be rounded and have one more significant
+digit than given by the precision. The precision must be 2
+or higher, and the field width should not be set.
+
+The symbol for
+micro, µ, i.e. 1e-6 is by default using the UTF-8
+encoding, which is the two hexadecimal values 0xc2 and 0xb5;
+you must use the $musymbol direrective to change this if
+your terminal is not using the UTF-8 (or compatible)
+character set.
+
+The difference
+between the two specifiers is that M outputs one
+space character between the number and the SI-prefix, while
+the m outputs the SI-prefix directly after the
+number.
+
+The decimal
+point is not output if no significant digits are output
+after it. This can only happen if the precision is 2 and the
+absolute value to be output is at least 100.
NULL
@@ -179,13 +214,27 @@ EXAMPLES
|NULL|nothing|
+This example
+shows how the m specifier can be used:
+
+double tt :=
+12.34e-6;
+printf "the time is %.3ms\n", tt;
+
+while will
+produce this output with the µ symbol in its UTF-8
+representation.
+
+the time is
+12.34µs
+
COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
@@ -196,7 +245,7 @@ SEE ALSO
statement(1rwl),
-filestatement(1rwl), expression(1rwl)
+filestatement(1rwl), expression(1rwl), directive(1rwl)
diff --git a/docs/refman/procedure.html b/docs/refman/procedure.html
index 412fb364..45002fe3 100644
--- a/docs/refman/procedure.html
+++ b/docs/refman/procedure.html
@@ -1,5 +1,5 @@
-
+
@@ -45,7 +45,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/proceduredeclaration.html b/docs/refman/proceduredeclaration.html
index 4492e512..1bdcc649 100644
--- a/docs/refman/proceduredeclaration.html
+++ b/docs/refman/proceduredeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -48,8 +48,10 @@ SYNTAX
proceduredeclaration
::=
[ private ] procedure identifier
-( [ argumentlist ] ) [ statistics |
-nostatistics ] [ is ]
+( [ argumentlist ] )
+[ statistics | nostatistics |
+statisticsonly ]
+[ is ]
statementlist
end [ procedure | identifier ]
@@ -97,7 +99,7 @@ DESCRIPTION
simulated business logic and are as such called repeatedly
using control loops to simulate some workload. They can
therefore have statistics associated with them, which
-includes thing like execution times, number of executions,
+includes things like execution times, number of executions,
etc. If the procedure contains any execution of SQL, such
statistics are collected by default; using the
nostatistics keyword turns this off. If the procedure
@@ -105,9 +107,15 @@ DESCRIPTION
statistics keyword; doing so will enable statistics
collection for the procedure and will additionally make
rwloadsim treat the procedure as if it were doing SQL
-execution. This again will imply the procedure will ensure a
+execution. This again implies the procedure will ensure a
database connection exists (e.g. by getting on from a
-session pool).
+session pool). If the procedure does not contain any
+execution of SQL, you can alternatively provide the
+statisticsonly attribute. This implies statistics
+such as execution counts is being gathered, but the
+procedure will not ensure or require a database
+connection. See controlloop(1rwl) for an example of how this
+can be used.
Functions never
have statistics collected, even if they contain SQL
@@ -192,7 +200,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/random.html b/docs/refman/random.html
index b0984b8e..141d162c 100644
--- a/docs/refman/random.html
+++ b/docs/refman/random.html
@@ -1,5 +1,5 @@
-
+
@@ -46,7 +46,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/randomproceduredeclaration.html b/docs/refman/randomproceduredeclaration.html
index 620b4ec8..3d8da514 100644
--- a/docs/refman/randomproceduredeclaration.html
+++ b/docs/refman/randomproceduredeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -140,7 +140,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/randomstringdeclaration.html b/docs/refman/randomstringdeclaration.html
index 36b44492..2c4fe219 100644
--- a/docs/refman/randomstringdeclaration.html
+++ b/docs/refman/randomstringdeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -133,7 +133,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/regex.html b/docs/refman/regex.html
index 6a7b0910..bb5e9e97 100644
--- a/docs/refman/regex.html
+++ b/docs/refman/regex.html
@@ -1,5 +1,5 @@
-
+
@@ -206,7 +206,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/runres.html b/docs/refman/runres.html
index 8ac31eb1..95a0326f 100644
--- a/docs/refman/runres.html
+++ b/docs/refman/runres.html
@@ -1,5 +1,5 @@
-
+
@@ -139,7 +139,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/rwlcpu.html b/docs/refman/rwlcpu.html
index de632863..ea00b50b 100644
--- a/docs/refman/rwlcpu.html
+++ b/docs/refman/rwlcpu.html
@@ -1,5 +1,5 @@
-
+
@@ -162,7 +162,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/rwlerror.html b/docs/refman/rwlerror.html
index 87365275..5b35ef5d 100644
--- a/docs/refman/rwlerror.html
+++ b/docs/refman/rwlerror.html
@@ -1,5 +1,5 @@
-
+
@@ -141,7 +141,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/rwlman.html b/docs/refman/rwlman.html
index 0b39cf8f..07855afd 100644
--- a/docs/refman/rwlman.html
+++ b/docs/refman/rwlman.html
@@ -1,5 +1,5 @@
-
+
@@ -141,7 +141,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/rwloadsim.html b/docs/refman/rwloadsim.html
index 71914359..74096c66 100644
--- a/docs/refman/rwloadsim.html
+++ b/docs/refman/rwloadsim.html
@@ -1,5 +1,5 @@
-
+
@@ -1001,7 +1001,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/rwlprogram.html b/docs/refman/rwlprogram.html
index 5198b8fc..0e303818 100644
--- a/docs/refman/rwlprogram.html
+++ b/docs/refman/rwlprogram.html
@@ -1,5 +1,5 @@
-
+
@@ -239,7 +239,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/rwlrun.html b/docs/refman/rwlrun.html
index 548f8cd7..212154ed 100644
--- a/docs/refman/rwlrun.html
+++ b/docs/refman/rwlrun.html
@@ -1,5 +1,5 @@
-
+
@@ -145,7 +145,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/simpledeclaration.html b/docs/refman/simpledeclaration.html
index b7da06b5..253a5a27 100644
--- a/docs/refman/simpledeclaration.html
+++ b/docs/refman/simpledeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -196,7 +196,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqldeclaration.html b/docs/refman/sqldeclaration.html
index 385ef1d4..eb6a82aa 100644
--- a/docs/refman/sqldeclaration.html
+++ b/docs/refman/sqldeclaration.html
@@ -1,5 +1,5 @@
-
+
@@ -851,7 +851,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/sqlexecution.html b/docs/refman/sqlexecution.html
index 6a6ce954..f5479dac 100644
--- a/docs/refman/sqlexecution.html
+++ b/docs/refman/sqlexecution.html
@@ -1,5 +1,5 @@
-
+
@@ -293,7 +293,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqlid2file.html b/docs/refman/sqlid2file.html
index 82be3236..455ab62d 100644
--- a/docs/refman/sqlid2file.html
+++ b/docs/refman/sqlid2file.html
@@ -1,5 +1,5 @@
-
+
@@ -115,7 +115,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqlmonitor.html b/docs/refman/sqlmonitor.html
index 0cd0162b..efd060ea 100644
--- a/docs/refman/sqlmonitor.html
+++ b/docs/refman/sqlmonitor.html
@@ -1,5 +1,5 @@
-
+
@@ -151,7 +151,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqlmonitorawr.html b/docs/refman/sqlmonitorawr.html
index 4cdf97c3..7e942d73 100644
--- a/docs/refman/sqlmonitorawr.html
+++ b/docs/refman/sqlmonitorawr.html
@@ -1,5 +1,5 @@
-
+
@@ -181,7 +181,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqlreport.html b/docs/refman/sqlreport.html
index d7dfa3e5..62a5f0d4 100644
--- a/docs/refman/sqlreport.html
+++ b/docs/refman/sqlreport.html
@@ -1,5 +1,5 @@
-
+
@@ -119,7 +119,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sqlstatement.html b/docs/refman/sqlstatement.html
index 3a66ec6c..8141bf06 100644
--- a/docs/refman/sqlstatement.html
+++ b/docs/refman/sqlstatement.html
@@ -1,5 +1,5 @@
-
+
@@ -234,7 +234,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/statement.html b/docs/refman/statement.html
index d3f3dc4c..7fd03c1f 100644
--- a/docs/refman/statement.html
+++ b/docs/refman/statement.html
@@ -1,5 +1,5 @@
-
+
@@ -181,7 +181,8 @@ SIMPLE STATEMENTS
Suspend execution for a number
of seconds which is a double. If a database session is held,
-the session will not be released during the wait.
+the session will not be released during the wait. If the
+expression is zero or less, there is no wait.
system
@@ -229,7 +230,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/statistics.html b/docs/refman/statistics.html
index 96f4c5c3..d76da33f 100644
--- a/docs/refman/statistics.html
+++ b/docs/refman/statistics.html
@@ -1,5 +1,5 @@
-
+
@@ -242,7 +242,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/string.html b/docs/refman/string.html
index 6772db46..8c766138 100644
--- a/docs/refman/string.html
+++ b/docs/refman/string.html
@@ -1,5 +1,5 @@
-
+
@@ -61,7 +61,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under the Universal Permissive License v 1.0 as
shown at https://oss.oracle.com/licenses/upl
diff --git a/docs/refman/sysres.html b/docs/refman/sysres.html
index 59f350a4..b295f444 100644
--- a/docs/refman/sysres.html
+++ b/docs/refman/sysres.html
@@ -1,5 +1,5 @@
-
+
@@ -154,7 +154,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/useroption.html b/docs/refman/useroption.html
index f320bd85..7eff2375 100644
--- a/docs/refman/useroption.html
+++ b/docs/refman/useroption.html
@@ -1,5 +1,5 @@
-
+
@@ -286,7 +286,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
diff --git a/docs/refman/utilities.html b/docs/refman/utilities.html
index 3515be5a..035c0b79 100644
--- a/docs/refman/utilities.html
+++ b/docs/refman/utilities.html
@@ -1,5 +1,5 @@
-
+
@@ -152,7 +152,7 @@ COPYRIGHT
Copyright
-© 2022 Oracle Corporation
+© 2023 Oracle Corporation
Licensed under
the Universal Permissive License v 1.0 as shown at
From 9dabb643c55ce543781fa9e67cde62ec3d499a82 Mon Sep 17 00:00:00 2001
From: Bjorn Kisbye Engsig
Date: Tue, 13 Jun 2023 16:01:57 +0000
Subject: [PATCH 17/19] Limit sequences to sb8
---
oltp/mtit_create.sql | 7 ++++---
oltp/mtit_declarations.rwl | 2 +-
2 files changed, 5 insertions(+), 4 deletions(-)
diff --git a/oltp/mtit_create.sql b/oltp/mtit_create.sql
index 3102b2e3..26af3657 100644
--- a/oltp/mtit_create.sql
+++ b/oltp/mtit_create.sql
@@ -10,6 +10,7 @@ rem Name
rem mtit_create.sql - Create Max Throughput Insert Tranaction
rem
rem History
+rem bengsig 13-jun-2023 - set sequence max to 2^63 to fit in sb8
rem bengsig 10-may-2023 - Creation
create table aw_mtit_noix
@@ -59,13 +60,13 @@ create table aw_mtit_cdr
)
/
-create sequence aw_mit_seq_small cache 20
+create sequence aw_mit_seq_small cache 20 maxvalue 9223372036854775800
/
-create sequence aw_mit_seq_large cache 20000
+create sequence aw_mit_seq_large cache 20000 maxvalue 9223372036854775800
/
-create sequence aw_mit_seq_scale cache 20000 scale
+create sequence aw_mit_seq_scale cache 20000 maxvalue 9223372036854775800 scale
/
exit
diff --git a/oltp/mtit_declarations.rwl b/oltp/mtit_declarations.rwl
index c2df224d..887f8052 100644
--- a/oltp/mtit_declarations.rwl
+++ b/oltp/mtit_declarations.rwl
@@ -56,7 +56,7 @@ procedure mtit_ins_rows() nostatistics
string(2000) payload;
string(2000) ovid2load;
ovid2load := ovidstring2(mtit_max_payload);
- string seq; # must be string for large values
+ integer seq; # fits in sb8 - see mtit_create.sql
sql mtit_get_seq
define sql;
From 4136fe849a9b9bfacb984641dd937a48cb09e5cf Mon Sep 17 00:00:00 2001
From: Jack Kennedy
Date: Wed, 14 Jun 2023 16:02:36 +0000
Subject: [PATCH 18/19] Now supports 23c
---
BUILDING.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/BUILDING.md b/BUILDING.md
index c7637136..59592012 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -3,7 +3,7 @@
## Prerequisites
* An Oracle client environment (release 19.9 or higher) used for building the tool; Instant Client including basiclite, sdk and sqlplus is fine.
- * Potentially client environments for other releases than the primary build release, these can similarly use full client or Instant Client; releases 11, 12, 18, 19, 21 are supported.
+ * Potentially client environments for other releases than the primary build release, these can similarly use full client or Instant Client; releases 11, 12, 18, 19, 21, 23 are supported.
* For client release 19, you must have at least 19.9.
* A database (release 19 or higher, release 21.3 preferred) that can be used to run test scripts.
* An environment with the gcc compiler and tools like make.
From 39f310d9eecf6f1d93abbae32c168c5fbb5f8c46 Mon Sep 17 00:00:00 2001
From: Bjorn Kisbye Engsig
Date: Wed, 14 Jun 2023 16:50:54 +0000
Subject: [PATCH 19/19] Update to security.md
---
SECURITY.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/SECURITY.md b/SECURITY.md
index fb238413..2ca81027 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -21,7 +21,7 @@ security features are welcome on GitHub Issues.
Security updates will be released on a regular cadence. Many of our projects
will typically release security fixes in conjunction with the
-[Oracle Critical Patch Update][3] program. Additional
+Oracle Critical Patch Update program. Additional
information, including past advisories, is available on our [security alerts][4]
page.
|