-----------------------------------------------------------------------------------------------
Purpose:
This program simulates concurrent execution of BI queries using multiple concurrent users. 
-----------------------------------------------------------------------------------------------
It first creates N user sessions (based on users_list.txt), then it parallely invokes and 
executes one distinct query each for each session. Row counts from the results of those 
queries gathered and displayed as and when each thread completes. When all the parallel 
threads complete, user sessions are cleaned up.

'users_list.txt' file contains the list of concurrent users that this program will use for 
simulation. These users must already be created with a common password inside the security 
provider used within your WLS deployment. Use 'import_users_to_wls.dat' to create these users 
on your environment if they don't exist already. You can import the users by navigating to 
Summary of Security Realms >myrealm >Providers >DefaultAuthenticator page under WLS Console.

Query execution can  be monitored in several ways including: 
1) Concurrency Simulator dashboard pages 2) WLS metrics such as concurrent queries, users etc 
3) Database active sessions.

If you wish to increase the number of concurrent users for simulation, edit users_list.txt and 
copy/paste the existing users to the number you desire. 

NOTE:- If you increase concurrent users to a very large number, you may have to edit the database 
parameters like number of processes, sessions and transactions to handle the large volume. 
If you fail to do so, then many of the queries will fail and return rowcount as 0, which indicates 
that the database is not able to handle the large number of concurrent sessions.
-----------------------------------------------------------------------------------------------

Usage:
java -jar LoadSimulation.jar "<hostname>" "<port number>" "<report path>" "<password for users in users_list file>"

Example:
java -jar LoadSimulation.jar "localhost" "9704" "/shared/7. Server Features/Concurrency Simulation/Simulation/Concurrency" "Admin123"
-----------------------------------------------------------------------------------------------

