home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / deskaces / callfor.arc / CALLFOR.DOC next >
Text File  |  1988-11-25  |  25KB  |  545 lines

  1.  
  2.                                CALLFOR
  3.  
  4.           version 0.1 (c) copy right 1988 All Rights Reserved
  5.  
  6.  
  7.           This program is for the receptionist/secretary.  This records 
  8.           the call of a phone/visitor on a pop up memory resident, 
  9.           easy to fill form (each form is called a "record").  And if
  10.           the default form is not suitable at any given time, you can
  11.           re-write a new one on-the-fly, while in the pop up with new
  12.           selections and others pre-filled in already.
  13.  
  14.           This pop up will pop up over another program or over DOS.
  15.  
  16.           The limit on the number of forms you can store is limited by 
  17.           the amount of empty space in your diskette or the hard disk.
  18.           If a hard disk is used, then changing from one subdirectory 
  19.           to the next will not prevent the list of filled in forms to 
  20.           be written in the original subdirectory it was in.
  21.  
  22.           CALLFOR.EXE keeps track of how many such forms were filled 
  23.           in since the last time the computer system was turned ON.
  24.           And every form also has the date and the time that the pop 
  25.           up was called, so you don't have to note anything.
  26.  
  27.           In case of a power failure, there is no loss of the filled 
  28.           in forms (called records in here) unless the loss occurred 
  29.           during the very short interval that the file is opened.
  30.  
  31.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  32.  
  33.           If you simply type
  34.  
  35.           CALLFOR
  36.  
  37.           then you get the help list only.
  38.  
  39.           The help list does not occupy needless memory, once the
  40.           program is in memory.
  41.  
  42.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  43.  
  44.           To run this, simply type
  45.  
  46.           CALLFOR RUN
  47.  
  48.           and end it with an <ENTER> or <ntr> or <cr> or anything
  49.           else you want to call the carriage return.  Just the letter
  50.           'r' in 'run' will work also.  The <alt> and 'M' will pop up
  51.           the menu.  The BAZIC.EXE program, another program in this 
  52.           series, must have at least 'ru' of 'run' in order to work.
  53.  
  54.           Pop up CALLFOR.EXE from DOS or under another program by 
  55.           pressing down on the alt key and while keeping this key 
  56.           pressed down, also pressing down on the letter "M".  
  57.           CALLFOR.EXE will not pop up from DOS while you're displaying 
  58.           the directory or something else but will pop up right after 
  59.           DOS stops doing whatever you told it to do.
  60.  
  61.           You can load any other program AFTER the CALLFOR to be
  62.           removed along with CALLFOR, provided that the other programs
  63.           have my name mentioned somewhere or it mentions that that
  64.           particular program will wipe out this program also.  Avoid 
  65.           running any other memory resident program after CALLFOR if
  66.           not made by this group or specifically mentions that
  67.           CALLFOR will wipe out that software also.
  68.  
  69.           CALLFOR.EXE itself does not have a wipe out feature, but 
  70.           many other programs made by this group will wipe this out 
  71.           from memory without rebooting.
  72.  
  73.           Do not load this or any memory resident program from the DOS 
  74.           mode many programs now-a-days.  In other words, if you 
  75.           happen to be in your favorite word processor and you 
  76.           suddenly go to DOS with the ability to go back to where you 
  77.           left off on the word processor by typing EXIT at the DOS 
  78.           prompt, do not load any memory resident program and then 
  79.           EXIT back to your word processor.  You've just initiated the 
  80.           computer system for a lock up and you will have to reboot 
  81.           the system as soon as you get out of your word processor.
  82.  
  83.           Similarly, do not load any memory resident program which can 
  84.           be removed from memory, run your word processor, go to the 
  85.           DOS mode, and then wipe out the memory resident program.
  86.  
  87.           These two conditions are both going to cause the computer 
  88.           system to lock up.  This is not a fault of this or any 
  89.           memory resident program, free, public, or expensive payware.
  90.  
  91.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  92.  
  93.                          HOW CALLFOR.EXE WORKS
  94.  
  95.           To run CALLFOR.EXE, type from the DOS prompt
  96.  
  97.           CALLFOR RUN<ntr>
  98.  
  99.           The first thing CALLFOR.EXE does is to check to see if 
  100.           another copy of CALLFOR.EXE is already in memory or not.  
  101.           After all, why waste memory?
  102.  
  103.           Then it checks to see if a copy of the records file CALLFOR 
  104.           (no extension given) is in the diskette or subdirectory 
  105.           which you ran CALLFOR.EXE.
  106.  
  107.                If a copy exists, then the drive (and subdirectory, if
  108.                any) where it exists is also recorded.  The total time 
  109.                is read and stored, and it becomes memory resident.
  110.  
  111.                If a copy does not exist in the present diskette or 
  112.                subdirectory, then the PATH is searched to find out if 
  113.                the records can be found.  If found, then the drive and 
  114.                subdirectory is noted and the total time is read and 
  115.                stored, and it becomes memory resident.
  116.  
  117.                If no copy exists, then the present drive and 
  118.                subdirectory is noted and a new CALLFOR records file 
  119.                is created here. (A hard disk is preferable since 
  120.                removing the diskette with the records or running out 
  121.                of empty space can cause errors.)
  122.  
  123.           When you press down on the alt key and while keeping this 
  124.           key pressed, you also press down on the letter "M", 
  125.           CALLFOR.EXE will pop up under your program.
  126.  
  127.           The pop up is designed to work on 80 columns and higher 
  128.           modes.  CALLFOR.EXE will not pop in 40 column modes.
  129.  
  130.           This is the type of pop up you'll get:
  131.  
  132.  
  133. insert mode            Record #:     1        Date: September 10, 1988  11:14pm
  134. Message for:                                                                   
  135. From:                                                                          
  136. :                                                                              
  137. Please call:            Tel #:                     Ext.:                       
  138. Returned your call:     Will call again:           Wants to see you:           
  139. Date:                   Time:                      Message received by:        
  140. Action: Approval: Signature: Note&return: Forward: File-it: Others:            
  141. =================================================<esc>=exits==v=0.1=DrMS&ASSOC=
  142.  
  143.                Let's call this entire thing composed of eight lines of 
  144.                79 characters wide screen as one record, and let's call 
  145.                each section which ends with the colon ":" as a field.  
  146.                And the entire list of such records as stored in your 
  147.                disk(ette) as a file.  So a field is one area to fill 
  148.                in such that "Please call:            " is one field, 
  149.                "Tel #:                     " is another field here and
  150.                "Ext.:                       " is still another field.
  151.  
  152.           The collection of such fields make up one such form to be
  153.           filled in, and this one such form which is already filled in 
  154.           by you is called a record.  The word "form" is used
  155.           sparsely here and is used to describe each record which is
  156.           not yet filled in by anything you typed.
  157.  
  158.           Every time someone comes calling into the office or makes a
  159.           phone call and wants to leave a message, you fill in one
  160.           such form after another.  The collection of all the records
  161.           which was filled in by you is called a file.
  162.  
  163.           It's important that you know the difference between what is
  164.           meant here by a field, a record and a file, as well as a 
  165.           form, in order to understand the rest of this document
  166.           since these four words are used to mean exactly that.
  167.  
  168.           In text mode, the blinking cursor will be just after the
  169.           colon ":" of "Message for:" and the mode will be in insert
  170.           mode.  This is like the regular word processor type insert
  171.           in that all characters to the right of the cursor will move
  172.           right.
  173.  
  174.                Once you start on the comment, the default is the 
  175.                INSERT mode.  In this mode, characters to the right of 
  176.                the cursor will be pushed right.  To switch between 
  177.                INSERT and OVERWRITE modes, press down on the INS key:  
  178.                The indicator to the left of the record number will 
  179.                tell you which mode you're in.
  180.  
  181.                The default mode for the first three rows is the insert 
  182.                mode and the default for the rest of the rows is the 
  183.                overwrite mode.  The indicator on the top left will 
  184.                tell you which mode you are currently in.
  185.  
  186.                     The DEL key will delete the character at the
  187.                     cursor, and the rest of the characters to the
  188.                     right of the cursor are pushed left to fill the
  189.                     spot.
  190.  
  191.                     The backspace will delete left as expected and all 
  192.                     characters to the right of the cursor will move 
  193.                     left, following the cursor.
  194.  
  195.                Once you press on the INS key, or if you go below the
  196.                first three rows and the indicator says "overwrite", 
  197.                then some keys behave differently:
  198.  
  199.                     The DEL key will not work.
  200.  
  201.                     The backspace will delete left, but all characters 
  202.                     to the right of the cursor will NOT move left.
  203.  
  204.           In either modes, the backspace will not stop deleting at
  205.           the colon ":" of the named fields, but will continue to
  206.           erase till the column 1 on the left corner.  (This is not a
  207.           bug but a feature, since this feature allows you to tailor
  208.           the form to fit your needs and to have pre-filled parts as
  209.           well.  This is discussed in more detail later on.)
  210.  
  211.           HOME will not move the cursor if the cursor is on the left
  212.           column 1.  If not on the very left, then it will search for
  213.           the colon ":" to the left of the cursor and will move the
  214.           cursor right after the colon.  The HOME key will not move
  215.           the cursor from the present row of fields.
  216.  
  217.           For example, if the cursor is represented by an "x" here
  218.  
  219.           "Please call:    x       Tel #:                     "
  220.  
  221.           and you press on the HOME key, then the cursor will go
  222.  
  223.           "Please call:x           Tel #:                     "
  224.  
  225.           It's a lot simpler to understand if you use it than if you
  226.           read this document.  But try to read the document, since
  227.           you can use this program more efficiently if you have an
  228.           inkling of an idea on what features are available.  And you
  229.           can look up the feature to clarify your vague memory.
  230.  
  231.           END will not move if the cursor is already on the very
  232.           right column.  Otherwise, it will search for the presence
  233.           of a capital letter and moves the cursor to just before the
  234.           capital letter.  For example, if the cursor is represented
  235.           by an "x" here
  236.  
  237.           "Please call:    x       Tel #:                     "
  238.  
  239.           and you press the END key, then the cursor will move to the
  240.           end of the field like this.
  241.  
  242.           "Please call:           xTel #:                     "
  243.  
  244.           The <ntr> key is the third key which does this type of 
  245.           searching.  This is the key known as the carriage return or 
  246.           ENTER, or CR or ^M.
  247.  
  248.           Every time you press down on the <ntr> key, the program 
  249.           searches for the presence of a colon to the right of the 
  250.           cursor.  And if found, then the cursor is placed right after 
  251.           the colon.  If the present row of fields no longer 
  252.           contained a colon, then the next row of fields are 
  253.           searched.  Once the very last field on the last row is 
  254.           searched, then the cursor will be placed on the top row 
  255.           first field.
  256.  
  257.           For example, if the cursor is represented by an "x" here and 
  258.           you press <ntr>,
  259.  
  260.      Returned your call:     Will call again:   x       Wants to see you:
  261.      Date:                   Time:                      Message received by:
  262.  
  263.           then the cursor will go here
  264.  
  265.      Returned your call:     Will call again:           Wants to see you:x
  266.      Date:                   Time:                      Message received by:
  267.  
  268.           and if you press down on the <ntr> now, then it goes to the 
  269.           next field on the next row like this
  270.  
  271.      Returned your call:     Will call again:           Wants to see you:
  272.      Date:x                  Time:                      Message received by:
  273.  
  274.           and so on.  After such repeated pressing on the <ntr> key 
  275.           and the cursor goes to the very last right bottom field here
  276.  
  277.      Action: Approval: Signature: Note&return: Forward: File-it: Others:x
  278.  
  279.           and you press <ntr> again, then the cursor will be moved to 
  280.           the very top left row's field here
  281.  
  282.      Message for:x
  283.  
  284.  
  285.           This behavior of searching for the colon ":" and a capital 
  286.           letter should be remembered when you modify the form (in 
  287.           other word, the blank record which is not filled in) to fit
  288.           your needs as it changes over the course of the day.
  289.  
  290.  
  291.           The <esc> key will get you out of the pop up.  If you did 
  292.           not even type a single space and just moved the cursor 
  293.           around, then a record is not stored to disk.  To make an 
  294.           empty record (in other words, a duplicate of the form)
  295.           stored in disk(ette), type a few spaces.
  296.  
  297.           When you cursor up/down, the insert/overwrite mode will 
  298.           indicate "insert mode" on the first top three rows of fields 
  299.           and will indicate "overwrite" on the rest of the rows of 
  300.           fields.  This default is necessary (you can change the 
  301.           default by switching with the INS key) since if you had it 
  302.           in insert mode with the cursor represented by an "x" and you 
  303.           typed any letter,
  304.  
  305.      Date:        x          Time:                      Message received by:
  306.  
  307.           the two fields to the right of the cursor will move right 
  308.           like this
  309.  
  310.      Date:         x          Time:                      Message received by:
  311.  
  312.           You may want this behavior when modifying the number of 
  313.           fields and pre-filling other fields.
  314.  
  315.           When you type any letters, numbers and such printable 
  316.           characters (including extended ascii for foreign characters, 
  317.           Greek symbols, box shapes, etc) in the insert mode, every 
  318.           other printable characters, including any field to the right 
  319.           of the cursor is also moved right.
  320.  
  321.           When you type any printable character in the overwrite mode, 
  322.           the rest of row does not move.  However, you are allowed to 
  323.           overwrite any field name to the right of the cursor on this 
  324.           row. (overwriting to the fields on the next row is 
  325.           prohibited)
  326.  
  327.           So, if the cursor is at "x" and you type "but was very rude 
  328.           too"
  329.  
  330.      Returned your call:  x  Will call again:           Wants to see you:
  331.      Date:                   Time:                      Message received by:
  332.  
  333.           then the record will look like this
  334.  
  335.      Returned your call:  but was very rude too         Wants to see you:
  336.      Date:                   Time:                      Message received by:
  337.  
  338.           This will be stored in the file in the disk(ette).  However, 
  339.           the next time you pop up CALLFOR.EXE, the fields will be as 
  340.           before.  The word "but was very rude too" will not be the 
  341.           default.
  342.  
  343.           To change the fields and pre-filled fields of the form which 
  344.           will appear everytime you pop this up, first type over the
  345.           fields as you like, making sure that each field begins with
  346.           a capital letter (like A, B or C) and end it with the colon
  347.           (the ":", not the semi-colon ";").  You can add or subtract
  348.           as many fields as will fit.  Use the insert mode by
  349.           pressing down on the INS key or use the overwrite mode by
  350.           pressing down on the INS key again as you see fit.
  351.  
  352.           For example, to change this row of three fields 
  353.  
  354.      Returned your call:     Will call again:           Wants to see you:
  355.  
  356.           to
  357.  
  358.      Returned your answer: May call: Wanna talk to you: Wanna borrow dough:
  359.  
  360.           move the cursor to the "c" in "Returned your call:" and 
  361.           type 
  362.  
  363.           "answer: May call: Wanna talk to you: Wanna borrow dough:"
  364.  
  365.           To make this the default which will pop up, press down on 
  366.           the alt key and while keeping this key pressed down, also 
  367.           press down on the "S" letter to "S"ave this as the new 
  368.           default of the form to fill in.
  369.  
  370.           Similarly, if you really messed up filling the present 
  371.           record in and you want to start by filling it in with a 
  372.           clean slate, do altl with the letter el "L".  This will wipe 
  373.           out the mess and will "L"oad the clean form before it was 
  374.           messed up.
  375.  
  376.           Note that storing and loading a form is the only operation 
  377.           which require that you press two keys at the same time, once 
  378.           you're in the pop up.  This prevents you from accidentally 
  379.           storing a new form or erasing the filled in record by 
  380.           loading an empty form over it.
  381.  
  382.           The list of records are stored as regular ascii file and can 
  383.           be loaded into your favorite word processor/editor or 
  384.           printed directly from DOS to your printer; do
  385.  
  386.           COPY CALLFOR CON:<ntr>
  387.  
  388.           from DOS.  Where <ntr> here is the carriage return you type.  
  389.           Do not type the two symbols and three letters representing it.
  390.  
  391.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  392.  
  393.                       FORMAT OF THE "CALLFOR" TIME LIST FILE
  394.  
  395.           CALLFOR.EXE reads a file called CALLFOR without any extension
  396.           to find out what the total time spent on your project was so 
  397.           far.
  398.  
  399.           As presented above, each record consists of eight lines of 
  400.           79 characters width.  The default form has a certain number 
  401.           of fields you can fill in with x's or with text.  The number 
  402.           of fields you decide to add or subtract is under your 
  403.           control.  Just make sure that each field name begins with a 
  404.           capital letter and ends with a colon.  And if the entire row 
  405.           is to be one comment (like the third row), put a colon 
  406.           anyway, so that the HOME and <ntr> keys can work properly.
  407.  
  408.           When CALLFOR.EXE first becomes memory resident and if there 
  409.           was already a CALLFOR records file present, then CALLFOR.EXE 
  410.           will check to see if the file was tampered.  It does this by 
  411.           dividing the length of the file with 648, the length of each 
  412.           record in the file.  If the file length was not divisible by 
  413.           this value, then CALLFOR.EXE will not become memory resident 
  414.           and will display a warning.
  415.  
  416.           This last feature is not really necessary since this version 
  417.           does not have other fancy features, but is placed here for 
  418.           consistency's sake.
  419.  
  420.           To make CALLFOR.EXE run, rename the file so that CALLFOR.EXE 
  421.           will create a new records file.  Or if you can figure out 
  422.           where the changes were made, correct the length of each line 
  423.           to 79 again and CALLFOR.EXE will run properly.
  424.  
  425.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  426.  
  427.                               PROMPTS AND MESSAGES
  428.  
  429.           =-=-=
  430.           You don't have to do it, CALLFOR is already in memory
  431.           =-=-=
  432.  
  433.           If you tried to run CALLFOR when CALLFOR was already in
  434.           memory, then you get this message.
  435.  
  436.           =-=-=
  437.           The callfor file not found
  438.           A new one is being created
  439.           =-=-=
  440.  
  441.           CALLFOR.EXE did not find the CALLFOR records file in 
  442.           either the default or the PATH listing.  As a result, a new 
  443.           records file is being created.
  444.           
  445.           If another of this group's memory resident program was
  446.           loaded before this program, and that program is removeable,
  447.           then remove that to remove this from memory.  If you need a
  448.           removeable CALLFOR.EXE, you can try asking for such a 
  449.           feature.
  450.  
  451.           =-=-=
  452.           This file was modified by someone and no longer corresponds to
  453.           the format originally set up.  Please correct this according
  454.           to the document CALLFOR.DOC
  455.           =-=-=
  456.  
  457.           When CALLFOR.EXE first ran, it read the pre-existing 
  458.           CALLFOR records file.  However, you apparently modified it 
  459.           yourself and changed the listing.  See above on the format 
  460.           on how the records file should be set up.
  461.  
  462.  
  463.                       MESSAGES FROM WITHIN THE POP UP
  464.  
  465.           =-=-=
  466.           File not found.  Type any key to retry or <esc>
  467.           =-=-=
  468.  
  469.           The pop up cannot find the CALLFOR records file.  Chances 
  470.           are that you removed the diskette where it existed.  Insert 
  471.           the diskette with the records file and type any key.  Or 
  472.           type <esc> to avoid writing the new record and exit the pop 
  473.           up.
  474.  
  475.           =-=-=
  476.           I cannot write the file.  Type any key to retry, <esc> aborts
  477.           =-=-=
  478.  
  479.           It appears that the records file was read but was unable to 
  480.           write the new record in here.  Insert the diskette with the 
  481.           records file and type any key to retry, or <esc> to avoid 
  482.           writing the new record and exit the pop up.
  483.  
  484.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  485.  
  486.  
  487.           All products and names mentioned are Trademarks or
  488.           Registered Trademarks of their respective corporations or
  489.           companies.
  490.  
  491.           All enclosed programs, documents and other files are
  492.           provided AS IS, without any warranty, expressed or implied,
  493.           including but not limited to fitness for a particular
  494.           purpose.
  495.  
  496.           If you find that this does not work in your machine, we
  497.           would like to know exactly what happened.  With enough
  498.           information, some of which you may consider useless, we may
  499.           be able to make it work in your computer as well.
  500.  
  501.           A contribution of $10 US/Canadian is appreciated if you
  502.           find this useful, or $20 for an improved one.  Your
  503.           negative criticisms are as welcome as your positive ones.
  504.  
  505.           PURPOSE OF THIS PROGRAM:
  506.           This program is for the receptionist/secretary.  This records 
  507.           the call of a phone/visitor on a pop up form.  And if the 
  508.           default form is not suitable at any given time, you can
  509.           re-write a new one on-the-fly, while in the pop up with new
  510.           selections and others pre-filled in already.  Features found 
  511.           in a regular word processors makes everything easy to fill.
  512.  
  513.  
  514.  
  515.           my old forwarding address was
  516.  
  517.           Dr. Masaaki Sawada & Assoc.
  518.           University of Waterloo, Faculty of Science
  519.           Waterloo, Ontario  Canada  N2L 3G1
  520.  
  521.  
  522.           the new forwarding address is
  523.  
  524.  
  525.           Dr. Masaaki Sawada & Assoc.
  526.           Lady Davis Institute for Medical Research,
  527.           Sir M. B. Davis Jewish General Hospital,
  528.           3755 Chemin Cote Ste-Catherine, 
  529.           Montreal, Quebec, 
  530.           Canada  H3T 1E2
  531.  
  532.  
  533.           (you'll find it a lot easier to cut this address out with
  534.           your word processor and print it on an envelope, rather
  535.           than trying to write it by hand)
  536.  
  537.  
  538.           The institute name is given instead of home address to
  539.           lower the chances that any mail is delivered to a wrong
  540.           address (a common occurrence).  However no institute time
  541.           nor equipment was used to write this program or document.
  542.  
  543.  
  544.  
  545.