com.ibm.di.api.local
Interface TombstoneManager

All Known Implementing Classes:

TombstoneManagerImpl

public interface TombstoneManager

Represents a TombstoneManager instance. Provides various methods to deal with Tombstones.

Method Summary

int	deleteALTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID) Deletes all tombstones for specified AssemblyLine.
int	deleteALTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, java.util.Date olderThan) Deletes all tombstones for the specified AssemblyLine that are older than the specified date.
int	deleteALTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, java.util.Date startDate, java.util.Date endDate) Deletes all tombstones for the specified AssemblyLine that are in the specified Date range.
int	deleteALTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, int aDays) Deletes all tombstones for the specified AssemblyLine that are older than the specified number of days.
int	deleteCITombstones(java.lang.String aConfigID) Deletes all tombstones for specified Config Instance.
int	deleteCITombstones(java.lang.String aConfigID, int aDays) Deletes all tombstones for the specified Config Instance that are older than the specified number of days.
boolean	deleteTombstone(java.lang.String aGUID) Deletes the tombstone with the specified GUID.
int	deleteTombstones(int aDays) Deletes all tombstones that are older than the specified number of days.
java.util.List<java.lang.String>	getAssemblyLineNames(java.lang.String configInstanceId) Obtains a list of AssemblyLine Names of the AssemblyLines for which a tombstone has been created.
Tombstone[]	getAssemblyLineTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID) Returns all available tombstones for the specified AssemblyLine.
Tombstone[]	getAssemblyLineTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, java.util.Date aStartTime, java.util.Date aEndTime) Returns all available tombstones for the specified AssemblyLine with timestamps in the interval specified by aStartTime and aEndTime.
Tombstone[]	getAssemblyLineTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, int aRecentNumberOfTombstones) Returns the recent n number of tombstones for a specified AssemblyLine.
java.util.List<java.lang.String>	getConfigInstanceIDs() Obtains a list of IDs of configInstances for which a tombstone has been created.
Tombstone[]	getConfigInstanceTombstones(java.lang.String aConfigID) Returns all available tombstones for the specified Config Instance.
Tombstone[]	getConfigInstanceTombstones(java.lang.String aConfigID, java.util.Date aStartTime, java.util.Date aEndTime) Returns all available tombstones for the specified Config Instance with timestamps in the interval specified by aStartTime and aEndTime.
Tombstone	getTombstone(java.lang.String aGUID) Returns a single tombstone object uniquely identified by the specified GUID.
Tombstone[]	getTombstones(java.util.Date aStartTime, java.util.Date aEndTime) Returns all available tombstones with timestamps in the interval specified by aStartTime and aEndTime.
boolean	hasTombstones(java.lang.String configInstanceId) Checks whether there are tombstone records for a configInstance with the specified ID.
boolean	hasTombstones(java.lang.String configInstanceId, java.lang.String alName) Checks whether there are tombstone records for an AssemblyLine with the specified name.
int	keepMostRecentALTombstones(java.lang.String aAssemblyLineName, java.lang.String aConfigID, int aMostResentToKeep) After this method is executed only the aMostRecentToKeep most recent tombstone records for the specified AssemblyLine are kept and all other are deleted.
int	keepMostRecentCITombstones(java.lang.String aConfigID, int aMostResentToKeep) After this method is executed only the aMostRecentToKeep most recent tombstone records for the specified Config Instance are kept and all other are deleted.
int	keepMostRecentTombstones(int aMostResentToKeep) After this method is executed only the aMostRecentToKeep most recent tombstone records are kept and all other are deleted.

Method Detail

getTombstone

Tombstone getTombstone(java.lang.String aGUID)
                       throws DIException

Returns a single tombstone object uniquely identified by the specified GUID.

Parameters:

aGUID - Tombstone GUID.

Returns:

the Tombstone object.

Throws:

DIException - if an error occurs while getting the Tombstone object.

getAssemblyLineTombstones

Tombstone[] getAssemblyLineTombstones(java.lang.String aAssemblyLineName,
                                      java.lang.String aConfigID)
                                      throws DIException

Returns all available tombstones for the specified AssemblyLine.

Parameters:

aAssemblyLineName - The name of the AssemblyLine.

aConfigID - The name of the AssmeblyLine's configuration.

Returns:

an array of Tombstone objects.

Throws:

DIException - if an error occurs while getting the Tombstone objects.

getAssemblyLineTombstones

Tombstone[] getAssemblyLineTombstones(java.lang.String aAssemblyLineName,
                                      java.lang.String aConfigID,
                                      int aRecentNumberOfTombstones)
                                      throws DIException

Returns the recent n number of tombstones for a specified AssemblyLine.

Parameters:

aAssemblyLineName - The name of the AssemblyLine.

aConfigID - The name of the AssmeblyLine's configuration.

aRecentNumberOfTombstones - The recent n number of tombstones to be returned.

Returns:

an array of Tombstone objects.

Throws:

DIException

Since:

6.1.1

getAssemblyLineTombstones

Tombstone[] getAssemblyLineTombstones(java.lang.String aAssemblyLineName,
                                      java.lang.String aConfigID,
                                      java.util.Date aStartTime,
                                      java.util.Date aEndTime)
                                      throws DIException

Returns all available tombstones for the specified AssemblyLine with timestamps in the interval specified by aStartTime and aEndTime.

Parameters:

aAssemblyLineName - The name of the AssemblyLine.

aConfigID - The name of the AssmeblyLine's configuration.

aStartTime - period start time.

aEndTime - period end time.

Returns:

an array of Tombstone objects.

Throws:

DIException - if an error occurs while getting the Tombstone objects for the specified AssemblyLine.

getConfigInstanceTombstones

Tombstone[] getConfigInstanceTombstones(java.lang.String aConfigID)
                                        throws DIException

Returns all available tombstones for the specified Config Instance.

Parameters:

aConfigID - The configuration name.

Returns:

an array of Tombstone objects.

Throws:

DIException - if an error occurs while getting the Tombstone objects for the specified Config Instance.

getConfigInstanceTombstones

Tombstone[] getConfigInstanceTombstones(java.lang.String aConfigID,
                                        java.util.Date aStartTime,
                                        java.util.Date aEndTime)
                                        throws DIException

Returns all available tombstones for the specified Config Instance with timestamps in the interval specified by aStartTime and aEndTime.

Parameters:

aConfigID - The configuration name.

aStartTime - period start time.

aEndTime - period end time.

Returns:

an array of Tombstone objects.

Throws:

DIException - if an error occurs while getting the Tombstone objects for the specified Config Instance.

getTombstones

Tombstone[] getTombstones(java.util.Date aStartTime,
                          java.util.Date aEndTime)
                          throws DIException

Returns all available tombstones with timestamps in the interval specified by aStartTime and aEndTime.

Parameters:

aStartTime - period start time.

aEndTime - period end time.

Returns:

an array of Tombstone objects.

Throws:

DIException - if an error occurs while getting the Tombstone objects for the specified interval.

deleteTombstones

int deleteTombstones(int aDays)
                     throws DIException

Deletes all tombstones that are older than the specified number of days.

Parameters:

aDays - Number of days.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

keepMostRecentTombstones

int keepMostRecentTombstones(int aMostResentToKeep)
                             throws DIException

After this method is executed only the aMostRecentToKeep most recent tombstone records are kept and all other are deleted.

Parameters:

aMostResentToKeep - number of most recent tombstones to keep.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteALTombstones

int deleteALTombstones(java.lang.String aAssemblyLineName,
                       java.lang.String aConfigID)
                       throws DIException

Deletes all tombstones for specified AssemblyLine.

Parameters:

aAssemblyLineName - The AssemblyLine name.

aConfigID - The AssemblyLine's configuration name.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteALTombstones

int deleteALTombstones(java.lang.String aAssemblyLineName,
                       java.lang.String aConfigID,
                       int aDays)
                       throws DIException

