Modernize sqlmonitor, sqlreport; better tags in oltp

Author: bengsig

bin/sqlmonitor

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# RWP*Load Simulator
+#
+# Copyright (c) 2024 Oracle Corporation
+# Licensed under the Universal Permissive License v 1.0
+# as shown at https://oss.oracle.com/licenses/upl/
+#
+# call rwloadsim -u sqlmonitor.rwl
+
+# bengsig  13-jun-2024 - Created 
+
+exec rwloadsim --pretend-gen-banner='RWP*SQL Monitor' -u sqlmonitor.rwl "$@"

bin/sqlreport

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

docs/refman/directive.html

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

docs/refman/directives.html

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