Manage remote jobs

In the Administration Console, you can view the remote jobs or build commands in the job queue, open their logs, and edit or delete jobs.

About remote jobs

Remote jobs enable you to initiate operations on a remote node where a Dimensions CM Listener is running, and integrate Dimensions CM with your own systems and tools.

For details on how to set up remote jobs, see the API reference.

In the Remote Jobs section of the Administration Console, you can:

  • View a list of remote jobs.

  • Change the status or description of remote jobs.

  • Delete remote jobs.

To open Remote Jobs, go to Administration Console > Distributed Development > Remote jobs.

Back to top

View and filter remote jobs

You can view the status, general summary, and logs of remote jobs or build commands initiated on Dimensions CM tertiary network nodes.

The log of a build command contains a brief build summary and details about targets built and preserved in Dimensions CM. It also includes any messages, warnings, or errors generated during build outputs collection.

Use the filter to narrow down the list of displayed remote jobs.

To view and filter remote jobs:

  1. In the Administration Console, go to Distributed Development > Remote jobs.

  2. In the navigation pane, select the top-level node to display a list of all remote jobs in the content pane.

  3. To filter the job list, click the Filter link at the top right of the content pane. In the Remote Job Filter dialog box, set the filtering criteria and click OK. For details, see Remote Job Filter dialog box.

  4. To view the log for a remote job:

    1. In the Remote Jobs navigation pane, select the relevant job.

    2. In the content pane, click the View logs button. The Show Logs dialog box opens, displaying the job results:

      Field Description
      Item The item specification.
      Log Type The status of the build of the target.
      Log The text of the log.

Back to top

Change or delete remote jobs

You can change the status, result code, or description of a remote job or build command, and delete jobs from the queue.

To change or delete remote jobs:

  1. In the Administration Console, go to Distributed Development > Remote jobs.

  2. In the navigation pane, select the top-level node to display a list of all remote jobs in the content pane.

  3. In the content pane, select one or more jobs to change or delete.

    Note: You can change the status and description only for those jobs and build commands whose current status is SUBMITTED.

  4. To change the status of selected jobs, click Change Status on the toolbar. In the Change Status of Remote Job dialog box, update the details, as needed:

    Field Description
    Status Change the job status to SUCCEEDED or FAILED.
    Result Code

    Enter an integer to specify the result code for the job.

    Normally, the code of 0 means success, and a non-zero code means failed.
    Description Update the job description.

  5. Click OK.

  6. To change only the description of selected jobs, click Change Description on the toolbar. In the Change Description of Remote Job dialog box, update the description and click OK.

  7. To delete selected jobs, click Delete on the toolbar, and confirm.

    Note: You can delete only those jobs and build commands whose status is SUCCEEDED or FAILED.

Back to top

See also: