;DECSpell V1.5 Installation for OpenVMS Alpha
+                             DECspell V1.5 1                    System and Installation GuideFThe software described in this  manual  is  in  part  subject  to  thefollowing copyright:FHoughton Mifflin Spelling Verification  -  Correction,  (c)  CopyrightC1983, 1981 Houghton Mifflin Company.  All rights strictly reserved.FThe spelling correction software contains unpublished materials  ownedFby  Houghton  Mifflin  Company,  licensed  for  use  solely in DigitalFsoftware.  Reproductions or disassembly of embodied computer  programsEor algorithms prohibited.  Based on The American Heritage Dictionary.PrefaceFThe DECspell System and Installation Guide describes the procedure forLinstalling  DECspell on an OpenVMS Alpha system, and the procedure to verify.that DECspell has been installed successfully.+It also provides advice and information on:)      .  How to make best use of DECspell+      .  Hardware and software requirements2      .  How to incorporate DECspell into ALL-IN-1      .  DECspell system filesIntended AudienceFThis guide is intended primarily for VAX/VMS system managers who  wishFto  install  DECspell  on their system.  It is also intended for users/who require further information about DECspell.'                              CHAPTER 11                    INTRODUCTION AND REQUIREMENTS1.1  IntroductionFYou install DECspell  using  the  VMSINSTAL  command  procedure.   The,installation procedure only requires you to:6      .  Set up proper conditions for the installation      .  Load the mediaF      .  Respond to any queries and prompts that are output during the         installation procedure1.2  Hardware RequirementsKDECspell is installed on  an OpenVMS Alpha system  configuration  having  aAminimum  of  3000  disk  blocks  available  on the system disk.  1.3  Software Requirements#The following software is required:$     1   OpenVMS Alpha V6.1 or later1.4  The KitFThe DECspell software is distributed online via a backup saveset to be-used with the SYS$UPDATE:VMSINSTAL procedure.FThere are two types of kit, basic and  update.   The  basic  kits  areFcomplete  products.   An  update  kit  adds  an  extra dictionary to apreviously installed basic kit.KThe DECspell kit contains both the American English and British dictionary.'                              CHAPTER 21                     PREPARATION AND INSTALLATION2.1  Preparing for Installation6Before you begin installing DECspell do the following:%     1   Check the distribution  kit.     2   Make sure there are:F          .  3000 free blocks on the system disk for a DECspell  basic             kit, andF          .  a further 1100 blocks  if  an  additional  dictionary  is             being installed.!     3   Back up the system disk.=     4   Make sure there are no users logged into the system.2.2  Installing DECspell>Take note of the following points before you install DECspell:F      .  During this installation procedure  a  number  of  cautionaryF         messages  and  general  information  messages,  which are notF         documented here,  may  display.   Please  read  all  messages4         carefully and follow the advice they offer.F      .  If the following error messages display at any  time,  duringF         the  installation,  you  may need to increase the global pageF         table.   Otherwise,  reboot  your  machine  and  restart  the          installation procedure:5         %SYSTEM-F-GPTFULL, global page table is fullG         %VMSINSTAL-F-NOREINSTAL, Image VMI$ROOT:[SYSLIB]DCLTABLES.EXE;;                                  could not be re-installedQ         %VMSINSTAL-F-UNEXPECTED, Installation terminated due to unexpected event+Now follow these steps to install DECspell:=1   Log in under the privileged VMS system manager's account.<2   Type the following command to initiate the installation:)    $ @VMSINSTAL SPLAXP015 E4   You will be asked a few questions about the installation options.'                              CHAPTER 3/                       ADVICE ON USING DECSPELLFThis chapter contains information to help you and the  users  on  yourFsystem  make  the  most  effective  use of DECspell.  It also containsFinformation that may help you in answering users' queries or problems.3.1  Personal DictionariesFPersonal dictionaries are lists maintained by users.   The  words  andFnames  contained  in  them  are  words  which  are  not  in the masterFdictionary.  DECspell is easier to use when personal dictionaries  areFused  for  checking,  because  fewer  valid  words  are highlighted aserrors.FUsers should  be  encouraged  to  make  full  use  of  their  personal
dictionaries.(3.1.1  Using DECspell for the First TimeKThe first  time  a  user runs DECspell he will not have a default personal dictionary.  This isFthe personal dictionary that DECspell  always  uses  unless  the  userFspecifies  otherwise.   DECspell  will  ask whether the user wants oneFcreated.  If  the  user  answers  NO,  this  question  is  asked  eachFsubsequent  time  the  user  runs DECspell.  If the user answers YES aFdefault  personal  dictionary  is  created,   with   the   file   nameSYS$LOGIN:PERSONAL.LGP.FPersonal dictionaries are ASCII files.  Users can create  and  add  toFother  personal  dictionaries using an editor, for example EDT.  ThereFcan be more than one word per line; separate the  words  with  spaces.The words can be in any order.53.1.3  Sharing Personal Dictionaries with Other Users#You can specify additional personalFdictionaries with the /DICTIONARY qualifier.  Users  should  refer  toFtheir   own  dictionaries  by  name.   They  can  use  other  people'sFdictionaries, but will need to specify the directory for  dictionariesFlocated  in  other  accounts.   For  example,  user  Brown  issues thecommand:6$ SPELL/DICTIONARY=(TECHNICAL,[SMITH]COMPANY) NAME.TXT;This will cause DECspell to use the following dictionaries:)SYS$LOGIN:PERSONAL.LGP       (by default)?SYS$LOGIN:TECHNICAL.LGP      (one of user Brown's dictionaries)?[SMITH]COMPANY.LGP           (one of user Smith's dictionaries)FDECspell requires Read access to additional dictionaries in  order  toFuse   them  for  verification.   DECspell  requires  Write  access  toFadditional dictionaries if you wish to add words while using DECspell.FYou can use this feature to set up a dictionary  that  can  be  sharedFbetween  users.   You  can  set  up shared dictionaries with Read-onlyFaccess to prevent the addition of incorrectly  spelled  words.   (This=means that users cannot add any words to those dictionaries.)<3.1.4  System Messages Associated with Personal Dictionaries1When a user invokes  additional  dictionaries  atFthe start of using DECspell (with the /DICTIONARY switch), a number of:messages may appear if he makes any one of these mistakes:-      .  Specifies the dictionary incorrectlyF      .  Specifies the directory in which  the  dictionary  is  stored         incorrectlyF      .  Specifies the  device  on  which  the  dictionary  is  stored         incorrectlyE      .  Specifies a dictionary that is protected against Read accessFThe user is asked if he wishes to continue.  He can type Y to continueFwithout  using  the  incorrectly specified dictionary or type N, start,DECspell again and respecify the dictionary.3.1.5  Words in DictionariesFDECspell dictionaries contain whole words only.  There are no  derivedFforms.   Separate entries exist for the plural and possessive forms ofFwords in dictionaries.   If  a  user  adds  a  word  to  his  personalFdictionary  he  may  also  need to add the plural and possessive formsseparately.FMany hyphenated words are stored in the  dictionary  as  whole  words.FDECspell  also  handles  compound  words  (valid  words separated by aFsingle hyphen) by checking each part in the dictionary.  The  compoundFword  is  only  accepted  if  both  halves  are valid and have correctFcapitalization.  Compound words can be added to personal dictionaries.FDECspell handles abbreviations by first checking the word without  theFtrailing  period.   If it is not found a second check is made with thetrailing period appended.3.2  The HELP KeyIThe HELP key used by DECspell is the  PF2  key  or the HELP key on LK4xx 
keyboards.3.4  DCL Command QualifiersFQualifiers modify the way DECspell works.  Users  can  use  them  when1starting   DECspell   Users  can  abbreviate  anyFqualifier uniquely and can use more than one qualifier at a time.  The/following DCL command qualifiers are available:/OUTPUTFGives the output document a new name.  If this qualifier is  not  usedFthe  output  document  will  be  stored under its original name with ahigher version number.1For example:  $ SPELL/OUTPUT=NEWNAME.TXT NAME.TXT	/NOOUTPUTFPrevents a corrected version of the document being created.  Words can;still be added to the personal dictionaries during the run.'For example:  $ SPELL/NOOUTPUT NAME.TXT/NOPERSONAL_DICTIONARYFPrevents the users's default personal dictionary (PERSONAL.LGP)  beingused.4For example:  $ SPELL/NOPERSONAL_DICTIONARY NAME.TXT/PERSONAL_DICTIONARYFThis can be used to specify an alternative personal dictionary  to  beFused instead of PERSONAL.LGP.  If the dictionary specified by the user?does not exist, DECspell asks whether he would like it created.:For example:  $ SPELL/PERSONAL_DICTIONARY=DICNAME NAME.TXT/DICTIONARYFSpecifies additional personal dictionaries for checking.   If  a  userFwishes  to  use a dictionary for checking, he must have Read access toFthe dictionary.  If a user wishes to add words  to  a  dictionary,  heFmust  have  Write  access  to  the  dictionary.   Up  to 10 additional/personal dictionaries can be used for checking.=For example:  $ SPELL/DICTIONARY=(DICNAME1,DICNAME2) NAME.TXT/KEYPADFSpecifies an alternative editor mini-keypad layout.  Available keypads%are WPS and EDT.  The default is WPS.)For example:  $ SPELL/KEYPAD=EDT NAME.TXT/MASTER_DICTIONARYFSpecifies an alternative master dictionary.   This  qualifier  can  beFused  only  if  the  system  has  both dictionaries.  The dictionariesavailable are:3      .  AMERICAN (the American English dictionary)1      .  BRITISH (the British English dictionary)8For Example:  $ SPELL/MASTER_DICTIONARY=BRITISH NAME.TXT/RUNOFFFIndicates that the document is a  RUNOFF  document,  if  it  does  notFalready  have  a  .RN%  file type, where % is any character.  DECspell=then bypasses the RUNOFF commands when checking the document.%For example:  $ SPELL/RUNOFF NAME.TXT	/NORUNOFFFIndicates that the document is not a RUNOFF document, if it has a .RN%Ffile type.  DECspell then checks every line in the document, includingany beginning with a period.'For example:  $ SPELL/NORUNOFF NAME.RNO#3.4.1  Tailoring Command QualifiersFSometimes it is cumbersome to type in a whole line of qualifiers.   IfFthe  same set of qualifiers are used frequently it is easier to set up+a global symbol in your login command file.For example:+$ SPELL :== SPELL/MASTER=BRITISH/KEYPAD=EDTEThe command SPELL will now invoke DECspell with the above qualifiers.3.5  Finding the Version NumberCTo find the version number of DECspell a user can do the following:FWhile verifying a document, press the HELP key.  The top line of  eachhelp frame has the format:CHELP               topic for help                    VERSION NUMBERThis version number shows:C      .  The version of DECspell you are using (for example, V1.5).F      .  Whether the Corrector option is present (VC).  All V1.5  kitsF         have  the  Corrector.   V1.0 kits could be Verifier only kits         (VO).F      .  Whether the master dictionary you are using  is  American  or         British (A or B).'                              CHAPTER 5)                            RELEASE NOTES/5.1  Differences Between DECspell V1.1 and T1.5,DECspell V1.5 has the following differences:      .  No support for /dx!      .  No support for ALL-IN-1.,5.2  Software Problems Fixed by this Release	None.$5.3  Known Problems and Restrictions5.3.2  Dictionary Status ReportFWhen DECspell has finished  checking  a  document,  it  displays  someFstatistics  for  each  personal  dictionary  to  which words have beenadded.  These are:"      .  The number of words added1      .  The new total of words in the dictionaryFThe total number of words in the dictionary does not include any wordsFgreater  than  32  characters  that  you  may  have  edited  into yourdictionary.*5.3.3  Lines With More Than 255 CharactersFDECspell does not support documents containing lines  of  text  longerFthan 255 characters (that is, documents whose record length is greaterFthan 255 characters).  Personal  dictionaries,  however,  can  containlines of any length.5.3.4  RUNOFF SupportFDECspell does not highlight incorrect RUNOFF commands as errors.  Thismeans that:4      .  Incorrect RUNOFF commands will not be foundF      .  If a  RUNOFF  command  without  a  terminating  semicolon  isF         incorrect,  DECspell  assumes that the whole line is a RUNOFFF         command.  Therefore, DECspell will not highlight  any  errors"         in the text on that line.(                              APPENDIX C5                SYSTEM FILES ASSOCIATED WITH DECSPELLFThe following files will  be  written  onto  the  system  disk  during
installation:Directory: SYS$SYSTEM:%	LNGSPLCOR.EXE  		Main DECspell image,	LNGSPLFOR.EXE  		DECspell image for /FORMATSYS$LIBRARY:&	LNGSPLAED.LGS  		AMERICAN ENGLISH ???-	LNGSPLAEM.EXE  		AMERICAN ENGLISH DICTIONARY;	LNGSPLBED.LGS  		BRITISH Dictionary - Optionally installed<	LNGSPLBEM.EXE  		BRITISH Dictionary - Optionally installed +	LNGSPLSHR.EXE  		Shareable DECspell image.	SYS$HELP:*	LNGSPLHLP.HLB  		Interactive help librarySYS$UPDATE:	LNGSPLIVP.TXT 		IVP test inputSYS$MESSAGE:	LNGSPLMSG.EXE  		Message file (                              APPENDIX D-                        SEVERE ERROR MESSAGESFThis chapter lists all the error messages that  appear  when  DECspell8fails, why they have occurred and how to deal with them.(D.1  Associated With Master DictionariesF%LNGSPL-F-BAD_MASTDIC, Master dictionary  was  specified  incorrectly.See your system manager.FYou specified the master dictionary incorrectly when using the /MASTER
qualifier.FWhen using the /MASTER qualifier  specify  either  /MASTER=BRITISH  or/MASTER=AMERICANF%LNGSPL-F-FILNOTFOU, Master dictionary not  opened  -  disk  file  notfoundFThe master dictionary you specified does  not  exist  on  the  system.FEither  just  the  American or just the British dictionary is present.%You cannot use the /MASTER qualifier.D.3  Associated with Formatter
D.3  Associated with FormatterF%LNGSPL-F-SORTWRKSET, Not enough working set space for SORT.  See yoursystem manager.FThe sort facility in the formatter failed to get the  working  set  itneeded.FIncrease the user's working set quota.  If the  quota  is  already  atmaximum, increase the maximum.F%LNGSPL-F-SORVIRMEM, Not enough virtual memory  for  SORT.   See  yoursystem manager.FThe sort facility in the formatter failed to get the virtual memory itneeded.FDECREASE the user's working set quota to release more memory  for  thesystem.F%LNGSPL-F-SORWRKDEV, SORT work file not a  disk  device  or  on  localnode.  See your system manager.FThe logical names for the sort facility  in  the  formatter  temporaryFwork  files, SORTWORK1, SORTWORK2, are pointing to unsuitable devices;Feither to devices on another system, or to devices that are not randomaccess devices (disks). FReassign these logical names to point to a random access device  on  aFsystem  from  which  you  wish to run the SPELL/FORMAT.  AlternativelyFdeassign these logical names, so that the sort creates temporary  workfiles in your local directory.F%LNGSPL-F-SOREXTWRK, SORT could not extend work file.  See your systemmanager.FThe sort facility in the formatter  creates  two  work  files  on  theFdevice(s)  specified  by  the  logical names SORTWORK1, SORTWORK2.  IfFthese logicals are undefined, the work files are created in your login
directory.FEnsure you extend your privilege for the device where SORT is creatingFthe temporary work files.  If you extended the privilege, increase thefree block space on the device.sF%LNGSPL-F-SORTMAP, SORT could not map  work  file.   See  your  systemmanager.FEnsure that the system parameter 'maximum process sections' is set  to20.fF%LNGSPL-F-SORCLNUP, SORT did not clean up work area.  Run SPELL/FORMATagain.@Sort failed to delete the work files and reinitialize the areas.F%LNGSPL-F-SORNOOUT, SORT could not open a work file.  See your  systemmanager. Sort failed to open a work file.FIf the logical names (SORTWORK1, SORTWORK2) are not defined,  increaseFthe  free  disk  space  on  the  device(s)  they point to.  Otherwise,2increase the free disk space on your login device.D.4  MiscellaneousF%LNGSPL-F-FILE_FNM_ERR,  document not accessible - was specifiedincorrectlyl:You have specified the filename of a document incorrectly.:Check the filename of the required document and try again.<%LNGSPL-F-FILE_GEN_ERR,  document Read access failure.#-RMS-F-DIR, error in directory namec<You have specified the directory for a document incorrectly.;Check the name and location of the directory and try again. <%LNGSPL-F-FILE_GEN_ERR,  document Read access failure.8-RMS-F-CHN, assign channel system service request failed'-SYSTEM-F-IVDEVNAM, invalid device namet9You have specified the device for a document incorrectly.l+Check the name of the device and try again.Y<%LNGSPL-F-FILE_GEN_ERR,  document Read access failure.+-RMS-E-DNR, device not ready or not mountedp3The device you specified was not online or mounted.iDCheck that the specified volume is online and mounted and try again.F%LNGSPL-F-FILE_PRV_ERR,   document  is  protected  against  Readaccess. :You do not have Read access to the document you specified.FIf you can, change the protection of the  required  document  and  tryagain.F%LNGSPL-F-FILE_PRV_ERR,  document  is  protected  against  Writeaccess.eFEither you do not have Write access to the  specified  (or  defaulted)Bdirectory, or you do not have Write access to the document itself.FIf you do not have Write access to  the  directory,  use  the  /OUTPUT@switch to create an output document in an alternative directory.FIf  you  do  not  have  Write  access  to  the  document,  change  itsprotection.l4%DEBUGBOOT-W-INSFWSL, insufficient working set limitFYou are trying to run DECspell with a working set EXTENT that  is  toosmall.!Increase your working set EXTENT.i5%LNGSPL-F-FILE_FNF_ERR,  document was not foundsThe document does not exist.:Check the name and location of the document and try again.F%LNGSPL-F-FILE_DNF_ERR,  document not accessible - directory was	not found >The input or output directory for the document does not exist.;Check the name and location of the directory and try again.aF%LNGSPL-F-BAD_KEYPAD, Keypad was specified  incorrectly.   Use  either
WPS or EDTFYou have specified an invalid keypad layout or incorrectly specified aFkeypad  layout  when  using  the  /KEYPAD  qualifier.  Only the keypadFlayouts WPS and EDT are supported by DECspell when using  the  /KEYPAD
qualifier.;Use a valid keypad option when using the /KEYPAD qualifier.eE%LNGSCR-F-UNSUP_TERM, DECspell is not supported on this terminal typetFDECspell  is  supported  on  the  VT100,  VT200  and  VT52  series  of6terminals.  Use a valid terminal type to run DECspell.F%LNGSCR-F-INSUF_CAP, Terminal has insufficient capabilities to display132 colsFYou cannot enter 132 column mode because your VT100 terminal does  not%have the Advanced Video Option (AVO).eUse the default 80 column mode.pt(                              APPENDIX F-                        INTERACTIVE TEST FILEFThe following piece of text is contained in the test file used as partFof  the  interactive  test  at  the end of the verification procedure.=Follow the instructions in the test file to complete the IVP.w$Test Text File for LNGVCB and LNGVCA5      TEST STARTID  --  YOU ARE RUNNING INTERACTIVELY F       Keep pressing RETURN to correct the highlighted errors.  If you@       have any problems, or you are happy with the verificationA       prosess and wish to finish, tpye the letter F, followed by        RETURN.E       As you can see, this product offers corrections just below the C       text.  By pressing the RETURN key, you can correct them with E       the suggested correction.  Digital beleives you will find this        product easy to use.uD       This product offers suggestions on the corrections list whichA       are the required spelling - with a high degree of acurasy.e>       Detials of how this product are to be found in the user       documentation. >       You shud now be happy that the product is installed and@       functioning correctly.  The remainder of the installationF       prosedure will continue when you have corrected the last error.r(                              APPENDIX G,                          REPORTING PROBLEMS                              JReport problems in the notes conference at which you found the pointer to 	this kit.r
a