Appendices A to K          `  ? ? % <łB        @ AAAAAAAAAA                                   2    Appendix A.  Punctuation Voicing Levels.      Any one of 5 levels of punctuation voicing can be selected by     pressing READ with FUNCTION KEY 8.  The way these levels treat     punctuation and format markers is defined below.      a)   Punctuation Level 1       All punctuation is ignored except \.  	   
 b)   Punctuation Level 2      Uncommon punctuation & / > < * + ^ [ ] | \ = % $ # is pronounced.     
 This is the default speech option when the machine is     initialized.      c)   Punctuation Level 3      All punctuation is pronounced except comma, period, question     mark, exclamation mark, semi-colon, colon, space, and single     quotes within words.      d)   Punctuation Level 4      All punctuation except for single spaces between words and single     quotes within words is pronounced.   Line Break, Page Break, and     New Format markers are announced.   Spaces nested between the end     of a word and a period, comma, semicolon or colon are also     announced.  Capital letters are indicated by raising the pitch.       If the first letter of a word, or all of the word is in capitals,     the pitch is raised for the whole word.   If a letter within a     word is capital, the pitch is raised from that point.   This      provides an alert to capital letters typed within words.  !   " e)   Punctuation Level 5  #   $ All text is spelled.   This level is not recommended for    % reviewing text, but it may be of use for other applications.    & Capital letters are spoken by announcing "CAP" before the letter.    ' If the whole word is in capital letters, the spelling of the word    ( will be prefixed with the announcement "CAP ALL".  )   * End of Appendix A.  +         Appendix B.  Serial Communications Parameters.    In order to communicate correctly with an external device such as    a serial printer or another computer, appropriate communications    settings must be established.    These settings must be defined in the Printer Set Up List if a    Serial printer is to be used, as described in section 5.5.2. They    must also be defined in the Communications Set Up List if it is   	 planned to transfer files between KeySoft and another computer,   
 as described in section 11.5.  The two sets of parameters are    independent but they are entered in exactly the same format.   
 Range of Allowable Values    The possible values are as follows:    Baud Rate  -110, 150, 300, 600, 1200, 2400, 4800, 9600, or   19200, 38400, 57600, 115200.  (These are   transmission speeds in data bits per second.)    Parity-N, O, or E.  (These define whether there is No   parity check, an Odd parity value, or an Even   value.)    Word Length  -7 or 8.  (The number of data bits per character   transmitted.)    End of Appendix B.          Appendix C.  Printer Information.    The following type styles may be obtained in KeySoft documents on    a range of popular printers.  The designated letter is entered    after the CONTROL with T command.    Bold:B  Condensed:C  Double strike:D 	 Elongated:E 
 Italics:I  Double Width and HeightJ  Quadruple Width and HeightK 
 Near Letter Quality:N  Overstrike:O  Superscript:S  Subscript:T  Underline:U  Proportional spacing:Z    Not all printers can produce all these type styles and some    printers will have additional type styles available.  If a    particular type style is unavailable, the printer will ignore    these embedded commands.  Each printer type file supplied with    KeySoft has a KeyWord text file supplied with it which lists the    type styles supported for that particular printer and the    corresponding letter to select it.    Printers Supported.    KeySoft supports the following printers.  Other printer driver    files will be developed as the demand warrants.    ! APPLE IMAGE WRITER. " C. ITOH and APPLE. # CITIZEN 120D. $ EPSON ENHANCED. % HEWLETT PACKARD DeskJet 500F. & STANDARD. ' STANDARD 2. ( IBM QUIETWRITER. ) STAR NX1000. *  + End of Appendix C. ,         Appendix D.  Searching For Format Markers. If you wish to    introduce major changes to the layout or presentation of a    document, you may need to locate such characters as New Format    markers, Type Style markers, Underline markers, etc.  If you want    to change the format of paragraphs, you will need to locate New    Line markers.    The Search, and Search and Replace Commands can be used to locate    any of these symbols. 	  
 The following examples indicate the text string which should be    entered to search for these markers:   
  New Linestring:  CONTROL with ENTER   New Pagestring:  CONTROL with N   New Line Formatstring:  CONTROL with L  (This may not be entered at the "Replace   with?" prompt.)   Underline Onstring:  CONTROL with U N   Underline Offstring:  CONTROL with U F   Type Style Onstring:  CONTROL with T X N   Type Style Offstring:  CONTROL with T X F   Center Linestring:  CONTROL with C   Right Justifystring:  CONTROL with R    End of Appendix D.          Appendix E.  Error Messages.    The majority of the Error Messages which may occur while using    KeySoft, and the likely reasons why they occur, are listed below.     Error messages associated with the KeyPlan diary and the KeyList    address list are not included.    When an error occurs, correct the cause of the error if this is    necessary, then press ENTER to continue.   Some error messages   	 give a retry option.   In these cases press ENTER to retry,   
 otherwise press ESCAPE.    In the following disk drive related errors, "x" denotes the drive   
 letter.    "No disk in drive x". There is no floppy disk in drive x, or it    is not inserted properly.   Find the cause of the problem,    correct it, and then press ENTER to retry.    "Unclassified error". An error has occurred while the disk is    being read.  Press ENTER or ESCAPE to abandon.   In the case of a    floppy disk, check whether an unformatted one has inadvertently    been used. If this is not the case, then retry a few times.  If    the error still persists then the disk is damaged.  Copy all you    can off the disk, then format it again.  If an error occurs    during formatting, the disk is unusable.    "The protection tab is on disk in drive x". The write-protect    switch on a floppy disk is on.   If you still wish to save on the    disk, move the write-protect tab to the "off" position and then    press ENTER.  If not, press ESCAPE.     "File will not fit on disk x". There is insufficient space left   ! on the disk to store the new file.   Erase any files that you no   " longer require, or use another disk. #  $ "Disk x is full". If this message is announced, no more   text   % can be saved on that disk unless some text is deleted.   Erase   & any files that you no longer require.  If disk x is a floppy   ' disk, use another. (  ) "File is protected". The file you are trying to Edit or Erase is   * protected.   Press ESCAPE to abandon.  If you wish to proceed,   + unprotect the file and start again. ,  - 	   "Out of memory". If this message is announced, no more text can  	  be saved on the current disk unless some text is deleted or a  	  complete file is erased.	  	  "File does not exist". The name entered after the "Filename?"  	  prompt does not exist in the directory specified.   Press the  	  RIGHT ARROW key to read the directory in case you have misspelled  	  the name.	  	 	 "No more free files". No more files may be added to that  	 
 directory.   Press ESCAPE to abandon.  Erase any files you no  	  longer require, or in the case of a floppy disk, use another.  	  "Can't copy to same file". An attempt has been made to store a  	 
 block, or insert a block, back into the same filename.   Enter a  	  filename different to that of the file containing the block.	  	  "Bad entry". The number or letter sequence entered at that point  	  is incorrect.   Press the HELP key to obtain information on the  	  required format, or refer to the appropriate section of the  	  User's Guide.	  	  "Number out of range". The number entered at that point is not in  	  the allowable range.   Refer to the appropriate section of the  	  User's Guide.	  	  "Can't find". The word being searched for cannot be found in the  	  direction of the search.   If you are sure the word is in your  	  document, try searching in both directions.  Check your spelling,  	  and try some other likely spellings.	  	  "Can't find place". The Place Marker letter specified cannot be  	  located.	   	 ! "Can't find "n" block marker". The block marker specified (either  	 " Top or Bottom) cannot be located.   This error occurs when you  	 # use the Jump to Place Marker command to try to jump to a  	 $ non-existent block marker.	 % 	 & "Can't find 2 block markers". A block command has been attempted  	 ' without both the top and bottom markers having been defined.    	 ( Mark the top and bottom of block and try again.	 ) 	 * 
   "Bottom marker is before top marker". A block command hass been  
  attempted with the bottom block marker placed before the top  
  marker.  Redefine the top and bottom block markers and try again.
  
  "Printer not ready". This error will occur for one or more of the  
  following reasons:
  
  1.   The printer is not switched on.
  2.   The cable to the printer is not connected or not 
 	 connected properly at one end or the other.
 
 
  Find the cause of the problem, correct it, and then press ENTER  
  to retry.  If you do not wish to continue, press ESCAPE.
 
 
  "Entry exists". The word you have tried to add to the Dictionary  
  already exists.  Use the RIGHT ARROW key to review the Custom  
  Dictionary entries.
  
  "Entry does not exist". The word you have tried to change in the  
  Dictionary does not exist.  Use the RIGHT ARROW key to review the  
  Custom Dictionary entries.
  
  "Host not ready". The host computer is not ready to receive data  
  from KeySoft. Check the cable connections.
  
  "Receiving bad data". KeySoft is receiving bad data from the host  
  computer.  Check that the communications protocol is correct, and  
  if not, change the communications code entry in the  
  Communications Menu Set-Up List.
  
  End of Appendix E.
          Appendix F.  Special Display Messages. In the Edit mode, the    following messages are shown on the bottom of the Display screen    when the cursor is positioned on a particular marker.  They are    used to indicate the format of the document being edited.    Binding Space. Used to prevent word wrap between words that    should remain on the same line.    Line Break. Indicates where a line has been broken by automatic   	 word wrap. 
   New Line. Indicates where ENTER has been used to end a line.   
 Page Break. Appears under a Line Break or New Line to indicate    the end of a page.    New Page. Indicates where CONTROL + N has been used to start a    new page.    End of File. Indicates the end of the file.    New Format. Indicates the start of a new line format list.    Underline Start. Indicates the start of underlined text.    Underline End. Indicates the end of underlined text.    Type Style (description) on or off. Indicates the start or finish    of a type style.    Top of Block. Indicates the top of a block.     Bottom of Block. Indicates the bottom of a block. !  " 
   Place Marker (x). Indicates a Place Marker.  X is a letter from A  
  to Z.
  
  xyz Field. Displayed when the cursor is in a field inserted by  
  CONTROL with A.
  
  Insert Date. Displayed when the cursor is in a printing date  
  field..
  
 	 End of Appendix F.
 
 
     Appendix G.  Pronunciation Dictionary Hints. The pronunciation    dictionary allows you to change the way a word, phrase or    character string is spoken.  The text may occur in a KeySoft    document, or it may be in a KeySoft prompt or help message.  In    general, you would only change the pronunciation of text which    you often use or encounter.  The Pronunciation Dictionary has two    typical uses:      1.  Correcting a mispronunciation. 	 2.  Substituting a text string. 
   These uses will now be discussed.   
 G.1. Fixing a Mispronunciation.    It is unusual to find a word which is seriously mispronounced,    but people's names and foreign words may be exceptions. Typical    problems are a shift in vowel sound, and misplaced stress.    To correct the way a word is spoken, misspell it phonetically,    and use a space to shift the stress.  For example:    Change "Mikhail Gorbachov" to "Mikhile Gorba choff".  Change "Socrates" to "Socra tees".  Change "Taj Mahal" to "Taaj Mah harl".    G.2. Substituting a Text String.    There are various reasons why you may wish to put a substitute    text string in the Pronunciation Dictionary.  For example,    KeySoft correctly speaks many acronyms which contain vowels, such    as "IBM".  However, a less common acronym may be spoken as a     word, so you may wish to use the Pronunciation dictionary to   ! change the rendering.  For example: "  # Change "ATM" to "A T M", or "automatic teller machine". $ Change "NaCl" to "N A Cl", or "sodium chloride". %  & You may also change the way in which symbols are spoken.  For   ' example, the character obtained by pressing SHIFT with 8 is   ( spoken by KeySoft as "star".  If you prefer to hear "asterisk",   ) you may do this with the Pronunciation Dictionary. *  + Change "*" to "asterisk", and , change "*s" to "asterisks", to cater for repeated symbols. -  .    You can have fun changing the way a word is spoken, but take    care!  It can be a source of mystery later on, when you have    forgotten that you made the change.    End of Appendix G.       Appendix H.  Keysoft Directories.    This Appendix provides a short Tutorial about the use of    Directories in KeySoft.  It is supplementary to Section 4.2,    Filenames and Directories, and Section 4.3, Reviewing File    Directories.  Before we start, it will be helpful to review how    the various KeySoft files are stored on the Companion.    H.1. Drives and Directories. 	  
 H.1.1. The "C" Drive.    The installation program creates a directory called \keynote, and   
 also six sub-directories of \keynote.  These are called keylist,    keyplan, KeyTerm, manual, printers, and text.    H.1.2. The Text Directory.    All wordprocessor files which you create are stored, by default,    in the "text" sub-directory.  You may store files in any other    directory with the KeySoft file management system.    H.1.3. The KeyList Directory.    The "keylist" directory is used to store files containing your    address list information.  Two address list files, named "Address    Notebook" and "Sample Address List", are automatically created in    this directory, together with two template files.    The file named "Address Notebook" contains the skeletal structure    of your address list.  It contains headings for Surname, First    name, Street Address etc. into which you may enter address     information. !  " As the name implies, the file named "Sample Address List"   # contains a number of address entries that have been provided as   $ examples, to assist you in setting up your own address list. %  & You may wish to create a number of different address list files   ' of your own, for example, choosing to separate business,   ( personal, and sporting contacts into different files. )  *    H.1.4. The Letters Directory.    A directory called "letters" has been created for use with this    Tutorial.  It is a sub-directory of \keynote\text.  In turn it    contains three further subdirectories named Personal, Business,    and Club.    With the exception of the Club subdirectory, they have no files    stored in them.  In the Club subdirectory, a wordprocessor file   	 named "April Minutes" has been stored. This file contains a   
 sample file for use during the Tutorial.    H.2. File Types. 
   The KeySoft file management system categorizes files according to    their type, namely:    KeyWord text for wordprocessor files,  KeyPlan diary for diary files, one per year,  KeyList address for address list files, one per list,  Pronunciation dictionary for pronunciation correction   entries,  Spelling Dictionary for lists of words for spell check   purposes, and  Printer for printer driver files.    When KeySoft presents you with a list of file names, it filters    the files in the directory and only presents those files relevant    to what you are currently doing.  For example, if you are in the    KeyWord wordprocessor, only KeyWord text files are announced.  If    you wish to review all files present in a particular directory    you should use the Directory option in the File Commands Menu.      To obtain information on the type of file being reviewed, press   ! READ with I after the file name has been announced. "  # H.3. Accessing Files In Another Directory. $  % As discussed earlier in this Tutorial, we have placed a file   & named "April Minutes" in the "club" directory.  The full pathname   ' of this directory is: \keynote\text\letters\club.  We will now   ( access this file with KeyWord. )  * Step 1.Press F3, the MENU key, so that we have a common  + starting point.  Remember!  Use the HELP key if you get  , stuck. -  . Step 2.Press F4, the WORD key, and after the filename prompt,  / press CONTROL with D. 0  1    KeySoft will prompt, "Drive? Press Enter for C:"    Press ENTER, or "C", to confirm you are looking for   information on the C drive.    Step 3.KeySoft will then prompt for the directory name,   saying, "Directory name? Press ENTER for   \keynote\text", if this is the default directory. Don't   press ENTER yet. 	  
 At this point you have two ways of selecting the   desired directory.  The most direct way is to type in   the full directory path name, but this can be rather  
 tedious.  Instead, we will use the ARROW keys to   navigate our way through the directory structure.    Step 4.Press the RIGHT arrow key to review the subdirectories   of \keynote\text.  When you hear "letters" announced,   press ENTER.  KeySoft will prompt you to press ENTER to   confirm that you wish to look for files in the   "letters" directory.  We know that there are no files   in this directory, so press RIGHT ARROW again to see if   the "letters" directory has any subdirectories.    Further presses of RIGHT ARROW will announce, "parent",   "business", "club", and "personal".  After the   announcement of "club", press ENTER.  Press ENTER again   to confirm you wish to review the "club" directory.  If   you had pressed ENTER at the announcement of "parent",   you will be returned to the \keynote\text directory,   which is the parent directory of "letters".  Another   way to return to the parent directory is to press UP   ARROW at the "Directory Name?" prompt.    ! Step 5.At the "Filename?" prompt for the "club" directory, use  " RIGHT ARROW to review the files.  The first  # announcement will be a confirmation of the directory  $ name, and the second should be "April Minutes". Press  % ENTER to open this file. &  ' Step 6.If you leave the wordprocessor and return later,  ( KeySoft will remember your last selections. You will be  ) offered "club" as the default directory, and if you  * select it, KeySoft will offer you "April Minutes" as  + the default file name.  Until you select another  , directory, KeySoft will continue to access files in the  - "club" directory. .  /    H.4. Accessing the Keysoft Manual.    One of the first documents that most users want to access is the    User's Manual.  Let's do this now.    Step 1.Select Edit mode by pressing F4, the WORD key, and   after the "Filename?" prompt, press CONTROL with D to   change directory.   	 Step 2.KeySoft will prompt, "Drive? Press Enter for C:" Press  
 ENTER.    Step 3.KeySoft will then prompt for the directory name. Use  
 the ARROW keys and ENTER to select the \keynote\manual   directory.    Step 4.Use RIGHT and LEFT ARROW to review the files in this   directory. You will notice that the manual files are   presented in the form:    1:    Getting started.  2:    Operating basics.  3:    Wordprocessor,  and so on.    Use the ARROW keys to select "1: Getting Started", and   press ENTER.  This chapter will be loaded and you may   review it as a normal wordprocessor document.    Step 5.Once you select a file, KeySoft will remember that you   have changed to the \keynote\manual directory. Let's   assume that while reading Chapter 1, you find that you    need to load chapter 6 for further information. !  " Press F4, and at the "File Name?" prompt, use the ARROW  # keys to select "6  Advanced word-processing", and then  $ press ENTER.  Chapter 6 will be loaded into memory,  % replacing the previously loaded Chapter 1. &  ' Step 6.Assume you have now completed your reading of the  ( User's Manual and wish to return to editing a document. )  * Press F4, and at the "File Name?" prompt, press CONTROL  + with D.  Press "C" to select the drive, and at the  , directory prompt, use the ARROW keys and ENTER to  - re-select the \keynote\text directory. .  /    H.5. Creating a New Directory.    Let's assume you have an interest in music and you find that it    would be convenient to have all your letters relevant to music    grouped under a common directory.  We need to create a new    directory named, for example, "music", as a subdirectory of    "letters".    Step 1.Press F4, and at the "File Name?" prompt, press CONTROL  	 with D.  Press "C" to select the C drive. 
   Step 2.At the directory prompt, use the ARROW keys and ENTER   to navigate the directories until KeySoft says,  
 "Directory name?  Press ENTER for   \keynote\text\letters".  Type  "music", and press   ENTER.  KeySoft will announce, "Directory does not   exist, create a new directory?"  Press Y to confirm   that you wish to create the new directory, which will   be \keynote\text\letters\music.  This is now the   current directory.    Step 3.KeySoft will then prompt for "File name?" in the normal   manner, and you may proceed to create a new letter.    H.6. Copying a File to Another Directory.    A worthwhile exercise for you to try at this point, would be to    copy a file from one directory to another.  We will copy the file    "April Minutes", located in the \keynote\text\letters\club    directory, to a new directory called \tramping.  Notice that    "tramping" is a subdirectory of the root directory.     Step 1.From the Main Menu, press W to select the KeyWord Menu,  ! and F to select the File Commands Menu. "  # Step 2.Press C to select "Copy a File", and press "C" in  $ response to the "Source Drive?" prompt. %  & Step 3.At the prompt for "Directory name?" use the ARROW keys  ' and ENTER to select the directory  ( called\keynote\text\letters\club . )  * Step 4.KeySoft will prompt, "Source file name?"  Use the ARROW  + keys to select the file called "April Minutes", and  , press ENTER. -  . Step 5.Press "C" at the prompt for Destination Drive. /  0    Step 6.Type in the Directory name, in this case \tramping,   followed by ENTER.  Because the directory doesn't   exist, you will be asked to confirm the creation of the   new directory.    Step 7.Type a name for the Destination File and press ENTER,   or if you wish to retain the name "April Minutes",   simply press ENTER.  You will then be returned to the   File Commands Menu. 	  
 Practice, Practice, Practice!    As with most things the best way to gain familiarity with   
 directories, moving around them, performing file copies, file    deletes, etc. is to practice.  Try using all the methods of    navigating around the directories.  Keep at it, and before long    you will be a confident user of directories, and your work will    be beautifully organized!    End of Appendix H.       Appendix I.  The Modem Database.    The modem database can be accessed through the KeyTerm "Port    setup" option, or through KeyList.    To look up the Modem Database from the KeyTerm menu, press P for    "Port selection list".  Review the list of COM ports with RIGHT    and LEFT ARROW, and select the required port number by pressing    ENTER.  KeyTerm will confirm the current modem type. 	  
 Press RIGHT ARROW, and KeyTerm will say, "Modem database". You    may use RIGHT and LEFT ARROW to review the list of modem types    which are supported by KeyTerm.  When you hear the required modem   
 type, press "D".  You may now use RIGHT and LEFT ARROW to review    a list of fields.  If you wish to change a field, press CONTROL    with K and type the new setting.  You may restore default    settings in a similar way to the Directory of Services, as    described in section 10.21.5.    Alternatively, use KeyList to look up or add to the Modem    Database. From the KeyList menu, press S to select a KeyList    file.  At the filename prompt, press CONTROL with D to change    directories.  Select the "C" drive and the \keynote\keyterm    directory, use RIGHT ARROW to find "Modem database", and press    ENTER to select it.  You will be returned to the KeyList menu.    You may now use KeyList to Lookup or Add to the Modem database,    as if it were an address list which consists of a number of modem    names, which can be reviewed with UP and DOWN ARROW.  For each    modem there is a corresponding list of fields which can be    reviewed with RIGHT and LEFT ARROW.  Fields for existing modems    can be changed by pressing CONTROL with K, and new modems can be     added with the KeyList Add function. !  " When you have finished using KeyList to update the modem   # database, you should re-select the Address Notebook.  From the   $ KeyList menu, choose "Select KeyList file", use RIGHT ARROW to   % locate the Address Notebook, and press ENTER. &  ' The record for any modem consists of the following 14 fields:  (  ) Field 1.Modem type.  The modem name may be up to 20 characters. *  + Field 2.Initialization string.  These characters are sent to  , the modem before dialing a number for the first time.   - You may include any A T commands which are valid for  . your modem.  To    enter control characters, precede the letter with ^,   which is normally SHIFT with 6.  The pause character,   defined in the Option setup list, may be used.  This is   usually ~.  The string will normally end with "^m",   representing a carriage return.    Field 3. Dial prefix.  KeyTerm sends these characters to the   modem before the phone number.  The default is "atdt",   for tone dialing. 	  
 Field 4.Dial suffix.  KeyTerm sends these characters to the   modem after the phone number.  The default is "^m".   
 Field 5. Hangup string.  KeyTerm sends this string to the modem   if it fails to hang up the line after Data Terminal   Ready is de-asserted.    Field 6.Auto-answer string.  KeyTerm sends this string to the   modem when "answer" is selected in the Directory of   Services.    Field 7.Connect string.  KeyTerm looks for this string after   dialing, or when waiting for the modem to answer a   call, to indicate that a connection has been achieved.    The default is "connect".    Fields 8 to 11.No-connect string 1, 2, 3, and 4.  KeyTerm   looks for any of these 4 strings from the   modem, indicating that the number should be   re-dialed.  The default settings are: "no   carrier", "busy", "no dialtone", and a blank   field.    ! Field 12.Voice dial prefix.  KeyTerm sends this string to the  " modem before a voice call number.  The default is  # "atdt". $  % Field 13.Voice dial suffix.  KeyTerm sends this string to the  & modem after a voice call number.  The default is "^m". '  ( Field 14.Voice dial hangup.  KeyTerm sends this string to the  ) modem to hang up a voice call. *  + The remaining fields in the modem data base correspond to those   , in the Directory of Services, from "Communications port" through   - to "Associated script file name".  These settings for the current   . modem are used if you dial a voice call, or type a number at the   / "Name or number to dial?" prompt. 0  1 End of Appendix I. 2  3    Appendix J.  Script File Commands.    J.1.  Basic Script File Commands.    KeyTerm has a range of commands which can be used in script    files.  There are eight basic commands, as follows:    J.1.1. Wait.   	 This command is followed on the same line by a word or some text   
 which is to be received from the host.  KeyTerm will wait for the    nominated text to be received before continuing.  The case of the    text does not matter.  For example the line: 
   wait password    will wait for "password" to be transmitted by the host before    continuing with the next line.  The wait timeout as set in the    KeyTerm setup list applies here.  After timeout, execution    continues with the next line.  The waittimeout command can be    used after wait to take some action if timeout occurs.    J.1.2. Send.    The text following this command is sent to the host as if it had    been typed at the keyboard.  When a control character is needed    in the text, type a "^" before the required character. For    instance, if an ENTER keystroke is needed at the end of the text    string, use "^m".  As an example, if a "wait password" command is    followed by "send mypassword^m", a password can be automatically    entered when requested by the host.     J.1.3. Pause. !  " This command waits for a nominated time in seconds before   # continuing.  For example, "pause 5" will wait 5 seconds before   $ continuing. %  & J.1.4. Crt. '  ( This command displays and speaks the following message on the   ) screen for the user, regardless of whether speech is on or off.    * For example the command: "crt Logon failed", will say: "Logon   + failed". ,  -    J.1.5. Off.    This command turns off the speaking of text received from the    host, in a similar manner to the READ with S command.    J.1.6. On.    This command turns on the speaking of text received from the    host, in a similar manner to the READ with S command. 	  
 J.1.7. Waittimeout.    The command following "waittimeout" on the same line will be   
 executed if the last wait statement timed out.  For example,    wait password  waittimeout crt Logon failed    would say "Logon failed" if "password" was not received from the    host within the time specified for the wait timeout.    J.1.8. Exit.    This command hangs up the call and returns to the "Name or    Number" prompt.    J.1.9. Example of the Basic Commands.    The basic commands could be used to log onto an information    service as follows:     off,    wait User ID, !  waittimeout exit, "  send MyID^m, #  wait password, $  waittimeout exit, %  send MyPassword^m, &  crt Logon OK, and '  on. (  )    J.2. Advanced Script File Commands.    There are 20 commands in the advanced group.  Some use labels to    indicate where to jump to.  A label is a single word at the    beginning of a line, followed by a colon.  It can be on a line of    its own or before a command on the same line.  Where a label is    used to specify the destination of a jump, the colon is not    included.   	 The advanced commands are: 
    goto,   call, 
  gosub,   return,   stop,   upload,   download,   logto,   getc,   ctimeout,   ifcnot,   echoc,   GetKey,   IfNString,   NextRecord,   DelRecord,   DOSToKN,   KNToDOS,   DelFile, and   SendBreak.     J.2.1. Goto. !  " This command must be followed by the name of a label.  It causes   # execution to jump to the line on which the label resides. For   $ example: %  & loop: crt Hellogoto loop '  ( would make KeyTerm continuously say "Hello". )  *    J.2.2. Call.    This command executes another script file before continuing with    the current one.  For example:    call logon    would look for a KeySoft text file called "logon" and execute it,    before continuing with the current script file.  To specify a   	 drive and directory, type the drive and directory followed by a   
 space before the filename.  For example:    call c:\keynote\keyterm\ logon 
   will execute the file "logon" in the KeyTerm directory on drive    C.  Note that the drive must be specified.    J.2.3. Gosub.    This executes the subroutine at the label following gosub before    continuing with the next line. For example:    gosub mysub    will execute commands following the mysub label until a "return"    command is found, before continuing with the next command.    J.2.4. Return.    This returns to the original command following a call or gosub    command.     J.2.5. Stop. !  " This stops execution of a script file as though READ with F,   # followed by E, were pressed again. $  % J.2.6. Upload. &  ' This command uploads the specified file using the specified   ( protocol.  Protocols are indicated by a single letter following   ) "upload" as follows: *  +  upload x = x-modem, ,  upload 1 = 1k-x-modem, -  upload y = y-modem, .  upload n = no protocol. /  0    The filename, preceded by a drive and directory, follows the    protocol letter.  To specify a KeySoft text file, leave a space    between the drive/directory and the filename.  To specify a DOS    file, string them all together in the usual DOS way.  Examples:    upload n c: A KeySoft text file    will upload the file called "A KeySoft text file" from drive C.   	 upload 1 c:\dos\label.exe 
   will upload the "label" utility from the dos directory of drive C    to the host, using 1k-x-modem. 
   J.2.7. Download.    This operates in a similar manner to the "upload" command.  If    y-modem protocol is selected, a filename is not required.  If the    specified file already exists, KeyTerm will append to it.    J.2.8. Logto.    This command specifies a file to log to, in the same way as the    on-line command READ with F, followed by L.  If the specified    file already exists, KeyTerm will append to it. Execution then    continues with the next instruction.  "Logto" without a filename    will close the log file.    J.2.9. Getc.    This command waits for the next character sent by the host and    stores it for use by the following commands.  Getc uses the same     timeout as the wait command. !  " J.2.10. Ctimeout. #  $ This command provides a timeout for "getc".  The command   % following "Ctimeout" on the same line will be executed if the   & last "getc" statement times out. '  ( J.2.11. Ifcnot. )  * This command is followed by a single character and then a   + command.  If the character does not match that obtained by the   , previous "getc", then the command is executed. -  .    J.2.12. Echoc.    This command echoes back to the host the character obtained by    the previous "getc".    J.2.13. GetKey "prompt" "help message".    This command speaks the "prompt" and then waits for the user to    press a key.  If the HELP key (F1) is pressed, the "help message"   	 will be spoken.  If the REPEAT key (F2) is pressed, the "prompt"   
 will be repeated.  "Prompt" and "help message" must be enclosed    in double quotes.  If the ESCAPE key is pressed and there is a    command on the same line following the "help message", it will be   
 executed.  Otherwise execution continues with the next line.     After a GetKey command, the key fetched may be sent to the host    with an Echoc command or tested with Ifcnot commands.  For    example:     GetKey "Download Weather or News?" "For Weather,press W.   For News, press N" exit   Ifcnot W goto skip_weather   etc.    Note that the "exit" command will be executed only if the ESCAPE    key is pressed.    J.2.14. IfNString "string 1" "string 2" command    IfNString compares "string 1" and "string 2".  If the strings are    NOT the same, 'command' is executed.  If they are the same,    execution continues with the next line.  The two strings must be    enclosed in double quotes.  The comparison ignores the case of     the characters in the strings.  This command is usually used to   ! compare database fields with a literal string. For example: "  #  IfNString "<Service>" "CompuServe" goto $  not_compuserve %  crt The Service field is CompuServe &  ' This IfNString command compares the contents of the "Service"   ( field with "CompuServe" and will execute "goto not_compuserve" if   ) the field does not contain the text "CompuServe". *  +    J.2.15. NextRecord    This command selects the next record in the "email send"    database.  If there are no more records, execution continues on    the same line.  If there are more records, execution continues on    the next line.  For example:     NextRecord goto the_end   crt There is another record 	  
 This example selects the next record in the "email send" database    and says, "There is another record".  If there are no more    records in the database it will go to "the_end".  For more   
 information on the "email send" database see Section 10.23.3.    J.2.16. DelRecord    This command deletes the currently selected record in the "email    send" database and selects the next record.  If there are no more    records, execution continues on the same line.  If there are more    records, execution continues with the next line.  For example:     DelRecord goto no_more_records   crt There is another record    For more information on the "email send" database see Section    10.23.3.    J.2.17. DOSToKN "DOS filename" "KeySoft filename"    This command converts a DOS text file to a KeySoft text file.    Both filenames must be enclosed in double quotes.  The DOS     filename must be prefixed with a drive and directory name. The   ! KeySoft file will be stored in the c:\keyterm\text directory of   " the C drive, unless a drive/directory name is specified by typing   # it before the KeySoft filename, with a space between the   $ drive/directory and the filename.  If the KeySoft file already   % exists, the new text will be appended to it.  The "Format for   & KeySoft file transfers" setting in the Directory of Services   ' applies to the conversion.  If the operation fails, an error   ( message will be spoken and execution will continue on the same   ) line.  If the conversion is successful, execution continues on   * the next line. +  , Example: -  . DOSToKN "c:\keynote\keyterm\mail.txt" "c:\mail My mail" goto  / conversion_failed 0  1    J.2.18. KNToDOS "KeySoft filename" "DOS filename"    This command converts a KeySoft text file to a DOS file.  Both    filenames must be enclosed in double quotes.  If no drive and    directory is specified for the KeySoft file, it will be assumed    to be in the \keynote\text directory of the C drive. To specify a    drive and directory for the KeySoft filename, leave a space    between the drive/directory and the filename. The DOS filename    must be prefixed with a drive and directory name.  If the DOS   	 file already exists, the new text will replace the original   
 contents of the file.  The "Format for KeySoft file transfers",    "Transmission of linefeeds", and "End of file marker" settings in    the Directory of Services apply to the conversion.  If the   
 conversion fails, an error message will be spoken and execution    will continue on the same line. If the conversion is successful,    execution continues with the next line.    Example:    KNToDOS "Demonstration document" "c:\demo.txt" goto   conversion_failed    J.2.19. DelFile "filename"    This command deletes a file.  The "filename" must be enclosed in    double quotes and may be either a DOS or KeySoft file.  If    "filename" is a DOS file, it must be prefixed with a drive and    directory name.  If "filename" is a KeySoft file and no drive and    directory is specified, it will be assumed to be in the    \keynote\keyterm directory of the C drive.  To specify a drive    and directory for the KeySoft filename, leave a space between the    drive/directory and the filename.  If the file does not exist, an     error message is spoken and execution continues on the same line.    ! If the file exists, execution continues with the next line. "  # Examples: $  % DelFile "c:\keynote\keyterm\mail.txt" goto does_not_exist &  ' DelFile "d:\ My mail file" (  ) J.2.20. SendBreak *  + This command transmits a 300 millisecond break signal to the host   , computer. -  .     J.2.21. Example of Advanced Commands.      The "c" commands can be used to implement a simple dial-in system     for your own or others' use.  In this example, KeyTerm should be     set to answer calls and the associated command file would contain     the following:       send ^m^jEnter password:    wait correct password  	  waittimeout exit  
  upload n c:\bb logon message    menu:    upload n c:\bb menu  
  getc    ctimeout exit    echoc    ifcnot h goto skip_help    upload n c:\bb help    goto menu    skip_help:    ifcnot d goto skip_dl    download y    goto menu    skip_dl:    ifcnot x goto skip_exit    send Goodbye    exit    skip_exit:    etc. ...    send ^g    goto menu       End of Appendix J.  ! !   !  "   Appendix K.  Compuserve Settings."  "  When you use KeyTerm to send email through CompuServe, as  "  described in Chapter 10, the script file which automates the  "  procedure relies on two conditions:"  "  1. Your name has been added to the Address Book, which is part of  "  the CompuServe mail service.  (Note that this has nothing to do  "  with the KeyList Address Notebook.)  This allows CompuServe to  " 	 add your name automatically to each outgoing email message." 
 "  2. The summary of mail features, which CompuServe presents for  "  beginning users, has been suppressed.  This can be done by  " 
 changing the verbosity level of CompuServe menus and prompts."  "  To set up these conditions, first connect to CompuServe. Assuming  "  that you have set up a CompuServe entry in the KeyTerm Directory  "  of Services, as described in Section 10.11, press F8 from  "  anywhere in KeySoft and you will hear, "Name or number to call?"   "  Use RIGHT ARROW until you hear "CompuServe", and press ENTER.   "  KeyTerm will dial the appropriate phone number and connect to  "  CompuServe, and the top-level menu will be presented."  "  Now select the CompuServe mail service.  You may navigate the  "  CompuServe menus to do this, but it is quicker to type, "go  "  mail", and then press ENTER.  You can do this at any menu prompt  "  which says, "Enter choice number"."  "  If you are a novice user, a summary of mail features will be  "  presented, with the option, "Do you wish additional information?"   "  Press "N" followed by ENTER in response to this prompt, and  "  CompuServe will present a Mail Main Menu.  The first line of this  "   menu will depend on whether you have mail waiting.  The rest of  " ! the menu will be as follows:" " " # 2    COMPOSE a new message." $ 3    UPLOAD a message." % 4    USE a file from PER area." & 5    ADDRESS Book." ' 6    SET options." ( " ) You will be making an entry in the Address Book, so press 5  " * followed by ENTER.  This will bring up the Mail Address Book, as  " + follows:" , " - #   1    INSERT an entry.#  2    CHANGE an entry.#  3    DELETE an entry.#  4    LIST Address Book.#  5    Enter / Change your NAME / Postal Address.#  6    DISTRIBUTION lists.#  #  You wish to enter your name, so press 5 followed by ENTER. You  #  will be prompted with editing information, and the old name,  # 	 which will be "None".  At the prompt for the new name, type your  # 
 own name and press ENTER.  You will also be given the opportunity  #  to enter your postal address, which is optional. Type "Y" or "N"  #  followed by ENTER, and your postal address if you have elected to  # 
 supply one.  You will then be returned to the Address Book.  To  #  return to the Mail Main Menu, press ENTER.#  #  To suppress the summary of mail features, you should change the  #  level of verbosity of CompuServe menus and prompts. There are 3  #  levels.  At the Mail Main Menu, select "SET options" by pressing  #  6 followed by ENTER.  This will yield the following Options Menu:#  #  [ ] Represents Current Setting.#  (yes/no options toggle).#  #  1    EDITOR uses line numbers [YES].#  2    MODE of operation is [MENU].#  (MENU, PROMPT, COMMAND).#  3    Output is PAGED [YES].#  5    RECEIVE postage-due messages [YES].#  6    SHOW Recipients [YES].#  #  To select the mode of operation, press 2 followed by ENTER, and  #   the following Mode Menu will be presented:# ! # " 1    MENU - (Novice User).# # List of choices in menu form.# $ 2    PROMPT - (Intermediate User).# % Brief list of commands.# & 3    COMMAND - (Expert user).# ' One word prompt.# ( # ) $   If you select the PROMPT mode, intended for intermediate users,  $  CompuServe will suppress the description of mail features.  To do  $  this, press 2 followed by ENTER.  The Options Menu will be  $  presented again, and this will show that the MODE of Operation is  $  now PROMPT, as you selected.$  $  To return to the top-level menu, type "top" followed by ENTER.  $  You will hear the prompt, "Make changes permanent for future mail  $  sessions?"  Press "Y" followed by ENTER, and you will be returned  $ 	 to the top-level CompuServe menu.$ 
 $  You may now type "bye" to log off, or continue to use the  $  CompuServe system.$ 
 $  End of Appendix K.$  $  End of Appendices.$  $  