Implement session max lifetime and max usage

Author: bengsig

CHANGELOG.md

@@ -7,6 +7,7 @@
 * OLTP workload gets ociping and connect times
 * Bitwise operations and input of hexadecimal constants
 * Bit set/clear assignments
+* session pool can set max usage count and max lifetime
 * dbsecounds() and ociseconds() functions
 
 ## 3.1.3

docs/ERRORLIST.md

@@ -1338,6 +1338,10 @@ allowed.
 The right operand of the bitwise shift operation is larger than or equal to
 the bit width of the left operand. The right operand should be at most 63.
 
+### RWL-328 error: "the connection pool database '%s' cannot use release %s"
+The release count or every time can only be provided for session pools, you can
+use release time (without the count or every keyword) as an alternative.
+
 ### 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/refman/connping.html

@@ -6,7 +6,7 @@ databasedeclaration \- RWP*Load Simulator declare a database connection
 \fC
 databasedeclaration ::=
   \fBdatabase\fR identifier [ concatenation ]
-  databasespecification { databasespecification }
+  { databasespecification }
 
 databasespecification ::=
   \fBusername\fR concatenation
@@ -18,14 +18,25 @@ databasespecification ::=
 | \fBreconnect\fR
 | [ \fBthreads\fR ] \fBdedicated\fR [ \fBrequestmark\fR | \fBstatemark\fR ] 
 | \fBcursorcache\fR expression
-| \fBsessionpool\fR expression [ \fB..\fR expression ] [ releasepool ] [ waitsession ]
+| \fBsessionpool\fR expression [ \fB..\fR expression ] { sessionrelease } ] [ waitsession ]
 | \fBconnectionclass\fR concatenation
-| \fBconnectionpool\fR expression [ \fB..\fR expression ] [ releasepool ]
+| \fBconnectionpool\fR expression [ \fB..\fR expression ] [ idlerelease ]
 | \fBconnect\fR \fBconnectionpool\fR identifier
 
-releasepool ::=
+sessionrelease ::=
+  idlerelease 
+  | countrelease
+  | lifetimerelease
+
+idlerelease ::=
   \fBrelease\fR expression
 
+lifetimerelease ::=
+  \fBrelease\fR \fBevery\fR expression
+
+countrelease ::=
+  \fBrelease\fR \fBcount\fR expression
+
 waitsession ::=
   \fBwait\fR expression
   | \fBwait\fR expression \fBthen break\fR
@@ -121,7 +132,7 @@ Note that this can imply a high number of database connections and dis-connectio
 .RE
 .P
 \fBdedicated\fR 
-.P
+.br
 \fBthreads dedicated\fR 
 .RS 4
 Use dedicated connections that are established once and kept logged on during 
@@ -169,13 +180,25 @@ does not have the counterpart of an OCIConnectionPool.
 .RE
 .P
 .B \fBrelease\fR value
+.br
+.B \fBrelease count\fR value
+.br
+.B \fBrelease every\fR value
 .RS 4
-For a pool, set the timeout value for idle
+For a pool, the first option sets the timeout value for idle
 sessions (OCI_ATTR_SPOOL_TIMEOUT)
 or connections (OCI_ATTR_CONN_TIMEOUT);
 the default is 60s.
 Sessions or connections in the pool that have been idle for more than the release value
 will disconnect unless the pool already has its minimum size.
+.P
+For a session pool, you can also set the max usage count (OCI_ATTR_SPOOL_MAX_USE_SESSION)
+or the max lifetime (OCI_ATTR_SPOOL_MAX_LIFETIME_SESSION)
+using the either of the two last options.
+The default is 0 implying sessions will not have a max usage count or max lifetime.
+.P
+For all three attributes, you may provide a double value, but since the value used in OCI
+is an integer, only the integer part of the value will be used.
 .RE
 .P
 .B \fBwait\fR value

docs/refman/databasedeclaration.html

@@ -11,6 +11,7 @@
  *
  * History
  *
+ * bengsig  10-oct-2024 - sessionpool release every/count
  * bengsig   2-sep-2024 - |= (bis) and &~= (bic) assignments
  * bengsig  29-aug-2024 - rwldorxtosb8 macro
  * bengsig  28-aug-2024 - Add rwloeradd function
@@ -461,6 +462,8 @@ struct rwl_cinfo
 
   ub4 stmtcache; /* size of statement cache */
   ub4 ptimeout; /* session/conneciton pool timeout */
+  ub4 pmaxuse;  /* session pool max use count */
+  ub4 pmaxlife;  /* session pool max life time */
 #define RWL_DBPOOL_DEFAULT_TIMEOUT 60 // for ptimeout
   double wtimeout; /* sessionpool wait timeout */
 
@@ -488,7 +491,13 @@ struct rwl_cinfo
 #define RWL_DB_CREDEXT    0x0010000 // Use OCI_CRED_EXT (for wallet authentication)
 #define RWL_DB_SP_NORLB   0x0020000 // Includ the OCI_SPC_NO_RLB during OCISessionPoolCreate
 #define RWL_DB_SPTOBREAK  0x0040000 // Break to end of procedure if OCISessionGet timeout
-#define RWL_DB_COPY_FLAGS (RWL_DB_SPTOBREAK|RWL_DB_CREDEXT|RWL_DB_REQMARK|RWL_DB_STATEMARK|RWL_DB_USECPOOL|RWL_DB_CCACHUSER|RWL_DB_SP_NORLB)
+#define RWL_DB_COPY_FLAGS (RWL_DB_SPTOBREAK \
+			   | RWL_DB_CREDEXT \
+			   | RWL_DB_REQMARK \
+			   | RWL_DB_STATEMARK \
+			   | RWL_DB_USECPOOL \
+			   | RWL_DB_CCACHUSER \
+			   | RWL_DB_SP_NORLB)
   rwl_estack *tobreak;    // time out break routine
   sb4 errcode;	// last error code
 

docs/refman/ociping.html

@@ -11,6 +11,7 @@
  *
  * History
  *
+ * bengsig  10-oct-2024 - sessionpool release count/every
  * obakhir   7-aug-2024 - Add RWL Errors from 324 to 327 for bitwise operators
  * obakhir  24-jun-2024 - Add RWL_ERROR_CLOB_TOO_LARGE for rwlreadlob
  * bengsig   4-jun-2024 - $ora01013:break
@@ -1850,6 +1851,11 @@ RWLERROR("bitwise shifting by an amount greater than or equal to the bit width",
 RWLEDESC("The right operand of the bitwise shift operation is larger than or equal to" RWL_LINEEND
 "the bit width of the left operand. The right operand should be at most 63")
 
+#define RWL_ERROR_CPOOL_NOT_RELEASE_COUNT 328
+RWLERROR("the connection pool database '%s' cannot use release %s", RWL_ERROR_PARSE)
+RWLEDESC("The release count or every time can only be provided for session pools, you can" RWL_LINEEND
+"use release time (without the count or every keyword) as an alternative")
+
 // When adding new errors, add them before these lines
 // and make sure the #define follows a format like
 // #define RWL_ERROR_whatever_reasonable_here NNN