How-to use Job Queue Info
Hello guys.
This article is a general simple introduction about how to use Job Queue Info program. After watch this article, you may generally understand how to use this tool to find and locate issues.
Here I would not introduce each menu or each window of the tool. I would check the existing issues through the tool and by the way, I would talk about the related windows or menus.
The system I am using to show you is Version 8.1.2. I think the UI or function would not change too much recently. If you use another version, you can take it for a reference.
Open the Tool
After your first opening of the tool, it may display like below screenshot.
In the left side, it shows the job queue information, which means the jobs are not totally processed. The list includes the jobs that is being processed, the jobs that is frozen due to some issues, include jobs that is suspended by an scheduler and some step may be executed after some time.
Find Frozen job
Our maintenance work is to find and solve the issues and the first step is to find out which items in the Job Queue are frozen due to errors.
In the above screenshot, it shows the steps to find ‘frozen’ jobs.
After the filtering, you may find that the number after ‘Job queue’ has changed to a smaller number. And all the listed jobs are 'frozen’, which means the jobs are stopped due to errors.
Next, let’s choose one job and find the ‘frozen’ clues.
- Expand all nodes
Now we choose one item for the example. we can click the plus icon to expand the node one by one, checking the steps. And also, we can right click it and choose ‘Expand all nodes’.
Below is the expanded result.
We can find the status of the step in red is FROZEN.
Check the error log
Then we click on the step, but until now we can not get further more information about the issue. We need more details about it.
Actually, there is a window named ‘Process step’, which is used quite frequently. It shows the details about the step you clicked at. But it would not shows at the first time you open Job Queue Info. Click the menu View–>Process step to open it.
When you open the window, it shows like below screenshot.
From the window, we can get the log from the field ‘ErrorMessages’. We can directly use 'Ctrl C’ to copy the content and paste to your notepad to view it.
There are also many other fields that may be useful for you to investigate the issue.
What we can do?
After you can check and investigate the issue, and maybe you already got some clues about it. What can you do next?
When you find out the root cause of it or have some ideas about how to solving the issue, you can create incident or bug ticket. This is anther topic, not related to Job Queue Info. And in job queue info, we normally can ‘Re-enable process step’. Sometimes, issues may be solved after this operation. It is not suggested that you click other operations if you do not know root cause of the issue and the operation impact.
Do the operation like below screenshots. The execution status will immediately changed to TRUE and the red color point in Process will turn to green. Then we can right click to choose ‘Monitor process’ and we can immediately see the status change of this step. The status would firstly change TRUE, then PROCESSING, at last HISTORY if executed successfully.