Job Group (JOBG)

{"URL":["/*.*/awa/pa_view_JOBG"],"heroDescriptionIdentifier":"ice_job_groups_intro","customCards":[{"id":"ice_JOBG_defining","title":"Defining Job Groups","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_JobGroup.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

A Job Group is a container for other objects. It helps you manage the execution of the individual objects it contains. A Job Group can contain Events, Jobs, Scripts, Notifications, Schedules and Workflows. As a developer and object designer, you use Job Groups to assemble individual objects that you want to execute collectively, either simultaneously or one after another.

The objects included in a Job Group are flagged as belonging to a group. When you execute the group, it is displayed in the Process Monitoring perspective and its status is Active. The individual objects in the group are in Registered status first, and then Active as soon as they are executed.

When you execute objects that belong to a Job Group from outside that group, their status remains as Registered. They are not executed unless the group is started as well.

Exception: When the individual objects are started by a Workflow, Schedule or a Recurring Task (C_PERIOD), the Job Group setting in the object definition is ignored.

Job Groups do not have object-specific pages since they are mere containers for other objects. The only Job Group-specific parameter that you can set is whether you want the group to execute he objects simultaneously or not and, if so, how many. You do this in the Allow <x> Maximum number of simultaneous executions of jobs within the group field on its Attributes page, see Defining the Attributes Page.

You assign an object to a Job Group on the Attributes page of the object, see .

Object class: Executable object

Object type/Short form: JOBG

A Job Group definition is made up of the following pages:

Understanding the Execution Sequence of the Objects in the Group

On the Attributes page of the Job Group definition you specify whether you want the group to execute he objects simultaneously or not and, if so, how many. You do this in the Allow <x> Maximum number of simultaneous executions of jobs within the group field:

  • 1 is the default. It means that only one task can be started at a time, therefore the objects within the group start one after the other. The sequence in which the they are started is not controlled by the Job Group but by the Automation Engine priority specified for the individual objects on their Attributes page. For more information, see Automation Engine Priority when Executing Objects

    Tasks that are being executed within a group are flagged as C_HOSTG. This status is displayed in the Type column on the Process Monitoring perspective only as long as the task is being processed.

  • >1 means that more than one object can be executed at the same time

    Let's suppose that you have created a group to which you have assigned 10 objects. Selecting 8 here means that when you execute the group and it is in Active status, 8 tasks will be Active as well whereas 2 remain in Registered status. As soon as a task is finished, task number 9 changes to Active, and so on.

    The system decides which tasks is the next based on its AE priority and on the FIFO principle.

  • If you leave this field empty, there is no limit to the number of objects that will be executed simultaneously with this Job Group.

Next Steps

  • Execute the object.
    You can execute Job Group objects in the following ways:

    • Include Job Group objects in Schedules (JSCH) to execute them automatically at predefined times and/or intervals.

    • Insert Job Group objects in Workflows (see Workflows (JOBP)).

    • Manually execute, restart or stop Job Group objects. For more information, see Executing Events.

  • Monitor the Job Group.
    Immediately after executing the object you can start monitoring it. Right-click it to select Monitoring and open the pre-filtered list of tasks to display this one. For more information, see Show in Process Monitoring. In the Process Monitoring perspective you can then follow their progress and access the reports and statistical information associated to them. For more information, see Working with Tasks. The Job Group Monitor provides detailed information on the processing status of the individual jobs and access the functions available for them. For more information, see Monitoring Job Groups

See also: