About Jobs and the Search All Jobs Window

Final Cut Server runs jobs for every task it performs. The number of jobs that run depends on the type of operation being performed. Some examples of jobs include:

Each job also creates multiple log entries for each step of the operation. If you want to monitor what Final Cut Server is working on, simply open the Search All Jobs window. In it, you can search for specific jobs and then see a job’s details. You can set up a subscription that sends you an email whenever a job submitted by you fails.

Important: Final Cut Server includes a schedule, named Scheduled Maintenance, that clears the Search All Jobs window once each day. You can modify that schedule as needed to better fit your needs. For more information, see About Clearing Jobs and Logs from the Final Cut Server Database.

Opening the Search All Jobs Window

The Search All Jobs window contains a detailed history of the jobs Final Cut Server has performed.

To view a history of the jobs that have been run (to the present)
  • Choose Search All Jobs from the Server pop-up menu (the pop-up menu in the Final Cut Server main window that appears when you click the Server button).

The Search All Jobs window appears.

Figure. Search All Jobs window.

Following are the possible Progress and Status definitions:

Progress
Status
Description
Full-width green bar
DONE
Job is successfully completed (note that some completed jobs are made of several steps; for example, uploading multiple files).
Expanding green bar
RUN
Job is in progress.
Blank field or text
RUN
Job is in progress.
Blank field
WAIT
Job is waiting for user input or for a turn in the job queue.
Full-width red bar
FAIL
Job failed because of an error.

Other fields in the Search All Jobs window include:

  • Title: Details of the job.
  • Owner: Name of the user who performed the job.
  • From Device: For a copy, the source device.
  • To Device: For a copy, the destination device.
  • Updated: The time and date the status was last updated.
  • Job Type: Copy is the only job type shown in the Search All Jobs window.

Searching for Jobs

The search function in the Search All Jobs window works similarly to the other search functions in Final Cut Server: you can search by name, or you can open the disclosure triangle and search by the advanced search parameters.

Figure. Search All Jobs window.

Some examples of common searches are:

  • Your own jobs: A simple search for your user name or an advanced search for your user name using the Owner pop-up menu and field
  • Failed jobs: A simple search for “fail” or an advanced search for “fail” using the Status pop-up menu and field
  • Jobs to or from particular device: An advanced search using the From Device and To Device pop-up menus and fields

Using the Search All Jobs Window to Diagnose Problems

Besides using the Search All Jobs window to track jobs being performed by Final Cut Server, you can use the Search All Jobs window to view details of each step in a job and diagnose problems.

To diagnose a problem using the Search All Jobs window
  1. Double-click the failed or idle job that you want to diagnose in the Search All Jobs window.

    In the window that opens, you can choose to show job metadata (in two panes, Job Details and Job Copy Params) or to see the job as it appears in the Log pane of the Administration window.

    Figure. A job's info window, showing the Job Details metadata.
  2. Click Metadata (along the top of the window) and Job Details in the column on the left to see the Job Details pane.

    The Job Details pane displays details of the job as a whole, including a unique Job ID (identifier), the job type, and specific job instructions. The last item displays the message associated with this job.

  3. Click Job Copy Params in the column on the left.

    The Job Copy Params pane displays parameters specific to copying.

    Note: No parameters are listed if the job was a copy without any transcoding.

    Figure. A job's info window, showing the Job Copy Params metadata.
  4. Click Logs along the top of the window.

The Logs pane displays details of each step in the job, exactly as step details appear in the Log pane of the Administration window.

Figure. A job's info window, showing the log files.

The ERROR message in the Detail column explains why the job failed. Using this information, you can correct the problem and then reprocess the job. You can double-click an entry to open it in its own window, which can make it easier to see the details.

Figure. Log window showing details about a failed job.

Jobs can fail for reasons such as a corrupt source file, network problems or device unavailability, or problems on the source or target device such as resource limitations or an unsupported codec.

Retrying Failed Jobs

When a job fails for a reason that is not permanent, it is automatically retried. You can define how many times a failed job is retried and how long to wait between retries in the General pane of Final Cut Server System Preferences and in the Preferences pane of the Administration window. See Preference Settings in the Administration Window for more information.

You can also manually retry the job.

To retry a failed job
  • Control-click the job, then choose Retry from the shortcut menu.

    Figure. Pop-up menu that appears when you Control-click a failed job.

Important: Only the person who originated a job or the administrator can retry a job. Additionally, you cannot retry jobs with permanent failures.