com.aspc.task

Class DBTask

java.lang.Object

com.aspc.DBObj.DBObject

com.aspc.task.DBTask

All Implemented Interfaces:

SecondaryCacheGroup

public class DBTask
extends DBObject

A DBTask is a background process that needs to be monitored.

data model
THREAD MODE: MIXED, SINGLE-THREADED when called from MutableDataSource else MULTI-THREADED

Since:

4 December 2003

Author:

Nigel Leck

Nested Class Summary

Nested classes/interfaces inherited from class com.aspc.DBObj.DBObject

DBObject.DenormalizeAction

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Object	BEAT gate keeper when we are creating a task in heart_beat table
static GlobalId	DBCLASS_GID A DBTask is a background process that needs to be monitored.
static java.lang.String	DBCLASS_NAME A DBTask is a background process that needs to be monitored.

Fields inherited from class com.aspc.DBObj.DBObject

ATTRIBUTE_MARVIN, dbClass, ds, NO_LOOP_PARAMS

Constructor Summary

Constructors

Constructor and Description
DBTask(DBClass def, DataSource dataSource) Std.

Method Summary

Modifier and Type	Method and Description
int	countLocks() counts number of locked transactions
int	countTransSyncMap()
static DBTask	create(MutableDataSource mds) Make a new instance of this class.
java.lang.String	end() END the task
java.lang.String	end(java.lang.String session_id)
void	error(java.lang.String message) sets the task to error.
protected void	extDeleteRecord(long transNr) OVERRIDE this method to add functionality to stSoftware WHILE deleting the record from the database.
protected java.lang.Object	extGetDerivedValue(DBField field, FldParams params) Calculate the derived value for this field.
protected void	extPreValidate() Update the in-memory universe BEFORE validating
protected void	extSaveRecord(long transNr) Additional functionality WHILE saving this record to the database.
protected void	extValidateRecord(ValidationList list) Performs additional validations on this record.
static DBTask	findKey(DataSource ds, java.lang.String key) Find the target for this class by the primary key
DBTaskMonitorLevel	findMonitorLevel(java.lang.String... args) monitor level either fatal, error or warn.
static DBTask	findOne(java.lang.String code, DataSource ds) used to find the db task
DBTaskStatus	findStatus(java.lang.String... args) The status of this task.
DBTaskType	findType(java.lang.String... args) The type of the task.
java.lang.String	getCode(java.lang.String... args)
java.lang.String	getCurrentHostname(java.lang.String... args)
java.lang.String	getCurrentSession(java.lang.String... args)
java.lang.String	getDescription(java.lang.String... args)
java.lang.String	getErrorTx(java.lang.String... args)
java.lang.String	getExternalErrorTx(java.lang.String... args)
java.lang.String	getGracePeriod(java.lang.String... args)
java.lang.String	getHeartBeatDuration(java.lang.String... args)
java.lang.String	getLabel(java.lang.String... args)
java.util.Date	getLastBeatTime(java.lang.String... args)
java.util.Date	getLastNotified(java.lang.String... args)
java.lang.String	getMode(java.lang.String session_id)
DBTaskMonitorLevel	getMonitorLevel(java.lang.String... args)
java.lang.String	getNotificationPeriod(java.lang.String... args)
java.lang.String	getParameters(java.lang.String... args)
java.lang.Object	getPlugin() get the task plugin.
java.lang.String	getProcessDuration(java.lang.String... args)
java.lang.String	getRawCurrentSession(java.lang.String... args)
java.lang.String	getRawStartKey(java.lang.String... args)
long	getRawTransGroup(java.lang.String... args)
java.lang.String	getStartedKey(java.lang.String... args)
DBTaskStatus	getStatus(java.lang.String... args)
long	getStatusForKey(java.lang.String key) return the transaction status on the global key, Make sure that key is for this task
java.util.Date	getSuppressUntil(java.lang.String... args)
java.lang.String	getTransactionErrors() get the errors associated the transactions
java.lang.String	getTransErrorText(java.lang.String... args)
int	getTransGroup(java.lang.String... args)
int	getTransGroupLayer(java.lang.String... args)
DBTaskType	getType(java.lang.String... args)
boolean	hasTransSyncMap()
void	heartBeat() Heart Beat for this task.
boolean	isEnabled(java.lang.String... args)
boolean	isHa(java.lang.String... args)
boolean	isMaintaining(java.lang.String... args)
java.awt.Color	makeColor()
static DBQuery<DBTask>	makeQuery(DataSource ds) Make a new QUERY for this class.
DBTask	setCode(java.lang.String value, java.lang.String... args)
DBTask	setCurrentHostname(java.lang.String value, java.lang.String... args)
DBTask	setDescription(java.lang.String value, java.lang.String... args)
DBTask	setEnabled(boolean value, java.lang.String... args)
DBTask	setExternalErrorTx(java.lang.String value, java.lang.String... args)
DBTask	setGracePeriod(java.lang.String value, java.lang.String... args)
DBTask	setHa(boolean value, java.lang.String... args)
DBTask	setHeartBeatDuration(java.lang.String value, java.lang.String... args)
DBTask	setLabel(java.lang.String value, java.lang.String... args)
DBTask	setLastNotified(java.util.Date value, java.lang.String... args)
DBTask	setMonitorLevel(com.aspc.dal.task.DBTaskMonitorLevel value, java.lang.String... args)
DBTask	setNotificationPeriod(java.lang.String value, java.lang.String... args)
DBTask	setParameters(java.lang.String value, java.lang.String... args)
DBTask	setPlugin(java.lang.String value, java.lang.String... args)
DBTask	setProcessDuration(java.lang.String value, java.lang.String... args)
DBTask	setRawCurrentSession(java.lang.String value, java.lang.String... args)
DBTask	setRawStartKey(java.lang.String value, java.lang.String... args)
DBTask	setRawTransGroup(long value, java.lang.String... args)
DBTask	setSuppressUntil(java.util.Date value, java.lang.String... args)
DBTask	setType(com.aspc.dal.task.DBTaskType value, java.lang.String... args)
java.lang.String[]	start()
java.lang.String[]	start(java.lang.String startkey) if the task is dead or end return update it to ok and return the transId startKey - Key assigned to start the task.

