There was a problem loading the comments.

What's a SuperBatch?

Support Portal  »  Knowledgebase  »  Viewing Article

  Print

A SuperBatch(tm) is simply a batch that triggers another batch upon completion.

---

How do you configure a SuperBatch?

When you open an existing batch or save a new batch, you'll see the INI button is enabled. This enables you to set your batch-specific options. One of those options is a SuperBatch. In your INI settings, right-click and add these instructions:

  1. Add your [SuperBatch] group header at the bottom of any existing settings (all [groups] are in red in the right-click menu)
  2. Insert "IfGoodRunTriggerThisBatch=" setting
  3. Set the XML full path and file name to trigger --- you can type manually or use the browse option in the menu
  4. That's it!

---

Anytime this batch runs on a schedule, or desktop short-cut, or via an Event Server rule (anything but a manually clicked Run within Report Runner Batch), when this batch completes, it will trigger another batch (the one you specify).

Note, if you Run this batch manually within Report Runner Batch, it will NOT trigger the SuperBatch (but it will display a message that it would have if scheduled).

---

You may have noticed a setting for "IfBadRunTriggerThisBatch" --- this setting is for triggering a batch even if this trigger batch fails (database error, bad email address, FTP server down --- anything that keeps batch from finishing 100% successfully). Most users do not want to do this, but the setting is there if you want to continue your SuperBatch even on batch failures.

Warning: If for some reason, a batch hard crashes or the process is killed or the PC/server/machine is rebooted, this "IfBadRunTriggerThisBatch" will NOT trigger. The process must finish normally for the SuperBatch trigger to work.

---

Last note... a batch triggered via a SuperBatch setting can also have a SuperBatch trigger. This enables you to schedule only one batch at the start of a long process, that batch triggers the next, and that batch triggers the next... and so on.

And we even have a way to visualize a long SuperBatch trigger... simply open the first batch with SuperBatch settings, click on Scheduler, and click on Open SuperBatch Trigger Tree button. This will show you the entire SuperBatch structure.

 

 

 

 


Share via

Related Articles

© Support @ Jeff-Net