From 9796280542d22707800cc5f608d0993b9059819b Mon Sep 17 00:00:00 2001
From: brutzman <brutzman@nps.edu>
Date: Sat, 11 Sep 2021 10:53:09 -0700
Subject: [PATCH] more-verbose output for explanatory clarity

---
 .../TcpExamples/TcpExample4HandlerThread.java |   3 +-
 .../TcpExamples/TcpExample4TerminalLog.txt    | 135 +++++++++---------
 2 files changed, 70 insertions(+), 68 deletions(-)

diff --git a/examples/src/TcpExamples/TcpExample4HandlerThread.java b/examples/src/TcpExamples/TcpExample4HandlerThread.java
index dc6d3f144b..6ff923319b 100644
--- a/examples/src/TcpExamples/TcpExample4HandlerThread.java
+++ b/examples/src/TcpExamples/TcpExample4HandlerThread.java
@@ -47,7 +47,8 @@ class TcpExample4HandlerThread extends Thread
             PrintStream ps = new PrintStream(os);
 
             final long TIMEOUT = 2000; // 2000 milliseconds = 2 seconds, 10000 milliseconds = 10 seconds
-            System.out.println(TcpExample4HandlerThread.class.getName() + " pausing for TIMEOUT=" + TIMEOUT + "ms"); // debug
+            System.out.println(TcpExample4HandlerThread.class.getName() + " pausing for TIMEOUT=" + TIMEOUT + "ms" + 
+                               " to emulate computation and avoid server-side overload"); 
             Thread.sleep(TIMEOUT);
                 
             // ps is the PrintStream is the Java way to use System.print() to pass data along the socket.