Methods inherited from class com.aspc.DBObj.DBObject

addReloadEventListener, archiveCheck, autoEnterCreate, calculateValue, calculateValue, calculateValue, callingRestoreByJournal, changeThreadMode, checkCreateAccess, checkDelete, checkDeleteAccess, checkModifyAccess, checkModifyAccess, checkReadAccess, clearCache, copy, copyFields, copyIncludeField, copyInwardLinks, delete, denormalizedResult, displayLogName, displayName, displayValue, doSearch, dump, equals, eventDataLoaded, eventFieldUpdated, extAutoEnterCreate, extCanDeleteDependantObject, extCheckCreateAccess, extCheckDeleteAccess, extCheckModifyAccess, extCheckModifyAccess, extCheckReadAccess, extCopy, extDelete, extFixUp, extGetDerivedGlobalKey, extGetValue, extIsMandatory, extIsOnChange, extMarkSavePoint, extPostDeleteRecord, extPostSaveRecord, extPreDeleteRecord, extPreSaveRecord, extPreValidateDelete, extRaiseEvents, extRollbackTo, extSetValue, extUndelete, extValidateDelete, extValidateField, fetchLinkHolder, findGlobalKey, findGlobalKey, findGlobalKey, findGlobalKey, findLinkedObject, findLinkedObject, findLinkedObject, findRawData, fireEventDataLoaded, fixUp, forceLockedTransaction, getBoolean, getBoolean, getBoolean, getBoolean, getBoolean, getBoolean, getChangedFieldInfo, getChangedFields, getDate, getDate, getDate, getDate, getDate, getDefaultValue, getDisableOnChangeEvent, getDouble, getDouble, getDouble, getDouble, getDouble, getFieldDouble, getFieldInt, getFieldLong, getFieldString, getFormattedString, getFormattedString, getGlobalKey, getGlobalKey, getGlobalKey, getGlobalKey, getGlobalKey, getInt, getInt, getInt, getInt, getInt, getInt, getInwardLinkage, getKeyString, getKeyValue, getLinkedObject, getLinkedObject, getLinkedObject, getLinkedObjectByKey, getLinkedRowId, getLinkedRowId, getLinkedRowIdByData, getLinkHolder, getLockedTransaction, getLong, getLong, getLong, getLong, getLong, getLong, getMutableArrayValue, getMutableArrayValue, getOriginalKey, getOriginalValue, getOriginalValue, getProcessedValue, getPureValue, getRawData, getRawValue, getRawValue, getRowId, getRowKey, getSecondaryCacheGroupKey, getSrcLayerID, getString, getString, getString, getString, getString, getString, getValue, getValue, getValue, getValue, hasAutoChanged, hasAutoChanged, hasChanged, hasChangedByUser, hasChangedByUserField, hasChangedByUserField, hasFieldChanged, hasFieldChanged, hashCode, hasStoredResult, iCheckDeleteAccess, iCheckModifyAccess, iCheckReadAccess, iGetDenormalizedMap, iGetRawValue, iPlaceDenormalizedResult, iPostSaveOrDeleteRecord, iPreSaveOrDeleteRecord, iPreValidate, iRaiseEvents, iSaveOrDeleteRecord, isBrokenLink, isBrokenLink, isChanged, isDataCacheKnownToBeDirty, isDeleted, isEmpty, iSetValue, isForceReindex, isKeyWordField, isMandatory, isNew, isNull, isNull, isOnChange, isReindex, iValidateRecord, lastTouched, makeArchiveDataLoader, makeClone, makeDataLoader, makeDenormalizedDoc, makeLinkedArray, makeModifyAccessException, makeSearchPlan, makeWriteProvider, manualDenormalizeOnSave, markSavePoint, optLockedTransaction, registerWatchedObject, reindex, releaseDenormalized, removeReloadEventListener, restoreByJournal, rollbackTo, setBoolean, setBoolean, setBoolean, setBoolean, setDisableOnChangeEvent, setDouble, setDouble, setInt, setInt, setLong, setLong, setRawData, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, toString, touch, undelete, validateField, validateRecord, validateSubType

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DBCLASS_NAME

