Show TOC

Procedure documentationControlling Global and Partition Restart Behavior Locate this document in the navigation structure

 

Restart behavior is used to react to the final job status of the job, see Restart Behavior for information on restart behavior. These settings can be specified globally and for a particular partition by creating special job definitions.

The job definition for the system-wide settings is named System_Defaults_System and resides in the GLOBAL partition.

The job definition for the partition-level settings is named System_Defaults_Partition and resides in the partition for which you want to specify the restart behavior.

The only properties that can be set on these special job definitions are:

  • Description - can only be set at creation-time in the ui.

  • Comment - can only be set at creation-time in the ui.

  • Restart Behavior

  • Object-level security

Recommendation Recommendation

The easiest way to create these special job definitions is to create a job chain with the appriate name, it will be changed into a System job definition as soon as you save it.

End of the recommendation.

Note Note

These job definitions are special and you cannot submit them or modify any other properties. Their sole purpose is to allow you to specify restart behavior settings at various levels.

End of the note.

Procedure

Creating system-wide restart behavior settings:

  1. Navigate to   Definitions → Job Chains  

  2. Choose Create from the context menu

  3. On the Job Definition tab, fill System_Defaults_System into the Name field. Make sure the Partition field is set to GLOBAL.

  4. On the Restart Behavior tab, select your desired restart settings.

  5. Choose Save & Close.

Creating partition-level restart behavior settings:

  1. Navigate to   Definitions → Job Chains  

  2. Choose Create from the context menu

  3. On the Job Definition tab, fill System_Defaults_Partition into the Name field. Make sure the Partition field is set to the appropriate partition.

  4. On the Restart Behavior tab, select your desired restart settings.

  5. Choose Save & Close.

Example

You want killed jobs in the Finance partition to be restartable on request:

  1. Navigate to   Definitions → Job Chains  

  2. Choose Create from the context menu

  3. On the Job Definition tab, fill System_Defaults_Partition into the Name field. Make sure the Partition field is set to Finance.

  4. On the Restart Behavior tab, select Request Restart for the On Killed property.

  5. Choose Save & Close.

You forgot to set the description at creation-time or would like to change the description of the job definition System_Defaults_System.

Navigate to   Scripting → Shell   and use the following code:

{

//Get the job definition

JobDefinition jobdef=jcsSession.getJobDefinitionByName("System_Defaults_System");

//Set the description

jobdef.setDescription("System-wide Restart Behavior");

jcsSession.persist();

}

You forgot to set the description at creation-time or would like to change the description of the job definition System_Defaults_Partition in the Finance partition:

Navigate to   Scripting → Shell   and use the following code:

{

//Get the partition and job definition

Partition mypart = jcsSession.getPartitionByName("Finance");

JobDefinition jobdef=jcsSession.getJobDefinitionByName(mypart, "System_Defaults_Partition");

//Set the description

jobdef.setDescription("Restart Behavior for the Finance partition");

jcsSession.persist();

}