yoncenglish
Welcome to Yonc

Using the Program/Common tasks

Command line options

Configuration

Program Options

Options -- Internet

Options -- Email

Options -- Dialog

Options -- Chart

Options -- Alert Popup

Options -- Idle Handling

Options -- Sounds

Creating and changing data items

List of System Data Sources

List of Parser Commands

Other Topics

Tips/Questions/Problems

Ordering Yonc

Reporting Ideas, Problems and Bugs

About Yonc


Welcome to Yonc

YONC -- YOUR FRIENDLY ONLINE DIAL-UP COMPANION

(C) EmTec Innovative Software, 1999

What is Yonc

Yonc is a utility that assists you with dial up connections to the internet.  The program allows you to connect to the internet via Windows dial up networking with a single mouse click and even redials if you do not get a connection on the first try.

With Yonc you can monitor a wealth of information about your internet connection and your system, among them your daily/monthly online time, your monthly online cost, the number of mails in your email account (or in multiple accounts), the speed with which data is transmitted to and from your computer and the modification date and text parts of www pages.

Also, if your provider disconnects you after some time when you are idle, Yonc can simulate activity over your internet connection to keep you online.

Good places to start learning more about this program are:

o	The file MANUAL.DOC in the Yonc directory.

o	Using the program/Common tasks (recommended!)

o	Configuring the program

o	Tips/Questions/Problems

o	Ordering Yonc

o	Support and Bug-Reports

o	Author-Contact


Using the Program/Common tasks

Here is a list of how to work with Yonc.  If you have a problem you might also want to look at Tips/Questions/Problems

How to ...

... make a connection to the internet
Select Dial Out from the File menu, click on the leftmost button in the toolbar or, if Yonc is minimized, double click the Yonc icon in the system tray.
Yonc will then call your internet provider using the dial up networking entry and will redial if necessary.  The corresponding configuration can be made in Edit -> Options -> Internet.
Yonc will also detect if you make a connection to your provider directly through dial up networking or from another application.

... connect to the internet immediately after starting
Modify your Yonc program shortcut and add /CONNECT to the command line (target).

... disconnect the internet connection
Select Hangup from the File menu.

... configure the window
The basic window properties like colors, display of charts etc. is done in Edit -> Options -> Dialog/Chart.
To add a new informational item to the window, choose Item -> Add from the menu and give the item a name and select the type of data you want to display.  Please check that window's help for more details.

... make the program check email
Add a new item to the window (see above).  Enter a name in the label field, select a refresh time and set the type to Mail Account.  Then you need to enter your account data (see the help for the Edit Item window fore more details).  After you click OK the item will appear in your window and will start checking for new mail as soon as you go online.

... modify an item that is only available when online
Mark the Display All Items in the Item menu. Then edit the item and unmark the option again.

... check the log file
The log file is a simple text file in your Yonc directory.  Use the Windows Explorer, open your Yonc folder and double click on the file name (eg. yonclog.txt) or use an editor and load the file.

... display data from the internet (like the Yonc version number)
This is a non-trivial feature.  It is explained in detail in the Tutorial (in the Yonc program group in your start menu).

... exchange internet items with a friend
Mark the entry in the main window and select Item -> Export from the menu.  You will be asked for a short description and a file to store the entry in.
To load such an entry select Item -> Import and choose the file. A window with the description will appear.  In this window you can give the new item a name and a refresh time.  Then click the Import button.


Command line options

When starting the program you can provide the following parameters in the command line:

/CONNECT
With this option Yonc will make a connection to the provider immediately after starting the program.

/LANG:<code>
Force the program to start in a given language.  Supported language codes are GER for German and ENGL for English.
Example: YONC /LANG:GER

/MIN
Start the program with the window minimized.

Alternately, you can specify command line options in Unix style, eg.
YONC -min -lang ger


Configuration

Topics in this section:

o	Program options

o	Creating and changing data items


Program Options

The program's options are subdivided into six topics:

o	Internet

o	Email

o	Dialog

o	Idle Handling

o	Chart

o	Alert-Popup

o	Sounds


Options -- Internet

Monitor dial up entry
The entry from the Windows dial up phone book that you use to connect to your internet provider.

Expected peak performance
This value is used for the send/receive thoughput graph and should be set to the theoretical the upper limit of transfer speed (in bytes per second) that you can expect.
Common values are:
3600 (modem 33.6)
5700 (modem 57.6k-flex)
7200 (ISDN 57.6)
8000 (ISDN 64K)

