Package com.redwood.scheduler.api.model
Interface ProcessServerCheck
- 
- All Superinterfaces:
- Detail,- NamedDetailObject,- ProcessServerCheckComp,- Readable,- SchedulerEntity,- SchedulerEntityComp
 
 public interface ProcessServerCheck extends ProcessServerCheckComp, NamedDetailObject, Readable A check on the status of a particular part of the server that the ProcessServer runs on. A ProcessServerCheck creates a Monitor Check with the path /System/ProcessServers/${ProcessServer}/Check/${Name} A ProcessServerCheck creates a Monitor Value with the path /System/ProcessServers/${ProcessServer}/Check/${Name}/${Style-Derived} where ${Style-Derived} is a term derived from the style. For Process,Socket,Win32Service it is Count. For LogFile and Win32Eventlog it is Message.
- 
- 
Field SummaryFields Modifier and Type Field Description static StringOBJECT_TYPEString that will be returned fromSchedulerEntity.getObjectType()for "ProcessServerCheck" objects.static StringSEC_RANK_ALLThis rank is made of the following privileges:static StringSEC_RANK_NONEThis rank has no privileges assigned to it.static QueryObjectType<ProcessServerCheck>TYPEType that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...).- 
Fields inherited from interface com.redwood.scheduler.api.model.SchedulerEntityACTION_AUDIT, ACTION_EXPORT, ACTION_READ, BEHAVIOR_DEPRECATED, BEHAVIOR_NONE, BEHAVIOR_SYSTEM
 
- 
 - 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description ProcessServerCheckLogcreateProcessServerCheckLog()Create a newProcessServerCheckLoglinked to this object.voidexecute()Executes the ProcessServerCheckvoidexecuteAndReact()Executes the ProcessServerCheck and takes action if the check failsStringgetAddress()Get the value for Address.AdHocAlertSourcegetAdHocAlertSource()Get the AdHocAlertSource.StringgetAttribute1()Get the value for Attribute1.StringgetAttribute2()Get the value for Attribute2.StringgetConditionExpression()Get the value for ConditionExpression.StringgetData()Get the value for Data.LonggetDelayAmount()Get the value for DelayAmount.TimeUnitgetDelayUnits()Get the value for DelayUnits.JobDefinitiongetJobDefinition()Get the JobDefinition.StringgetMessage()Get the value for Message.List<ProcessServerCheckAttributeInfo>getParameters()A list of ProcessServerCheckAttributeInfo objects describing each attribute.LonggetPollInterval()Get the value for PollInterval.ProcessServergetProcessServer()Get the ProcessServer.ProcessServerCheckLoggetProcessServerCheckLogByCreationTime(DateTimeZone creationTime)Get the ProcessServerCheckLog by ProcessServerCheckCreationTime.RWIterable<ProcessServerCheckLog>getProcessServerCheckLogs()Get anRWIterableover an ordered collection ofProcessServerCheckLogs.LonggetSeverity()Get the value for Severity.ProcessServerCheckStylegetStyle()Get the value for Style.booleanisEnabled()Get the value for Enabled.voidsetAddress(String newAddress)Set the value for Address.voidsetAdHocAlertSource(AdHocAlertSource newAdHocAlertSource)Set the value for AdHocAlertSource.voidsetAttribute1(String newAttribute1)Set the value for Attribute1.voidsetAttribute2(String newAttribute2)Set the value for Attribute2.voidsetConditionExpression(String newConditionExpression)Set the value for ConditionExpression.voidsetData(String newData)Set the value for Data.voidsetDelayAmount(Long newDelayAmount)Set the value for DelayAmount.voidsetDelayUnits(TimeUnit newDelayUnits)Set the value for DelayUnits.voidsetEnabled(boolean newEnabled)Set the value for Enabled.voidsetJobDefinition(JobDefinition newJobDefinition)Set the value for JobDefinition.voidsetMessage(String newMessage)Set the value for Message.voidsetPollInterval(Long newPollInterval)Set the value for PollInterval.voidsetSeverity(Long newSeverity)Set the value for Severity.voidsetStyle(ProcessServerCheckStyle newStyle)Set the value for Style.voidvalidate()Ensures that the parameters set for a ProcessServerCheck are valid- 
