com.ibm.di.api.jmx.mbeans
Interface SystemLogMBean

All Superinterfaces:

BaseAdminMBean, BaseMBean

All Known Implementing Classes:

SystemLog

public interface SystemLogMBean
extends BaseAdminMBean

This interface provides various methods for getting system log information.

Method Summary

java.lang.String	cleanALLogs(java.lang.String aConfigId, java.lang.String aALName, java.lang.String[] logsToBeDeleted) Deletes all the logs which are specified in " logsToBeDeleted" array.
void	cleanAllOldALLogs(java.util.Date aMinDate) Deletes all AssemblyLines' log files older than the specified date.
void	cleanAllOldALLogs(java.lang.Integer aKeepNum) Deletes all AssemblyLines' log files except those generated on the " aKeepNum" latest runs of all AssemblyLines.
void	cleanAllOldLogs(java.util.Date aMinDate) Deletes all log files older than the specified date.
void	cleanAllOldLogs(java.lang.Integer aKeepNum) Deletes all log files except those generated on the " aKeepNum" latest runs of all components.
java.lang.Boolean	cleanOldALLogs(java.lang.String aConfigId, java.lang.String aALName, java.util.Date aMinDate) Deletes those log files of the specified AssemblyLine, that are older than the specified date.
java.lang.Boolean	cleanOldALLogs(java.lang.String aConfigId, java.lang.String aALName, java.util.Date aMinDate, java.util.Date aMaxDate) Deletes those log files of the specified AssemblyLine, that are older than the specified date.
java.lang.Boolean	cleanOldALLogs(java.lang.String aConfigId, java.lang.String aALName, java.lang.Integer aKeepNum) Deletes all log files of the specified AssemblyLine except those generated on the "aKeepNum" latest AssemblyLine runs.
java.lang.String	getALLastLogFileName(java.lang.String aConfigId, java.lang.String aALName) Returns the name of the log file created on the last run of a given AssemblyLine.
java.lang.String	getALLog(java.lang.String aConfigId, java.lang.String aALName, java.lang.String aLogFileName) Given an AssemblyLine identification, and a log file name, retrieves the log of this AssemblyLine, stored in the specified file.
java.lang.String[]	getALLogFileNames(java.lang.String aConfigId, java.lang.String aALName) Returns the names of all available log files for a given AssemblyLine.
java.lang.String[]	getALLogFileNames(java.lang.String aConfigId, java.lang.String aALName, java.util.Date dDate) Returns the names of all available log files prior to the specified 'date' for a given AssemblyLine.
java.lang.String[]	getALLogFileNames(java.lang.String aConfigId, java.lang.String aALName, java.util.Date startDate, java.util.Date endDate) Returns the names of all available log files prior to the specified 'date' for a given AssemblyLine.
java.lang.String[]	getALLogFileNames(java.lang.String aConfigId, java.lang.String aALName, int n) Returns the names of all 'n' log files for a given AssemblyLine.
java.lang.String	getALLogLastChunk(java.lang.String aConfigId, java.lang.String aALName, java.lang.String aLogFileName, java.lang.Integer aKilobytes) Retrieves the last chunk from a specified AssemblyLine's log file.

Methods inherited from interface com.ibm.di.api.jmx.mbeans.BaseMBean

getId, getType

Method Detail

getALLogFileNames

java.lang.String[] getALLogFileNames(java.lang.String aConfigId,
                                     java.lang.String aALName)
                                     throws DIException

Returns the names of all available log files for a given AssemblyLine.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

Returns:

a String array, each of its elements specifying the name of a log file.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log file names.

getALLogFileNames

java.lang.String[] getALLogFileNames(java.lang.String aConfigId,
                                     java.lang.String aALName,
                                     int n)
                                     throws DIException

Returns the names of all 'n' log files for a given AssemblyLine.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

n - the max number of log files to be returned. If n exceeds the number of available log files then all the log files names are returned.

Returns:

a String array, each of its elements specifying the name of a log file.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log file names.

getALLogFileNames

java.lang.String[] getALLogFileNames(java.lang.String aConfigId,
                                     java.lang.String aALName,
                                     java.util.Date dDate)
                                     throws DIException

Returns the names of all available log files prior to the specified 'date' for a given AssemblyLine.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

dDate - all the log files prior to this date will be listed.

Returns:

a String array, each of its elements specifying the name of a log file.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log file names.

getALLogFileNames

java.lang.String[] getALLogFileNames(java.lang.String aConfigId,
                                     java.lang.String aALName,
                                     java.util.Date startDate,
                                     java.util.Date endDate)
                                     throws DIException

Returns the names of all available log files prior to the specified 'date' for a given AssemblyLine.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

startDate - all the log files after this date will be listed.

endDate - all the log files before this date will be listed.

Returns:

a String array, each of its elements specifying the name of a log file.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log file names.

getALLastLogFileName

java.lang.String getALLastLogFileName(java.lang.String aConfigId,
                                      java.lang.String aALName)
                                      throws DIException

Returns the name of the log file created on the last run of a given AssemblyLine.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

Returns:

the name of the log file created on the last AssemblyLine's run.

