Contents

• Overview
• Job Processor Status
• JobList Status
• Scheduled JobList Queue
• Job Processor Commands
• JobList Commands
• Starting a New Job Processor
• Resetting the Job Processor System

• Help Topics
• Help Index
• Scheduling and Output Options
• System Control Setup

The Job Processor Control Panel allows the system administrator to monitor and manage background job processing from one window. From this window, you can:

• View the current status of Job Processors
• View the current status of running, suspended and upcoming JobLists.
• View the queue of all active scheduled JobLists.
• Pause, resume or end a Job Processor.
• Start a new Job Processor.
• View a Job Processor log
• View the status of all JobLists that have been or are being run by a Job Processor.
• Reset the status of the entire Job Processor system.
• Change the status of a JobList
• Add a JobList to the queue.
• Expire a JobList.
• Maintain a JobList by running the JobList Setup program.
• View the entire Job History of any Step (Job) in a JobList.

The tabpanel in this window has two tabs: Job Processor Status and Job List Status. At startup, a current status display is run on both tabs.

Job Processor Status

At startup, and whenever the Refresh Status button is clicked, the Job Processor Status tab shows:

• The latest Job Processor Number (JP#) that was started (JP#'s are automatically assigned by the system, starting at 1)
• The number of JP's that have been started and not ended normally (presumably still running).
• Counts of the number of JobLists with the statuses: Running, Suspended, Active.

JobList Status

At startup, and whenever the Refresh Status button is clicked, the Job List Status tab shows JobLists and their individual Steps (Jobs) for:

• All JobLists with a status of Running or Suspended.
• JobLists with a status of Active whose next scheduled run is within 24 hours of the present time.

Scheduled JobList Queue

When the Show Queue button is clicked, the Job List Status table shows all JobLists and their individual Steps (Jobs) with a status of Active, regardless of the date and time of their next scheduled run. These are all the jobs that are eligible to be run by a Job Processor at some point in time.

Job Processor Commands

From the bottom line in the Job Processor Status tab, various commands can be added to a JP's queue (at the highest priority). Before starting each Step of a JobList, a Job Processor checks for any of these control commands. To send a command:

• Select a Job Processor # in the combobox. The latest JP# is shown at the top of the list, followed by previous JP#'s in descending order. If the desired JP# has "rolled off" the end of the list, you can enter it directly into the combobox field (it is an "editable" combobox).
• Select a JP Command. Possible commands are:
• Show Jobs: show all JobLists/Steps that have been or are being run by this JP
• View Log:   view the textfile log of all actions by this JP, in a Web browser
• End:             end this JP when it has finished all Steps of any JobList it is running
• Kill:              end this JP now without finishing any JobList it may be running
• Pause:          put this JP in a "pause" status; do nothing until "Resume" is received
• Resume:       resume normal processing after a Pause status
• Click the Submit JP Cmd button to add the command to the queue for action ASAP.

JobList Commands

From the buttons at the bottom of the Job List Status tab (below the JobList table), various commands can be run which affect JobLists.

First, select the desired JobList Number (and the desired JobList Step, for Job History) by clicking in the row containing it, then click:

• The Active button to change the JobList status to "Active".
• The Suspend button to change the status to "Suspended".
• The Close button to change the status to "Closed".
• The Run button to schedule a JobList to run immediately and set status to "Active".
• The Expire button to change the "Do not run after" date to "today".
• The Maintain JobList button to run JobList Setup for this JobList.
• The Job History button to show all Job History records on file for this JobList Step.

Starting a New Job Processor

From the menubar at the top of the window, click on Admin, then click on Start a new Job Processor in the menu which drops down. If the maximum number of Job Processors are already running (based on current count and maximum count in the System Control table), then a warning message will be displayed and no new JP will be started.

Otherwise, the JP startup command specified in the System Control table will be issued to the operating system of the host, and the next sequential JP Number will be assigned and displayed on the status tab.

Resetting the Job Processor System

From the menubar at the top of the window, click on Admin, then click on Reset Entire JP System in the menu which drops down. This command should only be used in the event of a "system crash" or other event which leaves the System Control and JobList tables in an incorrect status.

This command will cause the following actions to occur:

• Add Kill commands to the queue for all JP's that the database shows as still running, to see if they can end themselves normally.
• Wait for two "loop" cycles, as specified in the System Control table.
• Close all JP control commands in the queue.
• Reset the JP count in the System Control table to zero.
• Change the status of any "Running" JobLists to "Suspended".