From Documentation

Revision as of 07:40, 19 April 2006

Appendix A—Installing task3G

This section describes how to install task3G for your environment. Task3G is installed through the COSMmanager configuration menu.

See Installing COSmanager Applications in the COSmanager User Guide for full details.

What you need

1. the COSmanager framework installed on the target platform
2. a CDrom containing the task3G software
3. a valid license key
4. you must be a COSmanager user with the Manager role

Installing task3G

1. Load the CDrom in a CD drive on the local host or a network CD drive.
2. Mount the CDrom using the appropriate mount command for your operating system (listed on the inside of the CD jacket).
3. From the Product configuration menu, select COSmanager configuration > COSmanager applications.
4. Select Application > Install.
5. Enter the name of the host to which the CD drive is attached. In Install from, enter the file name containing the product distribution. Press Accept.
6. You will see the application contained in the distribution file. Choose the row titled task3G version 4.1.
7. Enter the name of the directory where you want task3G to be installed and press Accept.

COSmanager copies the task3G files from the CD distribution file to the target directory and creates the task3G audit trail.

Figure 20 — Installed COSmanager products

Appendix B—Job Recovery Action Outcomes

The following diagrams contained in this appendix illustrate the actions for each type of job recovery.

Figure 21 — Pre-condition and error recovery

In figure 21, the flow of the pre-condition and error job recoveries are illustrated. One thing to keep in mind is that depending which override status is selected (this is configured in when defining a job, see How to Define a Task on page 36.) will depend on what status the task will end in if an On-error command is defined.

Figure 22 — Kill job and timeout recovery

Figure 22 illustrates the kill and timeout job recovery actions.

Appendix C—Tutorial

The following diagram represents the relationships between the jobs and tasks that will be created and run.

Figure 23 — Job content and task relationship representation.

Entering Configuration

To start COSMmanager either:

1. Login as a COSMmanager 'Manager' and run 'cos'

OR

1. Login as 'root'
   1. ksh
   2. cd ~cosmos
   3. bin/cos -u cosmos

1. Click on the Config button from the COSMmanager menubar.
2. From the Product Configuration menu select task3G Configuration. You will now be presented with the task3G jobs console. This is where all configuration is done.

Tutorial 1: Creating a Queue

1. To configure a queue, select Tables > Queues. At this point you will be presented with the Job queue details console which contains a list of all currently defined queues. It's from here where you can Add, Change, Clone or Delete queues.
2. Select Maintain > Add to create a queue.
3. Enter the following for each relevant field:

Note For more information, see How to Define a Job Queue on page 54.

1. When done, press Accept. There should now be an acknowledged that the QUEDEFS has been updated and an addition of the item D_queue was successful. The queue should now appear on the Job queue details console.

You have successfully created a queue. Field Data Queue D_queue Description D queue - tutorial Unix queue d Concurrent jobs 2 Rescheduled time 60 Priority 2

Tutorial 2: Creating a Job

At this point you will be presented with the task3G jobs console which contains a list of currently defined jobs and subjobs. It's from here where you can Add, Change, Clone or Delete jobs Repeat these steps for each of the following jobs.

1. Select Maintain > Add to create a job.
2. Enter the following for each relevant field:

Field Job1 Job2 Job job1 job2 Description Job1 - tutorial Job2 - tutorial Mode manual manual When N/A N/A At time(s) On (day) N/A N/A Access role Other Other Run on host Queue D-queue AT_queue Fixed parameters Prompt form At-submit command Wait condition Timeout (mins) Pre-condition On failure N/A N/A At-end command Clear status submit submit Appendix C—Tutorial 85 Note For more information, see How to Define a Job on page 28.

1. When done press Accept.

The jobs should now appear on the task3G jobs console. You have successfully created the jobs. Concurrent jobs Priority Notes Field Job1 Job2

Tutorial 3: Creating a Subjob

At this point you will be presented with the task3G jobs console which contains a list of currently defined jobs and subjobs. It's from here where you can Add, Change, Clone or Delete subjobs.

1. Select Maintain > Add to create a job.
2. Enter the following for each relevant field:

Field Subjob1 Job subjob1 Description Subjob1 - tutorial Mode subjob When N/A At time(s) N/A On (day) N/A Access role N/A Run on host Queue N/A Fixed parameters N/A Prompt form At-submit command N/A Wait condition Timeout (mins) N/A Pre-condition On failure N/A At-end command Clear status N/A Note For more information, see How to Define a Job on page 28.

1. When done press Accept.

The subjob should now appear on the task3G jobs console. You have successfully created a subjob. Concurrent jobs N/A Priority N/A Notes Field Subjob1

Tutorial 4: Creating a Task

To configure a task, select Tables > Tasks. At this point you will be presented with the Tasks console which contains a list of currently defined tasks. Its from here where you can Add, Change, Clone or Delete tasks.

Repeat these steps for each of the following jobs.

1. Select Maintain > Add to create a task.
2. Enter the following for each relevant field:

Field Task1 Task2 Task3 Task4 Task name task1 task2 task3 task4 Command sleep 5 sleep 5; exit 1 sleep 5; exit 1 sleep 5; exit 1 Run on host As user Subjob N/A N/A N/A N/A Comment Task1 - tutorial Task2 - tutorial Task3 - tutorial Task4 - tutorial Pre-condition On-success cmd On-error cmd Override status N/A no N/A N/A Timeout (mins) On-error assist assist continue assist On pre-cond fail N/A N/A N/A N/A On kill assist assist assist assist On timeout N/A N/A N/A N/A Can re-run yes no yes yes Can continue yes yes yes yes Can kill yes no yes yes Appendix C—Tutorial 89 Note: For more information, see How to Define a Task on page 36.

