• System PulseMeter Help
  •  
    Home
    System PulseMeter
    Order
    2010 System Pulse Software (c)
    System PulseMeter Online Downloads Order Contact Us    

    System PulseMeter TCP Connection Test


    TCP Connection Test

    Use the TCP test for monitoring TCP based servers. The TCP test can be used for monitoring Whois, FTP servers, Telnet, Chargen, and other types of servers.

    TCP Connection Test Properties

    "Basic" TCP Connection test properties can be set in the "Test Properties" dialog.

    Specific TCP test properties include:

    • "Host" - monitored host name or IP address.
    • "Port" - number of the port at the monitored host used for listening for incoming TCP packets. It can be 21 for FTP servers, 23 for Telnet servers, 43 for Whois servers, etc.
    • "Timeout" - adjust this value to change timeout of the TCP test. Default TCP connection test timeout is set to 2.000 milliseconds.
    • "Test passes when" -
    • a set of reply type and reply value of the test, considered as successful.
      • "Condition" - condition of the reply can be:
        • "No reply"
        • "Any reply"
        • "Reply is equal to"
        • "Reply isn't equal to"
        • "Reply is greater than" 
        • "Reply is less than"   
        • "Reply contains"
        • "Reply doesn't contain"
      • "Value" - the value returned by the monitored host.
    • "Script" - The script options is used for setting sophisticated data exchange with the monitored server. For example, it can be used for logging to FTP servers, sending passwords, skipping greeting messages from servers, etc. The script always should be started with "Connect" command and finished by "Disconnect" command.

    The available "Script" commands include:

    • Connect - the command connects to a remote server.
    • Send - use "Send" command for sending data to server, including sending login data. All data sent in "Send" command should be double-quoted, for example: Send "User anonymous" . The response from the server can be assigned to the "Reply".
    • Recv - a command for receiving data from remote server containing reply from server. The response from the server can be assigned to the "Reply".
    • Reply - the "Reply" command is used for assigning data received from the server to the test result. The "Reply" command can be equal to "Recv" or to "Send" commands result. The "Reply" command should be followed by a = sign, for example:   Reply = Send "pass%20zzz@website.com"
    • FetchReply - FetchReply command can be used to process the reply to access it's specific fragments. Fetches a string from the reply until the first occurrence of the delimiter and deletes the string and delimiter from the reply. The command can be applied to the result several times, so that any part of returned data can be assigned to the Reply. Delimiter should be specified in double-quotes, for example:
      • FetchReply "," will return 45,10 if Reply is 23,45,10
      • Reply = FetchReply "," will return 23 if Reply is 23,45,10
    • Disconnect - use "Disconnect" command for quitting the connection to server.

    TCP Connection Test Script Examples

    1. Basic script example, that connects to remote server, doesn't send any data to the server and receives the reply. It can be used for connecting to FTP server, obtaining greeting message from the server and setting it as the reply result:
        Connect
        Reply = Recv
        Disconnect
    2. Connects to the FTP server, receives the greeting message, logins as an anonymous user and sets the login result as the reply. After that the script logs out from the FTP server:
        Connect
        Recv
        Send "User anonymous"
        Reply = Send "
      pass%20zzz@website.com"
        Send "Quit"
        Disconnect
    3. This script example connects to a mail server, sends login information and receives the number of letters and their total size, and then processes the received data to return only the number of letters. In case if we remove the "FetchReply" command the test will return both values separated by space, for example, if there are tree letters on a server, and their size is 20000 bytes, the reply will look like: 3 20000 . We can select whether we want to receive letters number or letters size as the result. In case if we apply Reply = FetchReply " " command, the result will be the first value, equal to the number of letters 3. In case if we apply FetchReply " " command, the result will be all the data after the first space in the returned text, in our example it will be the overall letters size 20000:
        Connect
        Recv
        Send "user%20user@mail.com"
        Send "pass%20apwd"
        Reply = Send "stat"
        Reply = FetchReply " "
        Disconnect