Throws:

DIException - if an error occurs while obtaining the log file name.

getALLog

java.lang.String getALLog(java.lang.String aConfigId,
                          java.lang.String aALName,
                          java.lang.String aLogFileName)
                          throws DIException

Given an AssemblyLine identification, and a log file name, retrieves the log of this AssemblyLine, stored in the specified file.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

aLogFileName - the name of the log file; no file path should be specified - just the file name.

Returns:

the specified log of the AssemblyLine.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log.

getALLogLastChunk

java.lang.String getALLogLastChunk(java.lang.String aConfigId,
                                   java.lang.String aALName,
                                   java.lang.String aLogFileName,
                                   java.lang.Integer aKilobytes)
                                   throws DIException

Retrieves the last chunk from a specified AssemblyLine's log file.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine.

aLogFileName - the name of the log file; no file path should be specified - just the file name.

aKilobytes - specifies in kilobytes the size of the log's last chunk that will be read.

Returns:

the last chunk of the specified AssemblyLine's log.

Throws:

DIException - if an error occurs while obtaining AssemblyLine's log.

cleanAllOldLogs

void cleanAllOldLogs(java.util.Date aMinDate)
                     throws DIException

Deletes all log files older than the specified date.

Parameters:

aMinDate - only log files that were last modified before this date will be deleted.

Throws:

DIException - if an error occurs while deleting log files.

cleanAllOldLogs

void cleanAllOldLogs(java.lang.Integer aKeepNum)
                     throws DIException

Deletes all log files except those generated on the " aKeepNum" latest runs of all components.

Parameters:

aKeepNum - specifies the number of the latest log files that should not be deleted; If for example, aKeepNum == 5, for each component only the 5 latest log files will not be deleted.

Throws:

DIException - if an error occurs while deleting log files.

cleanAllOldALLogs

void cleanAllOldALLogs(java.util.Date aMinDate)
                       throws DIException

Deletes all AssemblyLines' log files older than the specified date.

Parameters:

aMinDate - only log files that were last modified before this date will be deleted.

Throws:

DIException - if an error occurs while deleting log files.

cleanAllOldALLogs

void cleanAllOldALLogs(java.lang.Integer aKeepNum)
                       throws DIException

Deletes all AssemblyLines' log files except those generated on the " aKeepNum" latest runs of all AssemblyLines.

Parameters:

aKeepNum - specifies the number of the latest log files that should not be deleted; If for example, aKeepNum == 5, for each AssemblyLine only the 5 latest log files will not be deleted.

Throws:

DIException - if an error occurs while deleting log files.

cleanOldALLogs

java.lang.Boolean cleanOldALLogs(java.lang.String aConfigId,
                                 java.lang.String aALName,
                                 java.util.Date aMinDate)
                                 throws DIException

Deletes those log files of the specified AssemblyLine, that are older than the specified date.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine whose logs will be cleaned up.

aMinDate - only log files that were last modified before this date will be deleted.

Returns:

a Boolean that holds true if the log files were deleted successfully; and null if there is no log folder for the specified AssemblyLine.

Throws:

DIException - if an error occurs while deleting log files.

cleanOldALLogs

java.lang.Boolean cleanOldALLogs(java.lang.String aConfigId,
                                 java.lang.String aALName,
                                 java.util.Date aMinDate,
                                 java.util.Date aMaxDate)
                                 throws DIException

Deletes those log files of the specified AssemblyLine, that are older than the specified date.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine whose logs will be cleaned up.

aMinDate - only log files that were last modified after this date will be deleted.

aMaxDate - only log files that were last modified before this date will be deleted.

Returns:

a Boolean that holds true if the log files were deleted successfully; and null if there is no log folder for the specified AssemblyLine.

Throws:

DIException - if an error occurs while deleting log files.

cleanOldALLogs

java.lang.Boolean cleanOldALLogs(java.lang.String aConfigId,
                                 java.lang.String aALName,
                                 java.lang.Integer aKeepNum)
                                 throws DIException

Deletes all log files of the specified AssemblyLine except those generated on the "aKeepNum" latest AssemblyLine runs.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine whose logs will be cleaned up.

aKeepNum - specifies the number of the latest log files that should not be deleted; If for example, aKeepNum == 5 only the 5 latest AssemblyLine's log files will not be deleted.

Returns:

a Boolean that holds true if the log files were deleted successfully; and null if there is no log folder for the specified AssemblyLine.

Throws:

DIException - if an error occurs while deleting log files.

cleanALLogs

java.lang.String cleanALLogs(java.lang.String aConfigId,
                             java.lang.String aALName,
                             java.lang.String[] logsToBeDeleted)
                             throws DIException

Deletes all the logs which are specified in " logsToBeDeleted" array.

Parameters:

aConfigId - identification of the AssemblyLine's Config Instance.

aALName - the name of the AssemblyLine whose logs will be cleaned up.

logsToBeDeleted - name of the log files which are to be deleted.

Returns:

a Boolean that holds true if the log files were deleted successfully; and null if there is no log folder for the specified AssemblyLine.

Throws:

DIException - if an error occurs while deleting log files.