Merge branch 'bkemain' into 'oramain'

Bkemain to oramain

See merge request rwp/rwloadsim!38

Author: bengsig

README.md

@@ -35,14 +35,14 @@ See [docs/INSTALL.md](docs/INSTALL.md) for details.
 
 ## Branches
 
-The branches that should be used by ordinary users are named after the release, e.g. 3.1.0.
+The branches that should be used by ordinary users are named after the release, e.g. 3.2.0.
 The master branch receives occasional pull request from the various development branches.
 You should normally _not_ clone or checkout these
 unless you are developing the rwloadsim code or always want the latest.
 If you use a development or master branch, you _must_ do compilation yourself;
 no binaries are released.
 
-At present, branch 3.1.0 is the release branch.
+At present, branch 3.2.0 is the release branch.
 
 Please see [CHANGELOG.md](CHANGELOG.md) for details.
 

docs/refman/sqlexplain.html

@@ -31,7 +31,8 @@ Provide the format argument; the default is 'last, all, allstats'.
 .P
 .B --child-no=child#
 .RS 4
-When using the display_cursor function, provide this cursor_child_no, the default is 0.
+When using the display_cursor function, provide this cursor_child_no,
+the default is null implying all child cursors will be included.
 .RE
 .P
 .B --sessionid=sid
@@ -64,4 +65,4 @@ Copyright \(co 2024 Oracle Corporation
 Licensed under the Universal Permissive License v 1.0
 as shown at https://oss.oracle.com/licenses/upl
 .SH "SEE ALSO"
-rwloadsim(1rwl), sqlreport(2rwl), sqlmonitor(2rwl) sqlmonitorawr(2rwl), utilities(2rwl)
+rwloadsim(1rwl), sqlreport(2rwl), sqlmonitor(2rwl), sqlmonitorawr(2rwl), utilities(2rwl)

docs/refman/sqlmonitor.html

@@ -58,4 +58,4 @@ Copyright \(co 2023 Oracle Corporation
 Licensed under the Universal Permissive License v 1.0
 as shown at https://oss.oracle.com/licenses/upl
 .SH "SEE ALSO"
-rwloadsim(1rwl), sqlmonitor(2rwl) sqlmonitorawr(2rwl), sqlexplain(2rwl), utilities(2rwl)
+rwloadsim(1rwl), sqlmonitor(2rwl), sqlmonitorawr(2rwl), sqlexplain(2rwl), utilities(2rwl)

docs/refman/sqlreport.html

@@ -6,6 +6,7 @@
 #
 # History
 #
+# bengsig  10-dec-2024 - default null for child_no
 # bengsig   5-dec-2024 - Creation
 #
 # usage:
@@ -23,13 +24,13 @@ $endif
 $longoption:file-count=1
 
 integer sessionid, instance;
-integer awr := 0, child_no := 0;
+integer awr := 0, child_no := null;
 string format := "last, all, allstats";
 
 	              $userhelp:"Create a sql explain plan by calling dbms_xplan.display_cursor"
 	              $userhelp:"-l usr/pwd@con           : required option to give database logon"
 	              $userhelp:"sqlid                    : if provided, use that sqlid"
-           $useroption:child-no:"--child-no=child#        : provide cursor_child_no, default 0"
+           $useroption:child-no:"--child-no=child#        : provide cursor_child_no, default null"
              $useroption:format:"--format='format text'   : provide format, default 'last, all, allstats'"
           $useroption:sessionid:"--sesssionid=sid         : query v$session for the sqlid"
            $useroption:instance:"--instance=inst#         : query gv$session"