com.pega.pegarules.pub.context

Interface AgentUtils

public interface AgentUtils

Utilities for managing agent queues.

A reference to the global AgentUtils object can be obtained using the getAgentUtils PublicAPI method.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COPYRIGHT
static java.lang.String	VERSION

Method Summary

Modifier and Type	Method and Description
java.util.List	checkQueuesEnabled(java.lang.String aRuleSetName) For the specified Agent name, return a list of booleans indicating the running status of each individual queue defined in that Agent.
java.util.Map<java.lang.String,java.lang.Object>	getAgentDetails(java.lang.String aRuleSetName, java.lang.String qName) Fetch the agent details
java.util.Map<java.lang.String,java.lang.Object>	getAgentDetailsForNode(java.lang.String aRuleSetName, java.lang.String qName, java.lang.String nodeName) Fetch the agent details on the given node
IAgentInfo	getAgentInfoForNode(java.lang.String aRuleSetName, java.lang.String qName, java.lang.String nodeName) Fetch the agent details on the given node
java.lang.String	getAgentMode(java.lang.String aRuleSetName, java.lang.String aQueueName)
java.util.List	getAgentNames() Returns the names of all Agents currently configured on this node.
java.lang.String	getAgentStatus(java.lang.String aRuleSetName, java.lang.String aQueueName)
int	getNumberOfRunningAgents() Returns the number of agents currently running on this node
StringMap	getQueue(java.lang.String aRuleSetName, int aQueueNumber) For the specified Agent name (ruleset name) and the specified row number in that Agent, return state data about that agent queue.
java.util.List	getQueues(java.lang.String aRuleSetName) For the specified Agent name (ruleset name), return state data about each queue owned by this Agent.
java.lang.String	getScheduleExecutionPattern(java.lang.String mCurrentLocale, ClipboardPage page) Fetch the agent details
boolean	isQueueEnabled(java.lang.String aRuleSetName, int aQueueNumber) Determine whether the specified queue is currently enabled or not.
boolean	restartQueue(java.lang.String aRuleSetName) Restart all queues for the given Agent.
boolean	restartQueue(java.lang.String aRuleSetName, int aQueueNumber) Restart an agent queue.
java.lang.Boolean	restartQueue(java.lang.String aRuleSetName, java.lang.String aQueueName)
java.lang.String	startQueue(java.util.Set<java.lang.String> nodes, java.lang.String aRuleSetName, java.lang.String aQueueName) Start an agent queue.
boolean	startQueue(java.lang.String aRuleSetName) Start all currently disabled queues for the specified agent.
boolean	startQueue(java.lang.String aRuleSetName, int aQueueNumber) Deprecated.
java.lang.Boolean	startQueue(java.lang.String aRuleSetName, java.lang.String aQueueName) Start an agent queue.
java.lang.String	terminateQueue(java.util.Set<java.lang.String> nodes, java.lang.String aRuleSetName, java.lang.String aQueueName) Terminate an agent queue.
boolean	terminateQueue(java.lang.String aRuleSetName) Terminate all currently enabled queues for the specified agent.
boolean	terminateQueue(java.lang.String aRuleSetName, int aQueueNumber) Deprecated.
java.lang.Boolean	terminateQueue(java.lang.String aRuleSetName, java.lang.String aQueueName) Terminate an agent queue.
void	upgradeDAQsWithOlderNodeType(PRThread thread)

Field Detail

VERSION

static final java.lang.String VERSION

COPYRIGHT

static final java.lang.String COPYRIGHT

See Also:

Constant Field Values

Method Detail

startQueue

@Deprecated
boolean startQueue(java.lang.String aRuleSetName,
                               int aQueueNumber)

Deprecated.

Start an agent queue. If the agent queue is currently running, method will return false. Running queues must first be terminated with terminateAgentQueue first before being started again. Use startQueue instead

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

aQueueNumber - The queue number corresponding to the desired row in the Rule-Agent-Queue record.

Returns:

boolean Returns true if the agent queue was found and successfully asked to start, false if the agent queue was not found.

startQueue

java.lang.Boolean startQueue(java.lang.String aRuleSetName,
                             java.lang.String aQueueName)

