This document covers the following topics:

• Performance Monitoring

• JavaScript Logger Engine

• Investigating the Web Application's Code

• Redirecting back to hostLogin Page

See Web Application Development for introduction and concepts, and Error Messages for troubleshooting help.

---

Performance Monitoring

Performance monitoring provides the ability to trace the performance of all sessions/single sessions, and save them to a CSV (Excel) file.

This feature monitors the process of an instant/generated page, from pressing a host key until the result page is fully loaded. The monitoring includes browser performance, Web server performance and ApplinX server/host performance.

The monitoring includes:

• The entire wait time the user waits between pressing an action key, until receiving the HTML result of the target screen - Total Request.

• The entire time that the Web server processed the user request (including ApplinX server & the host response times) - Total Server Side.

• The send key response time - SendKeys.

• The HTML page loading time - Client Load.

• Important ApplinX actions such as attaching to ApplinX server, creating the instant page (Generate Instant), updating controls from the host screen, updating tables (when tables exist), detaching from ApplinX server.

JavaScript Logger Engine

The JavaScript logger engine is used to log JavaScript errors (primarily) as well as to debug specific modules of the JavaScript engine. The engine logs JavaScript errors which occur to users of the Web application. These errors are logged to the framework JavaScript log, with the following user information: Session ID, IP, browser details.

Each line in the log displays a timestamp, module name, log level, and the message.

Logging JavaScript Errors

The JavaScript logger engine automatically logs JavaScript errors to a log text file on the server (logs/javascript_log.txt).

Debugging JavaScript Modules

The JavaScript Logger Engine can be used by ApplinX developers to debug specific modules of the JavaScript engine (The JavaScript engine core, Emulation, modal windows, type ahead, Natural data transfer), by displaying the information in the log console (or writing to the server log when the log console is not shown).

To configure the JavaScript log console, configure parameters in the config/gx_clientConfig.xml file as follows:

<engineConfig
logLevel="3" <- 3-activate debug mode (0-Error , 1-Warnings , 2-Massage , 3-Debug)
debugModules=:z_engine.js,z_emulator.js,z_window.js,z_typeAhead,z_ndt.js" <- which modules to debug
showLogConsole="true" <- show/hide the log console
/>

Example:

Whenever myFunc is executed the Boolean variable "myBool" is evaluated. If the value received is "false", a message is logged in the debug log stating that there is a problem.

function myFunc(){
      var myBool = false;
      doSomthing(myBool);
      if (!myBool){
       GXLog.debug("myModule","Something went terribly wrong!!");
      }
      return myBool;
}

Ensure to set the config/gx_clientConfig.xml as detailed above.

Refer to the API:

• GXLog.debug(moduleName, message)

• GXLog.warning(moduleName, message)

• GXLog.error(moduleName, message)

Investigating the Web Application's Code

It is possible to use the ApplinX framework log to analyze and debug the code in the Web application. This is implemented by making changes in the config/gx_logConfig.xml file.

To define the messages that will be displayed in the framework log:

1. Open config/gx_logConfig.xml.

2. Uncomment the following section:

   JSP:

   <!--category additivity="false" name="<Category-Name>">
   	<level value="info"/>
   	<appender-ref ref="FRAMEWORK_LOG"/>
   </category
   -->

   .NET

   <!-- logger additivity="false" name="<Category-Name>">
   	<level value="info"/>
   	<appender-ref ref="FRAMEWORK_LOG"/>
   </logger
   -->
   
   

3. Change the level tag value to either: info, error, warning, or debug.

4. Change the <Category-Name> to a meaningful value. This will make it easier for you to find log entries at a later time.

5. Restart your web server, in order for the changes to take effect.

6. To write to the log file from anywhere in your code, make sure that the call looks similar to the following (depending on the log level):

   GXLog.info("Category-Name","<Message>");
   GXLog.error("Category-Name","<Message>");
   GXLog.warning("Category-Name","<Message>");
   GXLog.debug("Category-Name","<Message>");
   

Redirecting back to hostLogin Page

When using the hostLogin.jsp/hostLogin.aspx files and disconnecting the user, use the following JavaScript syntax to redirect back to the hostLogin page in the ApplinX Framework application:

window.parent.location="<landing page url>"

The hostLogin page needs to be loaded outside of the ApplinX Framework frameset.