3.4 Configuring the Subscriber Channel Trigger Job

The Subscriber Channel Trigger job sends event documents to be processed by the driver’s Subscriber channel. For example, a job could generate an event document to trigger policies associated with a user.

You configure the job to generate zero, one, or more event documents by defining a scope for the job. The scope identifies objects for which you want the job to trigger events. If you do not include a scope (no objects), the job creates one event document. If you identify one or more objects, the job creates event documents for each object.

Submitted event documents can be queued to the driver cache, or they can bypass the cache and be processed immediately.

  1. Make sure you’ve already added the job to the driver. If you haven’t, see Section 2.0, Adding a Predefined Job.

  2. On the General page in iManager, configure the following options:

    Enable Job: Leave this option selected unless you don’t want the job to run.

    Delete the Job After it Runs Once: Select this option if you want the job to run one time only and then be deleted.

    Servers: Select the servers where you want the job to run. Multiple servers are available only if the driver is running on multiple servers.

    Email Server: To monitor the job, you (or others) can receive e-mail notifications whenever certain results occur for the job. You configure e-mail notification on the Results page. However, to enable this e-mail notification to work, you must first specify the e-mail server that will be used to send the notifications. Click the button to locate and select the Default Notification Collection object or any other notfTemplateCollection object that defines an SMTP mail server.

    Display Name: Displays the name assigned to the job.

    Description: Displays the description assigned to the job.

  3. On the Schedule page, select one of the following options:

    Run on a Schedule: Runs the job on a daily, weekly, monthly, or yearly schedule. You can also specify a custom schedule; use the crontab standard when specifying a custom schedule.

    Run Manually: Runs the job only when you initiate it through the Run Now option (see Section 5.0, Starting a Job).

  4. On the Scope page, add the objects for which you want the job to trigger events. For each identified object, the job creates an event document. If no object is scoped, the job trigger creates one event document.

  5. On the Parameters page, set the parameters for which you want the job to submit trigger documents.

    1. If you want to submit a trigger document for scoped objects that do not have a driver association, select True. Otherwise, keep the default of False.

    2. If you want to use the job’s Common Name (CN) as a document identifier trigger, keep the default of True. Otherwise, select False.

    3. (Optional) If you select False, enter the string that the job can use as the value for the trigger element’s Source attribute.

    4. Select a method for submitting the trigger documents. If you want to queue the job the trigger is from, keep the default of Queue (use cache). Otherwise, select Direct (bypass cache).

    5. (Optional) If you select Direct (bypass cache), you are presented with the Start driver if not running option. If you want to start the driver if it is not running, keep the default of True. Otherwise, select False.

    6. (Optional) If you select True on the Start driver if not running option, you are presented with the Stop driver when finished processing triggers option with the default of True. Use the default to stop the driver once it finishes processing the trigger job, or select False to keep the driver running.

    A customized job definition has its own parameter set.

  6. On the Results tab, define the actions you want performed based on the results for the job.

    Each time the job runs, it generates Intermediate results and a Final result. The possible results are Success, Warning, Error, and Aborted. Intermediate results are generated at various points throughout the job. The Final result is generated when the job is finished. For each result, you can specify the action you want performed when it occurs: 1) generate an event for Novell Audit or Novell Sentinel and 2) generate an e-mail notification. For example, you might want no action to occur for an Intermediate Success result and an e-mail notification to be sent for an Intermediate Error result.

    To define an action for a result:

    1. Click the No action link next to the result to display the Result Notification dialog box.

    2. Select Audit result if you want to generate an event for Novell Audit or Novell Sentinel.

      or

      Select Send email, then fill in the recipient and e-mail template information.

    3. Click OK to save your changes.

  7. When you have finished configuring the job, click OK to save your changes.

    The job is added to the job list.

  8. Select the job in the list (by selecting the check box next to the job name), then click Get Status.

    The Job Status dialog box displays any configuration errors. Because the job requires write rights to the DirXML-AccessSubmitCommand attribute of the driver object and those rights have not yet been granted, you see an Insufficient rights to driver object error.

  9. Click Grant rights, then click OK to confirm the action.

  10. If other errors are displayed, resolve the errors. Otherwise, click Close to close the Job Status dialog box.