Package com.ibm.di.api.remote

Interface TombstoneManager

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

TombstoneManagerImpl

public interface TombstoneManager
extends java.rmi.Remote

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

Method Summary

Modifier and Type	Method	Description
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, int aDays)	Deletes all tombstones for the specified AssemblyLine that are older than the specified number of days.
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 number of days.
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	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, int aRecentNumberOfTombstones)	Returns the recent n number of tombsones for a 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.
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,
                       java.rmi.RemoteException

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.

java.rmi.RemoteException - if a communication-related exception occurs.

getAssemblyLineTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

getAssemblyLineTombstones

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

Returns the recent n number of tombsones 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 tombsones to be returned.

Returns:

an array of Tombstone objects.

Throws:

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

java.rmi.RemoteException - if a communication-related exception occurs.

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,
                                      java.rmi.RemoteException

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 - peroid 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.

java.rmi.RemoteException - if a communication-related exception occurs.

getConfigInstanceTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

getConfigInstanceTombstones

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

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 - peroid 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.

java.rmi.RemoteException - if a communication-related exception occurs.

getTombstones

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

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

Parameters:

aStartTime - peroid 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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteTombstones

int deleteTombstones(int aDays)
              throws DIException,
                     java.rmi.RemoteException

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.

java.rmi.RemoteException - if a communication-related exception occurs.

keepMostRecentTombstones

int keepMostRecentTombstones(int aMostResentToKeep)
                      throws DIException,
                             java.rmi.RemoteException

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteALTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteALTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteALTombstones

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

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.

olderThan - Date.

Returns:

The number of deleted tombstone records.

Throws:

DIException - if an error occurs while deleting Tombstone records.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteALTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

keepMostRecentALTombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteCITombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteCITombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

keepMostRecentCITombstones

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

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.

java.rmi.RemoteException - if a communication-related exception occurs.

deleteTombstone

boolean deleteTombstone(java.lang.String aGUID)
                 throws DIException,
                        java.rmi.RemoteException

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.

java.rmi.RemoteException - if a communication-related exception occurs.

getConfigInstanceIDs

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

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

java.rmi.RemoteException - if a communication-related exception occurs.

hasTombstones

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

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

java.rmi.RemoteException - if a communication-related exception occurs.

getAssemblyLineNames

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

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

java.rmi.RemoteException - if a communication-related exception occurs.

hasTombstones

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

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

java.rmi.RemoteException - if a communication-related exception occurs.