The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Job Activity pane displays information about jobs presently in the production schedule. To see jobs that have been defined but that are not currently scheduled, you need to open the Jobs pane. For more information about the Jobs pane, see Jobs .
Note Remember that the security rights of a user will always affect what they are allowed to see in Scheduler. The Job Activity pane may show all jobs currently scheduled or only the jobs owned by the user and the user’s workgroup, depending on the user’s security policy.
The messages that display information about each job and group use different colored text to indicate their status, with a row background color of white. For example, carry over job rows display a background color of light gray.
Job groups are presented in bold with an expand or collapse button in the first column. All jobs in a job group are slightly indented and can be collapsed into and expanded from the group.
Use the scroll bars to view all the columns in the Job Activity pane. The Job Activity pane makes a large amount of important job information easily accessible. In the case of estimated start times and durations, the values displayed are periodically updated as new data becomes available. You can also press the F5 key for an instant refresh.
The Job Activity pane displays can be customized through the Preferences dialog. For more information on how to customize the Job Activity pane, see “Job Activity Preferences Dialog” section .
If the schedule in the Job Activity pane is a “forecast” for a future date ( Forecast Only option selected when creating a schedule), then the word “Forecast” displays after the date in the pane title bar.
From the Navigator pane, select Operations > Job Activity to display the Job Activity pane.
You can double-click a job in the Job Activity pane to open its Job Details dialog.
Note When you view a particular day in the production schedule, all jobs that have not been launched on previous days will also appear (unless you have filtered them out). This includes jobs in Active, Waiting On Resources, Waiting On Operator, Waiting On Dependencies, Stopped, Held, Agent Unavailable and Agent Inactive states.
The Job Activity pane contains the following buttons:
Enter text that you want to search for within the columns displayed into this field.
Note This field at the top right of the grids will only search text columns that are not grayed out and are string-based. See “Searchable Columns” on page 44.
The order of the columns listed in the Job Activity pane can be rearranged from the Job Activity Preferences dialog.
The Job Activity pane contains the following columns:
Note The displayed value for the Actual Duration value of a job is updated every 90 seconds.
– Event – The job was inserted by an action that was initiated by an event.
– Calendar – The job was compiled into the schedule according to its calendar.
– On Demand – The job was an ad hoc insertion through either operator action or the command line.
Each column can be sorted in either ascending or descending order. Click any column name to change the column sort. For example, click Name on top of the Name column. The items in the column alphabetize from z to a . Click Name again and the items alphabetize from a to z . For a column that is numerical, the sort changes from earliest to latest time, or latest to earliest time.
Select View>Preferences from the main menu bar while viewing the Job Activity pane to display the Job Activity Preferences dialog.
From the Columns tab, you can select which columns are displayed in the Job Activity pane and in what order they appear.
The Status Colors tab lists every possible status a job can have. From the drop-down menu to the right of each field, you can select the color to represent that status in the Job Activity pane.
On the Grid Background Color tab select an option from the drop-down menus to the right of each field. You can select the color to represent the grid background color in the Job Activity pane.
When you right-click in the Navigator pane while viewing the Job Activity pane, the Navigator context menu displays.
This context menu contains the following options:
– Expand Selected – Expands one level on the selected job group, displaying its child jobs. If multiple groups are selected, only the first group selected is expanded.
– Collapse Selected – Collapses one level on the selected job group, hiding its child jobs. If multiple groups are selected, only the last job group selected is collapsed.
– Expand All – Expands all levels on the currently selected group, respectively.
– Collapse All – Collapses all levels on the currently selected job groups to hide all child jobs.
When you right-click in the Job Activity pane, the Job Activity context menu displays.
The Job Activity context menu contains the following options:
– Expand Selected – Expands one level on the selected job group, displaying its child jobs. If multiple groups are selected, only the first group selected is expanded.
– Collapse Selected – Collapses one level on the selected job group, hiding its child jobs. If multiple groups are selected, only the last job group selected is collapsed.
– Expand All – Expands all levels on the currently selected group, respectively.
– Collapse All – Collapses all levels on the currently selected job groups to hide all child jobs.
When you select Job Control from the Job Activity context menu, a submenu displays.
Note After selecting a job control action from the menu, a context dialog confirms the success or failure of the action.
This submenu contains the following options:
– Release – Changes the selected job status from Waiting On Operator or Held , to Active (with an intermediate Scheduled state). When a job group’s occurrence is selected, Release changes the job group’s status from Waiting On Operator to Active (with an intermediate Scheduled state), and changes all child job statuses from Waiting On Group to Scheduled .
– Resume – Changes the selected job status from Stopped to Active . Also changes the selected job status from Held to Waiting On Dependencies (with an intermediate Scheduled state). When a job group’s occurrence is selected, changes its status from Held to Active (with an intermediate Scheduled state). All child jobs that were Stopped become Active , and all that were Held become Waiting On Dependencies .
– Cancel – Changes the selected job status from Agent Inactive , Agent Unavailable , Deferred , Held , Waiting On Dependencies , Waiting On Operator , or Waiting On Resource to Canceled . Canceled jobs do not run in the production schedule.
– Abort – Changes the selected job status from Active or Stopped to Aborted , and kills the active job process on the system.
When selecting Cancel/Abort you can choose to release the selected job’s dependents. If you choose to release, the dependent job will no longer be dependent on the job you are canceling or aborting.
The View Time by Agent dialog displays by clicking the View Time By button on the TES toolbar while in the Job Activity pane.
This dialog configures the times displayed in the schedule according to the time zone of one of the system components. TES may be managing a production schedule that includes components that are spread out over a wide geographic area. This geographic area may encompass several time zones. When you are scheduling jobs over diverse timezones you have to account for the fact that the master, agent and Tidal Web client may be in different time zones.
Note You can configure the jobs to run according to the timezone used by the master or by the agent from the Timezone tab of the System Configuration dialog. Master and Job Based Timezone offset will be applied into all time value for that job.
You can configure the Tidal Web client to display the estimated and actual times of jobs from the viewpoint of one of the following components:
The Job Detail dialog displays when you double-click a job occurrence record in the Job Activity pane or right-click and select Details from the context menu.The details shown for a job differ from the details for a job group, thus while the Job Details dialog for a job group is very similar, it does not have the same tabs as a job does.
This tab contains the following elements:
– Calendar – Compiled into the schedule based on an assigned calendar.
– Event – Inserted by a job action based on an event trigger.
– On Demand – Inserted by an operator via the Tidal Web client, command-line, API or Web Service.
– if the value equals 0, the job has completed normally
– if the value does not equal 0, the job has completed abnormally
Displays both user-initiated job interaction and production schedule audit trail messages for the job including job control actions, job occurrence status changes and errors.
Double-click a record to display its details more clearly.
Displays the standard output of the job. TES can be configured to save or discard job output by default from the Defaults tab of the System Configuration dialog. Regardless of the system default, any individual job instance can be configured from its job definition to override the system default.
If a job is canceled before it can complete, any partial output that was generated during the processing of the job displays on the Output tab. Note that a job group does not have an Output tab in its Job Details dialog.
Note Scheduler’s default is to discard job output. To save or append job output or to specify that the output be produced in summary format, change the system default on the Defaults tab of the System Configuration dialog. This can be adjusted for individual jobs from the Options tab of that job’s Job Definition dialog.
You can refresh the output if parameters have been changed after runtime by clicking Refresh output .
Shows all predecessors (job, file, time and variable dependencies) needed before a job can run. It also displays all successors occurring after the job runs.
From the Dependencies tab, you can override individual job dependencies for a job instance (but not for a job group). (To override all of a job instance’s dependencies, refer to the override section of the Job Control Submenu .) Other instances of the job are not affected when you override a dependency.
There are three ways to override a dependency:
This tab contains the following elements:
File dependencies are defined in the job’s definition dialog, and are displayed with a file icon, the file’s path name and the dependency expression (Exist, Not Exist, etc…).
Job dependencies are defined in the job’s definition dialog and are displayed with a job icon, the job’s name, the selected logical operator (=, <>, etc…), its target status, and the present status. If the job is not currently in the production schedule, the icon changes to the not-in-schedule icon.
Note To have a job ignore a job dependency when the dependency is not in the schedule, select the Ignore dependency if job not in schedule option in the Job Dependency Definition dialog.
Time dependencies are displayed with a time icon, and indicate the time when the time dependency will be met.
Variable dependencies are defined in the job’s definition dialog and are displayed with a variable icon, the variable’s name, its dependency expression and its present value in parentheses.
The Resources tab of the Job Detail dialog displays information about any resources assigned to a job. The current and required system resource values, with a column showing the status of the resource, displays on this tab. In the case of a job that uses an agent list and has not yet been assigned an agent from the list, the current and status columns are grayed out.
The possible statuses for the resource are:
A resource in a Locked status cannot be overridden to release it but a user could modify the resource's definition to temporarily increase its limit and make more of the resource available to other jobs.
Note Resources cannot be assigned to a job group. If this is a job group definition, then the Resources tab is not displayed.
The Resources tab contains the following elements:.
– Type – The kind of resource that is being used, Virtual or Agent .
– Resource Name – Displays the name of the resource associated with the job.
– Amount Used – The amount of the resource's specified limit that the job uses. This number cannot exceed the number shown in the Amount Available column.
– Amount Available – The amount of the resource that is available to be used. This number is derived by subtracting the amount of the resource currently in use from the limit specified in the resource’s definition.
– Status – Denotes the status of a resource assigned to the job. There are three possible statuses:
Available – The resource is available for the job.
Waiting – The resource is not currently available. The job is unable to run until the specified amount (shown in the Amount Needed column) of the resource is available.
Locked – The resource is being used by job. The amount of the resource being used by the job (shown in the Amount Used column) is unavailable to any other job until this job completes. If multiple resources are required for the job, then an all or nothing approach is used. No resource is locked up until all of the required resources are available and can be locked simultaneously.
Note A resource in a locked status cannot be overridden to release it but a user could modify the resource's definition to temporarily increase its limit and make more of the resource available to other jobs.
– Type – The kind of resource that is being used, Published or Custom .
– Resource Name – Displays the name of the resource associated with the job.
– Current – Displays the current value.
– Condition – Contains the conditional operators depending on the data type of the resource.
– Required – Displays the amount of the resource needed by the job. This amount is defined in the Resource Requirement Definition dialog.
– Status – Denotes the status of a resource assigned to the job. There are three possible statuses:
Available – The resource is available for the job.
Waiting – The resource is not currently available. The job is unable to run until the specified amount (shown in the Amount Needed column) of the resource is available.
Locked – The resource is being used by job. The amount of the resource being used by the job (shown in the Amount Used column) is unavailable to any other job until this job completes. If multiple resources are required for the job, then an all or nothing approach is used. No resource is locked up until all of the required resources are available and can be locked simultaneously.
Displays the variables used by the job group. These variables are isolated from any changes to their values that occur outside of this job group and its parent or child groups. The Job Details dialog for a job does not have a Variables tab.
Displays job properties that can be changed for this occurrence at any time while the job is waiting to run. After a job runs, it is only useful to change these values if you rerun the job. Changes made only affect the instance and not the rule as defined in the Job Definition dialog. The Job Details dialog for a job group does not have an Override tab.
Note After changing any of these values and clicking OK, you are prompted to confirm the changes, and you are given the choice to apply the changes to all occurrences of the job in today’s schedule if this is a repeating job. This applies to all repeating jobs that have not run yet, and all additions of this job that were inserted manually.
This tab contains the following elements:
Note Since the agent is not assigned to a job until the last minute, if a user looks at a Job Details dialog before the job runs (e.g., the job is in a Waiting on Dependencies state), the Agent field on the Override tab is empty. The master does not select an agent from the agent list displayed in the Agent List field until the job’s dependencies are met and the job is ready to run. Only then is the agent selected and the name of the agent displayed in the Agent field. If the job reruns, the master may assign a different agent from the agent list according to the demands of the production schedule.
The Runbook tab is intended to supply any instructions for the user relative to the execution of this job. This field can be used effectively with the Require operator release option in the job’s definition.
Use this field to enter other notes concerning the job.
This tab contains the following elements:
A web address or network directory address can be entered here and if the Load URL option is selected, the specified directory or web page from an internet site or a company intranet site displays. The web page or directory pane that displays here is an active pane that can be refreshed and whose links and folders can be accessed by clicking. You can right-click a web page in this field to display a context menu of the same options available in the web browser.
Details the job run history of every occurrence of this job in the production schedule sorted by Start Time and then by job number in descending order. The history includes jobs that have completed and jobs currently waiting to run either as repeated jobs and/or in future days of the production schedule. The history is retained according to the retention history setting in the job’s definition.
Note Columns in the History tab can be resized by clicking the right border bar and dragging left or right.
This tab contains the following elements:
The Job Filter dialog displays by right-clicking in the Job Activity pane and selecting the Filter option from the context menu.
The Job Filter dialog allows you to perform the following tasks:
Note Filters only apply to jobs within groups, not to groups themselves. Groups are only displayed if at least one child within the group passes the filter criteria. If, according to the criteria, the group would be empty, the group is not displayed. If the Show Groups option is not selected, groups are ignored completely, and filters apply to the individual jobs which are now displayed outside of their group.
Use this filter to view only jobs with the statuses you are interested in. The default is all statuses (all selected).
The Job Filter dialog contains the following status viewing options:
Note When the Status column is sorted, the sort order is defined by the sort order listed in the System Configuration dialog. For more information about the System Configuration dialog, see, “System Configuration” on page 68.
Use this section to filter for jobs that run only during certain hours. Select the check box for each hour you wish to filter for.
– * (Asterisk) The asterisk character masks any number of characters on and to the right of the location it is placed. For example, A* will match (allow in) AB , ABB , and ABBB .
– ? (Question Mark) The question mark masks one character in the location it is placed. For example, A?A will match ABA and ACA , but not ABB or ABBA .
– [x, y, z] The brackets with commas let you specify a set of characters to filter in to that location in the string. For example, A[X,Y]B accepts AXB and AYB but not AAB .
– [a-z] You can also specify ranges within brackets. For example, A[X-Z]B filters in AXB , AYB , and AZB but not AWB .
Note Jobs that did not finish on their production dates carry over only if the Carry Over Unfinished Schedule option was selected on the Master tab of the System Configuration dialog.
If the option is not selected, all jobs are downloaded first and then filtered by the Tidal Web client to meet the defined criteria. After the initial download it is quicker to refilter the jobs from the Tidal Web client since they do not have to be downloaded again.
The Job Statistics dialog displays by right-clicking in the Job Activity pane and selecting Statistics from the context menu. The Job Statistics dialog shows statistics regarding job occurrences for the day currently displayed in the Job Activity pane. You can view statistics for All Jobs, Production jobs and Unscheduled jobs on the respective tab.
These tabs contain the following elements:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Select View>Preferences from the main menu bar or right-click the Navigator pane and select Preferences from the context menu to display the Preferences dialog.
Step 3 Click the Columns tab. By default, all columns are used.
To add a new job or group occurrence:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Right-click the job or job group occurrence to add to the production schedule and select Insert Job Into Schedule from the context menu or click the job or job group, and from the Activities main menu, select Insert Job Into Schedule .
Step 3 Click Yes at the confirmation prompt.
Another occurrence of the selected job or job group is added to today’s production schedule regardless of its calendar dates (if any). If the job is defined to repeat, only one occurrence of the job enters the schedule. Note that a job must have the Unscheduled Allowed option selected in its Job Definition to be added in this manner.
Step 1 Place the cursor on the right vertical border of the column heading. The mouse pointer turns into the separator icon.
Step 2 Hold down the left mouse button and resize the width.
To remove jobs that have not yet launched from the production schedule:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Right-click the job or job group occurrence to remove, and from the context menu select Remove Job(s) from Schedule . In the resulting confirmation dialog, select Yes if you only want to delete the selected job occurrence. If you wish to delete all future scheduled occurrences of the job, select the All option.
You can select multiple jobs or job groups simultaneously.
Step 3 Click Yes at the confirmation prompt.
Remove Job(s) from Schedule will remove any pre-launch job occurrence from the schedule, for any date. Only the job occurrence you select is removed. If a job group occurrence is selected, all of the group’s child jobs are removed.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Click the Filter button on the TES toolbar or right-click the Navigator pane and select Filter from the context menu to display the Job Filter dialog.
The statuses that are presently displayed are the ones with a check mark.
Step 3 Select the agent, owner and job statuses to view.
You can view job occurrences for past, present or future days. Each job’s retention history value in its job definition determines how far back you can see its job occurrences. The Future Days value in the System Configuration dialog determines how far you can see into the future.
Note When you are viewing the current day in the Job Activity pane, you may also see jobs from previous dates if those jobs have not yet completed.
To move to different dates and times:
From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
You can pause and then resume the production schedule at any time. You can also pause and resume job launching without having any affect on scheduling.
When you pause a production schedule, the master service is stopped and waiting jobs are prevented from running, even if their dependencies are met. Jobs that are already in Active status will continue to run on their respective agents; however, their updated status (for example, Completed Normally ) will not be displayed in the Job Activity pane until the master service is restarted.
When you pause job launching, jobs can still be scheduled and calendars compiled, but jobs will not actually launch until job launching is resumed.
To pause the production schedule or job launching:
Step 1 From the Navigator pane, select Operations>Job Activity> to display the Job Activity pane.
Step 2 From the Activities main menu, select Pause Scheduler or Pause Job Launching .
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 From the View main menu, select Preferences or right-click the Navigator pane and select Preferences from the context menu to display the Preferences dialog.
Step 4 Select the column and click the up or down arrows to arrange the titles into the desired order.
To recreate the production schedule:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 From the Activities menu, select Create Schedule to display the Create Schedule dialog.
Step 3 Select the date range for which to create the schedule.
Step 4 If you want repeating jobs with no time window to start immediately, rather than after midnight, select the For today’s repeating jobs with no time window, start repeating ASAP option.
Step 5 TES searches for all qualified jobs to add to the production schedule for the selected dates.
Warning All job occurrences that were added manually and all records of jobs that ran will be lost. Furthermore, the Create Schedule recreates the schedule at the time you issue the command. This means that jobs whose dependencies have not been met can qualify to run immediately. Use this command with caution.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 From the View main menu, select Refresh Data or Refresh All Data .
To resume the production schedule or job launching:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 From the Activities main menu, select Resume Scheduler or Resume Job Launching .
You can view the output of a job after the job finishes running. In order to view the output of a job from the Job Activity pane, you must save the output for the job on the master (this is the default).
To save a job’s output on the master:
Step 1 From the Navigator pane, select Definitions>Jobs to display the Jobs pane.
Step 2 Select the job for which to save output.
Step 3 Click the Edit button to display the Job Definition dialog.
Step 5 In the Save Output option, select Append or Replace .
Step 6 Click OK . The next time the job completes, you can view its output from the Job Detail dialog.
To select or remove all job filters:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Click the Filter button on the TES toolbar or right-click the Navigator pane and select Filter from the context menu to display the Job Filter dialog.
Step 3 Right-click in the Statuses section and select Check All or Uncheck All from the context menu.
Note You should only set the completion status of jobs that have already finished running. Setting completion status of a job that is still active, may adversely affect job activity.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Select the job on which to perform job control.
Step 3 Right-click the job to open the Job Activity context menu.
Step 4 From the Job Control submenu, select Set and from the Set submenu, select the desired job completion status.
Note When job completion statuses are changed in this way, an asterisk appears to the right of it, for example, Completed Normally*.
You can sort the job occurrences displayed in the Job Activity pane by two different sorting criteria. You can sort on a primary criteria and in turn, organize the primary sort by secondary criteria. The sorts are done by column header in either alphabetical or numerical order depending on the type of data contained in the column.
To sort a job using a column header:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Click the column header to select it for a primary sort. The jobs sort alphabetically (in text data) or numerically (if numerical data). A single arrow displays beside the column header to denote the primary sort.
If you click the header more than once, the sort order toggles back and forth from ascending to descending order.
Step 3 To perform a secondary sort, hold down the ALT key while clicking the column header. The secondary sort displays a double arrow in the column header.
For example, click the Name column heading. The items in the column are alphabetized from a to z (because the column contains alphabetical data). Clicking again reverses the order z to a. Click the Time column header while holding down the ALT key and the jobs remain in alphabetical order but are now organized also by numerical order (since this column contains numerical data). Now the jobs are arranged in alphabetical order and each numerical segment is organized from earliest time to latest time. Clicking again on the secondary sort column while holding down the ALT key reverses the secondary sort to latest time to earliest time.
If you click the header more than once, the sort order toggles back and forth from ascending to descending order.
To sort jobs using the Job Filter dialog:
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Click the Filter button on the TES toolbar or right-click the Navigator pane and select Filter from the context menu to display the Job Filter dialog.
Step 3 Checking or clearing the options for status or hours enables you to sort jobs using those criteria. You can also sort using other criteria listed including by job name, by agent, by queue, by command, etc.
Note The Job Filter dialog includes filter options that affect sorting. For example, if you want to sort by the status column, and some statuses have been filtered out, those statuses will not be used for sorting.
Note When a Status column is clicked for sorting within the Job Activity pane, the order is defined by the settings on the Job Status Order tab in the System Configuration dialog.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Select the job on which to perform job control.
Step 3 Right-click the job to display the Job Activity context menu.
Step 4 From the Job Control submenu, select one of the following job control options:
Note Windows jobs cannot be suspended, therefore this menu item is unavailable for active Windows jobs.
You can view the output of a job after the job finishes running. In order to view the output of a job from the Job Activity pane, you must first have the Save Output option selected in the job’s or job group’s definition.
Note Scheduler’s default is to discard job output.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Double-click the completed job to display the Job Detail dialog.
Step 3 Click the Output tab to view job output.
Step 1 From the Navigator pane, select Operations>Job Activity to display the Job Activity pane.
Step 2 Click the Select Day button or right-click in the Job Activity pane and select the Select Day option to display a Calendar tab.
Step 3 Click the date to go to. You can use the arrow controls in the title bar to move to different months.