FS
Documentation

Task3G/User Guide/Submitting and Managing Jobs

This page was last modified 03:40, 6 March 2008.

From Documentation

< Task3G | User Guide(Difference between revisions)
Jump to: navigation, search
Revision as of 06:41, 19 April 2006
Moff (Talk | contribs)

← Previous diff
Current revision
Moff (Talk | contribs)
(New Settings for a Job)
Line 1: Line 1:
 +{| align="right"
 +| __TOC__
 +|}
Job submissions are performed via the task3G Job console. From this console you can: Job submissions are performed via the task3G Job console. From this console you can:
*Submit jobs to run at a scheduled time. *Submit jobs to run at a scheduled time.
Line 12: Line 15:
<br> <br>
-=== task3G Job Monitor ===+<br>
 +<br>
 +<br>
 +<br>
 +<br>
 +<br>
 +<br>
 +<br>
 +<br>
 +=== Task3G Job Monitor ===
The ‘task3G monitor’ console is where all job scheduling and control is accomplished. The ‘task3G monitor’ console is where all job scheduling and control is accomplished.
-The monitor window contains a list of all available jobs. The jobs are displayed in+The monitor window contains a list of all available jobs. The jobs are displayed in alphabetical order. When a job is running it is moved to the top of the window with all its running tasks and tasks in assist appearing under it.
-alphabetical order. When a job is running it is moved to the top of the window with+
-all its running tasks and tasks in assist appearing under it.+
-Select Task from the COSMmanager button bar to display the job console.+Select {{cnav|Task}} from the COSmanager button bar to display the job console.
- Figure 17 — task3G Job console+[[Image:Task img 21.jpg|none|frame|upright|Figure 18 — task3G Job console.]]
<br> <br>
 +
=== Job State === === Job State ===
At any time a job or task is in a particular state. The following is a table of all states: At any time a job or task is in a particular state. The following is a table of all states:
-State (COLOR) Explanation+{| border="0" cellpadding="6" cellspacing="0"
-Assist (RED) The job is waiting for operator assistance after an unexpected+! align="left" width="160" style="border-bottom:1px solid grey;border-right:1px solid grey;" | State (COLOR)
-event (error, task killed, task timed out etc.).+! align="left" width="560" style="border-bottom:1px solid grey;" | Explanation
-Automatic (GREY) The job is scheduled automatically by task3G, but its not currently+|-
-running. The operator should normally not manually+| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="red"> Assist (RED)
-submit this job.+| style="border-bottom:1px solid grey;" | The job is waiting for operator assistance after an unexpected event (error, task killed, task timed out etc.).
-Disabled (GREY) The job cannot be submitted, or will not start until it is enabled.+|-
-End (GREEN OR RED) The job or task has finished, and the job status exits (i.e. has not+| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="grey"> Automatic (GREY)
-cleared)+| style="border-bottom:1px solid grey;" | The job is scheduled automatically by task3G, but its not currently running. The operator should normally not manually submit this job.
-Held (ORANGE) The job or task is suspended. If a job is on hold, no new tasks+|-
-will be run until it is released, but any running task will continue.+| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="grey"> Disabled (GREY)
-Queued (BLACK) The job has been submitted by the operator, but has not yet+| style="border-bottom:1px solid grey;" | The job cannot be submitted, or will not start until it is enabled.
-started.+|-
-Running (BLACK BOLD) The job or task is running.+| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="green"> End (GREEN)
-Waiting (BLACK BOLD) The job is waiting for its wait condition to be satisfied.+| style="border-bottom:1px solid grey;" | The job or task has finished successfully, and the job status exists (i.e. has not cleared)
 +|-
 +| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="red"> End (RED)
 +| style="border-bottom:1px solid grey;" | The job or task has finished where an issue an issue has occurred, and the job status exists (i.e. has not cleared)
 +|-
 +| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | <font color="orange"> Held (ORANGE)
 +| style="border-bottom:1px solid grey;" | The job or task is suspended. If a job is on hold, no new tasks will be run until it is released, but any running task will continue.
 +|-
 +| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | Queued (BLACK)
 +| style="border-bottom:1px solid grey;" | The job has been submitted by the operator, but has not yet started.
 +|-
 +| valign="top" style="border-bottom:1px solid grey;border-right:1px solid grey;" | '''Running (BLACK BOLD)'''
 +| style="border-bottom:1px solid grey;" | The job or task is running.
 +|-
 +| valign="top" style="border-right:1px solid grey;" | '''Waiting (BLACK BOLD)'''
 +| The job is waiting for its wait condition to be satisfied.
 +|}
Line 51: Line 78:
;Log files: This menu items deal with log files and audit trails. ;Log files: This menu items deal with log files and audit trails.
;View: This menu deals with manipulating the view of the monitor window. ;View: This menu deals with manipulating the view of the monitor window.
 +
The following is an explanation of each Job menu item: The following is an explanation of each Job menu item:
- +{{note| Each of the following items will only be active if a job is selected. This is achieved by clicking the left mouse button on a job.}}
- +
-----+
-;Note: Each of the following items will only be active if a job is selected. This is achieved by clicking the left mouse button on a job.+
-----+
<br> <br>
 +
== How to Manage Jobs == == How to Manage Jobs ==
=== Monitoring Jobs/Tasks === === Monitoring Jobs/Tasks ===
-Select Jobs > Monitor. This item, when selected, opens a job monitor window+Select {{cnav|Jobs > Monitor}}. This item, when selected, opens a job monitor window monitoring the logfile of the chosen task or job.
-monitoring the logfile of the chosen task or job.+
- +
-To monitor, you must first select a single job or task. The selection must either be a+
-job or task that is currently running or has completed and whose status has not been+
-cleared. After selecting a job or task, select monitor from the 'Jobs' menu.+
- +
- +
-----+
-;Note: Double-Clicking on a job or task will also open the monitor window.+
-----+
 +To monitor, you must first select a single job or task. The selection must either be a job or task that is currently running or has completed and whose status has not been cleared. After selecting a job or task, select monitor from the {{cnav|Jobs}} menu.
 +{{note| Double-Clicking on a job or task will also open the monitor window.}}
Depending on which has been chosen, there will be different information. Depending on which has been chosen, there will be different information.
- +<br>
-'''Information shown if a job is chosen for monitoring:'''+==== Information shown if a job is chosen for monitoring ====
*Start time of the job. *Start time of the job.
Line 90: Line 107:
*End time and status of the job. *End time and status of the job.
- +<br>
-'''Information shown if a task is chosen for monitoring:'''+==== Information shown if a task is chosen for monitoring ====
*Start time of the task. *Start time of the task.
Line 98: Line 115:
<br> <br>
 +
=== Assist Mode === === Assist Mode ===
-Assist mode occurs when a task fails and the recovery action is specified as+Assist mode occurs when a task fails and the recovery action is specified as Assist. To enter assist mode, highlight the task requesting assistance and select {{cnav|Jobs > Assist}}.
-Assist. To enter assist mode, highlight the task requesting assistance and select+
-Jobs > Assist.+
The assist can occur from four circumstances: The assist can occur from four circumstances:
Line 110: Line 126:
*The task times-out *The task times-out
 +<br>
 +==== Pre-Condition Error Assist ====
-'''Pre-Condition Error Assist'''+The operator will the be presented with a dialog box containing 3 buttons. The buttons are:
 +:;''Skip'': This option skips the main command and post-processing and executes the dependencies. The task will end in error.
 +:;''Run'': Ignore the error and execute the main command and any postprocessing. The task’s status will depend on the main command and post-processing.
 +:;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.
-The operator will the be presented with a dialog box containing 3 buttons. The buttons+<br>
-are:+==== Main Command and Post-Processing Error Assist ====
-;''Skip'': This option skips the main command and post-processing and executes the dependencies. The task will end in error.+
-;''Run'': Ignore the error and execute the main command and any postprocessing. The task’s status will depend on the main command and post-processing.+
-;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.+
 +:;''Continue'': This option will end the task with an error status and continue to run all dependencies.
 +:;''Re-Run'': This option will run the main command and post-processing again.
 +:;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.
-'''Main Command and Post-Processing Error Assist'''+<br>
 +==== Job Kill Assist ====
-;''Continue'': This option will end the task with an error status and continue to run all dependencies.+:;''Continue'': This option will end the task with an error status and continue to run all dependencies.
-;''Re-Run'': This option will run the main command and post-processing again.+:;''Re-Run'': This option will start the main command again.
-;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.+:;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.
- +
- +
-'''Job Kill Assist'''+
- +
-;''Continue'': This option will end the task with an error status and continue to run all dependencies.+
-;''Re-Run'': This option will start the main command again.+
-;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.+
 +<br>
 +==== Timeout Assist ====
-'''Timeout Assist'''+:;''Continue'': This option will end the task with an error status and continue to run all dependencies.
- +:;''Re-Run'': This option will start the main command again.
-;''Continue'': This option will end the task with an error status and continue to run all dependencies.+:;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.
-;''Re-Run'': This option will start the main command again.+
-;''Stop'': This will stop the task and NOT run any of the dependencies. The task will end in error.+
<br> <br>
 +
=== Killing Jobs === === Killing Jobs ===
-A job that is running or queued or a task that is running can be killed from the job+A job that is running or queued or a task that is running can be killed from the job console. This is achieved by selecting a job or task and selecting {{cnav|Jobs > Cancel}}.
-console. This is achieved by selecting a job or task and selecting Jobs > Cancel.+
<br> <br>
 +
=== Holding Jobs === === Holding Jobs ===
-Holding a job or task suspends it until it is released. A task can only be held when it+Holding a job or task suspends it until it is released. A task can only be held when it is running. A job can be held at any time except if it is disabled. If the job is running, holding the job without holding its tasks is possible, and will prevent more tasks
-is running. A job can be held at any time except if it is disabled. If the job is running,+from being started. To hold a job or task, select the job or task and then select {{cnav|Jobs > Hold}}.
-holding the job without holding its tasks is possible, and will prevent more tasks+
-from being started. To hold a job or task, select the job or task and then select Jobs > Hold.+
-To release a job from a held state, select the held job and the select Jobs > Release.+To release a job from a held state, select the held job and the select {{cnav|Jobs > Release}}.
<br> <br>
 +
=== Disabling Jobs === === Disabling Jobs ===
-A job can be disabled when inactive. When a manual job is disabled, it cannot be+A job can be disabled when inactive. When a manual job is disabled, it cannot be submitted. When an automatic job is disabled, it will not run. Disabling a job is achieved by selecting the job and then selecting {{cnav|Jobs > Disable}}.
-submitted. When an automatic job is disabled, it will not run. Disabling a job is+
-achieved by selecting the job and then selecting Jobs > Disable.+
-To enable a job, select the disabled job and then select Job > Enable.+To enable a job, select the disabled job and then select {{cnav|Job > Enable}}.
<br> <br>
 +
=== Job Report === === Job Report ===
-A job report is available detailing its tasks, settings and details. By highlighting a job+A job report is available detailing its tasks, settings and details. By highlighting a job and selecting {{cnav|Jobs > Job report}}, the report will be displayed.
-and selecting Jobs > Job report, the report will be displayed.+
<br> <br>
 +
=== Show Notes on a Job === === Show Notes on a Job ===
-A notes file can be attached to a job or task showing additional information. By+A notes file can be attached to a job or task showing additional information. By highlighting a job or task and selecting {{cnav|Jobs > Show notes}}, the notes file will be displayed.
-highlighting a job or task and selecting Jobs > Show notes, the notes file will+
-be displayed.+
<br> <br>
 +
=== Tasks in Job === === Tasks in Job ===
-The Tasks in Job console can be accessed from the task3G Monitor. To achieve this,+The Tasks in Job console can be accessed from the task3G Monitor. To achieve this, select the job and then select {{cnav|Jobs > Show tasks}}.
-select the job and then select Jobs > Show Tasks.+
<br> <br>
 +
