Rename awreport->awrreport, prepare 3.0.5

Author: bengsig

CHANGELOG.md

@@ -1,5 +1,11 @@
 # RWP\*Load Simulator Release Notes
 
+## 3.0.5
+
+* Bug fixes
+* Rename awreport to awrreport
+* Improve awrdump messages
+
 ## 3.0.4
 
 * Bug fixes

README.md

@@ -34,7 +34,7 @@ You should normally _not_ clone or checkout the master branch unless you are dev
 rwloadsim code or always want the latest.
 If you use the master branch, you _must_ do compilation yourself; no binaries are released.
 
-At present, branch 3.0.3 is the release branch.
+At present, branch 3.0.5 is the release branch.
 
 Please see [CHANGELOG.md](CHANGELOG.md) for details.
 

bin/awreport

@@ -2,12 +2,12 @@
 
 # RWP*Load Simulator
 #
-# Copyright (c) 2021 Oracle Corporation
+# Copyright (c) 2023 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
+# bengsig  02-jan-2023
 
-rwloadsim --pretend-gen-banner='RWP*AWR Report' -u awreport.rwl "$@"
+echo This utility has been renamed to awrreport 1>&2
+exit 1

bin/awrreport

@@ -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 "$@"

docs/INSTALL.md

@@ -1,11 +1,14 @@
 ## Installation and creation of repository
 
-There are two types of binary distributions available at github releases:
+There are three types of binary distributions available at github releases:
 
-* Complete binaries are in files that have -bin- in the name.
+* Complete binaries are in files that have -bin- in the name; this is the preferred distribution for most users.
 * Little more than executables are in files that have -binonly- in the name.
+* Generated stand-alone binaries for utilies like ociping and awrreport; the file name starts with generated.
 
-Complete binaries distributed in a file such rwloadsim-linux-x86_64-bin-3.0.4.tgz
+### Using complete binaries
+
+Complete binaries distributed in a file such rwloadsim-linux-x86_64-bin-3.0.5.tgz
 can be used as is, i.e. without getting a clone or pull from github.
 It should be used if you simply want a full run time environment
 and it contains the following directories:
@@ -24,7 +27,7 @@ and it contains the following directories:
 If you prefer to have access to source code, but avoid building the executables,
 you can clone or pull from github (which would allow you to potentially compile
 rwloadsim yourself), and then 
-use a file like rwloadsim-linux-x86_64-binonly-3.0.4.tgz.
+use a file like rwloadsim-linux-x86_64-binonly-3.0.5.tgz.
 This file contains little more than the compiled binaries of the rwloadsim program,
 and you can simply un-tar this file
 directly into your cloned or pulled directory; the result will be as if you had
@@ -43,7 +46,7 @@ On the system where you are going to run rwloadsim,
 create a (possibly shared) directory where you simply
 use a command like
 ```
-tar -zxvf rwloadsim-linux-x86_64-bin-3.0.4.tgz
+tar -zxvf rwloadsim-linux-x86_64-bin-3.0.5.tgz
 ```
 One install can be shared between several users as long as all have access to the directory.
 If appropriate, you can put the directory on an NFS (or some other) share and make it available to multiple systems.
@@ -62,7 +65,7 @@ You can use Oracle Instant Client or a full client (or even server) install.
 Start by doing a pull or clone of the sources from github 
 as if you would do your own compile, and then use a command like
 ```
-tar -zxvf rwloadsim-linux-x86_64-binonly-3.0.4.tgz
+tar -zxvf rwloadsim-linux-x86_64-binonly-3.0.5.tgz
 ```
 to extract little more than the compiled rwloadsim binaries into your already existing pull or clone.
 
@@ -189,6 +192,16 @@ The rwl234.sql file is found in the admin directory of your distribution.
 If you a using a secondary schema, you must also repeat the step above
 involving the rwlgrants.sql file.
 
+### Stand-alone generated binaries
+
+If your only interest is to use utilities such as ociping or awrreport, you can
+get these completely stand-alone.
+This does _not_ include the complete rwloadsim, and does _not_ allow you
+to create any rwl programs yourself.
+The file such as generated-linux-x86_64-bin-3.0.5.tgz _only_ contains binaries
+that you simply put into any directory, typically one in your PATH.
+The only other requirement is an Oracle client environment as explained above.
+
 ### Navigation
 * [index.md](index.md#rwpload-simulator-users-guide) Table of contents
 * [INTRODUCTION.md](INTRODUCTION.md) Previous topic: A brief introduction the RWP*Load Simulator

docs/NEWS30.md

@@ -1,3 +1,8 @@
+## Changed behavior in version 3.0.5 of the RWP\*Load Simulator
+
+The utility to create awr reports has been renamed to awrreport.
+Otherwise, 3.0.5 only has bug fixes and very minor changes.
+
 ## Changed behavior in version 3.0.4 of the RWP\*Load Simulator
 
 ### Stack evaluation with mixed data types

docs/ORACLENET.md

@@ -50,9 +50,10 @@ or ```rwlman nettest```.
 
 ### Stand alone executables
 
-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
+In addition to being part of the full rwloadsim distribution,
+the three utilities are distributed together with other as completely stand-alone
+executables in the file generated-linux-x86_64-bin-3.0.5.tgz.
+It only contains the executable files, and they can be used without a complete installation
 of rwloadsim, as long as there is an Oracle client environment that can be an ordinary
 installation or an Instant Client installation.
 The version must be 19 or later, and you must have LD_LIBRARY_PATH include
@@ -62,7 +63,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.4.tgz
+tar -zxvf generated-linux-x86_64-bin-3.0.5.tgz
 ```
 and possibly move the executables to one of the directories in your PATH.
 To get help for either, call it with the -h option.

docs/README.md

@@ -4,12 +4,12 @@ An introduction and the users guide to the RWP\*Load Simulator is available at
 [index.md](index.md) for your actual branch or
 [https://oracle.github.io/rwloadsim/](https://oracle.github.io/rwloadsim/)
 for the current
-[binary release 3.0.3](https://github.com/oracle/rwloadsim/releases).
+[binary release 3.0.5](https://github.com/oracle/rwloadsim/releases).
 
 ## RWP\*Load Simulator reference manual
 
 The reference manual is available after installation by typing
 ```
 rwlman
 ```
-or online (for release 3.0.3) in [refman/README.md](refman/README.md)
+or online (for release 3.0.5) in [refman/README.md](refman/README.md)

docs/refman/Makefile.refman

@@ -16,12 +16,13 @@
 
 ALL1=atclause.html bengsig.html compoundstatement.html conditional.html controlloop.html database.html databasedeclaration.html databasestatement.html declaration.html directive.html double.html expression.html filestatement.html histogram.html identifier.html include.html integer.html lob.html lobdeclaration.html multiprocess.html oerstats.html percentiles.html persec.html proceduredeclaration.html randomproceduredeclaration.html randomstringdeclaration.html regex.html runres.html rwlcpu.html rwlman.html rwloadsim.html rwlprogram.html rwlrun.html simpledeclaration.html sqldeclaration.html sqlexecution.html sqlstatement.html statement.html statistics.html string.html sysres.html threadexecution.html useroption.html rwlerror.html random.html procedure.html printfstatement.html
 
-ALL2=ashplot.html awreport.html awrdump.html connping.html nettest.html oltp.html oltpcheckkey.html oltpcore.html oltpcreate.html oltpday.html oltpdrop.html oltpfilloe.html oltpforever.html oltpparams.html oltpplot.html oltprun.html oltpscale.html oltpscalereport.html oltpverify.html ovid2.html sqlid2file.html sqlmonitor.html sqlmonitorawr.html ociping.html oltpsetup.html oltpawcols.html oltpplus.html utilities.html sqlreport.html netthroughput.html oltpxcset.html oltpxcrun.html oltpxc.html
+ALL2=ashplot.html awrreport.html awreport.html awrdump.html connping.html nettest.html oltp.html oltpcheckkey.html oltpcore.html oltpcreate.html oltpday.html oltpdrop.html oltpfilloe.html oltpforever.html oltpparams.html oltpplot.html oltprun.html oltpscale.html oltpscalereport.html oltpverify.html ovid2.html sqlid2file.html sqlmonitor.html sqlmonitorawr.html ociping.html oltpsetup.html oltpawcols.html oltpplus.html utilities.html sqlreport.html netthroughput.html oltpxcset.html oltpxcrun.html oltpxc.html
 
 all: $(ALL1) $(ALL2)
 
 ashplot.html: ../../man/man2rwl/ashplot.2rwl
 awrdump.html: ../../man/man2rwl/awrdump.2rwl
+awrreport.html: ../../man/man2rwl/awrreport.2rwl
 awreport.html: ../../man/man2rwl/awreport.2rwl
 atclause.html: ../../man/man1rwl/atclause.1rwl
 bengsig.html: ../../man/man1rwl/bengsig.1rwl