Methods inherited from interface com.redwood.scheduler.api.model.NamedDetailObjectgetComment, getDescription, getName, getSearchName, setComment, setDescription, setName
 - 
Methods inherited from interface com.redwood.scheduler.api.model.SchedulerEntitycanPerform, createSubjectObjectPrivilegeGrant, deleteObject, getAuditTrail, getAuditTrailSize, getBehavior, getEffectiveBehavior, getErrorNameEN, getErrorNameKey, getLLPVersion, getLOV, getLOVSupport, getObjectType, getParentSchedulerEntities, getRuntime, getSubjectObjectPrivilegeGrantBySubject, getSubjectObjectPrivilegeGrants, getUniqueId, getUrl, getUrl, isCreated, isDeletable, isDeleted, isModifiable, isModified, isSelectVersioned, processRelatedObjects, processRelatedObjects, processRelatedObjects, refreshObject, resetObject, resetObject, resetValuesToDefault, selectForRead
 
- 
 
- 
- 
- 
Field Detail- 
OBJECT_TYPEstatic final String OBJECT_TYPE String that will be returned fromSchedulerEntity.getObjectType()for "ProcessServerCheck" objects.- See Also:
- Constant Field Values
 
 - 
TYPEstatic final QueryObjectType<ProcessServerCheck> TYPE Type that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...).
 - 
SEC_RANK_NONEstatic final String SEC_RANK_NONE This rank has no privileges assigned to it.- See Also:
- Constant Field Values
 
 - 
SEC_RANK_ALLstatic final String SEC_RANK_ALL This rank is made of the following privileges:- See Also:
- Constant Field Values
 
 
- 
 - 
