Working with Jobs
Use
You use this tab to overview and browse the job instances of one or more job definitions that were executed by certain tasks.
There are two screen areas:
● You use the Jobs screen area to view basic information about a job.
In one view you see only a portion of the jobs that were selected from the back end. You can also browse to the next portions of jobs. The jobs are sorted by their end time with the latest being on top.
● In the Job Details you see more information about a job, as well as its parameters and its log.
Prerequisites
You have started the Job Scheduler.
Procedure
Viewing Jobs
You can view a portion of 500 jobs carried out by the defined job tasks.
To view the next portion of jobs, choose Next.
For each job, you also see the following information:
Column Heading |
Meaning |
Name |
Name of the job |
Status |
The current status of the job. It can be COMPLETED, RUNNING, or FAILED. Status FAILED means one of the following: ● UNKNOWN When a job is in execution while the server node where it runs crashes, the status is set to UNKNOWN while the server node restarts. ● ERROR A job is set to ERROR when a error occurs during job execution. ● STARTING A job can be in state STARTING when all resources are used and no more jobs can be executed. |
Return Code |
The return code which can be set by the job implementer according to the state of the job. |
Start |
The date and time when the job started, as well as the time zone, in which the job was carried out. |
End |
The date and time when the job ended, as well as the time zone in which the job was carried out. |
User |
The user who scheduled the job. |
Scheduler |
The name of the scheduler which was used to trigger this job. |
Filtering and Sorting Jobs
● To filter jobs according to their status, use the Show dropdown box.
The system performs the filtering of all jobs in the back end.
● To sort jobs ascending or descending according to column content, select the heading of the column that you want to sort.
The system sorts only the jobs which are displayed in the currently loaded portion of jobs.
● To filter columns other that the Status, use the standard filtering pushbutton.
The system filters only the jobs which are displayed in the currently loaded portion of jobs.
Displaying Job Details
To view details about a certain job, select the job in the Jobs screen area.
In the Job Details screen area, the following details appear:
● The Info tab contains the following general information:
Field |
Meaning |
Description |
Description on the job. |
Job ID |
Unique ID of the job. |
Application Name |
The name of the application with which the job is deployed. |
Scheduler Name |
The name of the scheduler in the context of which the job was executed |
User |
The name of the user under which the job was executed |
Submit Date |
The date when the execution of the job has been communicated to JMS. |
Start Time |
The time when the job started. |
End Time |
The time when the job finished. |
Submit Date |
The time when the job was submitted. |
Retention Period |
The retention period determines the number of days for which the job logs are persisted in the database. |
Status |
The status of the job (COMPLETED, RUNNING, FAILED) |
Return code |
The return code of the job |
● The Parameters tab contains the following information about the parameters with which the job was scheduled to run:
Column |
Meaning |
Name |
Name of the parameter. |
Type |
The data type of the parameter. |
Direction |
Indicates if the parameter is incoming or outgoing. |
Default Value |
Contains the default value of the parameter if it is defined. |
Description |
The description of the job parameter taken from the job-definition.xml |
Group |
The group to which this job parameter belongs, taken from the job-definition.xml |
Value |
Contained the parameter value which was set by the task when the task was defined. |
● The Log tab contains the logs which the job produced during execution.
You can view the log message, its severity, and time stamp.
If the log is very large, you can browse it in portions using the Next pushbutton.