Package com.redwood.scheduler.api.model
Interface ProcessServerService
-
- All Superinterfaces:
Association
,BusinessKeyObject
,Readable
,SchedulerEntity
,SchedulerEntityComp
public interface ProcessServerService extends Association, BusinessKeyObject, Readable
An instance of a Service on a ProcessServer.
-
-
Field Summary
Fields Modifier and Type Field Description static Long
EVENTS
Browse the file events files.static Long
FILESYSTEM
Browse the filesystem.static Long
INSTALLATION
Browse the installation files.static String
OBJECT_TYPE
String that will be returned fromSchedulerEntity.getObjectType()
for "ProcessServerService" objects.static String
SEC_RANK_ALL
This rank is made of the following privileges:static String
SEC_RANK_NONE
This rank has no privileges assigned to it.static Long
TCP_PROTOCOL
The TCP protocol.static Long
TRACEFILES
Browse the trace files only.static QueryObjectType<ProcessServerService>
TYPE
Type that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...)
.static Long
UDP_PROTOCOL
The UDP protocol.-
Fields inherited from interface com.redwood.scheduler.api.model.BusinessKeyObject
COPYRIGHT_MESSAGE_BKO, ID_BKO
-
Fields inherited from interface com.redwood.scheduler.api.model.Readable
COPYRIGHT_MESSAGE_E, ID_E
-
Fields inherited from interface com.redwood.scheduler.api.model.SchedulerEntity
ACTION_AUDIT, ACTION_EXPORT, ACTION_READ, BEHAVIOR_DEPRECATED, BEHAVIOR_NONE, BEHAVIOR_SYSTEM
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ProcessServer
getProcessServer()
Get the ProcessServer.String
getRemoteAgentStatusURL()
If there is an agent provide the URL for a status page, or null if there is no such page.Service
getService()
Get the Service.ProcessServerStatus
getStatus()
Get the value for Status.boolean
isBrowseable()
Indicates listDirectory can be usedListDirectoryResultSet
listDirectory(Long namespace, String path, String pattern, boolean allowFiles, boolean allowDirectories)
List the contents of a directory.OSUserSessions
listOSUserSessions()
List the user sessions present on the server that the agent is running on.byte[]
performSocketOperation(Long protocol, String hostname, Long port, byte[] data, Long timeout)
Perform an IP Socket operation remotely on the host that the agent lives on.-
Methods inherited from interface com.redwood.scheduler.api.model.BusinessKeyObject
getBusinessKey
-
Methods inherited from interface com.redwood.scheduler.api.model.SchedulerEntity
canPerform, 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_TYPE
static final String OBJECT_TYPE
String that will be returned fromSchedulerEntity.getObjectType()
for "ProcessServerService" objects.- See Also:
- Constant Field Values
-
TYPE
static final QueryObjectType<ProcessServerService> TYPE
Type that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...)
.
-
FILESYSTEM
static final Long FILESYSTEM
Browse the filesystem.
-
TRACEFILES
static final Long TRACEFILES
Browse the trace files only.
-
INSTALLATION
static final Long INSTALLATION
Browse the installation files.
-
EVENTS
static final Long EVENTS
Browse the file events files.
-
TCP_PROTOCOL
static final Long TCP_PROTOCOL
The TCP protocol.
-
UDP_PROTOCOL
static final Long UDP_PROTOCOL
The UDP protocol.
-
SEC_RANK_NONE
static final String SEC_RANK_NONE
This rank has no privileges assigned to it.- See Also:
- Constant Field Values
-
SEC_RANK_ALL
static final String SEC_RANK_ALL
This rank is made of the following privileges:- See Also:
- Constant Field Values
-
-
Method Detail
-
getStatus
ProcessServerStatus getStatus()
Get the value for Status. (The current Service status) This value is mandatory, and therefore will not benull
if this object has been retrieved from the database.- Returns:
- the field
- Throws:
ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
isBrowseable
boolean isBrowseable()
Indicates listDirectory can be used- Returns:
- Is the ProcessServerService browseable?
-
listDirectory
ListDirectoryResultSet listDirectory(Long namespace, String path, String pattern, boolean allowFiles, boolean allowDirectories) throws ListDirectoryException, ListDirectoryTransientException
List the contents of a directory.- Parameters:
namespace
- Which type of path is required. FILESYSTEM, TRACEFILES or INSTALLATION.path
- The path of the directory that should be listed. Start at the top of a namespace by specifying null or the empty string. The only other accepted paths are paths returned by earlier calls to this operation.pattern
- Pattern of files and directories to allow. You can assume that some type of wildcarding is allowed, in general this will be?
and*
, but this is not guaranteed.allowFiles
- Shall the list return paths that refer to plain files?allowDirectories
- Shall the list return paths that refer to subdirectories?- Returns:
- The contents of the directory.
- Throws:
ListDirectoryException
- Failure to retrieve the directory content, likely permanent in nature.ListDirectoryTransientException
- Failure to retrieve the directory content, likely transient in nature; a retry may succeed.
-
listOSUserSessions
OSUserSessions listOSUserSessions() throws ListOSUserSessionsException
List the user sessions present on the server that the agent is running on. Will only deliver data for a Microsoft Windows platform agent.- Returns:
- The user sessions
- Throws:
ListOSUserSessionsException
- Failure to list user sessions
-
performSocketOperation
byte[] performSocketOperation(Long protocol, String hostname, Long port, byte[] data, Long timeout) throws PerformSocketOperationException, PerformSocketOperationTransientException
Perform an IP Socket operation remotely on the host that the agent lives on. Only supported by the PlatformAgentService right now.- Parameters:
protocol
- The IP protocol that should be used to connect. At this moment the supported values are TCP_PROTOCOL and UDP_PROTOCOL.hostname
- Which host the agent should contact. Name resolution is done by the agent.port
- The port that the socket should connect to.data
- Data to send the socket.timeout
- Timeout in milliseconds for any socket operation. It is intended to be a timeout for the entire operation (which for TCP is open/write/read/close), but this may not be adhered to closely.- Returns:
- The resulting data returned by the socket, if any.
- Throws:
PerformSocketOperationException
- An IO or other system exception occurred while performing a socket operationPerformSocketOperationTransientException
- An IO or other system exception occurred while performing a socket operation. The error is transient in nature and a retry may work. For example, the process server is down.
-
getRemoteAgentStatusURL
String getRemoteAgentStatusURL()
If there is an agent provide the URL for a status page, or null if there is no such page. Only supported by the PlatformAgentService. The link is likely to be valid only for a limited amount of time, after which the agent will refuse to provide the data.- Returns:
- The resulting URL, or null if there is none.
-
getProcessServer
ProcessServer getProcessServer()
Get the ProcessServer.- Returns:
- ProcessServer
- Throws:
ObjectDeletedException
- If this method is called when the object has been marked for deletion.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
getService
Service getService()
Get the Service.- Returns:
- Service
- Throws:
ObjectDeletedException
- If this method is called when the object has been marked for deletion.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
-