Access web sites through proxy
If you want to use one of the web related features (either idle prevention or monitoring of www pages) and if your provider requires you to access the world wide web through a proxy server please enter the server and the port here, separated by a colon, eg. proxy.somewhere.net:8080
If you are not sure about your proxy setting, you can press the button below this field to check your system's web browser (Netscape or IE) proxy setting or just ask your provider's support staff.

When busy ...
Here you can set the dial delay and maximum number of attemtps for retrying to dial your provider when the number is busy.

Online cost per hour
If you want to monitor your online cost, please enter your hourly price here, eg. 4.95

Free hours online per month
If your internet subscription includes free monthly hours, enter the amount of free hours here.

Automatically start program ...
You can enter up to two program command lines here that will be executed after a call that was initiated by Yonc (eg. from the toolbar or menu) has been successful in making an internet connection.

Logfile
The name of a file in which Yonc will store session information (one line per session containing date, time and duration).  The file can be viewed with any editor, eg. Windows notepad.


Options -- Email

The options on in this section of the configuration applies only if you added an email checking item to Yonc (see Using the program/Common tasks).

Email program
The email program setting allows you to specify a program that you are using to read email.  Yonc can automatically start this program when new mail arrives and, if you are providing some text from the email programs title bar (eg. the word Outlook), Yonc will check if this window is already open to avoid starting multiple copies of the program when more than one mail arrives.

Window title ...
As mentioned above, Yonc can look if your email program is already open.  However, some email programs use different window titles for different parts of the program.  If you need to look for different keywords (eg. a Window that either contains the word Mail-O-Matic or the phrase Compose message, you can put vertical bars between them eg. Mail-O-Matic|Compose message.

Play sound for new mail
A sound file to play when Yonc detects new mail.  You can also specify if this should only happen for the first mail or for every new mail.


Options -- Dialog

Automtically restore window when going online
This option will automatically restore the Yonc window when it is minimized and when an internet connection is made (eg. by using the Windows Dial-Up-Networking icon to connect to your provider).

Automtically minimize window when going offline
This option will automatically hide the Yonc to the taskbar when it is open and when an internet connection is ended.

Window always on top
If enabled, the Yonc window will always stay on top of all other windows.

Hide toolbar
This option hides the toolbar to save screen space.

The [X] button in the main window minimizes the program
If this setting is enabled the [X] button in the title bar will minimize the Yonc window to the desktop instead of closing the program.

While offline, a double click on the tray icon ...
Here you can configure Yonc to connect to your internet provider by double clicking the minimized Yonc icon in the system tray (while offline).

Confirm disconnect when ending program
If you want Yonc to ask before it will close a connection when exiting the program, check this option.
Note: Upon exit Yonc will only close connections that were made through Yonc.  Connections that were made from the Windows dial-up network dialog will remain open.

Confirm manual hangup
This option shows a confirmation dialog before doing a manual hangup (from the toolbar or menu).


Options -- Chart

The performance chart comes in two flavours, either a line graph at the bottom of the Yonc window or a bar chart that looks a bit like a hifi equalizer at the right edge of the window.

You can configure the appearance of the chart and for which information elements (cpu, memory, send and receive throughput) you want to see a chart.

Line chart: You can configure the size of one grid element and the height (specified as a number of grid elements).  The width will automatically be adjusted to fit the window.  Default values are 6 elements with a size of 10 pixels.

Equalizer: You can configure the width of one bar in the graph. The height will automatically be adjusted to fit the window.  The number of bars depends on the data you put into the chart.  The default value for the width is 8.


Options -- Alert Popup

The alert popup is an small unobstrusive window that is used to notifiy the user of certain events (eg. when you go online, offline, when new mail arrives etc.).  This dialog allows you to configure the appearance of the popup window (color, font and position on screen).


Options -- Idle Handling

Disconnect ...
If you want Yonc to disconnect you after the line was idle for some time, you can specify a threshold of line traffic that is treated as an idle line.  Unlike the Windows dial up networking, Yonc can disconnect you even if you have a small amount of line traffic (eg. from checking email every few minutes or running ICQ).
To determine practical threshold values, just add two items to the Yonc windows that show amount of received and sent data; watch these during some time of inactivity to see what automatic line traffic your system (and Yonc) causes and select a noticably higher value as the threshhold.
Default values are 200KB in 30 minutes.

Keep line from becoming idle
Some internet providers close connections when the line was idle for some time.  This can be annoying when it happens while you read a lenghy online document, write email or just talk to someone on the telephone.

List of web sites for simulating activity
A list of web sites that Yonc will access to keep the line from being idle.

Randomly pick site to connect to
If this option is disabled, Yonc will connect to the web sites one after the other.  Otherwise it will pick a random entry each time it needs to access a site.

Get page headers only
Rather than getting whole web pages, Yonc can just get the page information.  This will reduce line traffic and will be sufficient to keep you online with most providers.

Connect every ...
These options let you define how often web sites are accessed.  You can set an upper time limit, in case you want to make sure that the program does not keep you online forever (in case that you really forget to disconnect).

 Warning!  Please be aware that, other program functions, like regular email checking, will result in line activity and can prevent Yonc, Windows or your provider to disconnect you after some idle time.


Options -- Sounds

This section lets you configure sounds for various events, like going online, going offline and when new mail arrives.  If you do not want a sound for an event, delete the entry in the corresponding field.


Creating and changing data items

Please also check the MANUAL.DOC file about how to add items to the list.

Label
This is a text that will appear in the first column to describe the data entry (e.g. "Free memory" or "Current time").

Refresh ...
This setting defines how often Yonc should obtain a new value for the item.  If you set this value to zero the item will not be refreshed at all (it will only refresh if you select "update now" from the program menu).

Note: Data item based on web sites or email accounts will only be updated while you are online.

Show value in tooltip
If the Yonc main window is minimized, the value of this item will be shown in the tooltip of Yonc's taskbar icon.

When value changes ...
For items which are based on email or World Wide Web you can specify if you want to be notified when the value changes.  The notification can either be an unobstrusive popup window that will automatically disappear after a few seconds or a message box that will require a click on the OK button to go away.

Data Source

System
To view a system data source just select an entry from the list there.  Most of these are self explanatory, however some require an additional information, for example, if you want to ping a host you need to put the host's address or name in the field next to the list.  Please check the list of system data sources for details.

POP3 mail account
Yonc allows you to check POP (post office protocol) mail accounts for mail.  To do this you need to enter the providers mail server, your account name (which is normally different from your email address) and your mail password here.
Naturally these settings vary from provider to provider, but in many cases they will be similar to the following example:
If your email address is joedoe@provider.net the mail server will probably be mail.provider.net and it is likely that your account name will be joedoe.  And, many times the password is the same that you use to login to the internet.
If you are not sure about these settings, please check the documentation that you received when you subscribed with your provider, or simply call their support staff.
Note: This feature will not work with AOL (because AOL uses a proprietary mail system) or web based mail services like Hotmail.Com.

http
Sometimes you will want to see a bit of information that is available somewhere on the internet.  Maybe you are interested in monitoring the latest version number of your favourite shareware or a stock price. In these fields you list the URL of the internet document.
As there is not enough room to show the entire document you can either select to monitor the time/date when the web page was last modified or you need to supply a script that works through the raw data of the web document to filter a text part from it.  Please see MANUAL.DOC in your Yonc directory for more information about scripting and/or list of parser commands.
Additionaly you will find a list of predefined web items when you use the Load function from the item menu.

Important: Please be aware that regular email or web site checking will cause line traffic which could keep your internet connection from being idle-disconnected.


List of System Data Sources

Here is a quick rundown of the non trivial system data sources: Many of these are not exactly related to dial up networking but they are useful nonetheless.  If you are interested in additional system monitoring, please check out EmTec's InfoTray product (at http:

Time Since Boot
This is the time (in days, hours, minutes) since your system was started. Under Windows 95 is determined by looking at the modification date of your \WINDOWS\SYSTEM.INI file.

Physical Memory Usage
The amount of RAM currently used in your computer.   Under NT this value will be 50% of the available size, since NT trys to keep 50% of it's memory available for short term use (the rest will be swapped to disk).

Pagefile Usage
Current and maximum size of disk swap files.

Dial-Up values
These values are reported by dial up system directly and seem to differ from the values which web browsers etc are reporting (probably due to the fact that dial up also reports all the management blocks which are sent to maintain the PPP connection).

Time until autom. disconnect
If you enabled the automatic disconnect feature, this item will show you the time left until Yonc will automatically disconnect the line.

Ping IP-Address
This item is used to check if an internet machine is currently online.  You need to specify an IP-address.  Please be aware that pinging a host will cause line traffic which could keep your internet connection from being idle-disconnected.


List of Parser Commands

The following is a complete list of commands and parameters for the internal raw data parser.  Please see the MANUAL.DOC file for a introduction to the web parser.

GotoLine <linenumber>
The data pointer will be positioned on the first character of the specified line (the first line is 1).  Negative values will be interpreted as numbers from the bottom, i.e. -1 is the last line, -2 is the one before the last etc.

MoveLine <offset>
Moves the pointer <offset> lines up or down (pos./neg. values) and to the leftmost character within the traget line.  If the pointer is located somewhere on line 3 MoveLine 2 will move it to the first character of line 5.  MoveLine -1 will move it to line 2.

FindLine <text> [,<repeat>]
This command tries to find a line that contains <text> an positions the pointer to the first character of that line.  The optional <repeat> parameter allows you to search for the 2nd or 5th occurrence.  For negative values of <repeat> the parser will search upwards, i.e. FindLine "INFO", -1 will locate the previous occurrence of the word INFO.

Note:  The search will not wrap around the end of the file with one exception:  If the pointer is located on the first line an upward search will begin with the last line of data.

GotoChar <n>
The pointer will be moved to the n'th character within the current line (the leftmost character is 1).  Negative values of <n> will be counted from the right end of the line.  GotoChar 3 will move the pointer to the third character in the current line, GotoLine -1 will move it to the last character.

MoveChar <offset>
Moves the pointer <offset> characters to the right or left, starting from the current position within the line.

FindInLine <text> [,<repeat>]
This command tries to find <text> within the current line and will locate the pointer to the first character after the found text.  By specifying an optional <repeat> value, you can find the n'th occurrence of a text within a line.  Negative <repeat> values will search to the right (instead of left) from the current position, but the search will be confined to the current line.
FindInLine "<B>", 3 will position the pointer after the 3rd occurence of the text "<B>" within the current line.

Note:  The search will not wrap around the beginning or end of the line with one exception:  If the pointer is located exactly on the first character of the line a search with negative <repeat> count will start at the end of the line.

SkipChars <charlist>
Moves the pointer to the right skipping all characters that are listed in <charlist>.  The result will be that the pointer is located on the next character that is not part of <charlist>.

SaveData <filename>
This command simply writes all raw data to a file with the given file name.

Say <text>
This command simply adds <text> to the data output.

SayNewLine
This command adds a new line character to the data output.  InfoTray will only display the first line in the main window, but it will display all lines if you select the Information entry from the right button menu or if you double click an item.

SayUntil <text>
This command adds all characters up the first occurrence of <text> to the data output.  The pointer will be positioned on the beginning of <text>.

SayNextWord
The SayNextWord command sends all alphabetic characters (upper and lower case) to the output, starting from the current position. The pointer will be positioned on the first character not being part of the word.

SayNextNumber
The SayNextNumber command sends all numeric characters (0-9, plus, minus, dot, comma, leading space characters) to the output, starting from the current position.  The pointer will be positioned on the first character not being part of the number.

SayNChars <n>
This command sends the next <n> characters to the output and move the pointer <n> characters to the right.

SayAll <charlist>
The SayAll command outputs all characters, starting from the current position, that are listed in <charlist>.  The pointer will be located on the first character that is not listed there.  E.g. SayAll "0123456789ABCEDFabcdef" will output a hexadecimal number.

If <text>
This command compares the characters at the current position with <text> and execute all commands up to an corresponding Else or EndIf command, if <text> was found at the current position. The pointer is not moved.  Nesting of If and IfNot-commands is allowed.  See below for an example.

IfNot <text>
This command compares the characters at the current position with <text> and execute all commands up to an corresponding Else or EndIf command, if <text> was not found at the current position. The pointer is not moved.  Nesting of If and IfNot-commands is allowed.  See below for an example.

Debug "ON"|"OFF" [, <name>]
The Debug command starts or stops writing debug output to a file. If the optional <name> parameter is omitted, the output will be stored in a file named DEBUG.OUT.  Turning debug on for the first time will write the entire raw data to the file.

OnError <text> [, <name>]
This command allows to intercept errors (e.g. in case a text was not found or you tried to move to a line that does not exist) and will write <text> to the output instead of the error message. If you supply the optional <name> parameter, the original error message will be appended to the file <name>.  If you use OnError "" the parser will, in case of an error, just exit and will keep your output.

Normally you will parse data by moving the pointer to a location of interest (first you will locate the line and then you will navigate within that line).  Then you will either output text from that location (by using Say commands) or you will check the location for certain text and output fixed text.

Comments can be added to the program by using // or #.

Example:

// move to column 10 in line 3
GotoLine 3
GotoChar 10

IfNot "US-Dollar:"
    Say "PANIC!  No 'US-Dollar' found on line 3 col. 10")
