|
|
7.1 Testing a TL1 Agent Using TL1 Browser
7.2 Configuring TL1 Browser Settings
7.3.Debugging and Decoding in TL1 Browser
7.1 Testing a TL1 Agent Using TL1 Browser
Follow the steps given below to test the TL1 Agent created in the previous chapter. It is assumed that a Standalone TL1 Agent created using tl1sample.tcs is running on port 9099.
Start the TL1 Browser Application using the TL1Browser.bat or TL1Browser.sh file from the <Agent Toolkit Home>/bin directory. It can also be started from the launcher.
Load the tl1sample.tcs and tl1security.tcs files using the File>>Load option in the menu bar. Also load the tl1sample.dat file.
Choose Operations>>Connect option in the MenuBar.
Enter the Host Name and Port Number where the agent is running in the dialog box that appears. Default values are "localhost" and "9099" respectively.
Click OK. Now you will be connected to the Agent.
Authenticate into the TL1 Agent by sending the
Input command "ACT-USER::root:1::public;"
by choosing Operations>>Send in the menu bar or using the shortcut
key CTRL+N. Here root is the default Administrator and public is the default
password.
The Agent will respond by sending the following Autonomous Message. This
can be viewed in the Autonomous Message Block. This means that you have
successfully authenticated into the TL1 Agent.
Autonomous Message Received From :localhost
<CR>
<LF><LF> rajeshm 2002-04-11 12:22:25<CR>
<LF> ** 1 REPT EVT SESSION<CR>
<LF> "rajeshm:NO"<CR>
<LF> /*NOTICE:This is a private computer system. <LF>
Unauthorized access or use
may lead to prosecution*/<CR>
<LF>;
Please note that a Response Message will also be sent for the ACT-USER
command. You can view the Response Message in the Response Message Block
of the TL1 Browser
Now expand the TCS tree of tl1sample.tcs.
Choose the command code RD-MEM
Send the input message RD-MEM:::1::; by choosing
Operations>>Send option in the menu bar or using the shortcut
key CTRL+N.
The Agent will send the following response message.
Response Message Received From :localhost
<CR>
<LF><LF> rajeshm 2002-04-11 12:40:55<CR>
<LF>M 3 COMPLD<CR>
<LF> "0,1"<CR>
<LF>;
This means that your simple TL1 Agent works!
7.2 Configuring TL1 Browser Settings
From the menu bar select Edit >> Settings. Here you will find different functions that can be enabled or disabled in the TL1 Browser Application.
The configuration settings for TL1Browser can classified into two parts based on their functionality.
General Options.
Parser Options.
General Options
Enable Keep Alive : TL1 Browser provides the facility to check for the health status of the TL1 device by sending TL1 messages at regular time intervals to the device. You have the option to change the input message to be sent and the time interval between subsequent messages. The time interval is calculated in seconds.
Enable Log : This is an option from the TL1 Browser to create log files (session log and bin files) that can be used for debugging purposes. The bin file can be opened in the debug window of the TL1 Browser to check for the messages exchanged between the TL1 Browser and the TL1 agent.
Connection Listener: If this is enabled, you will be notified as soon as the connection with the TL1 Agent breaks after opening a session with it from the TL1 Browser.
Timeout and Retries : Here you can set the timeout time for receiving the response for an input message. If the response for an input message is not received before the timeout value, an error is displayed. Number of retries can also be specified here.
Parser Options
Appending CR/LF : TL1 Browser has the option of appending CR/LF in the output message received.
Text Block Parsing : If this flag is enabled the browser will parse the text block in the TL1 message. If the flag is disabled, the browser will parse all fields in the response message other than the text block. The text block will be printed as a raw data.
Message Parsing : If this flag is enabled, the browser will parse the whole TL1 message. If disabled, the browser does not parse the TL1 message and prints the raw data received from the agent.
Accumulate Partial Messages : If this flag is enabled, partial messages received from the device will be accumulated and complete TL1 message will be printed on the arrival of last TL1 message (terminated by semicolon) with the same C-Tag. By disabling this flag, we can receive partial messages (terminated by >) in the TL1 Browser.
7.3 Debugging and Decoding in TL1 Browser
Debug window can be used to check the messages exchanged between the TL1 Browser and agent. To check for messages exchanged, you have to open the debug window before sending messages in order to view the messages in binary format. There is an option of saving the messages in a file. The user also has the facility to decode the messages. Clear button is provided to clear the results.
To decode the binary messages, one has to copy the message and paste it in the text area of the decoder window. Clicking the decode button will print the TL1 message in the text area. There is a option of saving the results in a file.
|
|