public static final java.lang.String DBCLASS_NAME

A DBTask is a background process that needs to be monitored.

See Also:

Constant Field Values

DBCLASS_GID

public static final GlobalId DBCLASS_GID

A DBTask is a background process that needs to be monitored.

BEAT

public static final java.lang.Object BEAT

gate keeper when we are creating a task in heart_beat table

Constructor Detail

DBTask

public DBTask(DBClass def,
              DataSource dataSource)
       throws java.lang.Exception

Std. DBObject constructor

Parameters:

def - The class of this object

dataSource - The datasource for this object

Throws:

java.lang.Exception - A serious problem occurred

Method Detail

getCode

@CheckReturnValue
 @Nonnull
public java.lang.String getCode(java.lang.String... args)

setCode

@Nonnull
public DBTask setCode(java.lang.String value,
                               java.lang.String... args)
                        throws java.lang.Exception

Throws:

java.lang.Exception

getCurrentHostname

@CheckReturnValue
 @Nonnull
public java.lang.String getCurrentHostname(java.lang.String... args)

setCurrentHostname

@Nonnull
public DBTask setCurrentHostname(java.lang.String value,
                                          java.lang.String... args)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

getCurrentSession

@CheckReturnValue
 @Nonnull
public java.lang.String getCurrentSession(java.lang.String... args)

getDescription

@CheckReturnValue
 @Nonnull
public java.lang.String getDescription(java.lang.String... args)

setDescription