Else
    MoveChar 10      // skip the word "US-Dollar:"
    SayNextNumber    // print the current exchange rate
EndIf

Example:

// current yonc version from www.emtec.com/index.html
OnError "<N/A>"
FindLine "Yonc V"
FindInLine "Yonc V"
Say "V "
SayNextNumber


Other Topics

o	Tips/Questions/Problem

o	Ordering Yonc

o	Reporting Ideas, Problems and Bugs

o	About Yonc


Tips/Questions/Problems

My system does not show line performance
Older versions of Windows 95 did not allow applications to access the dial up networking performance data.  To solve this problem (and many others), Microsoft provides an update for the Windows 95 dial up networking called Dial Up Networking 1.3 Performance & Security Update.
This update is available on http://www.microsoft.com. Due to the fact that the Microsoft site is frequently redesigned we cannot provide a direct link to the update, but you should be able to find it by using the site's search feature with the keywords Dial Up Networking Update or for MSDUN13.EXE or by using the following links from Microsoft's home page: Product Families -> Windows -> Windows 95 -> Download -> Networking.

The window size changes when going online/offline
This is a feature.  You can configure the display to show different informational items when online and offline and you can even turn the graphics on/off when online or offline.  Because of this, Yonc saves different sizes for each of these states to allow you to adjust the size according to the amount of information displayed in each state.

