Run Wizard

The Run Wizard is a series of screens you can use to set up the execution of a Job or Workflow. You can submit a Job or Workflow to be executed immediately, schedule it to execute at particular times, or set it up to execute on a recurring basis.

Note: The Run Wizard works a little differently for different types of Job s and Workflows. This topic provides a general overview.

There are two main ways to display the Run Wizard.

  • Right-click a Job or Workflow and choose Run from the context menu.

    • To get to the list of Workflows, navigate to Configure > Automate > Workflows or click View Workflows at the bottom of the Studio screen.

    • To get to the list of Jobs, navigate to Configure > Automate > Job Definitions or click View Jobs at the bottom of the Studio screen.

  • While editing a Workflow in the Workflow Editor, click Run.

The Run Wizard includes multiple screens. You can move through the screens sequentially by clicking Next, or you can go to a specific screen by clicking its name in the sidebar on the left.

The list of screens differs for different types of Jobs and Workflows, but in general, the screens are:

  • Show Definition: This screen displays information about the selected Job or Workflow.

  • Parameters: If the Job or Workflow includes input parameters, this screen lets you specify or override those parameters manually. When this screen is displayed, you can reset the parameter values to the last-used values by clicking Last used values on the left, or to their default values by clicking Default values on the left. If the Job or Workflow includes parameter groups, the groups are displayed as additional tabs across the top.

  • Time and Dates: This screen lets you choose when the Job or Workflow should execute. If you want to schedule it to run on a regular basis, you can use the controls under Time and Dates and in the Details area. If you need more granular control over recurrence, consider using Time Windows and Submit Frames.

    Note: Job calls and Workflow calls are submitted with a start time calculated relative to the session time zone. The time zone you choose when you submit will become the time zone specified on this screen.

    The Recurrence Options link lets you presubmit the Job or Workflow a specific number of times and optionally specify an end date for any recurrences.

    Note: You can change he default value for the presubmit count in the Run Wizard by setting the registry entry /configuration/jcs/recurrence/DefaultPreSubmit. Each time RunMyJobs starts up, it creates an Operator Message if this registry entry does not exist or is invalid.

    Warning: You cannot presubmit more than 5000 Job calls or Workflow calls, because that would have serious consequences in terms of performance. If you presubmit more than 100, a warning will display.

  • Control: This screen lets you specify a Queue for the Job call or Workflow call. You can also set a relative priority for the Job or Workflow. Check Hold On Run to give the Job call or Workflow call a Held status until an Operator releases it.

    The Advanced Options tab lets you specify the verbosity of the Out Log and Error Log and optionally specify a Process Server. You can also specify the minimum open Time Window duration necessary to run the Job or Workflow.

  • Run Summary: This screen summarizes the submission and allows you to choose which action to take next.

When you are ready to submit the Job call or Workflow call, click Run. If there are fields with required values that you have not supplied, those fields will be highlighted so you can supply values.

Note: When you initially display the Run Wizard, RunMyJobs evaluates and validates any associated parameter values. If there are many parameters, or there are complex evaluation and/or validation routines, parameter values may not immediately be editable.

Note: Each submitted Job or Workflow is owned by the user who ran it. If the Job or Workflow has a recurrence, all occurrences will be owned by the initial submitter. If you restart or rerun a Job or Workflow owned by another user, you are the owner of those Processes. You can use the System_ChangeOwner Job to switch owners of Job and Workflow recurrence groups.

Confirmation Messages and Errors

There is an area at the top of the Run Wizard overlay that displays confirmation messages (in green) and error messages (in red). You can view the stack trace for an error (for submission to Redwood Support) by clicking Details on the right.

If you hover over the right side of this area, an X displays. If you click this X, all confirmations and error messages are cleared.