Start an agent queue. If the agent queue is currently running, method will return false. Running queues must first be terminated with terminateAgentQueue first before being started again.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

aQueueName - The queue name.

Returns:

boolean Returns true if the agent queue was found and successfully asked to start, false if the agent queue was not found.

startQueue

java.lang.String startQueue(java.util.Set<java.lang.String> nodes,
                            java.lang.String aRuleSetName,
                            java.lang.String aQueueName)

Start an agent queue. If the agent queue is currently running, method will return false. Running queues must first be terminated with terminateAgentQueue first before being started again.

Parameters:

nodes - The node ids where this operation has to be executed

aRuleSetName - The Rule set name

aQueueName - The agent name

Returns:

boolean Returns true if the agent queue was found and successfully asked to start, false if the agent queue was not found.

startQueue

boolean startQueue(java.lang.String aRuleSetName)

Start all currently disabled queues for the specified agent. If a queue is already enabled, it will be ignored.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

Returns:

boolean Returns true if the Agent was found, false if the Agent was not found.

terminateQueue

@Deprecated
boolean terminateQueue(java.lang.String aRuleSetName,
                                   int aQueueNumber)

Deprecated.

Terminate an agent queue. If the agent queue is not currently running, or is disabled, this method will log an error to the console and return false. When a queue is terminated, it's status will be updated to reflect that it was terminated manually by this interface and not by an error or exception. Use terminateQueue instead

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

aQueueNumber - The queue number corresponding to the desired row in the Rule-Agent-Queue record.

Returns:

boolean Returns true if the agent queue was found and successfully asked to terminate, false if the agent queue was not found.

terminateQueue

java.lang.Boolean terminateQueue(java.lang.String aRuleSetName,
                                 java.lang.String aQueueName)

Terminate an agent queue. If the agent queue is not currently running, or is disabled, this method will log an error to the console and return false. When a queue is terminated, it's status will be updated to reflect that it was terminated manually by this interface and not by an error or exception.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

aQueueName - The queue name

Returns:

boolean Returns true if the agent queue was found and successfully asked to terminate, false if the agent queue was not found.

terminateQueue

java.lang.String terminateQueue(java.util.Set<java.lang.String> nodes,
                                java.lang.String aRuleSetName,
                                java.lang.String aQueueName)

Terminate an agent queue. If the agent queue is not currently running, or is disabled, this method will log an error to the console and return false. When a queue is terminated, it's status will be updated to reflect that it was terminated manually by this interface and not by an error or exception.

Parameters:

nodes - The node ids where this operation has to be executed

aRuleSetName -

aQueueName -

Returns:

boolean Returns true if the agent queue was found and successfully asked to terminate, false if the agent queue was not found.

terminateQueue

boolean terminateQueue(java.lang.String aRuleSetName)

Terminate all currently enabled queues for the specified agent. If a queue is already disabled, it will be ignored.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

Returns:

boolean Returns true if the Agent was found, false if the Agent was not found.

isQueueEnabled

boolean isQueueEnabled(java.lang.String aRuleSetName,
                       int aQueueNumber)

Determine whether the specified queue is currently enabled or not. An enabled queue is a queue that is either currently running or is scheduled to run at some future time, and hasn't been terminated due to error or manually by this interface.

Parameters:

aRuleSetName -

aQueueNumber -

Returns:

boolean Is queue enabled?

checkQueuesEnabled

java.util.List checkQueuesEnabled(java.lang.String aRuleSetName)

For the specified Agent name, return a list of booleans indicating the running status of each individual queue defined in that Agent. The list is returning in row order, row by row as defined in the Rule-Agent-Queue record.

Parameters:

aRuleSetName - Name of the Agent to query

Returns:

List A list of Boolean objects; true means the queue is enabled, false means the queue is disabled

getAgentNames

java.util.List getAgentNames()

Returns the names of all Agents currently configured on this node.

Returns:

List A List object containing 0 or more String objects

getQueues

java.util.List getQueues(java.lang.String aRuleSetName)

For the specified Agent name (ruleset name), return state data about each queue owned by this Agent. See getQueue for details on how that state data is formatted and returned

Parameters:

aRuleSetName - Name of the Agent to query