1. When done press Accept.

Notes Field Task5 Task6 Task7 Task8 Task name task5 task6 task7 task8 Command sleep 5 sleep 5; exit 1 sleep 5 N/A Run on host N/A As user N/A Subjob N/A N/A N/A subjob1 Comment Task5 - tutorial Task6 - tutorial Task7 - tutorial Subjob - tutorial Pre-condition On-success cmd On-error cmd Override status N/A N/A N/A N/A Timeout (mins) On-error assist ignore assist assist On pre-cond fail N/A N/A N/A N/A On kill assist assist assist assist On timeout N/A N/A N/A N/A Can re-run yes no yes yes Can continue yes yes yes yes Can kill yes no yes yes Notes Field Task1 Task2 Task3 Task4

The tasks should now appear on the Tasks console. You have successfully created the tasks.

Tutorial 5: Adding Tasks to a Job and Creating Dependencies

1. Highlight job1 and select Maintain > Task in job . At this point you will be presented with the Tasks in job console which contains a list of all tasks in the selected job, being job1 in this case. It's from here where you can add tasks to a job and create dependencies.
2. Select Maintain > Add to add the tasks. A list of all tasks will be presented. Select all the tasks needed for job1. These are: task1, task2, task3, task4, task5, task6 and task7.
3. When done press Accept. All the tasks now should appear in the Tasks in job console. In the current configuration all the tasks will run in parallel. Looking at the task relationships within job1 from the diagram presented at the start of this appendix, task1, task2 and task3 are not dependent on any other task and will run in parallel. All other tasks are dependent on another task.

The following steps create the dependencies for task4.

1. Highlight task4.
2. Select Dependencies > Cut.
3. Highlight task1.
4. Select Dependencies > Paste. Task4 should now appear with indentation under task1. This signifies that task4 is dependent on task1.
5. Highlight task4.
6. Select Dependencies > Link.
7. Highlight task2.
8. Select Dependencies > Paste. Task4 should now also appear with

indentation under task2. This signifies that task4 is dependent on task2. A task can only appear in a job once but dependent on multiple tasks. The first instance of a task in a job dependency structure is displayed normally, and all other instances (multiple dependencies) are represented by links.

The following steps create the dependencies for task5.

1. Highlight task5.
2. Select Dependencies > Cut.
3. Highlight task3.
4. Select Dependencies > Paste.

The following steps create the dependencies for task6.

1. Highlight task6.
2. Select Dependencies > Cut.
3. Highlight task4.
4. Select Dependencies > Paste.

The following steps create the dependencies for task7.

1. Highlight task7.
2. Select Dependencies > Cut.
3. Highlight task4.
4. Select Dependencies > Paste.
5. Highlight task7.
6. Select Dependencies > Link.
7. Highlight task5.
8. Select Dependencies > Paste.

All the dependencies have now been created.

1. Select Dependencies > Optimise to check and correct any deadlocks.

Move onto the next job.

1. Select View > Another job.
2. Highlight job2
3. A list of all jobs will be presented. Select job1.
4. When done press Accept. At this point you will be presented with the Tasks in job console which contains a list of all tasks in the selected job, being job2 in this case.

It's from here where you can add tasks to a job and create dependencies.

1. Select Maintain > Add to add the tasks. A list of all tasks will be presented.
2. Select all the tasks needed for job2. These are: task1, task5 and task8.
3. When done press Accept. All the tasks now should appear in the Tasks in job console. In the current configuration all the tasks will run in parallel. Looking at the task relationships within job2 from the diagram presented at the start of this appendix, task1 is not dependent on any other task. All other tasks are dependent on another task.

The following steps create the dependencies.

1. Highlight all tasks.
2. Select Dependencies > Sequence.
3. Select task5 and holding down the left mouse button, drag task5 to the bottom of the list. The list should be in the following order: task1, task8, task5.
4. When done press Accept. A sequence of dependent tasks should now appear.

Configure the subjob.

1. Highlight task8.
2. Select View > Subjob. At this point you will be presented with the Tasks in job console which contains a list of all tasks in the selected subjob, being subjob1 in this case. It's from here where you can add tasks to a subjob and create dependencies.
3. Select Maintain > Add to add the tasks.
4. A list of all tasks will be presented. Select all the tasks needed for subjob1. These are: task1 and task5.
5. When done press Accept. All the tasks now should appear in the Tasks in job console. In the current configuration all the tasks will run in parallel. Looking at the task relationships within subjob1 from the diagram presented at the start of this appendix, task1 and task 5 are not dependent on any other task. Therefore no dependencies need to be configured.

You have successfully populated the jobs and created the dependencies. You have successfully populated the jobs and created the dependencies.

Tutorial 6: Creating Wait Conditions

1. Highlight job2 and select Maintain > Task in job . At this point you will be presented with the Tasks in job console which contains a list of all tasks in the selected job, being job2 in this case. It's from here where you can wait conditions.
2. Select job8.
3. Select Dependencies > Wait for.
4. Enter the following for each relevant field:
5. Press Check syntax to check the syntax of the wait condition.
6. When done press Accept. The wait condition has been created.

You have successfully created a queue. Field Wait condition Wait condition $job1:task7 Timeout (mins) On failure assist