Creating a job

Before you create a job, determine which method the job runs or create a Docbasic script, Java method, or other program to perform the task. If you create your own script, method, or program, you must then create a method object referencing the program. Refer to Methods, for information about creating method objects.

The New Job and Job Properties pages are identical for standard jobs, replication jobs, records migration jobs, remove expired retention objects, BOCS caching jobs, and job sequences. For instructions about creating a specific type of job, refer to:

To create a basic job:

  1. Navigate to Administration > Job Management > Jobs.

    The system displays the Jobs list page.

  2. Select File > New > Job.

    The system displays the New Job page with the Info tab selected.

  3. Enter the general job information on the Info tab, as described in Table 7.3.

  4. Click the Schedule tab and enter the job schedule information, as described in Table 7.4.

  5. Click the Method tab and enter the job method information, as described in Table 7.5.

  6. Click the SysObject Info tab and enter the job SysObject information, as described in Creating, viewing, or modifying SysObject properties.

  7. Click Finish to save your changes.

Table 7.3. Job Info properties

Field labelDescription

Name

The name of the job object.

Job Type

A label identifying the job type.

If you are creating a replication job, records migration job, remove expired retention object, BOCS caching job, or a job sequence, this field is automatically populated with the associated job type.

Trace Level

Controls how much information is recorded in trace logs. May be set from 0 to 10. For instructions on viewing trace logs, refer to Viewing job trace logs.

Designated Server

When more than one server runs against a repository, use to designate a server to run the job. The default is Any Running Server.

State

Determines how the job runs:

  • If set to Active, the job runs as scheduled.

  • If set to Inactive, the job does not run automatically, but can be executed manually.

Job Start Date

Specifies when the job was started. This option is a read-only field that only displays for existing jobs.
Options 

Deactivate on Failure

Specifies whether to make the job inactive if it does not run successfully.

Run After Update

Specifies whether to run the job immediately after any changes to the job are saved.

Save If Invalid

Specifies whether to save the job object if Documentum Administrator is unable to validate the job.

Job Run History 

Last Run

Displays the last date and time the job ran and was completed. This option is a read-only field that displays for existing jobs.

Last Status

Displays the last time the job completed and the length of time the job took to run. This option is a read-only field that displays for existing jobs.

Last Return Code

Displays the last value returned by the job. This option is a read-only field that displays for existing jobs.

Runs Completed

Displays the number of times the job has run to completion. This option is a read-only field that displays for existing jobs.