Release 3.4.0

.mvn/maven.config

@@ -1 +1 @@
--Drevision=3.3.3-SNAPSHOT
+-Drevision=3.4.0

CHANGELOG.md

@@ -19,6 +19,24 @@ Types of changes:
 
 - [Use Podman instead of Docker inside Jenkins.](https://github.com/paulissoft/oracle-tools/issues/169)
 
+## [3.4.0] - 2024-09-17
+
+### Added
+
+- [Add dry run to Oracle package MSG_SCHEDULER_PKG.](https://github.com/paulissoft/oracle-tools/issues/170)
+- [Add statistics to Java class simple pool data source.](https://github.com/paulissoft/oracle-tools/issues/171)
+- [Main classes for Java JDBC pool data source should start with SmartPoolDataSource.](https://github.com/paulissoft/oracle-tools/issues/172)
+- [Add Oracle package PKG_REPLICATE_UTIL for replicating sources from one schema to another.](https://github.com/paulissoft/oracle-tools/issues/173)
+- [Add max retries, retry delay and retention time to MSG_AQ_PKG.CREATE_QUEUE.](https://github.com/paulissoft/oracle-tools/issues/174)
+- [Enhance start/stop MSG scheduler in case of PATO installations.](https://github.com/paulissoft/oracle-tools/issues/new)
+- [Use a default processing method when the job scheduler can not be used for the MSG subsystem.](https://github.com/paulissoft/oracle-tools/issues/176)
+- [Add pipelined function show_queues to MSG_AQ_PKG.](https://github.com/paulissoft/oracle-tools/issues/178)
+- [Add view msg_queue_info_v.](https://github.com/paulissoft/oracle-tools/issues/179)
+
+### Fixed
+
+- [Constant MSG_CONSTANTS_PKG. c_prefer_to_use_utl_http must be moved to WEB_SERVICE_PKG.](https://github.com/paulissoft/oracle-tools/issues/177)
+
 ## [3.3.2] - 2024-07-04
 
 ### Fixed

db/app/msg/src/full/R__09.PACKAGE_SPEC.MSG_SCHEDULER_PKG.sql

@@ -130,20 +130,36 @@ p_command = stop:
 p_command = restart:
 - Stop and start, equivalent to do('stop') followed by do('start').
 
-p_command = check-jobs-not-running/ check-jobs-not-running:
+p_command = check-jobs-running / check-jobs-not-running:
 - Check that there are (no) running jobs that have been started by this package. If so, an error is raised.
 
 **/
 
 function show_do
 ( p_commands in varchar2 default null -- comma separated list of: create / drop / start / shutdown / stop / restart / check-jobs-running / check-jobs-not-running
 , p_processing_package in varchar2 default '%' -- find packages like this paramater that have both a routine get_groups_to_process() and processing()
-, p_read_initial_state in natural default null -- read info from USER_SCHEDULER_* dictionary views at the beginning to constitute an ininitial state
+, p_read_initial_state in natural default null -- read info from USER_SCHEDULER_* dictionary views at the beginning to constitute an ininitial state (0=false)
 , p_show_initial_state in natural default null -- show the initial state: set to false (0) when you want to have what-if scenarios
 , p_show_comments in natural default null -- show comments with each command in p_commands and the program
 )
 return sys.odcivarchar2list
 pipelined;
+/**
+Shows what a call to do() would do, hence a kind of a dry run for do().
+
+This function will "read initial state" from the USER_SCHEDULER_* dictionary views at the beginning when:
+- ( p_read_initial_state is null ) OR
+- p_read_initial_state != 0
+
+This function will "show initial state" when:
+- ( p_show_initial_state is null and "read initial state" is true and p_commands is null ) OR
+- p_show_initial_state is not null and p_show_initial_state != 0
+
+This function will "show comments" when:
+- NOT( p_show_comments is null and "read initial state" is true and "show initial state" is true and p_commands is null ) AND
+- p_show_comments is null or p_show_comments != 0
+
+*/
 
 procedure submit_do
 ( p_command in varchar2 -- same as for do() above