The Verbose switch is used to write output text from OnBase into the verbose.txt file at the temporary report path. This is used for the purpose of troubleshooting problems.
If you are running OnBase as a service, the verbose.txt file will be saved in the temporary report path for the service profile.
If the DLL files Hyland.Logging.dll and Hyland.Logging.Wrapper.dll do not exist in the install directory, verbose logging will not function. Error messages are displayed, but the application will otherwise function normally.
Use the following qualifiers to add additional information to the report:
Qualifier |
Description |
---|---|
DCONLY |
This option allows the user to run the Diagnostic Console without also writing the output to the verbose.txt file. |
L |
This option adds document and process lock information into the verbose.txt file for tracing locks caused by the program. |
MSG |
This option increases the number and depth of status messages to the user. While this might slow down time intensive processes, such as the COLD processor, it is a vital tool in the search for faults and better ways to optimize this kind of process. |
NOWRAP |
This option disables formatting normally done when generating verbose logs, such as line breaks. With NOWRAP applied, no extra line breaks are inserted, which can be helpful if there are long values which need to be copied from the log unbroken. Note:
This behavior is automatically enabled when using the -HL7Listener, -HL7Processor, and -HL7Autosender switches. |
SIZE |
When followed by a space and a number between 1 and 1024, this option specifies the maximum number of megabytes a verbose log file can reach before statements are logged in a new log file. The naming of verbose log files created is specified by VerboseFilename in the INI file. If the position of $D is not specified, the date and time are added to the verbose log file name before the file extension. For more information, see the INI Settings module reference guide. Note:
Previous verbose log files are not overwritten when using the SIZE switch. It is considered a best practice to manage previous verbose log files as part of system maintenance. |
SQL |
This option logs SQL queries and statements made by the program to the verbose.txt file. |
SQL "Phrase" |
When using the SQL qualifier, you can include phrase filters to log only statements that contain the specified phrases. This is useful when the verbose file grows very large. The search phrase is case sensitive, and it must be enclosed in quotation marks. |
SQL "Insert", L |
If you want to use additional qualifiers for the -V switch, they must be separated with a comma, and they must fall outside of the quotation marks. |
SQL "Insert" "usergroup" |
Specify multiple phrases to log SQL statements containing any specified phrase. There is no limit to the number of phrases you can specify. Phrase searching is case sensitive. |
WG |
This option prints out data packets received from a WinGate Client. |
The following example causes the system to output each SQL statement with timestamps as it is prepared and/or executed: -V SQL. It is possible to have multiple parameters in your Verbose switch, for example, -V [MSG][,SQL ["Phrase"]][,WG][,L]. The following example causes the system to output each SQL statement to the Diagnostic Console only: -V SQL, DCONLY.