Job Management

This tab lets end users view status and print results for jobs in the environment that are queued, running, or completed.

Group box functions

Queued

The Queued group box shows jobs (by ID and name) that have already started but are not yet executed by the batch controller. When the My jobs only checkbox is selected, the list contains only jobs started by the current user.

Running

The Running group box shows jobs (by ID and name) that are currently executed by the batch controller. When the My jobs only checkbox is selected, the list contains only jobs started by the current user.

To stop, kill, interrupt, or wake up a running job, right-click the job and choose an action.

• Stop: Sends a wakeup signal to the selected job and sets SI-STOPREPORT to true. This system item can be used inside a report to stop the job in a controlled way. When a COMMIT command is performed while SI-STOPREPORT is true, an EXIT ALL command is executed. See SI-STOPREPORT in System Items for more information on stopping jobs in a controlled way.
• Kill: Sends a kill signal to the selected job. When a job won't stop by using the Stop signal, the alternative is to kill the job. This immediately stops the process and therefore the job.
• Interrupt: Sends an interrupt to the selected job. A dialog window will open in which an interrupt value (0 to 99) can be entered. See the INTERRUPT keyword of the Routine command. Note: A report is interrupted only when code in the report itself is being executed, not when code in a global routine called from the report is being executed.
• Wake up: Sends a wakeup signal to the selected job. A dialog window opens in which a wakeup string value can be entered. In a report this value will be available in the system variable in the report parameter. The system item SI-PARAMFLAG will always be set to TRUE, even when the wakeup string value is empty. If the waiting report has an optional WakeupData variable specified in the WAIT command, the data will be sent to that variable instead of the report parameter.

Job results

The Job results group box shows results of jobs that were executed by the batch controller. You can refresh the list by selecting Refresh on the right. When you select a job, you can perform actions by selecting one of the buttons on the right. The function of these buttons is described below in the Buttons section.

Job results filter

You can use the controls in this group box to filter the list of jobs.

• Show from - Show until: Use these date boxes to select a date range.
• Report: When a report name is entered here, only jobs where that report was executed are shown in the Job results list.
• User: When a user name is entered here, only jobs started by that user are shown.
• Printer: Select one of the available printer IDs in the AMT environment from the drop-down list. Only jobs that use that printer ID are shown.
• Checkboxes:
  • Only today: When selected, the Show from and Show until date boxes are disabled and both set to the current date, so the Job results list contains only jobs that ran today.
  • Printed today: When selected, the Job results list shows only jobs that were printed today.
  • Not printed: When selected, the Job results list shows only jobs that have not been printed.
  • My jobs only: When selected, the Job results list shows only jobs started by the current user.

Buttons

• Refresh: Refreshes the Job results list.
• Save job results: Saves the Job results list as a PDF file. A dialog to save the Job results list as a PDF file opens.
• Print job results: Prints the Job results list. A dialog opens to select the printer to print to, the pages to print and set the number of copies to print.
• Preview: When a job in the Job results list is selected and that job has print output, a preview of the output is displayed.
• Print again: When a job in the Job results list is selected and that job has print output, the output is printed again. A dialog opens to select the printer to print to, the pages to print and set the number of copies to print.
• View as doc: The print output will be converted to a Word document and opened in Word (if available). The print output can then be changed and saved by using the Save As option in Word.
• Save as...: A dialog to save the print output will open. The print output can then be saved as a:
  • PDF file for Graphical Reports.
  • Text file or comma-separated values (CSV) file for text reports.
• Delete: Deletes the selected job from the Job results list. This also deletes the corresponding entry in the Control Center -> Prints -> Completed (or Queued) prints list.
• Debug: Not yet implemented.

Remarks

Only the status of queued and running jobs as well as the print results of completed jobs can be viewed. No further action can be taken on these jobs.

The only exception is that a selected completed job in the Job results list can be removed from the displayed list by using the Delete button. The underlying job result is not deleted and can still be viewed in the Control Center.