Page History

...

SystemMonitorNotification / Notification / NotificationObjects / Job

Job supports the following attributes:

Attribute Usage Description

notifications

Optional

Integer

Specifies the number of notifications that are sent to a System Monitor.

Default: 1

scheduler_id

Optional

Notifications are restricted to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that log into the same database.

Regular expression can be used.

name

Optional

Job name including possible folder names.

Regular expression can be used.

Note: Monitoring Interface handle only the jobs used by a job chain, not the standalone jobs.

Jira

server	SOS JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602
key	JITL-353

return_code_from Optional Restricts notifications for jobs for a particular return code range.

Code Block

language	xml
title	Example
collapse	true

...
<Job notifications="2" name="test/my_job"/>
...
<Job scheduler_id="scheduler_4444" />
...
<Job scheduler_id="scheduler_4444" name="^(test/my_.*)" />
... 
<Job name="test/my_job" return_code_from="5"/> 
...  
<Job name="test/my_job" return_code_to="10"/>
...  
<Job name="test/my_job" return_code_from="5" return_code_to="5"/>  
...

...

SystemMonitorNotification / Notification / NotificationObjects / JobChain

JobChain supports the following attributes:

Attribute Usage Description

notifications

Optional

Integer

Specifies the number of notifications that are sent to a System Monitor.

Default: 1

scheduler_id

Optional

Notifications are restricted to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that log into the same database.

Regular expression can be used.

name

Optional

Job chain name including possible folder names.

Regular expression can be used.

Jira

server	SOS JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602
key	JITL-353

return_code_from Optional Restricts notifications for job chains for a particular return code range.

step_from Optional Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.

step_to Optional Restricts notifications for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.

excluded_steps Optional Specifies the steps which will be excluded from the analyzing (separated by semicolon)

Code Block

language	xml
title	Example
collapse	true

...
<JobChain notifications="2" name="test/my_jobchain"/>
...
<JobChain scheduler_id="scheduler_4444" />
...
<JobChain scheduler_id="scheduler_4444" name="^(test/my_.*)" />
... 
<JobChain name="test/my_jobchain" return_code_from="5"/> 
... 
<JobChain name="test/my_jobchain" return_code_to="10"/>
... 
<JobChain name="test/my_jobchain" return_code_from="5" return_code_to="5"/>  
...
<JobChain name="test/my_jobchain" step_from="200"/>
...
<JobChain name="test/my_jobchain" step_to="500"/>
...
<JobChain name="test/my_jobchain" step_from="300" step_to="300"/>
...
<JobChain name="test/my_jobchain" excluded_steps="200;300"/>
...

...

SystemMonitorNotification / Timer / TimerJobChain

TimerJobChain support the following attributes:

Attribute Usage Description

scheduler_id

Optional

Notifications are restricted to the JobScheduler instance with the given identification. By default notifications will be sent for all JobScheduler instances that log into the same database.

Regular expression can be used.

name

Optional

Job chain name including possible folder names.

Regular expression can be used.

Jira

server	SOS JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602
key	JITL-353

step_from Optional Restricts checks for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.

step_to Optional Restricts checks for job chains to a sequence of job nodes that are specified with the step_from and step_to attributes.

Code Block

language	xml
title	Example
collapse	true

...
<TimerJobChain scheduler_id="scheduler_4444" /> 
... 
<TimerJobChain scheduler_id="scheduler_4444" name="^(test/my_.*)" /> 
... 
<TimerJobChain name="test/my_jobchain" step_from="200"/> 
... 
<TimerJobChain name="test/my_jobchain" step_to="500"/> 
... 
<TimerJobChain name="test/my_jobchain" step_from="300" step_to="300"/>
...

...

set the scheduler_notification_result_parameters parameter (see job documentation jobs/JobSchedulerNotificationStoreResultsJob.xml)
set the StoreResultsJobJSAdapterClass as monitor
- JobScheduler version 1.9.x, 1.10.x
  - com.sos.scheduler.notification.jobs.result.StoreResultsJobJSAdapterClass
- JobScheduler version 1.11.x
  - com.sos.jitl.notification.jobs.result.StoreResultsJobJSAdapterClass

...

Expand

title	Variables: table SCHEDULER_MON_NOTIFICATIONS

Table of the history of steps of processed orders.

Name Description Note

${MON_N_ID}

Unique notification id

${MON_N_SCHEDULER_ID} Id of the JobScheduler

${MON_N_TASK_ID} Id of the JobScheduler task

${MON_N_STEP} Consecutive number of the order step

${MON_N_ORDER_HISTORY_ID} Id of the JobScheduler order

${MON_N_JOB_CHAIN_NAME} Name of the job chain of the order

${MON_N_JOB_CHAIN_TITLE} Title of the job chain of the order

${MON_N_ORDER_ID} Unique (within the job chain) id of the order

${MON_N_ORDER_TITLE} Title of the order

${MON_N_ORDER_START_TIME} Timestamp of the start of the order

${MON_N_ORDER_END_TIME} Timestamp of the end of the order

${MON_N_ORDER_TIME_ELAPSED} The time or difference in seconds between a beginning time and an ending time of the order

${MON_N_ORDER_STEP_STATE} State of the order inside the job chain

${MON_N_ORDER_STEP_START_TIME} Timestamp of the start of the order step

${MON_N_ORDER_STEP_END_TIME} Timestamp of the end of the order step

${MON_N_ORDER_STEP_TIME_ELAPSED} The time or difference in seconds between a beginning time and an ending time of the order step

${MON_N_JOB_NAME} Name of the job

${MON_N_JOB_TITLE} Title of the job

${MON_N_TASK_START_TIME} Timestamp of the job task start

${MON_N_TASK_END_TIME} Timestamp of the job task end

${MON_N_TASK_TIME_ELAPSED} The time or difference in seconds between a beginning time and an ending time of the job task

${MON_N_RECOVERED}

0 = dependent of the ${MON_N_ERROR} - ok or error was not recovered,

1 = error was recovered

${MON_N_RETURN_CODE} Return code number

${MON_N_AGENT_ERRORURL}

JobScheduler Agent uri

available with release 1.11.2

Jira

server	SOS JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602
key	JITL-351

${MON_N_CLUSTER_MEMBER_ID}

ID of the Scheduler cluster member (only used in cluster mode)

available with release 1.11.2

Jira

server	SOS JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	6dc67751-9d67-34cd-985b-194a8cdc9602
key	JITL-352

${MON_N_ERROR}

0 = ok

1 = error

$

0 = ok

1 = error

${MON_N_ERROR_CODE}

Exception-code of the job error

${MON_N_ERROR_TEXT} Exception message of the job (that processed the order)

${MON_N_CREATED} Timestamp of the notification initial record

${MON_N_MODIFIED} Timestamp of the latest changes to this notification record

Code Block

language	xml
title	Example
collapse	true

 scheduler id = ${MON_N_SCHEDULER_ID}, history id = ${MON_N_ORDER_HISTORY_ID}, job_chain = ${MON_N_JOB_CHAIN_NAME}(${MON_N_ORDER_ID}), error = ${MON_N_ERROR_TEXT}

...

Space shortcuts

Page tree

Versions Compared

Old Version 170

New Version 171

Key

SystemMonitorNotification / Notification / NotificationObjects / Job

SystemMonitorNotification / Notification / NotificationObjects / JobChain

SystemMonitorNotification / Timer / TimerJobChain