|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface AssemblyLine
Represents an AssemblyLine instance.
Method Summary | |
---|---|
void |
addListener(AssemblyLineListener listener,
boolean getLogs,
boolean getEntryOnEachCycle)
Register a listener for AssemblyLine events. |
void |
attachDebugger(int port,
String host,
boolean onerror)
Attach a debugger to the AssemblyLine. |
void |
detachDebugger(Object msg)
Detach the current debugger from the AssemblyLine. |
boolean |
getComponentDebugMode(String componentName)
Query the debug mode setting of the specified component (Connector or Function Component). |
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. |
boolean |
isSimulating()
Check whether the AssemblyLine is simulating or not |
void |
removeListener(AssemblyLineListener listener)
Unregister a listener for AssemblyLine events. |
void |
setComponentDebugMode(String componentName,
boolean debug)
Modify the debug mode setting of the specified component (Connector or Function Component). |
void |
setSimulating(boolean simulate)
Changes the way the AssemblyLine treats the target systems it is connecting/interacting to/with. |
void |
stop()
Stops the execution of the AssemblyLine. |
void |
stop(boolean sync)
Stops the execution of the AssemblyLine, and waits for it to stop. |
Method Detail |
---|
ConfigInstance getConfigInstance() throws DIException
Example
var mAssemblyLine = session.getAssemblyLines()[0]; var mConfigInstance = mAssemblyLine.getConfigInstance(); var configId = mConfigInstance.getConfigId(); var aAssemblyLineName = "AssemblyLine"; var assemblyLine = mConfigInstance.startAssemblyLine(aAssemblyLineName); var objectName = com.ibm.di.api.jmx.mbeans.AssemblyLine.genObjectName(assemblyLine.getName(), assemblyLine.getUniqueCode());
DIException
- if an error occurs while retrieving the configuration
instance information.String getName() throws DIException
Example
var mAssemblyLine = session.getAssemblyLines()[0]; var mConfigInstance = mAssemblyLine.getConfigInstance(); var configId = mConfigInstance.getConfigId(); var aAssemblyLineName = "AssemblyLine"; var assemblyLine = mConfigInstance.startAssemblyLine(aAssemblyLineName); var objectName = com.ibm.di.api.jmx.mbeans.AssemblyLine.genObjectName(assemblyLine.getName(), assemblyLine.getUniqueCode());
DIException
- if an error occurs while retrieving the name of the
AssemblyLine.int getUniqueCode() throws DIException
Example
var mAssemblyLine = session.getAssemblyLines()[0]; var mConfigInstance = mAssemblyLine.getConfigInstance(); var configId = mConfigInstance.getConfigId(); var aAssemblyLineName = "AssemblyLine"; var assemblyLine = mConfigInstance.startAssemblyLine(aAssemblyLineName); var objectName = com.ibm.di.api.jmx.mbeans.AssemblyLine.genObjectName(assemblyLine.getName(), assemblyLine.getUniqueCode());
DIException
- if an error occurs while retrieving the unique code of the
AssemblyLine.AssemblyLineConfig getConfig() throws DIException
DIException
- if an error occurs while retrieving the configuration
information of the AssemblyLine.String getNullBehavior() throws DIException
DIException
- if an error occurs while getting the nullBehavior attribute.String getNullBehaviorValue() throws DIException
DIException
- if an error occurs while getting the nullBehaviorValue
attribute.TaskStatistics getStatistics() throws DIException
Example
var runningALs = null; var stats = null; var result = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); result = runningALs[j].getResult(); var attr = new com.ibm.di.entry.Attribute("LogURL", "/log/" + runningALs[j].getGlobalUniqueID()); runningALs[j].stop(); } } }
DIException
- if an error occurs while getting the AssemblyLine statistics.boolean isActive() throws DIException
Example
var runningALs = null; var stats = null; var result = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); result = runningALs[j].getResult(); var attr = new com.ibm.di.entry.Attribute("LogURL", "/log/" + runningALs[j].getGlobalUniqueID()); runningALs[j].stop(); } } }
DIException
- if an error occurs while getting the AssemblyLine state.Entry getResult() throws DIException
Example
var runningALs = null; var stats = null; var result = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); result = runningALs[j].getResult(); var attr = new com.ibm.di.entry.Attribute("LogURL", "/log/" + runningALs[j].getGlobalUniqueID()); runningALs[j].stop(); } } }
DIException
- if an error occurs while getting the result Entry.void stop() throws DIException
Example
var runningALs = null; var stats = null; var result = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); result = runningALs[j].getResult(); var attr = new com.ibm.di.entry.Attribute("LogURL", "/log/" + runningALs[j].getGlobalUniqueID()); runningALs[j].stop(); } } }
DIException
- if an error occurs while stopping the AssemblyLine.void stop(boolean sync) throws DIException
Example
var stats = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { var runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { main.logmsg("Stopping [" + j + "]: " + runningALs[j].getName()); runningALs[j].stop(false); stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); } } }
sync
- If true, create a new Thread to do the waiting.
DIException
- if an error occurs while stopping the AssemblyLine.String getSystemLogFilePath() throws DIException
DIException
- if an error occurs while obtaining AssemblyLine log file
path.String getSystemLogFileName() throws DIException
DIException
- if an error occurs while obtaining AssemblyLine log file
name.String getSystemLog() throws DIException
DIException
- if an error occurs while obtaining AssemblyLine's log.String getSystemLogLastChunk(int aLastKilobytes) throws DIException
aLastKilobytes
- Specifies in kilobytes the size of the log's last chunk that
will be read.
DIException
- if an error occurs while obtaining AssemblyLine's log.String getGlobalUniqueID() throws DIException
Example
var runningALs = null; var stats = null; var result = null; var runningConfigs = session.getConfigInstances(); for (var i = 0; i < runningConfigs.length; i++) { runningALs = runningConfigs[i].getAssemblyLines(); for (var j = 0; j < runningALs.length; j++) { if (runningALs[j].isActive()) { stats = runningALs[j].getStatistics().toString(); main.logmsg("statistics[" + j + "] = " + stats); result = runningALs[j].getResult(); var attr = new com.ibm.di.entry.Attribute("LogURL", "/log/" + runningALs[j].getGlobalUniqueID()); runningALs[j].stop(); } } }
DIException
- if an error occurs while obtaining the AssemblyLine GUID
value.boolean isSimulating() throws DIException
DIException
- if an error occurs while obtaining the simulation statevoid setSimulating(boolean simulate) throws DIException
simulate
- true switches the simulation on, false switches it off
DIException
- if an error occurs while changing the simulation statevoid addListener(AssemblyLineListener listener, boolean getLogs, boolean getEntryOnEachCycle) throws DIException
listener
- Listener for AssemblyLine events.getLogs
- If true, the listener will receive logged messages.getEntryOnEachCycle
- If true the listener will receive the current entry at each
AssemblyLine cycle's end.
DIException
- If the listener cannot be registered.removeListener(AssemblyLineListener)
void removeListener(AssemblyLineListener listener) throws DIException
Unregister a listener for AssemblyLine events. You must be admin to
execute this method. Listeners are associated with the API object, not
with the AssemblyLine in the Server, so you can remove only listeners
added with the #addListener(AssemblyLineListener, boolean)
method
on the same object.
Beware that the listener may get notified one more time after it was unregistered. The only way to ensure this does not happen is to unregister the listener in one of its callback methods.
listener
- The listener that needs to be removed.
DIException
- If the listener cannot be unregistered.#addListener(AssemblyLineListener, boolean)
void attachDebugger(int port, String host, boolean onerror) throws DIException
port
- Port of the debugger.host
- Host of the debugger.onerror
- If true breakpoints are disabled except when there is an
error.
DIException
- If the AssemblyLine is already being debugged or the
AssemblyLine cannot connect to the debugger.void detachDebugger(Object msg) throws DIException
msg
- This object will be sent to the debugger before the detaching
occurs. Must be serializable. If null, nothing will be sent.
DIException
- If an error occurs while detaching the debugger.boolean getComponentDebugMode(String componentName) throws DIException
getConfig()
.
componentName
- The name of a Connector or a Function Component from this
AssemblyLine. Must be spelled exactly as it appears in the
configuration.
DIException
- If an error occurs while querying the debug mode.void setComponentDebugMode(String componentName, boolean debug) throws DIException
getConfig()
. If you run the same AssemblyLine
again it will use the settings from the configuration.
componentName
- The name of a Connector or a Function Component from this
AssemblyLine.debug
- The new debug mode of the component.
DIException
- If an error occurs while setting the debug mode.getComponentDebugMode(String)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |