Some of the content described in this article is available in the meshIQ Manage interface versions 11 and greater. See meshIQ Highlights v11 for an overview of feature changes.
When you schedule actions for objects, those actions can automatically take place at a later time, such as during a change or testing window.
Actions you can schedule include creating, deleting, modifying, starting or stopping objects. Message actions such as loading messages to a file or clearing a queue can also be scheduled.
Before you can schedule actions, your workgroup server must have the Job Scheduler Expert. Please see How do I install the Job Scheduler Expert for requirements and setup instructions.
Jump ahead |
Viewing an object's scheduled jobs
There is a clock icon next to the name of each object. The color represents the status of the object's scheduled jobs.
– no scheduled items found
– all scheduled items found are complete
– scheduled items are present and none are pending
– scheduled items include some pending approval
– some scheduled items failed
To view an object's scheduled jobs, click on its clock icon. A window similar to the following screenshot opens, displaying the object's past and future jobs.
The Status field displays the status of the job; potential statuses include Pending, Ready, Retrying, Cancelled, Success, or Failure. The Tags field displays the tag (job name) that you specified when the job was created.
Scheduling a job
Select an object to open its pop-up menu and select the desired action you want to schedule. In the below screenshot, the Start all WMQ objects action is going to be scheduled for two queue managers.
On the action window, click the green Schedule button.
The Scheduler window opens. Enter the date and time. Specify a name for the scheduled job in the Tag for scheduled job field. Click Ok. The action is now scheduled.
The object's clock icon will now appear yellow, signifying that the object has a job scheduled but that it has not yet been approved. See the following section for more information.
Approving scheduled jobs
You must have the Approve Scheduled Job right to perform the actions below.
- To view all scheduled jobs for all objects, click the clock icon
from the toolbar at the top right of the screen. Jobs that are pending approval show a status of Pending and are listed with an
button.
- Choose one of the following:
- To approve a single job, click the
Click Yes to confirm the approval. The job Status is updated to Ready.
- To approve a single job, click the
- To approve all Pending or Retrying jobs, click
in the upper right corner of the dialog. A Job Approval Action message is displayed.
Click Yes to confirm the approval. The job statuses for all jobs are updated to Ready.
The clock icons for the ready jobs are now green:
Viewing all scheduled jobs
All past and future scheduled jobs for all objects can be found by clicking the clock icon from the toolbar at the top right of the screen.
The Schedules window opens.
You can choose which columns to display on this dialog by clicking Columns. See Choosing Scheduler Columns.
Use the Search field to locate a scheduled job by entering its tag name and clicking the Search for tag button.
Select a scheduled job to open the Scheduled job info screen where all of the job's details are displayed.
In version 11, scheduled job details (EXCMD_INQUIRE_JOB) also return EXCA_RESPONSE_TEXT. Response Text will only have a value if the scheduled request was an Escape command.
The amount of data displayed in the Response Text row is limited to 2 KB.
You can then click the Response Text details to expand the row to include the full response.
Cancelling a scheduled job
Scheduled jobs can be cancelled from the Scheduled job info screen displayed above. Click the blue Cancel Schedule button at the bottom of the screen to cancel the job.
Choosing Scheduler Columns
To choose which columns you want to include on the table of scheduled jobs on the Schedules dialog, click Columns at the top of the dialog. Select the checkboxes of the columns you want to display, and clear the checkboxes of the columns you do not want to display. Click OK.