Deletes all tombstones for the specified AssemblyLine that are older than the specified number of days.

Parameters:

aAssemblyLineName - The AssemblyLine name.

aConfigID - The AssemblyLine's configuration name.

aDays - Number of days.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteALTombstones

int deleteALTombstones(java.lang.String aAssemblyLineName,
                       java.lang.String aConfigID,
                       java.util.Date olderThan)
                       throws DIException

Deletes all tombstones for the specified AssemblyLine that are older than the specified date.

Parameters:

aAssemblyLineName - The AssemblyLine name.

aConfigID - The AssemblyLine's configuration name.

olderThan - Date.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteALTombstones

int deleteALTombstones(java.lang.String aAssemblyLineName,
                       java.lang.String aConfigID,
                       java.util.Date startDate,
                       java.util.Date endDate)
                       throws DIException

Deletes all tombstones for the specified AssemblyLine that are in the specified Date range.

Parameters:

aAssemblyLineName - The AssemblyLine name.

aConfigID - The AssemblyLine's configuration name.

startDate - Date.

endDate - Date.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

keepMostRecentALTombstones

int keepMostRecentALTombstones(java.lang.String aAssemblyLineName,
                               java.lang.String aConfigID,
                               int aMostResentToKeep)
                               throws DIException

After this method is executed only the aMostRecentToKeep most recent tombstone records for the specified AssemblyLine are kept and all other are deleted.

Parameters:

aAssemblyLineName - The AssemblyLine name.

aConfigID - The AssemblyLine's configuration name.

aMostResentToKeep - Number of most recent tombstones to keep.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteCITombstones

int deleteCITombstones(java.lang.String aConfigID)
                       throws DIException

Deletes all tombstones for specified Config Instance.

Parameters:

aConfigID - Configuration name.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteCITombstones

int deleteCITombstones(java.lang.String aConfigID,
                       int aDays)
                       throws DIException

Deletes all tombstones for the specified Config Instance that are older than the specified number of days.

Parameters:

aConfigID - Configuration name.

aDays - Number of days.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

keepMostRecentCITombstones

int keepMostRecentCITombstones(java.lang.String aConfigID,
                               int aMostResentToKeep)
                               throws DIException

After this method is executed only the aMostRecentToKeep most recent tombstone records for the specified Config Instance are kept and all other are deleted.

Parameters:

aConfigID - Configuration name.

aMostResentToKeep - Number of most recent tombstones to keep.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

deleteTombstone

boolean deleteTombstone(java.lang.String aGUID)
                        throws DIException

Deletes the tombstone with the specified GUID.

Parameters:

aGUID - Tombstone GUID.

Returns:

true only when the tombstone object with the specified GUID is found and deleted.

Throws:

DIException - if an error occurs while deleting Tombstone record.

getConfigInstanceIDs

java.util.List<java.lang.String> getConfigInstanceIDs()
                                                      throws DIException

Obtains a list of IDs of configInstances for which a tombstone has been created.

Returns:

the list of configInstance IDs.

Throws:

DIException - if error occurs while obtaining the Config IDs

hasTombstones

boolean hasTombstones(java.lang.String configInstanceId)
                      throws DIException

Checks whether there are tombstone records for a configInstance with the specified ID.

Returns:

true if the configInstance has tombstones, false otherwise

Throws:

DIException - if error occurs while obtaining the Config IDs

getAssemblyLineNames

java.util.List<java.lang.String> getAssemblyLineNames(java.lang.String configInstanceId)
                                                      throws DIException

Obtains a list of AssemblyLine Names of the AssemblyLines for which a tombstone has been created.

Returns:

the list of configInstance IDs.

Throws:

DIException - if error occurs while obtaining the AL names

hasTombstones

boolean hasTombstones(java.lang.String configInstanceId,
                      java.lang.String alName)
                      throws DIException

Checks whether there are tombstone records for an AssemblyLine with the specified name.

Returns:

true if the AssemblyLine has tombstones, false otherwise

Throws:

DIException - if error occurs while obtaining the Config IDs