How to automatically start and monitor ZySCAN Unattended jobs with ZySCAN Shell Utility

SYMPTOMS

Occasionally, the OCR process may hang due to malformed documents or low-quality images. This may not be a problem when using ZySCAN application in interactive mode, but it can delay large batches in unattended mode. As it is generally not easy to know upfront when this situation can occur, a dedicated module has been created to automatically start and monitor ZySCAN in unattended mode, so that it can be safely used to process large data collections as an alternative to ZySCAN NT Service. If the unattended instance of ZySCAN hangs during ZyOCR or ZyEXPORT stages, ZySCAN Shell Utility will restart it so the process can continue with no delays. The document that could not be OCRed may then be processed manually or removed later.

CAUSE

Not applicable.

RESOLUTION

ZySCAN Shell Utility can be started manually or with a Windows Scheduled Task, with the following parameters:

• -t Will set timeout in seconds. Timeout specified here is applied on a per-page basis.
• -p Will point to the location of the ZySCAN executable file.
• -o Will start ZySCAN in unattended mode and perform only ZyOCR stages.
• -e Will start ZySCAN in unattended mode and perform only ZyEXPORT stages.
• -b Will start ZySCAN in unattended mode and perform ZyOCR and ZyEXPORT stages.
• -u[JOB_NAME] Will start ZySCAN in unattended mode and perform the entire job JOB_NAME.

Examples:
"C:\Program Files (x86)\ZyLAB\Information Management Platform\Bin\ZySCANShellUtility.exe" /t180 /p"C:\Program Files (x86)\ZyLAB\Information Management Platform\Bin\ZyScan.exe" /b
Will start ZySCAN in unattended mode and perform ZyOCR and ZyEXPORT stages with a timeout of 180 seconds.

"C:\Program Files (x86)\ZyLAB\Information Management Platform\Bin\ZySCANShellUtility.exe" /t180 /p"C:\Program Files (x86)\ZyLAB\Information Management Platform\Bin\ZyScan.exe" /u[Archive.job]
Will start ZySCAN in unattended mode and perform the entire job according to the Archive template with a timeout of 180 seconds.

NOTE: ZySCAN Shell Utility is only supported with ZyLAB Global Professional OCR engine. Also make sure that the user launching ZySCAN Shell Utility has the necessary permissions on the storage locations relevant to the process

APPLIES TO

6.0 Service Pack 1; 6.0 Service Pack 2; 6.0; 6.1; 6.1 Service Pack 1; 6.1 Service Pack 2; 6.2; 6.2 Service Pack 1; 6.2 Service Pack 2; 6.3; 6.4; 6.4 Service Pack 1