Home

Custom

The Batch processor was developed to remove the need for workstations to become unproductive as users processed necessary reporting.

The Batch processor runs on which ever server is designated as the Batch Server. In the case of WGS, VESSECPFORCE01 is the dedicated batch server.

The Batch Report Processor runs reports out to .pdf or .csv file formats. Selected Reports and ALL Ad-Hoc (Management) reports can be submitted to the Batch Report Processor.

 

Introduction

The PowerForce Batch Report Processing module runs on VESSECPFORCE01 as a processing window only. The reason for this is that the print routines and the code they rely on are Window based code, and hence cannot be run as pure background processes. To that end, a user logon has to be utilised to run the batch process.

In the case of the Batch processor, all PowerForce framework components are switched off and only the essential components required are loaded for processing report requests ( Starting and Stopping).

The Batch process is started by the desktop icon and/or a command line that can be added to the Server Startup commands.

A base instance of the Batch Report Processor may be added to the Vesbatch01 startup commands More that one instance of the Batch Report Processor can be started simultaneously, in which case the jobs are queued to the process which is free at the time. Additional sessions are started by dbl-clicking on the Desktop Shortcut.

Each session started is issued with a unique process id (PID) to differentiate each session of the Batch Report Processor. This process id is in turn allocated to each print job as it is run and this prevents each instance of a report from being processed multiple times.

An instance of the Batch Report Processor may be stopped by either clicking on the Stop Processing button on the actual application window (between cycles of activity) or End Process from the Task Manager.

Using the scheduling workbench

Dependancies The Batch Report Processor depends on the Application Server (VESSECPFORCE01) being available for access. Should the Application Server be rebooted for any reason, then all instances of the Batch Report Processor must be ended and subsequently restarted.

Operating requirements: The Batch Report Processor must be run in an active windows environment to facilitate use of the Windows Presentation Manager and active default printer for output to .pdf file format to be successful. You must ensure that the default printer for the environment is permanently available to the machine otherwise this process will not work correctly.

A symptom that there is no permanent default printer assigned is that reports will be run but there is no pdf file created and the subsequent email back to the user will be missing the intended attached report file. This commonly occurs when the connection to the server is closed.

Checking the default printer environment

default printer
The session may be closed to leave the program running in background.


Choose the PowerForce Batch Report Processor shortcut from the Desktop

Closing the Remote Session:

Once the Batch Server has loaded and started, the session can be Disconnection from the Server leaving the processes running in the background as follows: X

 

Examples

This view shows multiple sessions of the Batch Report Processor running.

  • There are two (2) modes: Active and Sleeping
  • Active is where a report queued is being processed
  • Sleeping is where there are no reports to process, noted by the scrolling banner
  • Each window has a unique PID (Process ID)

 

Task Manager & Process Table

  • Each Batch Report Processor running is represented in the Task Manager Processes table by its unique process id (PID).
  • Look for instances of the executable OINSIGHT.EXE
  • When a report is being processed, it will be represented against the PID that is working.
  • Close a session by using the End Process button against the selected PID

Top of Page

See Also