diff --git a/examples/src/TcpExamples/TcpExample4TerminalLog.txt b/examples/src/TcpExamples/TcpExample4TerminalLog.txt
index f699125b65..62945afa1c 100644
--- a/examples/src/TcpExamples/TcpExample4TerminalLog.txt
+++ b/examples/src/TcpExamples/TcpExample4TerminalLog.txt
@@ -1,68 +1,69 @@
-Invocation instructions:
-1. run/debug TcpExample4ThreadTcpExample4DispatchServerServer.java
-2. don't run TcpExample4HandlerThread (since it is automatically launched as needed)
-3. run/debug TcpExample4Client.java
-
-Two program response logs, server and client:
-
-===================================================
-===================================================
-run:
-ant -f C:\\x-nps-gitlab\\NetworkedGraphicsMV3500\\examples -Dnb.internal.action.name=run.single -Djavac.includes=TcpExamples/TcpExample4DispatchServer.java -Drun.class=TcpExamples.TcpExample4DispatchServer run-single
-
-run-single:
-TcpExample4DispatchServer ready to accept socket connections...
-=============================================================
-TcpExample4DispatchServer.handlerThread invocation for connection #1...
-TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
-TcpExample4HandlerThread starting to handle a thread...
-TcpExample4HandlerThread pausing for TIMEOUT=2000ms
-TcpExample4HandlerThread finished handling a thread, now exit.
-=============================================================
-TcpExample4DispatchServer.handlerThread invocation for connection #2...
-TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
-TcpExample4HandlerThread starting to handle a thread...
-TcpExample4HandlerThread pausing for TIMEOUT=2000ms
-TcpExample4HandlerThread finished handling a thread, now exit.
-=============================================================
-TcpExample4DispatchServer.handlerThread invocation for connection #3...
-TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
-TcpExample4HandlerThread starting to handle a thread...
-TcpExample4HandlerThread pausing for TIMEOUT=2000ms
-TcpExample4HandlerThread finished handling a thread, now exit.
-=============================================================
-TcpExample4DispatchServer.handlerThread invocation for connection #4...
-TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
-TcpExample4HandlerThread starting to handle a thread...
-TcpExample4HandlerThread pausing for TIMEOUT=2000ms
-TcpExample4HandlerThread finished handling a thread, now exit.
-BUILD STOPPED (total time: 42 seconds)
-
-===================================================
-===================================================
-run:
-ant -f C:\\x-nps-gitlab\\NetworkedGraphicsMV3500\\examples -Dnb.internal.action.name=run.single -Djavac.includes=TcpExamples/TcpExample4Client.java -Drun.class=TcpExamples.TcpExample4Client run-single
-
-TcpExample4Client start, loop 4 times
-==================================================
-TcpExample4Client creating socket #1...
-TcpExample4Client: message received from server='This message was written by the server TcpExample4HandlerThread'
-TcpExample4Client: time msec required for read=2023
-==================================================
-TcpExample4Client creating socket #2...
-TcpExample4Client: message received from server='This message was written by the server TcpExample4HandlerThread'
-TcpExample4Client: time msec required for read=2003
-==================================================
-TcpExample4Client creating socket #3...
-TcpExample4Client: message received from server='This message was written by the server TcpExample4HandlerThread'
-TcpExample4Client: time msec required for read=2005
-==================================================
-TcpExample4Client creating socket #4...
-TcpExample4Client: message received from server='This message was written by the server TcpExample4HandlerThread'
-TcpExample4Client: time msec required for read=2005
-==================================================
-TcpExample4Client complete
-BUILD SUCCESSFUL (total time: 9 seconds)
-
-===================================================
+Invocation instructions:
+1. run/debug TcpExample4ThreadTcpExample4DispatchServerServer.java
+2. don't run TcpExample4HandlerThread (since it is automatically launched as needed)
+3. run/debug TcpExample4Client.java
+
+Two program response logs, server and client:
+
+===================================================
+===================================================
+run:
+ant -f C:\\x-nps-gitlab\\NetworkedGraphicsMV3500\\examples -Dnb.internal.action.name=run.single -Djavac.includes=TcpExamples/TcpExample4DispatchServer.java -Drun.class=TcpExamples.TcpExample4DispatchServer run-single
+
+run-single:
+TcpExamples.TcpExample4DispatchServer ready to accept socket connections...
+=============================================================
+TcpExamples.TcpExample4DispatchServer.handlerThread invocation for connection #1...
+TcpExamples.TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
+TcpExamples.TcpExample4HandlerThread starting to handle a thread...
+TcpExamples.TcpExample4HandlerThread pausing for TIMEOUT=2000ms to emulate computation and avoid server-side overload
+TcpExamples.TcpExample4HandlerThread finished handling a thread, now exit.
+=============================================================
+TcpExamples.TcpExample4DispatchServer.handlerThread invocation for connection #2...
+TcpExamples.TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
+TcpExamples.TcpExample4HandlerThread starting to handle a thread...
+TcpExamples.TcpExample4HandlerThread pausing for TIMEOUT=2000ms to emulate computation and avoid server-side overload
+TcpExamples.TcpExample4HandlerThread finished handling a thread, now exit.
+=============================================================
+TcpExamples.TcpExample4DispatchServer.handlerThread invocation for connection #3...
+TcpExamples.TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
+TcpExamples.TcpExample4HandlerThread starting to handle a thread...
+TcpExamples.TcpExample4HandlerThread pausing for TIMEOUT=2000ms to emulate computation and avoid server-side overload
+TcpExamples.TcpExample4HandlerThread finished handling a thread, now exit.
+=============================================================
+TcpExamples.TcpExample4DispatchServer.handlerThread invocation for connection #4...
+TcpExamples.TcpExample4DispatchServer.handlerThread is launched, awaiting another connection...
+TcpExamples.TcpExample4HandlerThread starting to handle a thread...
+TcpExamples.TcpExample4HandlerThread pausing for TIMEOUT=2000ms to emulate computation and avoid server-side overload
+TcpExamples.TcpExample4HandlerThread finished handling a thread, now exit.
+BUILD STOPPED (total time: 25 seconds)
+
+===================================================
+===================================================
+run:
+ant -f C:\\x-nps-gitlab\\NetworkedGraphicsMV3500\\examples -Dnb.internal.action.name=run.single -Djavac.includes=TcpExamples/TcpExample4Client.java -Drun.class=TcpExamples.TcpExample4Client run-single
+
+run:
+TcpExamples.TcpExample4Client start, loop 4 times
+==================================================
+TcpExamples.TcpExample4Client creating socket #1...
+TcpExamples.TcpExample4Client: message received from server='This message was written by the server TcpExamples.TcpExample4HandlerThread'
+TcpExamples.TcpExample4Client: time msec required for read=2024
+==================================================
+TcpExamples.TcpExample4Client creating socket #2...
+TcpExamples.TcpExample4Client: message received from server='This message was written by the server TcpExamples.TcpExample4HandlerThread'
+TcpExamples.TcpExample4Client: time msec required for read=2008
+==================================================
+TcpExamples.TcpExample4Client creating socket #3...
+TcpExamples.TcpExample4Client: message received from server='This message was written by the server TcpExamples.TcpExample4HandlerThread'
+TcpExamples.TcpExample4Client: time msec required for read=2007
+==================================================
+TcpExamples.TcpExample4Client creating socket #4...
+TcpExamples.TcpExample4Client: message received from server='This message was written by the server TcpExamples.TcpExample4HandlerThread'
+TcpExamples.TcpExample4Client: time msec required for read=2011
+==================================================
+TcpExamples.TcpExample4Client complete
+BUILD SUCCESSFUL (total time: 8 seconds)
+
+===================================================
 ===================================================
\ No newline at end of file
-- 
GitLab