Returns:

List a List object containing 0 or more StringMap objects

getQueue

StringMap getQueue(java.lang.String aRuleSetName,
                   int aQueueNumber)

For the specified Agent name (ruleset name) and the specified row number in that Agent, return state data about that agent queue. This data is returned in a StringMap, which contains a series of name/value mappings (which are String objects). The mappings are:

Description: The text description of this agent queue row
IsEnabled: (true/false) Is this queue currently enabled, or has it been terminated (manually or due to error)?
IsPeriodic: (true/false) Is this queue executing periodically, or on a recurring calendar schedule?
RescheduleInterval: A textual description of this queue's recurring schedule.
LastRunStart: Time (standard PegaRULES time stamp; ISO format, GMT zone) when queue last run. If queue has never run since the node was started, this value will be blank ("")
LastRunFinish: Time (standard PegaRULES time stamp; ISO format, GMT zone) when queue last finished a run. If queue has never finished a run since the node was started, this value will be blank ("")
NextRunTarget: Time (standard PegaRULES time stamp; ISO format, GMT zone) when queue is next scheduled to run.
LastExceptionData: If queue is disabled, detailed text information on the last exception that occurred.

Parameters:

aRuleSetName - The name of the Agent (RuleSet name)

aQueueNumber - The row number (agent queue) to describe

Returns:

StringMap A StringMap object containing name/value mappings as described above

restartQueue

boolean restartQueue(java.lang.String aRuleSetName,
                     int aQueueNumber)

Restart an agent queue. If the agent queue is currently running it will be terminated first before starting it again.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

aQueueNumber - The queue number corresponding to the desired row in the Rule-Agent-Queue record.

Returns:

boolean Returns true if the agent queue was found and successfully asked to restart, false if the agent queue was not found.

restartQueue

boolean restartQueue(java.lang.String aRuleSetName)

Restart all queues for the given Agent. If an agent queue is currently running, it will be terminated first before starting it again.

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record) to modify.

Returns:

boolean Returns true if the agent was found and its queues were asked to restart.

getAgentDetails

java.util.Map<java.lang.String,java.lang.Object> getAgentDetails(java.lang.String aRuleSetName,
                                                                 java.lang.String qName)

Fetch the agent details

Parameters:

aRuleSetName - - Rule set name

qName - - Agent queue name

Returns:

HashStringMap - details of the agent

getScheduleExecutionPattern

java.lang.String getScheduleExecutionPattern(java.lang.String mCurrentLocale,
                                             ClipboardPage page)

Fetch the agent details

Parameters:

mCurrentLocale - - browser locale

page - - clipboard page that contains the schedule

Returns:

String - Agent schedule

getAgentStatus

java.lang.String getAgentStatus(java.lang.String aRuleSetName,
                                java.lang.String aQueueName)

Parameters:

aRuleSetName - The name of the agent (key to the Rule-Agent-Queue record).

aQueueName - The queue name

Returns:

current status of the given agent. Would return one of the three Running,Exception,Stopped

getAgentDetailsForNode

java.util.Map<java.lang.String,java.lang.Object> getAgentDetailsForNode(java.lang.String aRuleSetName,
                                                                        java.lang.String qName,
                                                                        java.lang.String nodeName)

Fetch the agent details on the given node

Parameters:

aRuleSetName -

qName -

nodeName -

Returns:

Map - details of the agent

getAgentInfoForNode

IAgentInfo getAgentInfoForNode(java.lang.String aRuleSetName,
                               java.lang.String qName,
                               java.lang.String nodeName)

Fetch the agent details on the given node

Parameters:

aRuleSetName -

qName -

nodeName -

Returns:

AgentInfo - details of the agent

getNumberOfRunningAgents

int getNumberOfRunningAgents()

Returns the number of agents currently running on this node

Returns:

int - number of running agents

restartQueue

java.lang.Boolean restartQueue(java.lang.String aRuleSetName,
                               java.lang.String aQueueName)

getAgentMode

java.lang.String getAgentMode(java.lang.String aRuleSetName,
                              java.lang.String aQueueName)

upgradeDAQsWithOlderNodeType

void upgradeDAQsWithOlderNodeType(PRThread thread)