MarkView Bar Code Generator - What diagnostic steps should I follow and what information should I gather when there is an issue with MarkView Bar Code Generator?

Applies To

• ERP System: Oracle, SAP
• MarkView Version: All Versions

Overview

The MarkView Bar Code Generator creates bar code images that you can use within your workflow. For example, if you are creating a cover sheet, MarkView Bar Code Generator can create the bar code that identifies and tracks the faxed or scanned document.

Troubleshooting Steps

If you encounter an issue with the MarkView Bar Code Generator, please perform the following steps:

Verify the OC4J is up

• Verify that the MarkView Bar Code Generator has properly started, by starting a browser and navigating to a URL of the following form which should display a bar code with the word "test" underneath it.
  http://server:http_port/mvasbcg/barcode?text=test
• Your MarkView Home page contains your server:http_port.
• If the above URL does not generate a bar code continue to the next step.

Verify that pop-ups are enabled in your web browser

• The Bar Code Generator will launch a new window with the bar code cover page. Therefore you will need to make sure pop-ups are not being blocked.

Review log files for errors

• If the Bar Code Generator is not functioning correctly then you will want to review the log files for any error messages. See the "Logging" section below for logging information.

Check pre-requisite software

• To check the versions of pre-requisite software please review Technical Specification document in the MarkView product documentation for your version.
  • Note: For de-supported versions of MarkView, this would be the Kofax Cross Product Compatibility Matrix.

Logging

Enable Debug Logging

• Typically, the Bar Code Generator will either create a bar code, which is displayed in a pop-up window, or a red 'x' will appear on the page indicating that a bar code was not created.
  • MarkView 8.0 or Earlier (de-supported) 
    • The Bar Code Generator has no debug logging.
  • MarkView 8.1 or Later
    • Set the MVAS_BCG_LOGGING_LEVEL preference to DEBUG level.

* The change takes effect immediately (without having to re-start the Application Server).

Disable Debug Logging

• MarkView 8.0 or Earlier (de-supported)
  • The Bar Code Generator has no debug logging.
• MarkView 8.1 or Later
  • Set the MVAS_BCG_LOGGING_LEVEL preference to WARN (default value)

Log File Location

• The logs location depends on the Application Server (i.e. Weblogic or OAS)
  • File location: All MarkView Components - Log File Locations
  • File name(s): mvbcg.log
    • TIP: If you have trouble finding the MarkView log directory, just search the log file name (mvbcg.log) on your Application Server. 

Impact of debug logging

• Enabling debug logging on the Bar Code Generator will cause the log file to grow at a rate of about 2.5KB for each new Bar Code.