com.ibm.di.api.local
Interface AssemblyLine

All Known Implementing Classes:
AssemblyLineImpl

public interface AssemblyLine

Represents an AssemblyLine instance.


Method Summary
 AssemblyLineConfig getConfig()
          Returns configuration information about the AssemblyLine.
 ConfigInstance getConfigInstance()
          Returns the configuration instance of the AssemblyLine.
 String getGlobalUniqueID()
          Returns AssemblyLine GUID.
 String getName()
          Returns the name of the AssemblyLine.
 String getNullBehavior()
          Gets the nullBehavior attribute of the AssemblyLine object
 String getNullBehaviorValue()
          Gets the nullBehaviorValue attribute of the AssemblyLine object.
 Entry getResult()
          This method returns the result entry object.
 TaskStatistics getStatistics()
          This method returns the TaskStatistics object for this AssemblyLine.
 String getSystemLog()
          Retrieves the current AssemblyLine's system log.
 String getSystemLogFileName()
          Returns the name of the log file of the AssemblyLine (not prefixed by folders path).
 String getSystemLogFilePath()
          Returns the fully-qualified path of the log file of the AssemblyLine.
 String getSystemLogLastChunk(int aLastKilobytes)
          Retrieves the last chunk from the current AssemblyLine's system log.
 int getUniqueCode()
          Returns the unique code of the AssemblyLine.
 boolean isActive()
          Checks if the AssemblyLine is active.
 void stop()
          Stops the execution of the AssemblyLine.
 

Method Detail

getConfigInstance

ConfigInstance getConfigInstance()
                                 throws DIException
Returns the configuration instance of the AssemblyLine.

Returns:
Returns ConfigInstance object representing the configuration instance of the AssemblyLine.
Throws:
DIException - if an error occurs while retrieving the configuration instance information.

getName

String getName()
               throws DIException
Returns the name of the AssemblyLine.

Returns:
String object representing the AssemblyLine’s name.
Throws:
DIException - if an error occurs while retrieving the name of the AssemblyLine.

getUniqueCode

int getUniqueCode()
                  throws DIException
Returns the unique code of the AssemblyLine.

Returns:
int value representing the unique code of the AssemblyLine.
Throws:
DIException - if an error occurs while retrieving the unique code of the AssemblyLine.

getConfig

AssemblyLineConfig getConfig()
                             throws DIException
Returns configuration information about the AssemblyLine.

Returns:
AssemblyLineConfig representing the configuration information of the AssemblyLine.
Throws:
DIException - if an error occurs while retrieving the configuration information of the AssemblyLine.

getNullBehavior

String getNullBehavior()
                       throws DIException
Gets the nullBehavior attribute of the AssemblyLine object

Returns:
String object representing the nullBehavior attribute value or null if no setting values are available for the AssemblyLine.
Throws:
DIException - if an error occurs while getting the nullBehavior attribute.

getNullBehaviorValue

String getNullBehaviorValue()
                            throws DIException
Gets the nullBehaviorValue attribute of the AssemblyLine object.

Returns:
String object representing the nullBehaviorValue attribute value or null if no setting values are available for the AssemblyLine.
Throws:
DIException - if an error occurs while getting the nullBehaviorValue attribute.

getStatistics

TaskStatistics getStatistics()
                             throws DIException
This method returns the TaskStatistics object for this AssemblyLine.

Returns:
The accumulated TaskStatistics object.
Throws:
DIException - if an error occurs while getting the AssemblyLine statistics.

isActive

boolean isActive()
                 throws DIException
Checks if the AssemblyLine is active.

Returns:
true if the AssemblyLine’s thread is alive, false otherwise.
Throws:
DIException - if an error occurs while getting the AssemblyLine state.

getResult

Entry getResult()
                throws DIException
This method returns the result entry object. This object is a copy of the working entry as it were when the AssemblyLine finished processing the connectors.

Returns:
The last "work" entry object.
Throws:
DIException - if an error occurs while getting the result Entry.

stop

void stop()
          throws DIException
Stops the execution of the AssemblyLine.

Throws:
DIException - if an error occurs while stopping the AssemblyLine.

getSystemLogFilePath

String getSystemLogFilePath()
                            throws DIException
Returns the fully-qualified path of the log file of the AssemblyLine.

Returns:
the fully-qualified log file path.
Throws:
DIException - if an error occurs while obtaining AssemblyLine log file path.

getSystemLogFileName

String getSystemLogFileName()
                            throws DIException
Returns the name of the log file of the AssemblyLine (not prefixed by folders path).

Returns:
the log file name.
Throws:
DIException - if an error occurs while obtaining AssemblyLine log file name.

getSystemLog

String getSystemLog()
                    throws DIException
Retrieves the current AssemblyLine's system log.

Returns:
the log generated by the AssemblyLine so far.
Throws:
DIException - if an error occurs while obtaining AssemblyLine's log.

getSystemLogLastChunk

String getSystemLogLastChunk(int aLastKilobytes)
                             throws DIException
Retrieves the last chunk from the current AssemblyLine's system log.

Parameters:
aLastKilobytes - Specifies in kilobytes the size of the log's last chunk that will be read.
Returns:
the last chunk of the AssemblyLine's log, generated so far.
Throws:
DIException - if an error occurs while obtaining AssemblyLine's log.

getGlobalUniqueID

String getGlobalUniqueID()
                         throws DIException
Returns AssemblyLine GUID. The GUID is a string value that is unique for each component ever created by a particular TDI Server.

Returns:
The AssemblyLine GUID value.
Throws:
DIException - if an error occurs while obtaining the GUID.