OS/2 Shareware BBS: InfoMgt/InfoMgt.zip/dialer10.zip/DIALER.DOC

Text File | 1994-10-01 | 31KB | 502 lines

                              Dialer Version 1.0
                           A Shareware OS/2 Program
                        Copyright (c)1994 Kari Jackson
                             All rights reserved.
                               October 1, 1994
                       Internet [e-mail]

Requires:  VX-REXX runtime module VROBJ.DLL dated end of April 1994 or later
  (not included, but available on most any OS/2 BBS, either by itself or as
  part of another program that requires it).  RXASYNC.DLL, dated 5/23/94 or
  later (not included, but available on most any OS/2 BBS as part of the
  RXASYNC.ZIP package).  Both on LIBPATH.  And of course, OS/2 2.1 or later.
  (May work on 2.0 also; I don't know.)  With REXX support installed.

Installation:  Nothing to it!  Just put DIALER.EXE and DIALER.F1 into a
  directory that's listed as part of the SET PATH= command in your CONFIG.SYS
  file.  Put RXASYNC.DLL and VROBJ.DLL into a directory on your LIBPATH.  If
  you want to make a WorkPlace Shell program object for Dialer, put DIALER.ICO
  into the same directory where DIALER.EXE is, before you do that, so that
  OS/2 will see and use that icon for the program object you create.

Purpose:  Dialer is a program that stores all your phone numbers, dials one or
  more, keeps trying until a connection is made, logs the call if you want it
  to (the default action is to log all long distance calls), allows you to add
  a note to the log if you want to, etc.  Lots of extra little features that
  make it easy to use; for example, you can enter a phone number like
  800-3-IBM-OS2 and the program will turn it into numerical digits before
  dialing it.  Also good for travelers, since it's very easy to tell the
  program to dial or not dial the area code, and/or your long distance
  company's credit card number, depending on whether you're currently in or
  not in the city where the callee resides.

Usage:  For a quick description of what each object (like a checkbox, entry
  field, etc.) is for, while the program is running, just put your mouse
  pointer over the object and look at the bottom line of the window.  The hint
  text there changes according to where your mouse pointer is at the moment.

  In order to see the hint text of a menu bar item, you have to click the
  mouse button over the item, and read the hint text while holding the mouse
  button down.  If you move the mouse pointer off the menu bar before
  releasing the mouse button, then the menu item will not get executed as it
  would if the mouse pointer were still touching it when you let go of the
  mouse button.  So you don't have to execute a menu item just to find out
  what it does!

  And speaking of menu items, the ones in this program are not quite like
  you'd expect.  They act more like push buttons than menu items, in that
  there are no menus or menu entries.  The items listed on the menu bar itself
  are all that there is.  Hitting the FILE menu item with your mouse doesn't
  give you a list of file-related things to do.  It gives you the Open File
  dialog box.  I just couldn't see cluttering up the program's main window
  with six extra pushbuttons that have nothing to do with making phone calls,
  when there could be a perfectly good out-of-the-way menu bar at the top of
  the window instead.  So those six functions are menu bar items instead of
  push buttons, even though there are no menu items to go into the menus.  So
  the menu bar headings just act like push buttons.

Name:  If you don't like the program's name, you can change it.  Simply rename
  DIALER.EXE to (for example) RIKER.EXE and the program's title bar and Window
  List entry will be RIKER the next time you run it, and it will look for
  RIKER.DAT and RIKER.INI instead of DIALER.DAT and DIALER.INI, and it will
  store log entries in RIKER.LOG instead of DIALER.LOG.  And the file for the
  F1 key help for the DATABASE window will be searched for as RIKER.F1 rather
  than DIALER.F1, so remember to rename that file too.  This .DOC file keeps
  mentioning DIALER.INI, DIALER.LOG, etc., but if you rename the .EXE file,
  just think "RIKER.INI" (or whatever first name you use) whenever the .DOC
  file says "DIALER.INI", etc.

Home Directory:  The program looks for all its files in whatever directory the
  .EXE file is in.  So if you move the .EXE file and the others, you don't
  have to reconfigure or anything to get the program to understand where to
  look for its files.  It doesn't store any records of where it thinks it's
  located.  Exception:  If you alter the COMMAND TO VIEW THE LOG FILE entry-
  field on the CONFIGURATION window, the command saved in your DIALER.INI file
  will contain the pathname of your log file.  So if you move DIALER.EXE and
  its companion files, you'll need to change that entry-field again before the
  VIEW LOG menu item will work any more.

Payment:  This program is shareware, not freeware.  What that means is this:
  It may be freely distributed to anyone as long as all of its files and
  documentation are distributed together without any sort of modification.  It
  may be freely used for evaluation purposes, to decide whether you like it.
  If you do like it and want to continue using it, you are supposed to
  register it.  I'm not going to track you down and have you arrested or sue
  you if you don't, but you should feel guilty about it if you have a
  conscience.  Using someone else's work without his permission is against the
  law, and I do not give you permission to use Dialer longer than necessary
  for evaluation purposes (like about a month) unless you register it (or
  unless you were one of my beta testers).  To register it, just send $15 to
  Kari Jackson at 3201 Monroe Street, Omaha NE 68107-4048.  Sorry, I won't
  send you a registered copy of the program because the shareware version just
  does not have one single disabled feature, so there's no reason to.  <grin>

Disclaimer:  While this program has been thoroughly reviewed and tested, it is
  provided solely "as is" and without warranty of any kind.  Kari Jackson
  specifically disclaims all warranties, expressed or implied, including but
  not limited to implied warranties of merchantability and fitness for a
  particular purpose with respect to defects in any portion of the package.
  In no event shall Kari Jackson be liable for any loss of profit or any other
  damage, including but not limited to special, incidental, commercial,
  consequential or other damages of any kind resulting from defects in this
  software or its documentation.  USE THIS PROGRAM AT YOUR OWN RISK.

Now, on to the real documentation:

The phone number field:
  This is where you enter or choose the phone number you want to dial.  If
  you've never made a DIALER.DAT file (or it's not in the same directory where
  the DIALER.EXE file is, so that Dialer can't find it by itself), then there
  aren't any entries from which to choose in the dropdown part of the field.
  So all you can do is change to a different .DAT file (using the FILE menu
  item), create the DIALER.DAT file (using the DATABASE menu item) or manually
  enter a phone number to dial, into the entry-field part of the number field.
  Of course even if you do have a DIALER.DAT file, you can still manually
  enter a number any time you want to.

  Every time a change is made to whatever is in the entry-field portion of
  this field, the program looks at the number and decides whether it's a long
  distance or local call, and checks or unchecks the DIAL 1, DIAL AREA CODE,
  and LOG THIS CALL checkboxes accordingly, and turns off the ADD A NOTE TO
  THE LOG checkbox.  Unless of course the entry contains any of the key words
  that make the program treat the entry differently.  (You'll find everything
  you want to know about how the program reads and interprets the phone
  numbers and key words, in the DIALER.F1 file which you can read by hitting
  the F1 key while in the program's DATABASE window.)  So don't bother
  checking the DIAL 1, DIAL AREA CODE, etc., checkboxes until you're done
  selecting or entering your phone number, because changing the phone number
  in the number field is going to change the state of the checkboxes!

  If you're entering a number manually rather than choosing it from the
  "database" in the dropdown box, you can type just the number rather than
  making the entry look like a "database" entry, if you want to.  But if you
  do that, then the "name" of the person you're calling will be entered into
  the log and the THIS CALL: line as "Unknown".

The spin buttons:
  The values selected here (as well as the two PREFIX entry fields) always get
  saved in the DIALER.INI file when you close the program.  If the default
  value is selected, the .INI file entry is deleted.  The same goes for the
  .INI file entries that go with the options on the CONFIGURATION menu.  If
  all the .INI file's entries have been deleted because their values have
  returned to the defaults, the file is deleted to avoid wasting your hard
  drive space for a file that no longer has any use.

  The REDIAL button lets you decide how many seconds the program should wait
  between redialing attempts and between one queued call and the next.  Choose
  a low number when the line is busy, or a high number when there's no answer.
  Or whatever you like.  You may also type a number rather than selecting from
  the existing choices.  This is the only information-containing object on the
  main window whose setting is not saved as part of a queue entry.  The
  current value of this object is used between each pair of dials, regardless
  of what the object's value was at the time any phone number entry got added
  to the dialing queue.

  The LET IT RING button lets you decide how many seconds to let the phone
  ring before deciding no one's going to answer.  You may also type a number
  rather than selecting from the existing choices.  Like all the other objects
  except REDIAL, LET IT RING's value is saved as part of a queue entry, so you
  can have a different value here for each call you make even when you're
  queueing a lot of calls at once.

The PREFIX objects:
  There are two separate prefix fields.  You might put a "9" in the first one
  if you have to dial "9" to get an outside line, and put your phone company
  credit card number in the second one.  Since there are USE PREFIX 1 and USE
  PREFIX 2 checkboxes, you can determine when to use or not use each prefix,
  separately.  So you could leave the "9" turned on all the time, but turn off
  the credit card number on local calls.  That way, you never have to retype
  those long, long credit card numbers (because the prefix values are stored
  in the DIALER.INI file), but they don't get used when you don't want them to
  be used.  When the USE PREFIX checkboxes are turned on, the prefixes are the
  first digits dialed, before the "1", area code, and phone number.

The other four checkboxes:
  Always look at these to make sure they say what you want, after you choose
  the number you want to dial.  Because choosing a number (or entering one
  manually, or manually altering one that was chosen from the "database") will
  cause the status of these boxes to get automatically changed.  So checking
  the checkboxes before choosing or changing the phone number doesn't do a bit
  of good!

  DIAL 1:  When this box is checked, the program will dial a "1" between the
  prefix characters (if used) and the phone number.

  DIAL AREA CODE:  When this box is checked, the program will dial the area
  code before the phone number.

  LOG THIS CALL:  When this box is checked, and you hit the CONNECTED button,
  the program will store a record of the call into the DIALER.LOG file.

  The above three checkboxes are always turned on when you select a phone
  number which Dialer thinks is a long distance call.  See the "database"
  instructions (in the DIALER.F1 file) for more information, and to find out
  how to make the program act otherwise.

  ADD A NOTE TO THE LOG:  When this box is checked, LOG THIS CALL will be
  assumed also, whether it's checked or not.  When you hit the CONNECTED
  button, then the SAVE NOTE and SAVE TIME buttons will be enabled so that you
  can tell the program when the call has ended and when you're done typing
  your Note.  (You can type part or all of it before you hit the QUEUE or DIAL
  buttons, also.)  The THIS CALL: line of the program's main window will be
  updated every three seconds with the approximate duration of the call.  And
  your Note will be added to the DIALER.LOG file at the end of the rest of the
  log entry.

The DIAL button:
  Make sure all your settings are correct before hitting this button!  When
  you hit this button, if there are no numbers in the queue, then the current
  entry in the number field is dialed.  If there are numbers in the queue,
  then the current entry is added to the queue (if it's not already there) and
  the queue is dialed.  The dialing takes place in a second thread.

  When that thread gets started, the DIAL, QUEUE, QUEUE ALL, and REMOVE
  buttons are disabled, along with most of the objects on the main window.
  The CONNECTED and HANG UP buttons are enabled.  If there are more than one
  number in the queue, then the ABORT QUEUE button is enabled and the HANG UP
  button's name is changed to NEXT CALL.  (Its function remains the same.  Its
  name is just changed to more aptly describe its purpose.)

  The name and number of the queue entry that's currently being dialed appears
  in the THIS CALL: line of the program's main window.

  The program waits until the modem says either "BUSY", "NO CARRIER" (which
  means the modem waited for an answer for however many seconds your LET IT
  RING spin button is set for, without getting an answer from a remote modem),
  or "NO DIALTONE" (which means your modem is not connected to the phone line,
  or it thinks it isn't).  At which time it waits the number of seconds that's
  currently selected in the REDIAL spin button, and then either dials the next
  number in the queue, or redials the same number if it's the only number in
  the queue.  And of course it puts "BUSY" or "NO ANSWER" or "NO DIAL TONE"
  into the LAST CALL: line of the program's main window.

The QUEUE button:
  After selecting or entering a phone number in the phone number field, and
  setting the various other checkboxes and entry-fields the way you want them
  for that call, you can click on the QUEUE button.  The current settings of
  all those objects (except the REDIAL spin button) will be stored into memory
  as a queue entry.  There should not be any limit to the number of queue
  entries you can have at once.  If you're ready to dial, you can hit the DIAL
  button instead of the QUEUE button, because if the current entry is not
  already in the queue, the DIAL button adds the current settings to the queue
  just as the QUEUE button would.

  Since the program has no way of giving you a visual cue in the dropdown box,
  as to which numbers are in the queue, the program will not let you use the
  QUEUE button when the selected number is already in the queue.  The QUEUE
  button is disabled and the REMOVE button is enabled, whenever the selected
  number is in the queue; or when the selected number is not in the queue the
  QUEUE button is enabled and the REMOVE button is disabled.  That's how you
  can tell whether you've already queued a number or not, but it has the side
  effect of making it nearly impossible to put a number into the queue twice
  if you should happen to want to.  The only way you can do that is queue it
  up once and then hit the QUEUE ALL button.  That adds all the numbers in the
  current .DAT file to the queue, regardless of what's already there.  Then
  you could use the REMOVE button to remove whatever numbers you didn't want
  to add to the queue.

The QUEUE ALL button:
  This button adds all the entries in the dropdown box to the current queue,
  all at once.  If there are just a couple entries you don't want in the
  queue, you can certainly use the REMOVE button to remove them.  It's often
  easier to QUEUE ALL and then REMOVE a couple, than it is to separately QUEUE
  all of the ones you do want.  The queue entries will use their own .DAT file
  values for the USE PREFIX checkboxes, and the four checkboxes below the
  PREFIX entry fields.  All of the queue entries will receive whatever LET IT
  RING, PREFIX 1, PREFIX2, and NOTE values are in effect at the time you hit
  the QUEUE ALL button.

The REMOVE button:
  Click on an entry in the dropdown box which you've added to the queue and
  changed your mind about, and click on REMOVE, to remove that entry from the
  dialing queue.

The NOTE entry-field:
  If you check the ADD A NOTE TO THE LOG checkbox, then here's where you type
  the Note.  You can begin typing it before you hit the QUEUE or DIAL button.
  Whatever's there at the time you hit one of those buttons will become part
  of the queue entry just like the phone number and the rest of the settings.
  Each time the program dials the number, it puts that partially-done Note
  entry back into the entry-field (just like it does with the rest of the
  settings that are part of a queue entry).  So that after you hit the
  CONNECTED button, you can finish typing the Note or add more to it before
  saving it.

The ERASE button:
  This button just erases the NOTE entry-field and puts the cursor into it so
  that you can type something else into it.  A little easier than holding down
  the DELETE key or marking the text and hitting the DELETE key, to get the
  previous call's Note erased.

The CONNECTED button:
  If someone answers the phone at the other end of a call, you must pick up
  your telephone receiver and hit the program's CONNECTED button, and the
  modem will hang up so your telephone has the line all to itself.  If there's
  more than one number in the queue, or if you've checked the ADD A NOTE TO
  THE LOG checkbox for this phone number, then a dialog box will come up with
  some instructions.  Once you're familiar with the program, you won't need
  those instructions anymore, so you can check the KILL DIALOG BOX checkbox on
  the CONFIGURATION window and the dialog box won't come up anymore.

  The dialog box says that the program is not going to continue until you hit
  the button that says CONTINUE or SAVE NOTE.  That button's name changes
  depending on the circumstances.  If the only reason for the program to be
  pausing is that there are other numbers to be dialed, so the program needs
  to know when you're done with the current call so that it doesn't continue
  dialing while you're still talking, then the button's name is CONTINUE.  If
  you've checked the ADD A NOTE TO THE LOG checkbox for this phone number,
  then the button's name is SAVE NOTE.

  And if you've checked the ADD A NOTE TO THE LOG checkbox, then the dialog
  box also says that the program will record the time you click on the SAVE
  NOTE button as the time the call ended.  If you want the ending time of the
  call to be recorded sooner (like if you're done with the call but need to
  add more to the Note), click on the SAVE TIME button whenever the call ends.
  The ending time will be saved right then, but the log entry won't be saved
  until you click on the SAVE NOTE button.

  When you do click on the SAVE NOTE button, the ending time will be recorded
  unless you've already clicked on the SAVE TIME button.  The current contents
  of the NOTE field will be added to the log entry along with the duration of
  the call.  If a call lasts over 24 hours, the log entry will not show it.
  For example, if a call is 25 or 49 hours, the log entry will say that it was
  just 1 hour.  For a 26-hour or 50-hour call, the log will say 2 hours.  Etc.
  I really don't think this will be a problem for more than a handful of
  people in the entire world.

  If the LOG THIS CALL or ADD A NOTE TO THE LOG checkbox is checked, the log
  will contain the "name", the "number", the time at which you hit the
  CONNECTED button, and if ADD A NOTE TO THE LOG is checked, then the duration
  of the call, and the Note, as well.  If those checkboxes are not checked for
  the current phone number, then nothing will be added to the log.  The
  logfile will be named DIALER.LOG in the same directory with your DIALER.EXE
  file, and it's a plain ASCII text file, one entry per line.

  Also, as soon as you click on the CONNECTED button, the program window's
  LAST CALL: spot will change to "Last call:  CONNECTED", and if ADD A NOTE TO
  THE LOG is checked, the THIS CALL: line will begin being updated every three
  seconds with the approximate duration of the call.  This three-second
  updating will continue until you hit the SAVE TIME or SAVE NOTE button to
  tell the program that the call is over.  If you want the duration display,
  you can always use the ADD A NOTE TO THE LOG checkbox even if you don't want
  to type a Note.  The log file will be updated, and the Note that gets added
  to it will simply be "nothing".

The HANG UP or NEXT CALL button:
  This button changes its name depending on the circumstances.  If there's
  only one number being dialed, its name is HANG UP.  If there are other
  numbers in the queue, its name is NEXT CALL.  Either way, it is used to hang
  up the modem and stop trying to call that number (the one specified in the
  THIS CALL: line of the program's main window).  In other words, it removes
  that number from the queue.  "HANGUP" will appear on the LAST CALL: line of
  the window.

The ABORT QUEUE button:
  If there's more than one number in the queue, the ABORT QUEUE button will be
  enabled.  Click on it to abort all dialing.  "ABORT QUEUE" will appear on
  the LAST CALL: line of the program's window.

The FILE menu item:
  If you want to be able to queue up a certain group of phone numbers easily
  by hitting the QUEUE ALL button, keep that group of numbers in a separate
  .DAT file instead of the main DIALER.DAT file.  (The filename does not have
  to end in .DAT, but the *.DAT files are the ones that will be offered to you
  by default in the Open File dialog box, so it will be easier for you if you
  do use a .DAT filename extension.)  When you want to use that group of phone
  numbers, just choose that .DAT file from the dialog box offered by the FILE
  menu item, and then that .DAT file's phone numbers will be entered into the
  dropdown box where the phone numbers go.  And you can hit the QUEUE ALL
  button to queue them all up.  That filename will become your new default
  database file until you exit the program, or use the FILE menu item again,
  or use the SAVE AS button on the DATABASE window, to change it back to
  DIALER.DAT or another filename.

  But no matter what you do with the FILE menu item or the SAVE AS button on
  the DATABASE window, DIALER.DAT is the only database file that the program
  will attempt to use each time you restart it.  So the .DAT file you want to
  use most often should be the one to which you give the name DIALER.DAT.

The DATABASE menu item:
  If you want to go to the DATABASE window, where you enter your phone
  numbers, just hit this menu item.  You can add, change, or delete entries.
  To learn the format of the database entries, see the DIALER.F1 file.  The
  easiest way to view that file is to go to the DATABASE window and hit the F1
  key.  (If you use some other method to view the file, do not alter it!  At
  least, do not rewrap the paragraphs.  Each paragraph simply must remain as
  one long line in order for OS/2 to properly display it.)  In order for the
  program to find the DIALER.F1 file, it must be in the same directory with
  the DIALER.EXE file.

  To leave the DATABASE window without saving any changes you may have made to
  the entries, either click on the CANCEL button or doubleclick on the system
  menu icon.  To leave the DATABASE window and save your changes, click on the
  SAVE button.  Or click on the SAVE AS button to save the current entries in
  a file other than the current database file (which is DIALER.DAT unless
  you've changed it).  The hint text for the SAVE AS button (which is the text
  displayed in the bottom line of the program's window while your mouse
  pointer is over the SAVE AS button) tells you the name of your current
  database file, in case you've forgotten whether you've changed it, or
  forgotten what you'd changed it to.

  All your phone number entries are stored in a plain ASCII text file named
  (unless you specify otherwise) DIALER.DAT in the same directory where your
  DIALER.EXE file is.  And it turns out that this file is in the same format
  as the *.$$F files made by OS/2 2.x's Database applet!  So if you happen to
  have a file, made by that applet, of phone numbers, and it happens to have
  the people's names as the first field and their phone numbers as the second
  field, you can actually load your .$$F file into Dialer as a DIALER.DAT
  file!  Of course, the first line of the .$$F file is the names of the
  fields.  So in Dialer, in the dropdown phone number box, there will be one
  line that says something like
  Name   Number   Address   City   State   Zip
  but other than that, it will work.  As long as the third field doesn't
  happen to contain NOTE or DIAL1 or any of those other key words (as
  described in the DIALER.F1 file), your .$$F file won't need to be modified
  at all!  Just copy it straight to DIALER.DAT and away you go!

The VIEW LOG menu item:
  Click here to start OS/2's E editor or the editor or viewer of your choice
  (according to your entry on the CONFIGURATION window) to look at your
  DIALER.LOG file.

The VIEW QUEUE menu item:
  Click here to view the names and numbers of the current dialing queue
  entries.  You can't change anything about them here though.

The CONFIGURE menu item:
  Click here to go to the CONFIGURATION window.  The CONFIGURATION window
  contains the following objects:

  The COM PORT spin button.

  The TONE/PULSE spin button.

  The KILL DIALOG BOX checkbox.  If you don't want to see that dialog box
  which comes up and explains things to you, after you hit the CONNECTED
  button when ADD A NOTE TO THE LOG is checked or when there are more than one
  phone number queued, you can check this checkbox.  After doing that and
  hitting the SAVE button, the program will never again show you that dialog
  box unless it can't find your .INI file or unless you come back and uncheck
  this box and hit SAVE again.

  The COMMAND TO VIEW THE LOG FILE entry-field.  The default command runs
  OS/2's built-in E editor.  If you want to be able to view your .LOG file,
  from within the program, by hitting the VIEW LOG menu item, using some
  editor or viewer other than E, then change this command here.  Change "E" to
  the name of the program you want to use.  If that program is not in a
  directory on the PATH statement in your CONFIG.SYS file, then include its
  full pathname here, also, as in C:\UTIL\EDIT.EXE or whatever.  And if it's a
  character mode program rather than a PM one, you will want to add the /C
  switch to the START command as well.  For example,
  START /C EDIT C:\UTIL\DIALER.LOG

  Remember, in order for START to interpret a switch as belonging to itself,
  the switch must come right after the word "START", before the name of the
  program it's supposed to start.  The command
  START EDIT /C C:\UTIL\DIALER.LOG
  would not make START act like the /C switch had been used.  START will pass
  the /C switch to EDIT rather than using that switch itself.

  You also need to use START's /F switch to get the editor/viewer to start in
  the foreground.  It's already there, by default, so just don't remove it.

  And if you change this entry from the default setting and then later move
  DIALER.EXE and its companion files to another directory, you'll need to
  change the log file's name in this entry-field again before the VIEW LOG
  menu item will work any more.  Or delete the DIALER.INI file if you want to
  go back to the original E command and all the other default settings.

  The ADDITIONAL MODEM ("AT") COMMANDS entry-field.  This is where you can
  send extra commands to your modem.  For example, if you want to have your
  modem's speaker volume turned all the way up while dialing so that you can
  hear the busy signal or ringing more clearly, and if ATL3 is the command
  that your modem uses for that purpose, then you want to put L3 into this
  entry-field.  Then instead of ATE0S7=nnS12=10DTphonenumber, the program will
  dial ATL3E0S7=nnS12=10DTphonenumber, every time you tell it to dial
  anything.  If you want it to stop doing that, change this entry-field back
  to blank.

  Be sure you don't use a modem command that would conflict with E0 or S12=10
  or your S7 register's value which is set by the LET IT RING spin button.

  One Cardinal MVP144DSP modem that this program has been tested on, for some
  reason needed &V in this entry-field in order to keep from hanging up
  immediately after going offhook, before even dialing.  We have no idea why
  &V makes it work, but if you have the same modem and the same symptom, try
  it!  Maybe it'll work for you too.  It still isn't perfect, though, on this
  particular modem.  When the user hits the HANG UP button, it takes a couple
  of tries before it works.  None of the other modems we've tested with have
  any such problems, though.

  The SAVE button.  All the objects on the CONFIGURATION window are read,
  their values are saved in the program's .INI file, and the CONFIGURATION
  window is closed.  Of course, the .INI file entry for a non-default setting
  that has now been changed back to the default, is erased instead.  When you
  exit the program, if all the .INI file settings have been put back to the
  defaults and erased, then the program erases the .INI file too, since an
  empty .INI file does nothing but waste your hard drive space.

  The CANCEL button.  To close the window without saving your changes.  You'll
  get the same effect if you close the window by doubleclicking on its system
  menu icon.