iReasoning TL1 API FAQ

Q. What is iReasoning TL1 library?
A. TL1 (Transaction Language 1) is an ASCII or man-machine management protocol defined by Bellcore. It is used to manage most of the optical, broadband, and access equipment in North America. iReasoning TL1 library is a set of Java based APIs providing complete support for building TL1 management applications. It hides the complexity of TL1 protocol from engineers so they do not have to understand all the details of TL1 protocol. Because many vendors TL1 agents follow telecordia standards loosely, some other vendors TL1 libraries can not manage TL1 agents which have slightly different implementations. iReasoning TL1 library has a flexible architecture which can adapt to different implementations of TL1 agents easily.

Q. Does TL1 library conform to the EJB specification?
A. If asynchronous mode is not used, no thread is created. And EJB specification allows client side socket. So TL1 library conform to the EJB specification. However, if asyncSend method in TL1Session is used, it creates a new thread and violates EJB specification. Asynchronous mode is not recommended to be used in enterprise java beans. TL1 libraries from other vendors create thread no matter which mode to use, they generally do not conform to EJB specification.

Q. How do I get started with this library?
A. First of all, a basic understanding of TL1 and Java is required. User guide (TL1UserGuide.pdf) provides nice introduction and usage examples about this library. Then you can start with example code shipped with this product. Those example code clearly illustrates how to write simple programs to to talk to TL1 agent. Example code is also integrated into javadoc help. So you can read them from browsers. You also need a TL1 agent to test with most of example code. You can run runsimulator.bat (on windows) or (on unix) to start a TL1 simulator listening on port 9000.

Q. How do I run example code?

1. Set up java classpath.
   For example: 
   set classpath=lib\examples.jar;lib\ireasoningtl1.jar
   (on windows, and assuming on a directory a level higher than lib)
2. Run runsimulator.bat (on windows) or (on unix)
3. Run 
   java tl1
   or other example code

Q. What operating systems does iReasoning TL1 library run on ?
A. iReasoning TL1 library is written in Java, so it can run on any OS which has JVM support.