awreport and awrdump updates etc

Author: bengsig

.gitignore

@@ -5,19 +5,12 @@ new.git.branch
 afiedt.buf
 bin/rwloadsim??
 bin/rwlerror
+genbin11/*
+genbin19/*
 lib/*.o
 dist-rwl-bin.sh
 push_to_remotes.sh
 make.generated.sh
-ociping11
-connping11
-netthroughput11
-ociping12
-connping12
-netthroughput12
-ociping
-connping
-netthroughput
 *.tgz
 *.o
 *.i

CHANGELOG.md

@@ -8,6 +8,7 @@
 * The oltp workload has new features to allow it to be used for live demonstration
 * An oltp workload run can be set to gradually increase the arrival rate
 * $queueeverytiming:on directive to include emulated queue time
+* Updated awreport and new awrdump utilities
 
 ## 3.0.3
 

bin/awrdump

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2021 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u awrdump.rwl
+
+# bengsig  23-nov-2022 - Creation
+
+rwloadsim --pretend-gen-banner='RWP*AWR Dump Repository' -u awrdump.rwl "$@"

bin/awreport

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2021 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u awreport.rwl
+
+# bengsig  23-nov-2022 - Creation
+
+rwloadsim --pretend-gen-banner='RWP*AWR Report' -u awreport.rwl "$@"

bin/connping

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2021 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u connping.rwl
+
+# bengsig  23-nov-2022 - Creation
+
+rwloadsim --pretend-gen-banner='RWP*Connect/OCIPing' -u connping.rwl "$@"

bin/netthroughput

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2021 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u netthroughput.rwl
+
+# bengsig  23-nov-2022 - Creation
+
+rwloadsim --pretend-gen-banner='RWP*Oracle Net Throughput' -u netthroughput.rwl "$@"

bin/ociping

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2021 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u ociping.rwl
+
+# bengsig  23-nov-2022 - Creation
+
+rwloadsim --pretend-gen-banner='RWP*OCIPing' -u ociping.rwl "$@"

docs/ERRORLIST.md

@@ -1164,7 +1164,7 @@ You should change your code and use a different identifer as it otherwise will
 cause a syntax error in the future.
 
 ### RWL-294 error: "Variables of type %s cannot be declared threads sum"
-The threads sum attribut can only be used with variables of type integer
+The threads sum attribute can only be used with variables of type integer
 or double..
 
 ### RWL-295 warning: "Assign to threads global '%s' with same variable in expression"
@@ -1177,6 +1177,10 @@ You have been using the abort statement and $abortnice is in effect. It should
 only be used when no other possibilities exist.
 Consider using exit in stead.
 
+### RWL-297 warning: "All arguments are positional in a generated executable"
+When generating an executable for direct execution of rwl scripts, all
+arguments are rwl files during generation, and are positional at execution..
+
 ### RWL-600 internal error: '%s'
 An abnormal situation caused an internal error in rwloadsim.
 This is in most cases due to a programming error and it

docs/MISCUTIL.md

@@ -9,6 +9,11 @@ For details, please see the appropriate rwlman page.
 |sqlid2file|Extracts the sql text of a provided sqlid from either gv$sql or awr_hist_sqltext and saves it in a file|
 |sqlmonitor|Creates a sql monitor for a given sqlid from data available in the shared pool|
 |sqlmonitorawr|Creates a sql monitor for a given sqlid from data available in the awr repository|
+|awreport|List available awr repositories and create awr or ash reports|
+|awrdump|Extract awr data as datapump dump file and potentially copy it to an OCI bucket|
+
+The latter two are available as shell scripts in a full rwloadsim installation
+and also distributed as stand alone executables.
 
 ## Navigation
 * [index.md](index.md#rwpload-simulator-users-guide) Table of contents

docs/ORACLENET.md

@@ -10,6 +10,8 @@ database, i.e. both username, password and connect string.
 
 Two of them, ociping.rwl and connping.rwl, produce output similar to
 ping; the third does a more comprehensive network throughput test.
+They are all available as shell scripts that can be called directly
+as their name such as ociping.
 
 The first, ociping.rwl, only measures the time to do a simple SQL\*Net roundtrip using
 OCIPing.
@@ -33,7 +35,7 @@ The third script, netthroughput.rwl estimates the total available throughput
 from the database to the client.
 A sample call and output is:
 ```
-rwloadsim --concurrency=10 -ul username/{password}@//host/db --period=20 netthroughput.rwl
+netthroughput --concurrency=10 -l username/{password}@//host/db --period=20
 
 RWP*Load Simulator Release 3.0.2.20 Development on Mon, 19 Sep 2022 08:44:52 UTC
 Connected default database to:
@@ -48,8 +50,8 @@ or ```rwlman nettest```.
 
 ### Stand alone executables
 
-The three utilities are distributed as completely stand alone
-executables in the file generated-linux-x86_64-bin-3.0.3.tgz.
+The three utilities are distributed together with other as completely stand alone
+executables in the file generated-linux-x86_64-bin-3.0.4.tgz.
 It only contains the three files, and they can be used without a complete installation
 of rwloadsim, as long as there is an Oracle client environment that can be an ordinary
 installation or an Instant Client installation.
@@ -60,7 +62,7 @@ with Instant Client it is the top directory of the installation.
 
 After download, simply execute
 ```
-tar -zxvf generated-linux-x86_64-bin-3.0.3.tgz
+tar -zxvf generated-linux-x86_64-bin-3.0.4.tgz
 ```
 and possibly move the executables to one of the directories in your PATH.
 To get help for either, call it with the -h option.