== How to Submit Jobs == == How to Submit Jobs ==
=== Schedule === === Schedule ===
-Scheduling a job is submitting it to run at a certain time in the future. This is+Scheduling a job is submitting it to run at a certain time in the future. This is achieved by first selecting the job and then selecting {{cnav|Submit > Schedule}}. If the job selected has scheduling information configured, it will be used. Otherwise a form will be presented asking the operator for scheduling details.
-achieved by first selecting the job and then selecting Submit > Schedule. If the+{{note| Automatic jobs can be scheduled but it is not advisable as it can clash with its automatic submission.}}
-job selected has scheduling information configured, it will be used. Otherwise a+
-form will be presented asking the operator for scheduling details.+
 +[[Image:Task img 22.jpg|none|frame|upright|Figure 19 — Schedule job parameters.]]
-----+The fields correspond to the fields found on the Job definition form. For more information, see How to Define a Job on page 28.
-;Note: Automatic jobs can be scheduled but it is not advisable as it can clash with its automatic submission.+
-----+
 +<br>
- Figure 18 — Schedule job parameters+=== Run Now ===
-The fields correspond to the fields found on the Job definition form. For more+Any jobs can be submitted to run immediately (background mode). This is achieved by selecting the job and then selecting {{cnav|Submit > Run now}}.
-information, see How to Define a Job on page 28.+{{note| Automatic jobs can be submitted to run immediately but it is not advisable as it can clash with its automatic submission.}}
<br> <br>
-=== Run Now === 
-Any jobs can be submitted to run immediately (background mode). This is achieved+=== New Settings for a Job ===
-by selecting the job and then selecting Submit > Run now.+ 
-70 Submitting and Managing Jobs+Jobs can be scheduled to run at a different time or in a different queue than their default configuration. This is achieved by first selecting the job and then selecting {{cnav|Submit > New settings}}. A prompt form will be presented asking the operator for scheduling details. All jobs, including scheduled jobs will be rescheduled.
-Note Automatic jobs can be submitted to run immediately but it is not+{{note| Automatic jobs can be scheduled but it is not advisable as it can clash with its automatic submission.}}
-advisable as it can clash with its automatic submission.+ 
-New Settings for a Job+[[Image:Task img 23.jpg|none|frame|upright|Figure 20 — New job schedule parameters.]]
-Jobs can be scheduled to run at a different time or in a different queue than their+ 
-default configuration. This is achieved by first selecting the job and then selecting+
-Submit > New settings. A prompt form will be presented asking the operator+
-for scheduling details. All jobs, including scheduled jobs will be rescheduled.+
-Note Automatic jobs can be scheduled but it is not advisable as it can clash+
-with its automatic submission.+
-Figure 19 — New job schedule parameters+
For more information about each field, see How to Define a Job on page 28. For more information about each field, see How to Define a Job on page 28.
-Clear Status of a Job+ 
-Selecting Submit > Clear status manually clear a job’s status of the highlighted+<br>
-job.+ 
-Submitting and Managing Jobs 71+=== Clear Status of a Job ===
-How to View and Manage Job Logfiles+ 
-Display Logfile of a Job+Selecting {{cnav|Submit > Clear status}} manually clears a job’s status of the highlighted job.
-To view a logfile of a particular job or task, highlight it and select Logfiles >+ 
-Display.+<br>
-Manage Logfiles+ 
-To manage and view all logfiles, select Logfiles > Manage. A list will be displayed+== How to View and Manage Job Logfiles ==
-showing logfiles of all jobs run. From here you can view and/or remove particular+ 
-logfiles. The following is a list of all the menu items available and their+=== Display Logfile of a Job ===
 + 
 +To view a logfile of a particular job or task, highlight it and select {{cnav|Logfiles > Display}}.
 + 
 +<br>
 + 
 +=== Manage Logfiles ===
 + 
 +To manage and view all logfiles, select {{cnav|Logfiles > Manage{{cnav|. A list will be displayed showing logfiles of all jobs run. From here you can view and/or remove particular logfiles. The following is a list of all the menu items available and their
functions. functions.
-Note The same job may have many logfiles depending on how many times+{{note| The same job may have many logfiles depending on how many times it has been run.}}
-it has been run.+ 
-Manage > Display+ 
-By highlighting a job/task and selecting the Display menu+;{{cnav|Manage > Display}}: By highlighting a job/task and selecting the Display menu item, the selected job’s or task’s logfile is displayed.
-item, the selected job’s or task’s logfile is displayed.+;{{cnav|Manage > Remove}}: By highlighting a job/task and selecting the Remove menu item, the selected job’s or task’s logfile is removed.
-Manage > Remove+;{{cnav|View > All jobs}}: By selecting All jobs menu item, the list of all the job logfiles is shown.
-By highlighting a job/task and selecting the Remove menu item,+;{{cnav|View > Same job}}: By highlighting a job and selecting the Same job menu item, a list of all the job logfiles of the selected job is shown.
-the selected job’s or task’s logfile is removed.+;{{cnav|View > Details}}: By highlighting a job and selecting the Details menu item, a list of logfiles for the jobs and its tasks are shown.
-View > All jobs+;{{cnav|View > Refresh}}: Updates the list of job/task logfiles displayed.
-By selecting All jobs menu item, the list of all the job logfiles+ 
-is shown.+<br>
-View > Same job+ 
-By highlighting a job and selecting the Same job menu item, a+=== Audit trail ===
-list of all the job logfiles of the selected job is shown.+ 
-View > Details+To display the audit trail that logs all of task3G's activities, select {{cnav|Logfiles > Audit trail}}. You will be presented with a list showing the current and archived versions of the audit trail. For audit trail cycling see COSmanager User Guide.
-By highlighting a job and selecting the Details menu item, a list+ 
-of logfiles for the jobs and its tasks are shown.+<br>
-View > Refresh+ 
-Updates the list of job/task logfiles displayed.+=== Add comment to an Audit trail ===
-72 Submitting and Managing Jobs+ 
-Audit trail+Operators have the ability to add comments to the Audit trail. This is achieved by selecting {{cnav|Logfiles > Add comment{{cnav|.
-To display the audit trail that logs all of task3G's activities, select Logfiles >+ 
-Audit trail. You will be presented with a list showing the current and archived+<br>
-versions of the audit trail. For audit trail cycling see COSMmanager User Guide.+ 
-Add comment to an Audit trail+=== Monitor Views ===
-Operators have the ability to add comments to the Audit trail. This is achieved by+ 
-selecting Logfiles > Add comment.+The monitor window can be filtered to show certain information. This filtering is achieved via the View menu. The following is a list of views:
-Monitor Views+ 
-The monitor window can be filtered to show certain information. This filtering is+;{{cnav|View > Normal}}: The default view of the monitor window. Shows all accessible jobs and active tasks.
-achieved via the View menu. The following is a list of views:+;{{cnav|View > All}}: This view shows all accessible jobs and all their tasks. The tasks appear under their job.
-View > Normal+;{{cnav|View > Active}}: This view shows all jobs and tasks that are active. These are jobs that are queued or running.
-The default view of the monitor window. Shows all accessible+;{{cnav|View > Running}}: This view shows running jobs only.
-jobs and active tasks.+;{{cnav|View > Inactive}}: This view shows all inactive jobs only.
-View > All+;{{cnav|View > Assistance}}: This view shows all tasks that require assistance.
-This view shows all accessible jobs and all their tasks. The tasks+;{{cnav|View > Held}}: This view shows jobs and tasks that are held.
-appear under their job.+;{{cnav|View > For role}}: This view shows jobs accessible by a selected role. The role is chosen from a list of accessible roles.
-View > Active+;{{cnav|View > Job details}}: By highlighting a job and selecting the Job details menu item, this shows the selected job and all its tasks is shown.
-This view shows all jobs and tasks that are active. These are jobs+ 
-that are queued or running.+<br>
-View > Running+
-This view shows running jobs only.+
-View > Inactive+
-This view shows all inactive jobs only.+
-View > Assistance+
-This view shows all tasks that require assistance.+
-View > Held+
-This view shows jobs and tasks that are held.+
-View > For role+
-This view shows jobs accessible by a selected role. The role is+
-Submitting and Managing Jobs 73+
-chosen from a list of accessible roles.+
-View > Job details+
-By highlighting a job and selecting the Job details menu item, this+
-shows the selected job and all its tasks is shown.+
-74 Submitting and Managing Jobs+

Current revision

Contents

Job submissions are performed via the task3G Job console. From this console you can:











Task3G Job Monitor

The ‘task3G monitor’ console is where all job scheduling and control is accomplished.

The monitor window contains a list of all available jobs. The jobs are displayed in alphabetical order. When a job is running it is moved to the top of the window with all its running tasks and tasks in assist appearing under it.

Select Task from the COSmanager button bar to display the job console.

Figure 18 — task3G Job console.
Figure 18 — task3G Job console.


Job State

At any time a job or task is in a particular state. The following is a table of all states:

State (COLOR) Explanation
Assist (RED) The job is waiting for operator assistance after an unexpected event (error, task killed, task timed out etc.).
Automatic (GREY) The job is scheduled automatically by task3G, but its not currently running. The operator should normally not manually submit this job.
Disabled (GREY) The job cannot be submitted, or will not start until it is enabled.
End (GREEN) The job or task has finished successfully, and the job status exists (i.e. has not cleared)
End (RED) The job or task has finished where an issue an issue has occurred, and the job status exists (i.e. has not cleared)
Held (ORANGE) The job or task is suspended. If a job is on hold, no new tasks will be run until it is released, but any running task will continue.
Queued (BLACK) The job has been submitted by the operator, but has not yet started.
Running (BLACK BOLD) The job or task is running.
Waiting (BLACK BOLD) The job is waiting for its wait condition to be satisfied.


The following is a list of the menus and an explanation of each.

Jobs
This menu deals with the control of jobs and tasks.
Submit
This menu deals with the scheduling and running of jobs.
Log files
This menu items deal with log files and audit trails.
View
This menu deals with manipulating the view of the monitor window.


The following is an explanation of each Job menu item:

Note
Note
Each of the following items will only be active if a job is selected. This is achieved by clicking the left mouse button on a job.


How to Manage Jobs

Monitoring Jobs/Tasks

Select Jobs > Monitor . This item, when selected, opens a job monitor window monitoring the logfile of the chosen task or job.

To monitor, you must first select a single job or task. The selection must either be a job or task that is currently running or has completed and whose status has not been cleared. After selecting a job or task, select monitor from the Jobs menu.

Note
Note
Double-Clicking on a job or task will also open the monitor window.

Depending on which has been chosen, there will be different information.


Information shown if a job is chosen for monitoring


Information shown if a task is chosen for monitoring


Assist Mode

Assist mode occurs when a task fails and the recovery action is specified as Assist. To enter assist mode, highlight the task requesting assistance and select Jobs > Assist .

The assist can occur from four circumstances:


Pre-Condition Error Assist

The operator will the be presented with a dialog box containing 3 buttons. The buttons are:

Skip
This option skips the main command and post-processing and executes the dependencies. The task will end in error.
Run
Ignore the error and execute the main command and any postprocessing. The task’s status will depend on the main command and post-processing.
Stop
This will stop the task and NOT run any of the dependencies. The task will end in error.


Main Command and Post-Processing Error Assist

Continue
This option will end the task with an error status and continue to run all dependencies.
Re-Run
This option will run the main command and post-processing again.
Stop
This will stop the task and NOT run any of the dependencies. The task will end in error.


Job Kill Assist

Continue
This option will end the task with an error status and continue to run all dependencies.
Re-Run
This option will start the main command again.
Stop
This will stop the task and NOT run any of the dependencies. The task will end in error.


Timeout Assist

Continue
This option will end the task with an error status and continue to run all dependencies.
Re-Run
This option will start the main command again.
Stop
This will stop the task and NOT run any of the dependencies. The task will end in error.


Killing Jobs

A job that is running or queued or a task that is running can be killed from the job console. This is achieved by selecting a job or task and selecting Jobs > Cancel .


Holding Jobs

Holding a job or task suspends it until it is released. A task can only be held when it is running. A job can be held at any time except if it is disabled. If the job is running, holding the job without holding its tasks is possible, and will prevent more tasks from being started. To hold a job or task, select the job or task and then select Jobs > Hold .

To release a job from a held state, select the held job and the select Jobs > Release .


Disabling Jobs

A job can be disabled when inactive. When a manual job is disabled, it cannot be submitted. When an automatic job is disabled, it will not run. Disabling a job is achieved by selecting the job and then selecting Jobs > Disable .

To enable a job, select the disabled job and then select Job > Enable .


Job Report

A job report is available detailing its tasks, settings and details. By highlighting a job and selecting Jobs > Job report , the report will be displayed.


Show Notes on a Job

A notes file can be attached to a job or task showing additional information. By highlighting a job or task and selecting Jobs > Show notes , the notes file will be displayed.


Tasks in Job

The Tasks in Job console can be accessed from the task3G Monitor. To achieve this, select the job and then select Jobs > Show tasks .


How to Submit Jobs

Schedule

Scheduling a job is submitting it to run at a certain time in the future. This is achieved by first selecting the job and then selecting Submit > Schedule . If the job selected has scheduling information configured, it will be used. Otherwise a form will be presented asking the operator for scheduling details.

Note
Note
Automatic jobs can be scheduled but it is not advisable as it can clash with its automatic submission.
Figure 19 — Schedule job parameters.
Figure 19 — Schedule job parameters.

The fields correspond to the fields found on the Job definition form. For more information, see How to Define a Job on page 28.


Run Now

Any jobs can be submitted to run immediately (background mode). This is achieved by selecting the job and then selecting Submit > Run now .

Note
Note
Automatic jobs can be submitted to run immediately but it is not advisable as it can clash with its automatic submission.


New Settings for a Job

Jobs can be scheduled to run at a different time or in a different queue than their default configuration. This is achieved by first selecting the job and then selecting Submit > New settings . A prompt form will be presented asking the operator for scheduling details. All jobs, including scheduled jobs will be rescheduled.

Note
Note
Automatic jobs can be scheduled but it is not advisable as it can clash with its automatic submission.
Figure 20 — New job schedule parameters.
Figure 20 — New job schedule parameters.

For more information about each field, see How to Define a Job on page 28.


Clear Status of a Job

Selecting Submit > Clear status manually clears a job’s status of the highlighted job.


How to View and Manage Job Logfiles

Display Logfile of a Job

To view a logfile of a particular job or task, highlight it and select Logfiles > Display .


Manage Logfiles

To manage and view all logfiles, select {{cnav|Logfiles > Manage{{cnav|. A list will be displayed showing logfiles of all jobs run. From here you can view and/or remove particular logfiles. The following is a list of all the menu items available and their functions.

Note
Note
The same job may have many logfiles depending on how many times it has been run.


Manage > Display
By highlighting a job/task and selecting the Display menu item, the selected job’s or task’s logfile is displayed.
Manage > Remove
By highlighting a job/task and selecting the Remove menu item, the selected job’s or task’s logfile is removed.
View > All jobs
By selecting All jobs menu item, the list of all the job logfiles is shown.
View > Same job
By highlighting a job and selecting the Same job menu item, a list of all the job logfiles of the selected job is shown.
View > Details
By highlighting a job and selecting the Details menu item, a list of logfiles for the jobs and its tasks are shown.
View > Refresh
Updates the list of job/task logfiles displayed.


Audit trail

To display the audit trail that logs all of task3G's activities, select Logfiles > Audit trail . You will be presented with a list showing the current and archived versions of the audit trail. For audit trail cycling see COSmanager User Guide.


Add comment to an Audit trail

Operators have the ability to add comments to the Audit trail. This is achieved by selecting {{cnav|Logfiles > Add comment{{cnav|.


Monitor Views

The monitor window can be filtered to show certain information. This filtering is achieved via the View menu. The following is a list of views:

View > Normal
The default view of the monitor window. Shows all accessible jobs and active tasks.
View > All
This view shows all accessible jobs and all their tasks. The tasks appear under their job.
View > Active
This view shows all jobs and tasks that are active. These are jobs that are queued or running.
View > Running
This view shows running jobs only.
View > Inactive
This view shows all inactive jobs only.
View > Assistance
This view shows all tasks that require assistance.
View > Held
This view shows jobs and tasks that are held.
View > For role
This view shows jobs accessible by a selected role. The role is chosen from a list of accessible roles.
View > Job details
By highlighting a job and selecting the Job details menu item, this shows the selected job and all its tasks is shown.