User Manual

Version 2.00

06/05/06

Copyright (C) 2006

All rights reserved
 
 
 
 
 
 
 
 
 

Kadtronix
web: www.kadtronix.com
email: info@kadtronix.com


 
 

Table of Contents

  1. Introduction
    1.  
      1. System Requirements
      2. Email Client Compatibility
      3. Features
      4. Ordering
      5. Installation

      6.  
  2. Program Operation
    1.  
    2. Message List
    3. List Filter
    4. Clock
    5. Convenience Buttons
    6. Create Message
    7. Macro Strings
    8. Settings
      1.  
      2. Selections
      3. Text Coloring
      4. List Filtering
      5. Email Properties
         
  1. Legal
    1. License
    2. Warranty

    3.  
 




 
 
  1. Introduction

  2. Kadtronix SMS (KSMS) is a message notification tool for contacting individuals quickly and easily using SMS (short message service) technology.  KSMS puts you in easy reach using SMS text messages, utilized by most cell phones.  Maximize your daily effort by minimizing time on the telephone.  Customer- and patient-oriented service personnel can reduce countless hours spent on the telephone with clients.  While phone conversations are necessary, many times a simple text message notification is all that is required.  KSMS saves time and effort by quickly and effortlessly delivering those messages to client's existing cell phone as SMS text-messages.  To contact a client, all that is required is a cell-phone number and a brief message.  No more unanswered calls, busy signals, or  time-consuming voice mails.  Just type a brief message and send it:
     
      "J.Smith, your prescription is ready for pickup."
     
    Send text messages to customers, visitors, patients, vendors, etc. with just a few easy clicks of the mouse.  Send reminders, requests, appointment confirmations, instructions, etc.  KSMS can be used in a number of venues.  Hospitals will find it invaluable for contacting patient family.  Businesses can contact employees, stores can quickly reach customers, and schools can contact parents.  KSMS is useful in these venues and more:
     
  3. Hospitals
  4. Businesses
  5. Clinics
  6. Offices
  7. Stores
  8. Schools
  9. Colleges
    1.  
    KSMS seamlessly integrates with popular e-mail client programs including Microsoft Outlook.
     
    1. System Requirements
    2. KSMS requires a Windows laptop or desktop PC with the following minimum capabilities:
       
    3. Pentium CPU
    4. 8 MB RAM
    5. 1 MB Available Hard Disk Space
    6. VGA Monitor
    7. Windows 98/2000/XP

    8.  
    9. Email Client Compatibility

    10. A SMTP/POP3 compatible Email program is required such as:
       
    11. Microsoft Outlook
    12. Eudora (Lite & Pro)
    13. Pegasus
    14. Calypso
    15. PM Mail 98
    16. Actif Mail
    17. Lotus Notes
    18. Netscape

    19.  
    20. Features

    21. KSMS features include the following:
         
    22. Send quick-access text messages anytime
    23. Specify SMS text- and/or e-mail messages
    24. Can be used with most SMS-to-Email gateway providers
    25. Compatible with popular e-mail client applications
    26. Configurable settings

    27.  
      Note:  KSMS is used for sending messages only.  It does not receive messages.
       
    28. Ordering

    29. KSMS is available at the following source:

          Kadtronix
          web: http://www.kadtronix.com
          email: sales@kadtronix.com
       

    30. Installation

    31. Before installing the application, you may need to uninstall any earlier version.   To start the installation process, locate and run  the self-extracting setup file (setup.exe) on the install media.
     
  10. Program Operation

  11. Activate the program by selecting:
     
      Start Menu -> Programs -> Kadtronix SMS


    When the program begins, the main display dialog appears as shown below:




     

    1. Message List

    2. The dialog consists of several regions including message list, list filter, clock, and convenience buttons.  The message list displays messages that have been created.
       



      You may specify optional text coloring for visual message status.  For instance, green may be used to indicate messages that have been successfully sent.  Blue may indicate messages that have been created, but not yet sent.  And red can be used to indicate messages which failed during the send attempt.  Use program settings to change these assignments if desired.  The bottom of the list region contains several items of interest.  The "Messages" field indicates the total number of messages being displayed in the message list.  Note that this is not necessarily the total number of available messages.  (Refer to the list filtering for more information.)
       


      Use the "Delete" button to permanently remove a message.  The button remains disabled (grayed) until a message is selected (highlighted) in the message list.  The check box at the right titled, "Detailed View" allows you to choose the amount of information to display in the message list.  When checked, all available record fields will be shown.  (Use the horizontal scroll bar to see hidden fields.)  When unchecked, only a subset of fields will be displayed.
       
       

    3. List Filter

    4. The list filter allows you to select a range of created messages based on a specified date range.  This is useful in limiting the number of messages to display in the message list.  Any messages that were created within the specified range will be shown, while all others will be hidden.  There are four available filter range selections:  None,  1 day, 1 week, or 1 month. (Refer to program settings for details.)  You may adjust the range by left-clicking on the "Date Start:" and/or "Date End:" controls.  You may also select a default range using the program settings.
       


    5. Clock

    6. The clock region shows a digital time and date display.  The time and date are shown in a LCD-like format.  They are also given in standard text format.
       


    7. Convenience Buttons

    8. KSMS also provides convenience buttons as shown below:
       


      The "Exit" button terminates the application, saving any changed settings.  The "Message..." button allows you to create and/or edit messages to send.
       

    9. Create Message

    10. The "Message..." button allows you to create new messages and/or modify a previously created message.  To modify a message, you must first left-click select it from the message list.  Then, click the "Message..." button to invoke the following dialog:
       



      There are several regions including identification, send-to, message, and buttons.  Enter the requested parameters in the fields as shown.  Field values must be properly entered to allow KSMS software to send SMS text and/or e-mail messages.  A valid e-mail account is required.   If necessary, consult your network administrator for assistance.  The identification region provides fields for entering the recipient's name.
       


      The "Send To:" region provides a message type selector:  SMS text message or standard e-mail.  To specify a text message, left-click the "Text Msg:" specifier.  This will enable a field for entering a 10-digit cell-phone number.  To specify an e-mail address instead, left-click the "E-Mail:" specifier to enable a field for entering an e-mail address.
       


      The next region allows the entry of a message subject and body.  If desired, these fields may be pre-populated.  (Refer to Email Properties for more information.)
       



    11. Macros

    12. Use the <M>... (macro) buttons to enter optional macro strings.   Macros are special string fields that are to be replaced with actual data when the message is sent.  They are especially useful for specifying how to generate text messages for a particular SMS-to-Email gateway.  Macros allow you to define variable-content data including name, phone number, etc.  Left-click the macro button to display the following dialog:
       


      The example above indicates that the recipient's first name and last name are to be prepended to the text.  When the message is sent, the macro strings will be replaced and text will read, "Ben Laslo, it's time for your appointment!".  When you have completed the macro definition, use the "OK" button to close the dialog and save your entry.

      Several buttons are provided at the bottom of the message dialog:
       


      Use the "Send" button to send the message to the specified recipient.  The button remains disabled (grayed) until pertinent fields have been defined, including first name, last name, and cell phone (or e-mail address).  When sending, the following confimation dialog may be displayed:
       


      (Note:  Each attempt to send text or e-mail messages results in log data saved to a file within the KSMS program folder.  This file is named SendEmail.log and provides useful information for trouble-shooting purposes.)

      Left-click the "OK" button to send the message and close the message dialog.  (To disable further message confirmations, use the check-box titled, "Don't ask me this again.".

      Click the "New" button to clear all fields for creating a new message.  (Note:  If you have specified a message subject and/or body in the Email Properties dialog, then these fields will be pre-populated in the message dialog.)  The "Cancel" button is used to exit the dialog without sending the message.  When using this button, the following prompt may appear:
       


      Choose "Yes" to save your changes or "No" to abandon them.  Choose "Cancel" to continue making changes in the message dialog.

       
    1. Settings

    2. To change or review program settings, make the following menu selection:
       
        File -> Settings


      The settings dialog will appear as shown below:
       



      The settings dialog contains several groups of information:  selections, text coloring, list filtering, and email properties as described below:
       

        1. Selections

        2. There are two check-box selections as shown below:
           


           



          The first selection, when checked, will display a prompt before sending any text or email message.  This gives you the opportunity to cancel or confirm the message before it is sent.
           
           



          The second selection enables or disables alternate row highlighting in the message list.  When enabled, the message list contents will be shown as follows:
           


        3. Text Coloring

        4. This region allows you to define colors for text items in the message list of the main dialog display. Using these definitions, you can specify a different color for each of three message classes:  Unsent, Sent, Failed.  To change a message color, left click the applicable combo box control.
           


        5. List Filtering

        6. List filtering provides a way to limit the number of displayed messages in the main dialog message list, allowing you to view only more recent messages for instance.  Filtering is performed based on a date range.  Choose one of the following selections:  None, 1 Day, 1 Week, 1 Month.  Choose "None" to disable filtering so all messages will be displayed.
           


        7. Email Properties
        8. Email properties define parmeters essential for sending SMS text messages and email.
           


           



          To access email properties, left-click the button titled, "Email Properties...".  The following dialog will be displayed:
           



           The following parameters are required for proper text and email messages notifications:
           

        9. Your email address (e.g., jimmy@att.net)
        10. Outgoing (SMTP) mail server (e.g., mailhost.worldnet.att.net)
        11.  
          The program is compatible with systems where e-mail is implemented on networked servers.  In this instance, enter the server name in the "Outgoing Mail Server" field.

          Specify the following parameters only if SMTP authentication is required:
           

        12. SMTP user name
        13. SMTP password
           
          The region titled, "SMS Text Messaging" provides fields for defining your SMS-to-Email gateway provider, necessary for sending text messages.  Providers often have specific formats for sending text messages including definition of send-to and/or subject.  If necessary, use macro button(s) "<M>..." to define variable-content fields.   (Contact your SMS-to-Email gateway provider for details on the required formats and field content.)  The sample macro definition below indicates a field that includes recipient telephone number, user ID, and password.
           


          You may also define an optional message body that will be automatically inserted in each new message you create.  If desired, include one or more macro fields.  Or use the "Browse..." button to specify the contents of a text file.
           


  1. Legal

  2. By purchasing this product, you agree to terms of licensing and warranty.  Please read the following sections carefully.
  1. License

  2. Kadtronix, Inc. grants the registered user of Kadtronix SMS, herein referred to as "the application",  the right to use one copy of the application software on a single computer. The user may not use the application on more than one computer at the same time unless expressly intended for this purpose (such as network applications).  The application may NOT be distributed without our express written permission.
     
  3. Warranty

  4. KADTRONIX, INC. DISCLAIMS ALL WARRANTIES RELATING TO THIS PRODUCT, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER KADTRONIX, INC. NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH PRODUCT EVEN IF KADTRONIX, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT SHALL KADTRONIX' LIABILITY FOR ANY SUCH DAMAGES EVER EXCEED THE PRICE PAID FOR THE PRODUCT, REGARDLESS OF THE FORM OF THE CLAIM. THE PERSON USING THE PRODUCT BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE PRODUCT.