{"id":24508,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/debugging-1\/"},"modified":"2024-02-15T14:53:34","modified_gmt":"2024-02-15T22:53:34","slug":"debugging-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/","title":{"rendered":"Debugging"},"content":{"rendered":"<h3>\n\tThe ExtraView Log File<\/h3>\n<p>The ExtraView application server log is a very valuable tool in writing and debugging Java in ExtraView. It is possible to issue timestamped messages to the log file while the program is running. The following sample call is used to issue log messages:<\/p>\n<p><span class=\"fixedWidthFont\">Z.log.writeToLog (Log.DEBUG, &#8220;String to be inserted&#8221;);<\/span><\/p>\n<p>This will insert the parameter string into the log subject to the log filtering constraints. In general, the &#8220;log level&#8221; is set internally to a value that allows only error, critical error, and information messages to be inserted to the log. However, a simple CLI command can set the debug level for log messages:<\/p>\n<p><span class=\"fixedWidthFont\">debug 7<\/span><\/p>\n<p>You can also set the log level with a URL, such as:<\/p>\n<p><span class=\"fixedWidthFont\">http:\/\/www.mycompany.com\/evj\/ExtraView?DEBUG=7<\/span><\/p>\n<p>This sets the log level internally to allow all DEBUG messages to be stored in the log, viz., those that are issued by the program with \u201cLog.DEBUG\u201d as the first parameter.<\/p>\n<p>Where is the log file? It is located in:<\/p>\n<p><code>&lt;tomcat-base&gt;\/webapps\/&lt;instance-name&gt;\/WEB-INF\/logs\/&lt;logname&gt;.log<\/code><\/p>\n<p>However, there is a parameter named <span class=\"fixedWidthFont\">LOG_FILE_PATH_NAME<\/span> within the Configuration.properties file that allows you to relocate the log file to a different location. The log file is a simple sequential text file that can be read using any text editor.<\/p>\n<h3>\n\tDebug Levels<\/h3>\n<p>Up to 12 levels of debugging are provided. Level 6 is the value used for production sites, and 6 means only messages with a level of 6 or less are written to the log.<\/p>\n<p>Note: A value greater than 6 can significantly impact the performance of a production system, and should only be used when trying to trace a specific problem.<\/p>\n<p>The following error levels are defined for the log \u2013<\/p>\n<table class=\"tableWithBorder\" width=\"50%\">\n<tbody>\n<tr class=\"tableHeaderRow\">\n<th width=\"40%\">\n\t\t\t\tDEBUG Name<\/th>\n<th width=\"60%\">\n\t\t\t\tDEBUG Level<\/th>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">ALERT<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">1<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">CRITICAL<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">2<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">ERROR<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">3<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">WARN<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">4<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">NOTICE<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">5<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">INFO<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">6<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">DEBUG<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">7<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">DEBUG2<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">8<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">DEBUG3<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">9<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">DEBUG4<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">10<\/span><\/td>\n<\/tr>\n<tr>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">DEBUG5<\/span><\/td>\n<td>\n\t\t\t\t<span class=\"fixedWidthFont\">12<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\n\tMonitoring and Evaluating the SQL that is Executed<\/h3>\n<p>If you insert the line &#8211;<\/p>\n<p><span class=\"fixedWidthFont\">PSP_LOG = YES<\/span><\/p>\n<p>Into the <code>WEB-INF\/configuration\/Configuration.properties<\/code> file, then an entry is made into the log file, showing each SQL statement as it is executed, along with all the bind variables used in its execution.<\/p>\n<h3>\n\tMonitoring and Evaluating Ajax calls<\/h3>\n<p>If you insert the line <span class=\"fixedWidthFont\">AJAX_LOG = YES<\/span> Into the WEB-INF\/configuration\/Configuration.properties file, then an entry is made into the log file, showing metrics about each Ajax call as it is executed.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The ExtraView Log File The ExtraView application server log is a very valuable tool in writing and debugging Java in ExtraView. It is possible to issue timestamped messages to the log file while the program is running. The following sample call is used to issue log messages: Z.log.writeToLog (Log.DEBUG, &#8220;String to be inserted&#8221;); This will&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24503,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24508","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Debugging - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Debugging - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"The ExtraView Log File The ExtraView application server log is a very valuable tool in writing and debugging Java in ExtraView. It is possible to issue timestamped messages to the log file while the program is running. The following sample call is used to issue log messages: Z.log.writeToLog (Log.DEBUG, &#8220;String to be inserted&#8221;); This will...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/\",\"name\":\"Debugging - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"User Custom Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Java Interface\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Debugging\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Debugging - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/","og_locale":"en_US","og_type":"article","og_title":"Debugging - Product Documentation","og_description":"The ExtraView Log File The ExtraView application server log is a very valuable tool in writing and debugging Java in ExtraView. It is possible to issue timestamped messages to the log file while the program is running. The following sample call is used to issue log messages: Z.log.writeToLog (Log.DEBUG, &#8220;String to be inserted&#8221;); This will...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/","og_site_name":"Product Documentation","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/","name":"Debugging - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/debugging-1\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"User Custom Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/"},{"@type":"ListItem","position":4,"name":"Java Interface","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/user-custom-guide-1\/java-interface-1\/"},{"@type":"ListItem","position":5,"name":"Debugging"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24508","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24508"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24508\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24503"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}