Configuration

Configuring Batch Process Definitions

Configuring Batch Process Definitions describes the following topics; locate the appropriate sections on this page:

• User Interface
• Defining a Batch Process
• Defining the Transaction Type
• Defining the Transaction Mode
• Adding a Report
• Deleting a Batch Process Definition

Batch Process Definition – User Interface

This section provides a tour of the Batch Process Definitions UI. The interface is comprised of a treeview (left hand side), the definition form (main central area), and a secondary window for creating the menus and submenus or categories.
To access the Batch Process Definitions form:

1. Launch Govern New Administration (GNA).
2. Select Batch Process > Definitions.

Once you create menus and define batch processes, the selected items are listed in a treeview on the left of the form. You can display or hide the treeview according to your preference.

About Batch Process Definitions

You can view, add, or modify a batch process definition, as described later in this section.
To display or hide the English and French long and short descriptions, click on the arrow beside the text box at the top of the form.

About the Menu Manager

The Menu Manager form is used for creating the menus and submenus for organizing your batch process definitions in Govern.NET.
To access the Menu Manager

1. Launch Govern New Administration (GNA).
2. Select Batch Process > Definitions.
3. Click the ellipsis button beside the Category text box.

If categories are already created, they are listed on the left. You can expand a category to view secondary levels if they exist. The name of selected menu is displayed on the right. You can expand the name to view the English and French short and long descriptions.

Defining a Batch Process

Use the following process to name the definition and to associate it with a Govern Batch process.

To define a Batch Process:

1. Select the category where you are defining the process as described under Selecting a Category for the Batch Process. The batch processes already defined for the category are displayed in the treeview on the left.
2. Click the New button.
3. Enter a code for the new batch process definition. This is a required field.
4. Select a Govern batch process from the Process drop-down list. This is a required field.
5. Enter a name for the record in the text box at the top right. This is automatically added to the English Long Description field.
6. Click the button to the left of the text box where you entered the name. This expands a menu with additional descriptions.
7. Add an English Short Description and French Short and Long Description as required. These fields are optional.
8. Click the Save button to add the category to the menu.
   If you click the New button without saving your modifications, a confirmation message appears:

Defining the Transaction Type
The Govern batch processes can be run synchronously or asynchronously. If they are run synchronously, they are run on the same server. If run asynchronously they are run on multiple servers at the same time.
Select Synch or Asynch as required. For processes with multiple transactions, it is recommended to use asynchronous processing as this spreads the load over multiple servers and makes for faster processing time.
Pool #: For Asynchronous processes only, enter the maximum number of transactions to be handled by the client servers at any one time.
This works as follows: If you are running asynchronous batch processing, there is one master server that manages all the transactions and is responsible for sending them to the client servers. The value In the Pool # field indicates the maximum number of transactions to send out by the master server at any one time.
Scenario: Running a Batch Process Asynchronously
The following scenario illustrates how asynchronous batch processing works.
The parameters are as follows:

• Master server: one
• Client servers: five
• Transactions: 50,000
• Pool #: 50

The master server sends out the first 50 transactions to the client servers. Each server is responsible for ten transactions. As soon as a server completes one transaction, the master server sends it another. This continues until all transactions have been processed. However, there are never more than 50 transactions being handled by the client servers at any given time.

Defining the Transaction Mode

Select one of the following transaction modes for the process.

• Break If One Transaction Failed: the process terminates when the transaction fails.
• Roll Back If One Transaction Failed: the process terminates when a transaction fails and all the transactions that were completed are cancelled. Computations are returned to the starting point.
• Continue If One Transaction Failed: Continue to run the process even if a transaction fails.

Adding a Report

Use the following procedure to associate one or more reports with the selected batch process.
To add a report: to the batch process:

1. Launch the Batch Process Definitions form.
2. Select the category for the process as described under Selecting a Category for the Batch Process.
3. Select the batch process from the treeview on the left.
4. Click Add Reports.
5. Select one or more reports from the Choose the Reports menu.
   

   TIP: You can select multiple reports using the left mouse button.

6. Click Select Reports.

The selected reports are displayed in the List of Reports text box. The parameters for the report are displayed in the Report Parameters list box.
The List of Parameters text box displays the parameters that can be included in the report and that can be used to build an external report; for example, these could include Date To and Date From fields. The purpose is to give you the exact reference and wording of these fields.

Deleting a Batch Process Definition

To delete a batch process:

1. Launch the Batch Process Definitions form.
2. Select the category for the process as described under Selecting a Category for the Batch Process.
3. Select the batch process from the treeview on the left.
4. Click the Delete button.

Adding Batch Processes Definition to Govern

When you have defined your batch processes, you need to add them to Govern.NET. In order to do this, you need to launch the Govern Security Manager and synchronize your new processes between GNA and Govern. Then, you need to assign access permissions.

Synchronizing Batch Process Definitions

When you have synchronized your new batch process definitions, they appear on the Govern.NET menu.
To synchronize the new batch processes:

1. Launch the MSGovern Security Manager (GSM).
2. Select your database connection key.
3. Right-click on Applications and select Synchronize menu from the dropdown list. A confirmation message appears.
4. Click Yes on the confirmation message.

Permissions and Batch Processes

Use the following procedure to assign access permissions to the new batch process definitions. You can grant permissions by profiles and grant permissions to the Batch Process Editor application in Govern Administrator.

1. Launch the MSGovern Security Manager (GSM).
2. Select your database.
3. Expand Applications > MSGovern.NET > Batch Process > Batch Process.
4. Continue to expand the menus until you are the level where you want to grant permission.
5. Right-click on the item that you want to secure.
6. Define the permissions and exclusions as required and as described in the Govern Security Manager.

What’s New

• [6.0] Batch processes no longer use categories. They are linked to a profile.
  • For more information, see What’s New in Govern Administrator (GNA) What’s New and Govern Scheduler What’s New

Related Topics

Govern New Administration (GNA)
Batch Processing in OpenForms