Service Desk Handbook - Production Job Scheduling - Checking and Managing Agents
When agents are running normally, they will appear in RUNNING status. You can start, stop, idle, resume, or reset the automation engine or agents, and edit an agent's threads by selecting one or more agents (or the automation engine), right-clicking, and selecting from the menu.
If an Agent is not RunningWhen not in Running status, the Agent may be in Busy, Trouble, or Stopped status and will display in red. Check Event Notices in the Production Requests mailbox to see if there are any events that would explain why the Agent would not be running.
Try restarting the agent by right-clicking and selecting Start. If it doesn't go to Running status within a few moments, try selecting Stop then Start again.
If the agent still won't start, try requesting and submitting the process flow EPS_UTL_CONTRL_UNIX_AGENTS_CHN. In the request, change the "action to perform" to stop. Repeat but the second time set "action to perform" to start.
If the agent is still not running at this point, contact the on-call person for COE Production Scheduling.
Managing AgentsYou manage the automation engine and its agents in several ways. From the Explorer window you can:
- Take an action on a single agent or automation engine by right-clicking an agent's icon in the object tree or by right-clicking a listing in the Agent Summary.
- Take an action on one or more agents or the automation engine by highlighting them in the Agent Summary and right-clicking.
- Take an action on all agents and the automation engine by right-clicking the Agents icon in the object tree.
- Take an action on all agents on a machine by right-clicking the machine name under the Machines icon in the object tree.
- Change an agent or automation engine's thread schedule by right-clicking the agent or automation engine.
Actions you can take on agents are start, stop, idle, resume, and reset. These actions can be taken on the automation engine as well. Each action is described below.
Idling and Resuming Agents or the Automation Engine
If you want to stop processing newly submitted tasks through an agent you can idle it. The agent will go to an Idled status and the icon for the agent will be displayed with a yellow triangle over it in the Explorer tree. Tasks in the Backlog set to run on an agent in an Idled status will have a task status of AGENT WAIT. To take the agent out of the idle status, you resume it.
Starting Agents or the Automation Engine
Starting an agent will start processes on that agent if they are stopped and change the agent's status to Running. The agent may change to an interim Starting status before it moves to Running. Starting an agent is equivalent to issuing the startso <agent name> command. It may take some time to update the status when starting agents or the automation engine.
Stopping Agents or the Automation Engine
You should generally idle agents rather than stop them if you want to stop processing tasks on a particular machine. Stopping an agent will put it into a Stopped status, but it will not stop any processes. If an OAE or PEOPLESOFT agent is stopped, Applications Manager won't poll the application for task status updates. Stopping an agent is equivalent to issuing the stopso <agent name> command. It may take some time to update the status when stopping agents or the automation engine. When stopped, agents show a Stopped status and the icon for the agent in the Explorer tree is gray. Tasks in the Backlog set to run on an agent in a Stopped status will have a task status of AGENT WAIT.
Showing BUSY or TROUBLE Agents as Stopped by Resetting
There are times when the machine where an agent is installed is taken down for maintenance. When this happens, the agent will go into a BUSY or TROUBLE status in the Applications Manager client. If you know why the agent is in one of these statuses, and there is no need for action, you may not want the agent's status to affect the color of the status bar. You can right-click it and choose Reset from the pop-up menu. Resetting an agent only changes its viewable status to Stopped. The reset agent will have no effect on the status bar.
Changing Thread Schedules for the Automation Engine and its Agents
Automation engine and agent thread schedules set the maximum number of concurrent tasks that can run through any combination of queues. To change an automation engine or agent's thread schedule, right-click the agent icon and select Threads from the pop-up menu. Applications Manager displays the Threads window shown below where you select a thread schedule.