Method Detail- 
isEnabledboolean isEnabled() Get the value for Enabled. (Whether this process server check is currently enabled.)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getStyleProcessServerCheckStyle getStyle() Get the value for Style. (The style or type of the check) This value is mandatory, and therefore will not benullif this object has been retrieved from the database.- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getAttribute1String getAttribute1() Get the value for Attribute1. (The first attribute, meaning is style dependent) This value is mandatory, and therefore will not benullif this object has been retrieved from the database.- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getAttribute2String getAttribute2() Get the value for Attribute2. (The second attribute, meaning is style dependent)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getPollIntervalLong getPollInterval() Get the value for PollInterval. (Polling interval that servers as the upper bound for how often the check is performed.) This value is mandatory, and therefore will not benullif this object has been retrieved from the database.- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getSeverityLong getSeverity() Get the value for Severity. (The severity that the resulting monitor check will get when the check fails the condition, or null for the system default.)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getConditionExpressionString getConditionExpression() Get the value for ConditionExpression. (The (optional) condition expression. If this is set, then the expression is evaluated to evaluate whether the condition is met. The default condition is '= Count < 1' which means that the Monitor will be set to a severity if no item in the system matches the search condition(s) set in Attribute 1 and 2.)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getDelayAmountLong getDelayAmount() Get the value for DelayAmount. ( Number of 'delay time units' after a ProcessServerCheck has failed to rerun the check. On failure of the check for the second time a relevant reaction will be triggered. Leave unassigned or assign null if the check is not to be rerun on failure. ) This value is mandatory, and therefore will not benullif this object has been retrieved from the database.- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getDelayUnitsTimeUnit getDelayUnits() Get the value for DelayUnits. (Time units for 'delay amount' - seconds, minutes, hours, days. May not be null, defaults to minutes) This value is mandatory, and therefore will not benullif this object has been retrieved from the database.- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getAddressString getAddress() Get the value for Address. (The address parameter of the reaction job)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getMessageString getMessage() Get the value for Message. (The message parameter of the reaction job)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getDataString getData() Get the value for Data. (The data parameter of the reaction job)- Returns:
- the field
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setEnabledvoid setEnabled(boolean newEnabled) Set the value for Enabled. (Whether this process server check is currently enabled.)- Parameters:
- newEnabled- the new value for Enabled.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setStylevoid setStyle(ProcessServerCheckStyle newStyle) Set the value for Style. (The style or type of the check) This value is mandatory.- Parameters:
- newStyle- the new value for Style. If this is- null, then the object cannot be persisted.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setAttribute1void setAttribute1(String newAttribute1) Set the value for Attribute1. (The first attribute, meaning is style dependent) This value is mandatory.- Parameters:
- newAttribute1- the new value for Attribute1. If this is- null, then the object cannot be persisted.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setAttribute2void setAttribute2(String newAttribute2) Set the value for Attribute2. (The second attribute, meaning is style dependent) This value is optional.- Parameters:
- newAttribute2- the new value for Attribute2.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setPollIntervalvoid setPollInterval(Long newPollInterval) Set the value for PollInterval. (Polling interval that servers as the upper bound for how often the check is performed.) This value is mandatory.- Parameters:
- newPollInterval- the new value for PollInterval. If this is- null, then the object cannot be persisted.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setSeverityvoid setSeverity(Long newSeverity) Set the value for Severity. (The severity that the resulting monitor check will get when the check fails the condition, or null for the system default.) This value is optional.- Parameters:
- newSeverity- the new value for Severity.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setConditionExpressionvoid setConditionExpression(String newConditionExpression) Set the value for ConditionExpression. (The (optional) condition expression. If this is set, then the expression is evaluated to evaluate whether the condition is met. The default condition is '= Count < 1' which means that the Monitor will be set to a severity if no item in the system matches the search condition(s) set in Attribute 1 and 2.) This value is optional.- Parameters:
- newConditionExpression- the new value for ConditionExpression.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setDelayAmountvoid setDelayAmount(Long newDelayAmount) Set the value for DelayAmount. ( Number of 'delay time units' after a ProcessServerCheck has failed to rerun the check. On failure of the check for the second time a relevant reaction will be triggered. Leave unassigned or assign null if the check is not to be rerun on failure. ) This value is mandatory.- Parameters:
- newDelayAmount- the new value for DelayAmount. If this is- null, then the object cannot be persisted.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setDelayUnitsvoid setDelayUnits(TimeUnit newDelayUnits) Set the value for DelayUnits. (Time units for 'delay amount' - seconds, minutes, hours, days. May not be null, defaults to minutes) This value is mandatory.- Parameters:
- newDelayUnits- the new value for DelayUnits. If this is- null, then the object cannot be persisted.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setAddressvoid setAddress(String newAddress) Set the value for Address. (The address parameter of the reaction job) This value is optional.- Parameters:
- newAddress- the new value for Address.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setMessagevoid setMessage(String newMessage) Set the value for Message. (The message parameter of the reaction job) This value is optional.- Parameters:
- newMessage- the new value for Message.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
setDatavoid setData(String newData) Set the value for Data. (The data parameter of the reaction job) This value is optional.- Parameters:
- newData- the new value for Data.
- Throws:
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- This will be thrown if this method is called while the object is not attached to a session.
 
 - 
getParametersList<ProcessServerCheckAttributeInfo> getParameters() A list of ProcessServerCheckAttributeInfo objects describing each attribute. Each object contains a translation keys that is used as the label for the attribute. The list will contain zero, one or two object. Zero objects means there are no attributes for the check and both fields are disabled. One object means one attribute1 is made available and attribute2 is disabled. Two objects makes both attributes available for entry.- Returns:
- The list of ProcessServerCheckAttributeInfo objects describing the attributes
 
 - 
validatevoid validate() throws com.redwood.scheduler.api.exception.ProcessServerCheckValidateException, com.redwood.scheduler.api.exception.ProcessServerCheckSystemExceptionEnsures that the parameters set for a ProcessServerCheck are valid- Throws:
- com.redwood.scheduler.api.exception.ProcessServerCheckValidateException- The attributes defined for a Process Server Check failed validation
- com.redwood.scheduler.api.exception.ProcessServerCheckSystemException- An IO or other system exception occurred while executing a Process Server Check
 
 - 
executevoid execute() throws com.redwood.scheduler.api.exception.ProcessServerCheckFailException, com.redwood.scheduler.api.exception.ProcessServerCheckValidateException, com.redwood.scheduler.api.exception.ProcessServerCheckSystemExceptionExecutes the ProcessServerCheck- Throws:
- com.redwood.scheduler.api.exception.ProcessServerCheckFailException- A Process Server Check failed to meet the defined threshold(s)
- com.redwood.scheduler.api.exception.ProcessServerCheckValidateException- The attributes defined for a Process Server Check failed validation
- com.redwood.scheduler.api.exception.ProcessServerCheckSystemException- An IO or other system exception occurred while executing a Process Server Check
 
 - 
executeAndReactvoid executeAndReact() throws com.redwood.scheduler.api.exception.ProcessServerCheckValidateException, com.redwood.scheduler.api.exception.ProcessServerCheckSystemExceptionExecutes the ProcessServerCheck and takes action if the check fails- Throws:
- com.redwood.scheduler.api.exception.ProcessServerCheckValidateException- The attributes defined for a Process Server Check failed validation
- com.redwood.scheduler.api.exception.ProcessServerCheckSystemException- An IO or other system exception occurred while executing a Process Server Check
 
 - 
getProcessServerProcessServer getProcessServer() Get the ProcessServer.- Returns:
- ProcessServer
- Throws:
- com.redwood.scheduler.api.exception.ObjectDeletedException- If this method is called when the object has been marked for deletion.
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- If this method is called when the object has been removed from it's session.
 
 - 
getAdHocAlertSourceAdHocAlertSource getAdHocAlertSource() Get the AdHocAlertSource.- Returns:
- AdHocAlertSource
- Throws:
- com.redwood.scheduler.api.exception.ObjectDeletedException- If this method is called when the object has been marked for deletion.
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- If this method is called when the object has been removed from it's session.
 
 - 
getJobDefinitionJobDefinition getJobDefinition() Get the JobDefinition.- Returns:
- JobDefinition
- Throws:
- com.redwood.scheduler.api.exception.ObjectDeletedException- If this method is called when the object has been marked for deletion.
- com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException- If this method is called when the object has been removed from it's session.
 
 - 
setAdHocAlertSourcevoid setAdHocAlertSource(AdHocAlertSource newAdHocAlertSource) Set the value for AdHocAlertSource. This value is optional.- Parameters:
- newAdHocAlertSource- is the object to set AdHocAlertSource to. AdHocAlertSource that is used to raise an alert when the ProcessServerCheck fails
 
 - 
setJobDefinitionvoid setJobDefinition(JobDefinition newJobDefinition) Set the value for JobDefinition. This value is optional.- Parameters:
- newJobDefinition- is the object to set JobDefinition to. Reaction JobDefiniton that is submitted on failure of the ProcessServerCheck
 
 - 
getProcessServerCheckLogsRWIterable<ProcessServerCheckLog> getProcessServerCheckLogs() Get anRWIterableover an ordered collection ofProcessServerCheckLogs. If the collection is empty, an empty iterator will be returned, that is, this method will never returnnull. ProcessServerCheckLog logging the success state of a ProcessServerCheck.- Specified by:
- getProcessServerCheckLogsin interface- ProcessServerCheckComp
- Returns:
- An RWIterableover an ordered collection ofProcessServerCheckLogobjects .
 
 - 
createProcessServerCheckLogProcessServerCheckLog createProcessServerCheckLog() Create a newProcessServerCheckLoglinked to this object.- Returns:
- a new ProcessServerCheckLog.
 
 - 
getProcessServerCheckLogByCreationTimeProcessServerCheckLog getProcessServerCheckLogByCreationTime(DateTimeZone creationTime) Get the ProcessServerCheckLog by ProcessServerCheckCreationTime.- Parameters:
- creationTime-
- Returns:
- the ProcessServerCheckLog, or nullif it could not be found
 
 
- 
 
-