Job Schedule Execution

Navigating to a Specific Job Schedule 

To manually execute a job schedule for testing or demo, or to review the job schedule status for a specific date, follow these steps:

1. Click the Usage switch (Usage/Account toggle) in the navigation pane.
2. Click the Scheduling option in the navigation panel to expand the Job Schedule framework sub-menu.
3. Click the Schedules option in the navigation panel to list each job schedule configured for the client.
4. Select the job schedule configuration you want to process or review under the Schedules option.
5. The Activity pane for that job schedule opens. In the header bar, select the date to execute or view the job schedule.
   1. If the job schedule is not executed for the date, the UI allows you to create and execute it.
   2. If the job schedule is executed for the date, it displays the job schedule status as shown below. Note,
      1. Above the Activity bar, the Allegro UI displays job schedule configuration attributes for reference. These fields are display-only.
      2. The activity bar shows a status circle on the left indicating the overall job schedule status for the date.
      3. Below the activity header bar,
         1. A linked tile appears for each job set in the job schedule configuration. Note that if you add or remove jobs, previous job schedules still show the status of the job schedule executed on that date. Job schedules executed after the change date reflect the updated job schedule execution.

Managing The Job Schedule Actions

This is required only for test or demo purposes. It may also be needed if a client's job schedule is set to execute manually. To manage job schedule actions,

1. Navigate to the job schedule using “Navigating to a specific job schedule”.
2. The activity pane for the job schedule on the selected date appears.
3. Action buttons appear on the left of the activity header. These are:
   1. Create—Creates a job schedule for test or demo. After creation, the UI disables the button.
   2. Recreate—If the job schedule is pending, recreates it for the date. Use this after editing the job schedule configuration to add or remove jobs or change their sequence. Otherwise, the UI disables the button.
   3. Process—If the job schedule is pending, executes it for the date. Once execution starts, the button disables automatically.
   4. Reprocess—Enabled if the job schedule or any job has errors. The underlying error must be resolved; otherwise, reprocessing has no effect.
   5. Reset—Resets the job schedule.
4. The activity bar also has a Refresh button. Use it to update the job schedule's current state during execution. 

Managing the Job Details

If a job schedule execution is in progress, completed, or errored, you can view the current state of each job. To manage job details,

1. Navigate to the job schedule using “Navigating to a specific job schedule”.
2. To see job details in a schedule, click the 3 dots at the top-right of a job tile. This opens a drop-down menu with options enabled based on the job's state. The sub-menu options include:
   1. Process Action—Allows manual processing of the job within the schedule. Disabled if the job is Completed or Errored.
   2. Retry—Enabled if the job has errored work items. Resolve underlying errors before retrying to avoid no change.
   3. Stats—View work item stats for the job, showing:
      1. Total Count—Total work items for the job on that date. For example, a billing job expecting 1000 accounts will show 1000.
      2. Pending Count—Number of work items pending processing during execution or if errored.
      3. Processed Count—Count of successfully completed work items.
      4. Error Count—Count of errored work items needing reprocessing. Clicking the Info icon next to the error count opens a drawer showing error counts by code, including:
      5. Error Count—Count for the specific error code.
         1. Error Code—The error code.
         2. View Detail—Click the View link to see errored work items for that code. This opens a sub-drawer listing each errored work item with:
         3. Account Id—Account associated with the errored work item.
         4. Batch Id—Batch ID for the work item. Jobs execute in batches; multiple batches may exist per job depending on volume. This aids operations in review and reprocessing.
         5. Reason—Failure reason. Expand or hover over the box to view details.
         6. Status—Displays as ERROR.
         7. Payload—Each work item relates to an internal API with a JSON input specification. Expand or hover to view full details. Useful for operations to review the execution payload.
3. To return to the main activity pane, click the Cancel button at the bottom right of the drawers or click outside in the activity pane. You may need to click multiple times. This is shown in the following screenshots:
   
   Sub-menu for a job in a job-schedule:
   
   
   Stats for the job:
   
   
   Option to drill down the error count details:
   
   
   Next click-down of error-count, by error code:
   
   
   Next click-down of work items that errored for a specific error code:
   

Reprocessing Errored Jobs

Allegro job schedule management supports multiple reprocessing levels, assuming underlying errors are resolved. Otherwise, reprocessing may not change the outcome and will consume resources.

Available reprocess options are:

1. Reprocess job schedule—Enabled via the Reprocess button in the activity bar. It reprocesses from the first job with errored work items and, if successful, completes the remaining schedule.
2. Reprocess job—Enabled in the job sub-menu (three vertical dots) if the job is errored. If subsequent jobs exist, this retry matches the Reprocess job schedule outcome.