@Nonnull
public DBTask setDescription(java.lang.String value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

isEnabled

@CheckReturnValue
public boolean isEnabled(java.lang.String... args)

setEnabled

@Nonnull
public DBTask setEnabled(boolean value,
                                  java.lang.String... args)
                           throws java.lang.Exception

Throws:

java.lang.Exception

getErrorTx

@CheckReturnValue
 @Nonnull
public java.lang.String getErrorTx(java.lang.String... args)

getExternalErrorTx

@CheckReturnValue
 @Nonnull
public java.lang.String getExternalErrorTx(java.lang.String... args)

setExternalErrorTx

@Nonnull
public DBTask setExternalErrorTx(java.lang.String value,
                                          java.lang.String... args)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

getGracePeriod

@CheckReturnValue
 @Nonnull
public java.lang.String getGracePeriod(java.lang.String... args)

setGracePeriod

@Nonnull
public DBTask setGracePeriod(java.lang.String value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getHeartBeatDuration

@CheckReturnValue
 @Nonnull
public java.lang.String getHeartBeatDuration(java.lang.String... args)

setHeartBeatDuration

@Nonnull
public DBTask setHeartBeatDuration(java.lang.String value,
                                            java.lang.String... args)
                                     throws java.lang.Exception

Throws:

java.lang.Exception

isHa

@CheckReturnValue
public boolean isHa(java.lang.String... args)

setHa

@Nonnull
public DBTask setHa(boolean value,
                             java.lang.String... args)
                      throws java.lang.Exception

Throws:

java.lang.Exception

isMaintaining

@CheckReturnValue
public boolean isMaintaining(java.lang.String... args)

getLabel

@CheckReturnValue
 @Nonnull
public java.lang.String getLabel(java.lang.String... args)

setLabel

@Nonnull
public DBTask setLabel(java.lang.String value,
                                java.lang.String... args)
                         throws java.lang.Exception

Throws:

java.lang.Exception

getLastBeatTime

@CheckReturnValue
 @Nullable
public java.util.Date getLastBeatTime(java.lang.String... args)

getLastNotified

@CheckReturnValue
 @Nullable
public java.util.Date getLastNotified(java.lang.String... args)

setLastNotified

@Nonnull
public DBTask setLastNotified(java.util.Date value,
                                       java.lang.String... args)
                                throws java.lang.Exception

Throws:

java.lang.Exception

getMonitorLevel

@CheckReturnValue
 @Nullable
public DBTaskMonitorLevel getMonitorLevel(java.lang.String... args)

findMonitorLevel

@CheckReturnValue
 @Nonnull
public final DBTaskMonitorLevel findMonitorLevel(java.lang.String... args)
                                                                      throws NotFoundException

monitor level either fatal, error or warn.

--> DBTaskMonitorLevel (String, Searchable)

Parameters:

args - the optional arguments

Returns:

DBTaskMonitorLevel

Throws:

NotFoundException - DBTaskMonitorLevel was not found

setMonitorLevel

@Nonnull
public DBTask setMonitorLevel(com.aspc.dal.task.DBTaskMonitorLevel value,
                                       java.lang.String... args)
                                throws java.lang.Exception

Throws:

java.lang.Exception

getNotificationPeriod

@CheckReturnValue
 @Nonnull
public java.lang.String getNotificationPeriod(java.lang.String... args)

setNotificationPeriod

@Nonnull
public DBTask setNotificationPeriod(java.lang.String value,
                                             java.lang.String... args)
                                      throws java.lang.Exception

Throws:

java.lang.Exception

getParameters

@CheckReturnValue
 @Nonnull
public java.lang.String getParameters(java.lang.String... args)

setParameters

@Nonnull
public DBTask setParameters(java.lang.String value,
                                     java.lang.String... args)
                              throws java.lang.Exception

Throws:

java.lang.Exception

setPlugin

@Nonnull
public DBTask setPlugin(java.lang.String value,
                                 java.lang.String... args)
                          throws java.lang.Exception

Throws:

java.lang.Exception

getProcessDuration

@CheckReturnValue
 @Nonnull
public java.lang.String getProcessDuration(java.lang.String... args)

setProcessDuration

@Nonnull
public DBTask setProcessDuration(java.lang.String value,
                                          java.lang.String... args)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

getRawCurrentSession

@CheckReturnValue
 @Nonnull
public java.lang.String getRawCurrentSession(java.lang.String... args)

setRawCurrentSession

@Nonnull
public DBTask setRawCurrentSession(java.lang.String value,
                                            java.lang.String... args)
                                     throws java.lang.Exception

Throws:

java.lang.Exception

getRawStartKey

@CheckReturnValue
 @Nonnull
public java.lang.String getRawStartKey(java.lang.String... args)

setRawStartKey

@Nonnull
public DBTask setRawStartKey(java.lang.String value,
                                      java.lang.String... args)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getRawTransGroup

@CheckReturnValue
public long getRawTransGroup(java.lang.String... args)

setRawTransGroup

@Nonnull
public DBTask setRawTransGroup(long value,
                                        java.lang.String... args)
                                 throws java.lang.Exception

Throws:

java.lang.Exception

getStartedKey

@CheckReturnValue
 @Nonnull
public java.lang.String getStartedKey(java.lang.String... args)

getStatus

@CheckReturnValue
 @Nullable
public DBTaskStatus getStatus(java.lang.String... args)

findStatus

@CheckReturnValue
 @Nonnull
public final DBTaskStatus findStatus(java.lang.String... args)
                                                          throws NotFoundException

The status of this task.

--> DBTaskStatus (String, Derived, Searchable)

Parameters:

args - the optional arguments

Returns:

DBTaskStatus

Throws:

NotFoundException - DBTaskStatus was not found

getSuppressUntil

@CheckReturnValue
 @Nullable
public java.util.Date getSuppressUntil(java.lang.String... args)

setSuppressUntil

@Nonnull
public DBTask setSuppressUntil(java.util.Date value,
                                        java.lang.String... args)
                                 throws java.lang.Exception

Throws:

java.lang.Exception

getTransErrorText

@CheckReturnValue
 @Nonnull
public java.lang.String getTransErrorText(java.lang.String... args)

getTransGroup

@CheckReturnValue
public int getTransGroup(java.lang.String... args)

getTransGroupLayer

@CheckReturnValue
public int getTransGroupLayer(java.lang.String... args)

getType

@CheckReturnValue
 @Nullable
public DBTaskType getType(java.lang.String... args)

findType

@CheckReturnValue
 @Nonnull
public final DBTaskType findType(java.lang.String... args)
                                                      throws NotFoundException

The type of the task.
- per system
- per layer
- per application

--> DBTaskType (String, Mandatory, Searchable)

Parameters:

args - the optional arguments

Returns:

DBTaskType

Throws:

NotFoundException - DBTaskType was not found

setType

@Nonnull
public DBTask setType(com.aspc.dal.task.DBTaskType value,
                               java.lang.String... args)
                        throws java.lang.Exception

Throws:

java.lang.Exception

create

@Nonnull
 @CheckReturnValue
public static DBTask create(@Nonnull
                                                        MutableDataSource mds)
                                                 throws java.lang.Exception

Make a new instance of this class.

Parameters:

mds - the datasource

Returns:

the new record

Throws:

java.lang.Exception - an object of this class could not be created

makeQuery

@Nonnull
 @CheckReturnValue
public static DBQuery<DBTask> makeQuery(@Nonnull
                                                                    DataSource ds)
                                                             throws NotFoundException

Make a new QUERY for this class.

Parameters:

ds - the datasource

Returns:

the new QUERY

Throws:

NotFoundException - if class could not be found

findKey

@Nonnull
 @CheckReturnValue
public static DBTask findKey(@Nonnull
                                                         DataSource ds,
                                                         @Nonnull
                                                         java.lang.String key)
                                                  throws NotFoundException,
                                                         java.lang.Exception

Find the target for this class by the primary key

Parameters:

ds - the datasource

key - the value

Returns:

the target

Throws:

NotFoundException - if target could not be found

java.lang.Exception - a serious problem

getPlugin

public java.lang.Object getPlugin()
                           throws java.lang.Exception

get the task plugin.

Returns:

the plugin or null

Throws:

java.lang.Exception - a serious problem.

error

public void error(java.lang.String message)
           throws java.lang.Exception

sets the task to error.

Parameters:

message - The error message

Throws:

java.lang.Exception - A serious problem

getMode

@CheckReturnValue
 @Nonnull
public java.lang.String getMode(@Nullable
                                                            java.lang.String session_id)

Parameters:

session_id - Session ID for the task

Returns:

Mode

end

public java.lang.String end()
                     throws java.lang.Exception

END the task

Returns:

Mode of the session

Throws:

java.lang.Exception - Serious problem

end

public java.lang.String end(java.lang.String session_id)
                     throws java.lang.Exception

Parameters:

session_id - Session ID

Returns:

Mode of the session

Throws:

java.lang.Exception - A serious problem.

start

public java.lang.String[] start()
                         throws java.lang.Exception

Returns:

list of values session_id, heartbeatduration, enabled flag

Throws:

java.lang.Exception - A serious problem.

start

public java.lang.String[] start(java.lang.String startkey)
                         throws java.lang.Exception

if the task is dead or end return update it to ok and return the transId startKey - Key assigned to start the task.

Parameters:

startkey - Key assigned to start the task.

Returns:

list of values session_id, heartbeatduration, enabled flag result contains 0 - session_id if live, empty if standBy 1 - HeartBeatDuration 2 - Enabled - 3 - mode L - Live, S - Standby, U - unknown 4 - parameters session_id - id used by acquiring process in case of task is already acquired the session_id will be blank hear beat duration - time in which task has to beat otherwise it will be declared dead enabled flag - additional information whether the task is enabled or not.

Throws:

java.lang.Exception - A serious problem.

heartBeat

public void heartBeat()
               throws java.lang.Exception

Heart Beat for this task.

Throws:

java.lang.Exception - A serious problem

makeColor

public java.awt.Color makeColor()

Returns:

Color object

hasTransSyncMap

public boolean hasTransSyncMap()
                        throws java.lang.Exception

Returns:

true if it task has trans sync map

Throws:

java.lang.Exception - A serious problem.

countTransSyncMap

public int countTransSyncMap()
                      throws java.lang.Exception

Returns:

number of TransSyncMap

Throws:

java.lang.Exception - A serious problem.

countLocks

public int countLocks()
               throws java.lang.Exception

counts number of locked transactions

Returns:

number of locked transactions

Throws:

java.lang.Exception - A serious problem.

extPreValidate

@OverridingMethodsMustInvokeSuper
protected void extPreValidate()
                                                         throws java.lang.Exception

Update the in-memory universe BEFORE validating

Overrides:

extPreValidate in class DBObject

Throws:

java.lang.Exception - A serious problem

extValidateRecord

@OverridingMethodsMustInvokeSuper
protected void extValidateRecord(@Nonnull
                                                                   ValidationList list)
                                                            throws java.lang.Exception

Performs additional validations on this record. Only ever called from MutableDataSource.

Overrides:

extValidateRecord in class DBObject

Parameters:

list - The validation list.

Throws:

java.lang.Exception - A serious problem

extGetDerivedValue

@CheckReturnValue
protected java.lang.Object extGetDerivedValue(@Nonnull
                                                                DBField field,
                                                                @Nullable
                                                                FldParams params)
                                                         throws java.lang.Exception

Calculate the derived value for this field.

Overrides:

extGetDerivedValue in class DBObject

Parameters:

field - The field to get

params - The parameters for this field eg. language= or default=

Returns:

The derived value

Throws:

java.lang.Exception - A serious problem

extDeleteRecord

@OverridingMethodsMustInvokeSuper
protected void extDeleteRecord(@Nonnegative
                                                                 long transNr)
                                                          throws java.lang.Exception

Description copied from class: DBObject

OVERRIDE this method to add functionality to stSoftware WHILE deleting the record from the database. At this stage we are within a database transaction. YOU MAY NOT CHANGE THE UNIVERSE AT THIS STAGE.

Overrides:

extDeleteRecord in class DBObject

Parameters:

transNr - Transaction number

Throws:

java.lang.Exception - Serious Problem

extSaveRecord

@OverridingMethodsMustInvokeSuper
protected void extSaveRecord(@Nonnegative
                                                               long transNr)
                                                        throws java.lang.Exception

Additional functionality WHILE saving this record to the database.

Overrides:

extSaveRecord in class DBObject

Parameters:

transNr - This transaction number that was just saved.

Throws:

java.lang.Exception - A serious problem

findOne

public static DBTask findOne(java.lang.String code,
                             DataSource ds)
                      throws java.lang.Exception

used to find the db task

Parameters:

code - - task code

ds - data source

Returns:

a dbTask object

Throws:

java.lang.Exception - if there are more than one DBTasks found

getStatusForKey

public long getStatusForKey(java.lang.String key)
                     throws java.lang.Exception

return the transaction status on the global key, Make sure that key is for this task

Parameters:

key - - is the global key

Returns:

0 is it is OK or transaction id if it is DEAD

Throws:

java.lang.Exception - if the sql error happens

getTransactionErrors

@CheckReturnValue
 @Nonnull
public java.lang.String getTransactionErrors()
                                                                  throws java.lang.Exception

get the errors associated the transactions

Returns:

formatted list of transaction error

Throws:

java.lang.Exception - a Serious problem has occurred