Assigning a method to a job

Each job executes a method to perform particular tasks. Methods are executable scripts or programs represented by method objects in the repository. The script or program can be a Docbasic script, a Java method, or a program written in another programming language such as C++.

The associated method object has properties that identify the executable and define command line arguments and the execution parameters. For example, the dm_DMClean job executes the dm_DMClean method. Some Documentum jobs execute a specific method that cannot be changed.

If you assign a user-defined method to a job, that method must contain the code to generate a job report. If you turn on tracing, only a DMCL trace is generated.

To assign a method to a job:

  1. Click the Method tab on the the New Job or Job Properties page.

  2. Enter the method information, as described in Table 7.5.

  3. Click OK to save the changes.

Table 7.5. Job method properties

Field labelDescription

Method Name

Specifies the name of the method that is associated with the job.

Click Select Method to display the Choose a method page. Select a method name and click OK.

Refer to Locating a method for a job for instructions to locate a method.

Arguments

Specifies the method arguments.

Click Edit to display the Method Arguments page. Enter new arguments, remove unnecessary arguments, or change the values to the method by the job.

Many jobs take the queueperson and window_interval arguments.

  • The queueperson argument defines which repository user receives the inbox and email notifications generated by the jobs. If you do not designate a repository user for a specific job, the notifications are sent to the user identified by the operator_name property of the server’s server config object. This property is set to the repository owner’s name by default.

  • The window_interval argument defines a window on either side of the job’s scheduled run time in which the job can run. This ensures that if a server must be restarted, the startup is not delayed by jobs that must be run.

Pass Standard Arguments

Select this option to pass the standard arguments for the method.

The standard arguments are:

  • Repository owner

  • Repository name

  • Job ID

  • Trace level