Some items suddenly appear/disappear
All items can be configured to show only when online or offline. If you want to see or modify an items that is not currently available just select Display All Items for the Item menu.

I can't figure out how to get data from the internet?
Please check out the MANUAL.DOC file in the Yonc directory. This file contains extensive explanations and samples to show how to do this.

Where can I get updates?
Please fire up your web browser and go to http://www.emtec.com

How do I order?
Please checkout the Order Form in the Help menu and/or check Ordering Yonc topic in this help file.

How can I start Yonc minimized?
Edit the properties shortcut which you are using to start Yonc and add /min to the command line, e.g. c:files.exe /min.

I want to backup my data files
All configuration data is stored in the following files: items.inf and yonc.cfg.  All these files are plain text.

I think I found a bug
See Support and Bug-Reports.

How can I uninstall Yonc?
Please open the Windows Control-Panel and double click 'Add/Remove Programs'. Then select Yonc and click on 'Add/Remove'.


Ordering Yonc

If you want to order Yonc, please select the Order-Form item from the Help menu or start the separate Order application from the Yonc program group.  There you will find all neccesary information regarding pricing and payment.

When ordering Yonc, you will receive a license code which turn off the evaluation mode of your installed copy of moony.  This license code will work for the current version of Yonc and for all versions with the same major version number (e.g. all 1.xx versions).  The idea behind this license scheme is to provide users with free bug fixes and minor improvements (like additional configurability and improved user interface). However, at some point, EmTec will probably make a new release with major improvements and a new major version number.  In this case registered users will be offered upgrades at a reduced price.

When ordering you can choose from the following options:

Yonc License
A code to license the program for one machine/user.

Diskette
A 3.5'' disk with the latest Yonc version available.

Please see also Author-Contact and How to get support/report bugs.


Reporting Ideas, Problems and Bugs

If you have questions about ordering/paying the program, please go to Ordering Yonc.

Of course there are no bugs in this program (you probably know the saying "It's not a bug, it's a feature), so here is how you ask questions, how to tell us about your ideas or how to report "undesired features" ;-)

First of all, please check out the help text related to your problem (e.g. for a certain option) and also browse through Common Questions, to see if the problem is known and if an answer is already provided there.

If this does not help, please contact us via email and provide a good description of the problem.  To solve a problem it is essential for us to be able to reproduce it, so please try out different situations or settings (e.g. an problem might only occur the first time after the program was started, or only if a certain feature is enabled or while there is a lunar eclipse).  Generally, try to figure out what's going wrong and provide as many details as possible.

The email address is yonc@emtec.com


About Yonc

YONC - Multi Purpose Info and CPU Monitor

All concepts and programming done by
Markus Schmidt & Markus Gömmel

Yonc is (C) Copyright 1999 by

  EmTec Innovative Software
  Markus Schmidt
  Waagstr. 4
  90762 Fuerth
  - Germany -

  m.schmidt@emtec.com
  +49 911 7406856
  +49 911 7406857 (fax)

and

  CompuLab Software Communication
  Markus Gömmel
  Heiligenstr. 5
  90762 Fuerth
  - Germany -

  m.goemmel@compulab.de
  +49 911 7406930
  +49 911 7406931 (fax)

Please see also Ordering Yonc and How to get support/report bugs.