AA-X571B-TE VAX DECspell VAX DECspell System and Installation Guide System and Installation Guide Version 1.1 Version 1.1 DIGITAL EQUIPMENT CORPORATION DIGITAL EQUIPMENT CORPORATION Maynard, Massachusetts Maynard, Massachusetts 1 AA-X571B-TE First Printing, September 1983 Revised Printing, March 1985 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may used or copied only in accordance with terms of such license. No responsibility is assumed for the use or reliability of its software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Copyright (c) Digital Equipment Corporation 1983, 1985. All rights reserved. The following are trademarks of Digital Equipment Corporation: +-+-+-+-+-+-+-+ |D|I|G|I|T|A|L| +-+-+-+-+-+-+-+ ALL-IN-1 DECwriter RSTS DEC DIBOL RSX DECmate MASSBUS UNIBUS DECspell PDP VAX DECsystem-10 P/OS VMS DECSYSTEM-20 Professional VT DECTAPE II Rainbow Work Processor DECUS The software described in this manual is in part subject to the following copyright: Houghton Mifflin Spelling Verification - Correction, (c) Copyright 1983, 1981 Houghton Mifflin Company. All rights strictly reserved. The spelling correction software contains unpublished materials owned by Houghton Mifflin Company, licensed for use solely in Digital software. Reproductions or disassembly of embodied computer programs or algorithms prohibited. Based on The American Heritage Dictionary. ii CONTENTS CHAPTER 1 INTRODUCTION AND REQUIREMENTS 1.1 Introduction . . . . . . . . . . . . . . . . . . . 1-1 1.2 Hardware Requirements . . . . . . . . . . . . . . 1-1 1.3 Software Requirements . . . . . . . . . . . . . . 1-1 1.4 The Kit . . . . . . . . . . . . . . . . . . . . . 1-3 CHAPTER 2 PREPARATION AND INSTALLATION 2.1 Preparing for Installation . . . . . . . . . . . . 2-1 2.2 Installing DECspell . . . . . . . . . . . . . . . 2-3 CHAPTER 3 ADVICE ON USING DECSPELL 3.1 Personal Dictionaries . . . . . . . . . . . . . . 3-1 3.1.1 Using DECspell for the First Time . . . . . . . 3-1 3.1.1.1 Using DECspell Outside ALL-IN-1 V2 . . . . . . 3-1 3.1.1.2 Using DECspell from ALL-IN-1 V2 . . . . . . . 3-2 3.1.2 Using Imported Dictionaries in ALL-IN-1 V2 . . . 3-2 3.1.3 Sharing Personal Dictionaries with Other Users . 3-3 3.1.4 System Messages Associated with Personal Dictionaries . . . . . . . . . . . . . . . . . . 3-3 3.1.5 Words in Dictionaries . . . . . . . . . . . . . 3-4 3.2 The HELP Key . . . . . . . . . . . . . . . . . . . 3-4 3.3 RUNOFF Documents in ALL-IN-1 . . . . . . . . . . . 3-4 3.4 DCL Command Qualifiers . . . . . . . . . . . . . . 3-5 3.4.1 Tailoring Command Qualifiers . . . . . . . . . . 3-7 3.5 Finding the Version Number . . . . . . . . . . . . 3-7 CHAPTER 4 SYSTEM TUNING CHAPTER 5 RELEASE NOTES 5.1 Differences Between DECspell V1.1 and V1.0 . . . . 5-1 5.2 Software Problems Fixed by this Release . . . . . 5-1 5.2.1 Message Numbers Appearing on the Screen . . . . 5-1 5.2.2 Lost Output Files . . . . . . . . . . . . . . . 5-2 5.3 Known Problems and Restrictions . . . . . . . . . 5-3 5.3.1 Non-AVO Terminals . . . . . . . . . . . . . . . 5-3 5.3.2 Dictionary Status Report . . . . . . . . . . . . 5-3 5.3.3 Lines With More Than 255 Characters . . . . . . 5-3 5.3.4 RUNOFF Support . . . . . . . . . . . . . . . . . 5-4 APPENDIX A INCORPORATING DECSPELL INTO ALL-IN-1 V1.3 A.1 The Procedure . . . . . . . . . . . . . . . . . . A-1 iii A.2 Using DECspell from ALL-IN-1 V1.3 . . . . . . . . A-5 A.3 Creating the DEFAULT Personal Dictionary . . . . . A-5 A.4 Creating Other Personal Dictionaries . . . . . . . A-6 APPENDIX B INCORPORATING DECSPELL INTO ALL-IN-1 V2 B.1 The Procedure . . . . . . . . . . . . . . . . . . B-1 B.2 Using DECspell from ALL-IN-1 V2 . . . . . . . . . B-5 B.3 Creating ALL-IN-1 Personal Dictionaries . . . . . B-5 APPENDIX C SYSTEM FILES ASSOCIATED WITH DECSPELL APPENDIX D SEVERE ERROR MESSAGES D.1 Associated With Master Dictionaries . . . . . . . D-1 D.2 Associated with DX documents . . . . . . . . . . . D-1 D.3 Associated with Formatter . . . . . . . . . . . . D-3 D.4 Miscellaneous . . . . . . . . . . . . . . . . . . D-4 APPENDIX E IVP OUTPUT EXAMPLES APPENDIX F INTERACTIVE TEST FILE APPENDIX G REPORTING PROBLEMS Preface Preface The DECspell System and Installation Guide describes the procedure for installing DECspell on a VAX/VMS 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 requirements . How to incorporate DECspell into ALL-IN-1 . DECspell system files Intended Audience Intended Audience This guide is intended primarily for VAX/VMS system managers who wish to install DECspell on their system. It is also intended for users who require further information about DECspell. iv Related Documents Related Documents How to Use DECspell (the user's card) ALL-IN-1 Office Menu V1.3 Application Programmer's Reference Guide ALL-IN-1 Office Menu V2 User's Reference ALL-IN-1 Office Menu V2 Application Programmer's Reference VAX/VMS System Management and Operations Guide You may also need to refer to the various VAX Software Installation Guides. v Document Structure Document Structure Chapter 1 Contains the introduction. Lists the hardware and software requirements. Describes the kit components. Chapter 2 Describes how to prepare for installation. Describes the installation procedure and the verification procedure. Chapter 3 Gives some guidance on the use of DECspell. Chapter 4 Describes how to tune the performance of DECspell. Chapter 5 Contains the release notes. Appendix A Describes how to incorporate DECspell into ALL-IN-1 V1.3. Appendix B Describes how to incorporate DECspell into ALL-IN-1 V2. Appendix C Lists the DECspell files. Appendix D Describes severe error messages that DECspell displays when it fails, and how to deal with them. Appendix E Lists specimen output of the Installation Verification Procedure, for each type of kit. Appendix F Contains the text of the file that is used in the interactive test, which is the final part of the Installation Verification Procedure. Appendix G Describes who to contact if you have problems. Conventions Used in This Document Conventions Used in This Document Convention Meaning Dot Matrix Indicates output lines or prompting characters displayed or printed at your terminal. Red print Indicates commands or responses that you type. A name that is context dependent. Valid alternatives or examples are given in the body of the text. vi CHAPTER 1 INTRODUCTION AND REQUIREMENTS INTRODUCTION AND REQUIREMENTS 1.1 Introduction 1.1 Introduction You install DECspell using the VMSINSTAL command procedure. The installation procedure only requires you to: . Set up proper conditions for the installation . Load the media . Respond to any queries and prompts that are output during the installation procedure Installation takes about 30 minutes for RX01 diskettes, 60 minutes for TU58 cassettes, and 15 minutes for 1600 BPI magnetic tapes. 1.2 Hardware Requirements 1.2 Hardware Requirements DECspell is installed on a VAX/VMS system configuration having a minimum of 3000 disk blocks available on the system disk. If an additional dictionary is installed a further 1100 disk blocks are required. It is recommended that the installation is performed on a hard-copy terminal. The final part of the Installation Verification Procedure, the interactive test, requires the use of a suitable video terminal: a VT100, VT200, or a VT52 series terminal. 1.3 Software Requirements 1.3 Software Requirements The following software is required: 1-1 1 VAX/VMS operating system, version 3.5 or later 2 If you intend to use DECspell from ALL-IN-1, ALL-IN-1 version 1.3 or later 1-2 1.4 The Kit 1.4 The Kit The DECspell software is distributed on RX01 diskettes, TU58 DECTAPE II cartridges, or 9-track 1600 BPI magnetic tapes. The number of volumes in the kit depends on which kit you are installing. Each volume has a unique physical label. The volumes must be mounted in order. The installation procedure is the same for all types of media. There are two types of kit, basic and update. The basic kits are complete products. An update kit adds an extra dictionary to a previously installed basic kit. Table 1-1 shows the different kits available. Table 1-1: The DECspell V1.1 Kits Title Product Q Numbers Kit type Identifier DECspell verifier LNGVCA QC650-HM, QD650-HM Basic and corrector with QE650-HM, QC650-HG American dictionary QD650-HG, QE650-HY DECspell verifier and LNGVCB QC651-HM, QD651-HM Basic corrector with QE651-HM, QC651-HG British dictionary QD651-HG, QE651-HY DECspell additional LNGALA QC655-HM, QD655-HM Update American dictionary QE655-HM, QC655-HG QD655-HG, QE655-HY DECspell additional LNGALB QC656-HM, QD656-HM Update British dictionary QE656-HM, QC656-HG QD656-HG, QE656-HY NOTE The product identifiers in the above table are part of the kit description on the distribution media. 1-3 CHAPTER 2 PREPARATION AND INSTALLATION PREPARATION AND INSTALLATION 2.1 Preparing for Installation 2.1 Preparing for Installation Before you begin installing DECspell do the following: 1 Check the distribution kit for DECspell is complete and correct according to the bill of materials included with the kit. 2 Make sure there are: . 3000 free blocks on the system disk for a DECspell basic kit, and . 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. 5 Make a note of the the product identifier from Table 1-1, The DECspell Kits. NOTE 1 A basic kit (Product Identifiers: LNGVCA, LNGVCB) must already be installed if you are installing an update kit (Product Identifiers: LNGALA, LNGALB). 2 Do not move the files in your basic kit from the system disk to another area. If you do, you will not be able to install an update kit. 2-1 6 Obtain a copy of the user's card - How to Use DECspell. 7 During installation you are asked whether you require access to DECspell through ALL-IN-1. (ALL-IN-1 is DIGITAL's office automation system.) 2-2 Decide now whether you wish to incorporate DECspell into ALL-IN-1. Several files will be copied into the SYS$UPDATE directory. (See Appendix A, Incorporating DECspell into ALL-IN-1 V1.3, and Appendix B, Incorporating DECspell into ALL-IN-1 V2.) 8 It is recommended that you perform the installation on the system console, a hard-copy terminal. However, installation can be performed on a video terminal. If you use a hard-copy terminal, make sure that you have a video terminal available to complete the final part of the Installation Verification Procedure, the interactive test. 2.2 Installing DECspell 2.2 Installing DECspell Take note of the following points before you install DECspell: . The installation procedure (below) assumes you are installing on the console, and displays CSA1: as the device name. . The wording of the messages displayed may vary, depending on the version of VMS being used. Some questions may not appear. . During this installation procedure a number of cautionary messages and general information messages, which are not documented here, may display. Please read all messages carefully and follow the advice they offer. . If the following error messages display at any time, during the installation, you may need to increase the global page table. Otherwise, reboot your machine and restart the installation procedure: %SYSTEM-F-GPTFULL, global page table is full %VMSINSTAL-F-NOREINSTAL, Image VMI$ROOT:[SYSLIB]DCLTABLES.EXE; could not be re-installed %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 Establish the following default directory: $ SET DEFAULT SYS$UPDATE 2-3 3 Type the following command to initiate the installation: $ @VMSINSTAL DEV: where is the product identifier described in Table 1-1, The DECspell V1.1 Kits, and DEV: is the name of the device on which you are installing DECspell. The following message appears: VAX/VMS Software Product Installation Procedure It is dd-mmm-yyyy at hh:mm Enter a question mark (?) at any time for help. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. where dd-mmm-yyyy and hh:mm are the current date and time. 4 If other users are accessing the system the following message may appear: %VMSINSTAL-W-ACTIVE, The following processes are still active . . . * Do you want to continue anyway [NO] where refers to the process name of a user logged into the system. It is not advisable to continue, so type N to halt VMSINSTAL, ask any users to log out, and then restart the installation procedure. 5 If you answer YES to the above question or no users are logged into the system, the following message appears: * Are you satisfied with the backup of your system disk [YES]? If you are not satisfied type N, do a disk backup and restart the installation. If you are satisfied type Y. 6 The following message appears: Please mount the first volume of the set on CSA1: * Are you ready? 2-4 Mount the first volume of the set, an RX01 diskette, a TU58 cartridge, or a magnetic tape, on the console device. (If you unfamiliar with the loading of media refer to the VAX-11 Software Installation Guide.) 2-5 7 Type Y and press RETURN when you have mounted the volume. The following message appears: %MOUNT-I-MOUNTED, 01 mounted on _CSA1: The following products will be processed: V1.1 Beginning installation of V1.1 at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... It takes about 10 minutes for an RX01 to be restored, 15 minutes for a TU58 cassette, and 5 minutes for a magnetic tape. After the volume has been restored, and if there is more than than one volume in the kit you are installing, the following message appears: %BACKUP-I-RESUME, resuming operation on volume 2 %BACKUP-I-READYREAD, mount volume 2 on _CSA1: for reading Enter "YES" when ready: 8 Remove the volume and mount the next volume. Type Y and press RETURN when you have done this. 9 Repeat step 8 for each additional volume when prompted. 10 When all the volumes have been restored and if you are installing a basic kit, the following message appears: * Do you want to run the IVP after the installation [YES]? If you are using a video terminal, you are recommended to run the IVP afterwards, to check that the installation was successful. (You cannot run the IVP from a hard-copy terminal.) Press RETURN. 11 The following message appears: * Do you want to purge files replaced by this installation [YES]? You no longer need files replaced by this installation, so you are recommended to purge them to save disk space. Press RETURN. 2-6 12 If you are installing a basic kit, the following message appears: * Do you require access to DECspell through ALL-IN-1 [YES]? If you wish to use DECspell from ALL-IN-1, press RETURN. (When you have completed this installation procedure, see Appendix A, Incorporating DECspell into ALL-IN-1 V1.3, or Appendix B, Incorporating DECspell into All-IN-1 V2.) If you do not wish to use DECspell from ALL-IN-1, type N and press RETURN. 13 If you are not installing an additional dictionary, the following message appears: %-I-LINKIMAGE, Linking DECspell images, please wait... If you intend to use DECspell from ALL-IN-1, a message appears confirming that the ALL-IN-1 DECspell files have been placed in SYS$UPDATE. The following message appears: %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... If you answered YES to run the IVP after the installation, the Installation Verification Procedure now begins. Each type of kit has its own verification procedure. See Appendix E, IVP Output Examples, for an example of the text that displays during the Installation Verification Procedure for each type of kit. At the beginning of any verification procedure the following message appears: VAX DECspell V1.1 Installation Verification Procedure starting 2-7 A series of tests are then made, the results of which are displayed on the terminal. Once the verification is complete, the following messages appear: VAX DECspell V1.1 dd-mmm-yyyy hh:mm IVP Successfully completed Successful installation of V1.1 at hh:mm Enter the products to be installed from the next distribution volume set. * Products: Type CTRL/Z to exit from VMSINSTAL. 14 The following message appears: * Do you want to mount the console volume [NO]? It is recommended that the console volume is remounted, so type Y and press RETURN. 15 The following message appears: Please mount it on CSA1:. * Are you ready? Replace the console volume. Type Y and press RETURN when you have done this. 16 The following message appears: %MOUNT-I-MOUNTED, CONSOLE mounted on _CSA1: VMSINSTAL procedure done at hh:mm To complete the IVP, for the kits with product identifiers LNGVCA, LNGVCB, follow the instructions displayed to you during the Installation Verification Procedure. For examples of this text see Appendix E, IVP Output Examples. The final test, called the interactive test, demonstrates that DECspell has been installed correctly and is functioning properly. The test requires you to run DECspell on a video terminal using a test document provided. For a listing of the document text, see Appendix F, Interactive Test File. 2-8 CHAPTER 3 ADVICE ON USING DECSPELL ADVICE ON USING DECSPELL This chapter contains information to help you and the users on your system make the most effective use of DECspell. It also contains information that may help you in answering users' queries or problems. 3.1 Personal Dictionaries 3.1 Personal Dictionaries Personal dictionaries are lists maintained by users. The words and names contained in them are words which are not in the master dictionary. DECspell is easier to use when personal dictionaries are used for checking, because fewer valid words are highlighted as errors. Users should be encouraged to make full use of their personal dictionaries. 3.1.1 Using DECspell for the First Time 3.1.1 Using DECspell for the First Time If you are using DECspell from ALL-IN-1 V2, read section 3.1.1.2. Otherwise, read section 3.1.1.1. (This includes ALL-IN-1 V1.3 users.) 3.1.1.1 Using DECspell Outside ALL-IN-1 V2 3.1.1.1 Using DECspell Outside ALL-IN-1 V2 - The first time a user runs DECspell he will not have a default personal dictionary. This is the personal dictionary that DECspell always uses unless the user specifies otherwise. DECspell will ask whether the user wants one created. If the user answers NO, this question is asked each subsequent time the user runs DECspell. If the user answers YES a default personal dictionary is created, with the file name SYS$LOGIN:PERSONAL.LGP. Personal dictionaries are ASCII files. Users can create and add to other personal dictionaries using an editor, for example EDT. There 3-1 can be more than one word per line; separate the words with spaces. The words can be in any order. 3.1.1.2 Using DECspell from ALL-IN-1 V2 3.1.1.2 Using DECspell from ALL-IN-1 V2 - The first time a user runs DECspell from ALL-IN-1 V2, an empty personal dictionary is created for that user. It is called PERSONAL, and is stored in the DICTIONARIES folder. (Personal dictionaries are ALL-IN-1 documents, with a file type of DICTIONARY.) However, if a user already has a personal dictionary outside ALL-IN-1 (SYS$LOGIN:PERSONAL.LGP), then ALL-IN-1 takes this as the PERSONAL dictionary. Each time the user updates the dictionary, both PERSONAL and PERSONAL.LGP are updated. In this way, people can use the same personal dictionary when running DECspell inside or outside ALL-IN-1. 3.1.2 Using Imported Dictionaries in ALL-IN-1 V2 3.1.2 Using Imported Dictionaries in ALL-IN-1 V2 In addition to dictionaries in the user's own File Cabinet, dictionaries transferred from VMS, or mailed from other ALL-IN-1 accounts can be used. However, DECspell does not recognize these as dictionaries unless the user does the following: 1 Dictionaries transferred from VMS, using the DT option on the WP menu -- When transferring a dictionary, users should press Gold A at the Creating From VMS File form, to display additional fields. They should then enter DICTIONARY in the Handling field. (Refer to the ALL-IN-1 User's Reference volume 2 for details on transferring documents.) If a user has transferred the dictionary without doing this, he should enter Convert Document (CD) from the File Cabinet menu, and convert the document type to DICTIONARY. 2 Dictionaries mailed from another ALL-IN-1 account, using ALL-IN-1 Electronic Messaging -- When users mail dictionaries using ALL-IN-1 Electronic Messaging, they should mail them as attachments. (Refer to the ALL-IN-1 User's Reference volume 1 for details on sending mail.) The filed attachments can then be used to check documents. 3-2 3.1.3 Sharing Personal Dictionaries with Other Users 3.1.3 Sharing Personal Dictionaries with Other Users ALL-IN-1 does not allow users to share personal dictionaries. However, outside of ALL-IN-1, you can specify additional personal dictionaries with the /DICTIONARY qualifier. Users should refer to their own dictionaries by name. They can use other people's dictionaries, but will need to specify the directory for dictionaries located in other accounts. For example, user Brown issues the command: $ 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) DECspell requires Read access to additional dictionaries in order to use them for verification. DECspell requires Write access to additional dictionaries if you wish to add words while using DECspell. You can use this feature to set up a dictionary that can be shared between users. You can set up shared dictionaries with Read-only access 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 Dictionaries 3.1.4 System Messages Associated with Personal Dictionaries If a user is running DECspell from ALL-IN-1, an error message appears if he types an incorrect name when specifying additional dictionaries to be used for checking. ALL-IN-1 then lets the user try again. Outside of ALL-IN-1, when a user invokes additional dictionaries at the 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 incorrectly . Specifies the directory in which the dictionary is stored incorrectly . Specifies the device on which the dictionary is stored incorrectly . Specifies a dictionary that is protected against Read access The user is asked if he wishes to continue. He can type Y to continue without using the incorrectly specified dictionary or type N, start DECspell again and respecify the dictionary. 3-3 3.1.5 Words in Dictionaries 3.1.5 Words in Dictionaries DECspell dictionaries contain whole words only. There are no derived forms. Separate entries exist for the plural and possessive forms of words in dictionaries. If a user adds a word to his personal dictionary he may also need to add the plural and possessive forms separately. Many hyphenated words are stored in the dictionary as whole words. DECspell also handles compound words (valid words separated by a single hyphen) by checking each part in the dictionary. The compound word is only accepted if both halves are valid and have correct capitalization. Compound words can be added to personal dictionaries. DECspell handles abbreviations by first checking the word without the trailing period. If it is not found a second check is made with the trailing period appended. 3.2 The HELP Key 3.2 The HELP Key The HELP key used by DECspell is the PF2 key for VT100 and VT200 series terminals and the blue key on the mini-keypad on the VT52 series terminals. Alternatively you can use Gold H. On non-word-processing terminals the Gold key is the PF1 key for VT100 and VT200 series terminals and the red key on the mini-keypad for VT52 series terminals. 3.3 RUNOFF Documents in ALL-IN-1 3.3 RUNOFF Documents in ALL-IN-1 When transferring a RUNOFF document from VMS, users should do the following to make DECspell recognize it as a RUNOFF document: 1 Press Gold A at the Creating From VMS File form, to display additional fields. 2 Enter RUNOFF in the Handling field. (Refer to the ALL-IN-1 User's Reference volume 2 for more details on transferring documents.) If users have transferred RUNOFF documents without doing this, they should enter Update Index Information (U) from the File Cabinet menu, and enter RUNOFF in the Handling field. DECspell then bypasses RUNOFF commands in the document when checking it. 3-4 3.4 DCL Command Qualifiers 3.4 DCL Command Qualifiers Qualifiers modify the way DECspell works. Users can use them when starting DECspell outside ALL-IN-1. Users can abbreviate any qualifier uniquely and can use more than one qualifier at a time. The following DCL command qualifiers are available: /OUTPUT Gives the output document a new name. If this qualifier is not used the output document will be stored under its original name with a higher version number. For example: $ SPELL/OUTPUT=NEWNAME.TXT NAME.TXT /NOOUTPUT Prevents 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_DICTIONARY Prevents the users's default personal dictionary (PERSONAL.LGP) being used. For example: $ SPELL/NOPERSONAL_DICTIONARY NAME.TXT /PERSONAL_DICTIONARY This can be used to specify an alternative personal dictionary to be used 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 /DICTIONARY Specifies additional personal dictionaries for checking. If a user wishes to use a dictionary for checking, he must have Read access to the dictionary. If a user wishes to add words to a dictionary, he must have Write access to the dictionary. Up to 10 additional personal dictionaries can be used for checking. 3-5 For example: $ SPELL/DICTIONARY=(DICNAME1,DICNAME2) NAME.TXT /KEYPAD Specifies an alternative editor mini-keypad layout. Available keypads are WPS and EDT. The default is WPS. For example: $ SPELL/KEYPAD=EDT NAME.TXT /MASTER_DICTIONARY Specifies an alternative master dictionary. This qualifier can be used only if the system has both dictionaries. The dictionaries available are: . AMERICAN (the American English dictionary) . BRITISH (the British English dictionary) For Example: $ SPELL/MASTER_DICTIONARY=BRITISH NAME.TXT /DX Displays the index of the user's documents created on a word processor and transferred by DX. Allows the user to select the required document for checking. (If the user combines /DX with other qualifiers, he must specify /DX first.) For example: $ SPELL/DX /RUNOFF Indicates that the document is a RUNOFF document, if it does not already 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 /NORUNOFF Indicates that the document is not a RUNOFF document, if it has a .RN% file type. DECspell then checks every line in the document, including any beginning with a period. For example: $ SPELL/NORUNOFF NAME.RNO 3-6 3.4.1 Tailoring Command Qualifiers 3.4.1 Tailoring Command Qualifiers Sometimes it is cumbersome to type in a whole line of qualifiers. If the 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=EDT The command SPELL will now invoke DECspell with the above qualifiers. 3.5 Finding the Version Number 3.5 Finding the Version Number To find the version number of DECspell a user can do the following: While verifying a document, press the HELP key. The top line of each help frame has the format: HELP topic for help VERSION NUMBER This version number shows: . The version of DECspell you are using (for example, V1.1). . Whether the Corrector option is present (VC). All V1.1 kits have the Corrector. V1.0 kits could be Verifier only kits (VO). . Whether the master dictionary you are using is American or British (A or B). 3-7 CHAPTER 4 SYSTEM TUNING SYSTEM TUNING To reduce the overheads associated with invoking DECspell, and the memory requirements when more than one person is using DECspell, the image components of DECspell may be installed as shared images to the VAX/VMS system. Specify these as shared images using the VAX/VMS INSTALL utility. (Refer to the VAX/VMS System Management and Operations Guide.) Make sure that you increase the parameters GBLPAGES (global pages) and GLBSECTIONS (global sections) so that they can accommodate the DECspell images. The following table shows the requirements for each component: Table 4-1: Component Requirements Global Sections Global Pages Corrector: SYS$SYSTEM:LNGSPLCOR 3 134 Shareable Library SYS$LIBRARY:LNGSPLSHR 10 164 Dictionary SYS$LIBRARY:LNGSPLAEM 1 72 Dictionary SYS$LIBRARY:LNGSPLBEM 1 72 If these images are installed, they should be /OPEN/SHARED, and may be /HEADER_RESIDENT. 4-1 CHAPTER 5 RELEASE NOTES RELEASE NOTES 5.1 Differences Between DECspell V1.1 and V1.0 5.1 Differences Between DECspell V1.1 and V1.0 DECspell V1.1 has the following differences: . Larger, more compact master dictionaries . Support for RUNOFF. DECspell now by-passes RUNOFF commands when checking documents, instead of highlighting them as errors . Support for ALL-IN-1 V2. There is an ALL-IN-1 Spelling Check Dictionary menu. 5.2 Software Problems Fixed by this Release 5.2 Software Problems Fixed by this Release 5.2.1 Message Numbers Appearing on the Screen 5.2.1 Message Numbers Appearing on the Screen DECspell no longer displays an erroneous message at various places on the screen when a user's process has run out of open file quota, or when DECspell is being run with a working set extent that is too small (less than 50). The message that appeared was: MESSAGE NUMBER XXXXXXXX where XXXXXXXX represents a hexadecimal number. Instead, DECspell displays the correct error messages, as listed in Appendix D. 5-1 5.2.2 Lost Output Files 5.2.2 Lost Output Files There will no longer be lost space on disk if the user leaves DECspell in an unusual way (by typing CTRL/Y, or if the system crashes). Previously, this space had to be recovered using the VERIFY utility. 5-2 Now, if the user types CTRL/Y STOP, or if the system crashes, a file called .TMP appears in the user's directory. This file will contain the results of the checking done up to that point. If the user types CTRL/Y only, no output file is produced. 5.3 Known Problems and Restrictions 5.3 Known Problems and Restrictions 5.3.1 Non-AVO Terminals 5.3.1 Non-AVO Terminals Non-AVO terminals are VT100 series terminals without the Advanced Video Option. These terminals have limited video attributes and are not suitable for checking DX documents containing either bolding or underlining, because: . The bolding and underlining in the DX document is displayed as normal video. If you edit the document and insert any characters in a section of text that is bolded or underlined, they will not be bolded or underlined. . If you select the cursor to be an underline character, spelling errors will be displayed underlined. 5.3.2 Dictionary Status Report 5.3.2 Dictionary Status Report When DECspell has finished checking a document, it displays some statistics for each personal dictionary to which words have been added. These are: . The number of words added . The new total of words in the dictionary The total number of words in the dictionary does not include any words greater than 32 characters that you may have edited into your dictionary. 5.3.3 Lines With More Than 255 Characters 5.3.3 Lines With More Than 255 Characters DECspell does not support documents containing lines of text longer than 255 characters (that is, documents whose record length is greater than 255 characters). Personal dictionaries, however, can contain lines of any length. 5-3 5.3.4 RUNOFF Support 5.3.4 RUNOFF Support DECspell does not highlight incorrect RUNOFF commands as errors. This means that: . Incorrect RUNOFF commands will not be found . If a RUNOFF command without a terminating semicolon is incorrect, DECspell assumes that the whole line is a RUNOFF command. Therefore, DECspell will not highlight any errors in the text on that line. 5-4 APPENDIX A INCORPORATING DECSPELL INTO ALL-IN-1 V1.3 INCORPORATING DECSPELL INTO ALL-IN-1 V1.3 A.1 The Procedure A.1 The Procedure You can use DECspell V1.1 from ALL-IN-1 V1.3 or V2. Appendix B describes how to use DECspell from ALL-IN-1 V2. You can set up DECspell to be accessed in the way you require. Before you attempt to install DECspell into ALL-IN-1 V1.3 you should be familiar with ALL-IN-1 and have read the ALL-IN-1 Application Programmer's Reference Guide. Also make yourself familiar with DECspell. If you install DECspell into ALL-IN-1 V1.3 in the way described in this appendix it will be available from the SC option on the WP menu. You should already have answered YES to the following prompt during the DECspell installation procedure (section 2.2, step 12): Do you require access to DECspell through ALL-IN-1 [YES]? This means that the ALL-IN-1 related files, LNGSPLSC1.COM and LNGSPLFRM.FLB, have been copied into SYS$UPDATE. Now follow these steps: 1 Incorporate the DECspell personal dictionary form into the ALL-IN-1 form library in the following way: - Log into the ALL-IN-1 manager's account. - Copy the files from SYS$UPDATE to the ALL-IN-1 directory using the following commands: $ COPY SYS$UPDATE:LNGSPLSC1.COM DEVICE:[DIRECTORY] $ COPY SYS$UPDATE:LNGSPLFRM.FLB DEVICE:[DIRECTORY] A-1 where DEVICE:[DIRECTORY] is the location of ALL-IN-1. A-2 2 Copy the form LNGSC1 in the form library LNGSPLFRM to the library of ALL-IN-1 forms in the following way: - Run ALL-IN-1. - At the ALL-IN-1 Main Menu, enter FD. The Forms Development menu is displayed. - Enter the CO option to copy a known form to another form library. - When the Extract and Copy a Form Definition form appears, enter the following information: Destination Form Library: OALIB:OAFORM Form Name to Extract: LNGSC1 Source Form Library: OALIB:LNGSPLFRM Do NOT enter the file type FLB in the library specifications. Press RETURN when complete and the form will be copied into the ALL-IN-1 library. 3 Make DECspell accessible as an ALL-IN-1 option in the following way: - Return to the Forms Development menu. - Type E to edit an existing form. - When the Update Argument form appears type the following: Form Name to Update: WP Form library containing form: OALIB:OAFORM - When the form appears enter EDIT at the command prompt. If there is no line describing the SC option, enter a line describing it. - When you have finished editing return to command mode. 4 Type NAME to create an entry in the name table. Enter the following line in the table, or if a line already exists change it to the following: Name Data SC COMMAND LNGSPLSC1/NODUMP If the name table is full the last line of the table will contain the name of the continuation form, for example: Name Data A-3 .MORE WP2 A-4 5 Type SAVE and press RETURN. 6 When the Forms Development menu appears, enter E. 7 When the Update Argument form appears enter the name of the continuation form in the Form to Update field. 8 Enter or change the line describing the SC option in the way described in step 4 above. 9 When you have entered the line in the name table describing the SC option, press RETURN and type SAVE. DECspell will now be available for users. However, any users currently using the system must log out and log in again to use this option. 10 When you are sure that DECspell is installed correctly into ALL-IN-1, delete the two files, LNGSPLSCI.COM and LNGSPLFRM.FLB, in SYS$UPDATE. A.2 Using DECspell from ALL-IN-1 V1.3 A.2 Using DECspell from ALL-IN-1 V1.3 At the Document Processing (WP) menu, select the required document using the SEL option. Then enter SC and press RETURN. A form appears showing the personal dictionaries that will be used for checking. You can enter any additional dictionaries required. Use the ALL-IN-1 document names for these dictionaries. If the dictionaries displayed are the ones you require, press RETURN. A.3 Creating the DEFAULT Personal Dictionary A.3 Creating the DEFAULT Personal Dictionary The first time a new user runs DECspell from within ALL-IN-1 a default personal dictionary is automatically created for him if one does not already exist. This dictionary has the file name SYS$LOGIN:PERSONAL.LGP. In order to make this dictionary available from ALL-IN-1 do the following: 1 Run ALL-IN-1. 2 At the ALL-IN-1 Main Menu, enter DM. The Desk Management menu is displayed. 3 Enter FC (File Cabinet Maintenance). A-5 4 Enter A (Add VMS File to Document Database). When the form appears, enter the following: Document name to create: PERSONAL DICTIONARY VMS file name to be used: SYS$LOGIN:PERSONAL.LGP Add any additional information you may require. The personal dictionary is now available as an ALL-IN-1 document and may be edited from the WP menu. A.4 Creating Other Personal Dictionaries A.4 Creating Other Personal Dictionaries Create other personal dictionaries outside ALL-IN-1. Give them the default file specification of SYS$LOGIN:NAME.LGP, where NAME is the name of the dictionary. Make the dictionaries available for use from ALL-IN-1 in the same way as described above for the default personal dictionary. A-6 APPENDIX B INCORPORATING DECSPELL INTO ALL-IN-1 V2 INCORPORATING DECSPELL INTO ALL-IN-1 V2 B.1 The Procedure B.1 The Procedure Before you install DECspell into ALL-IN-1 V2, you should: . Make yourself familiar with both DECspell and ALL-IN-1 . Make sure you have the following VMS system privileges set up: . SYSPRV . EXQUOTA . PRMGBL . SYSGBL PRMGBL and SYSGBL are needed when you recompile and reinstall the OAFORM library in Step 5. . Make sure you have the ALL-IN-1 PRVCMD privilege set up. This is needed when you recompile and reinstall the TXL in Step 6. . Make sure that no users are logged into ALL-IN-1. NOTE If WPS-PLUS/ALL-IN-1 was already on your system when you installed DECspell, you must relink WPS-PLUS and ALL-IN-1 before continuing with this procedure. Refer to the ALL-IN-1 Installation Guide for more details. If you install DECspell into ALL-IN-1 in the way described in this section it will be available from the SC option on the WP and EMC menus. The Spelling Check Dictionary Menu will be available from the SCD option on any ALL-IN-1 menu. The option will be displayed on the WP menu. B-1 You should already have answered YES to the following prompt during the DECspell installation procedure (section 2.2, step 12): Do you require access to DECspell through ALL-IN-1 [YES]? This means that the following files are copied into SYS$UPDATE: . LNGSPLFRM.FLB . LNGSPLSC2.SCP . LNGSPLSC1.COM . LNGSPLSEL.SCP . LNGSPLSCI.COM . LNGSPLVAL.SCP . LNGSPLCRE.SCP . LNGSPLMNU.SCP . LNGSPLCSY.SCP . LNGSPLIDX.SCP . LNGSPLDEL.SCP . LNGSPLIST.SCP . LNGSPLDOW.SCP . LNGSPLSC2.FLB . LNGSPLEDI.SCP . LNGSPLSC2.HLP . LNGSPLFMT.SCP . LNGSPLSCD.HLP . LNGSPLINI.SCP . LNGSPLFOL.HLP . LNGSPLPOS.SCP . LNGSPLIVP.TXT NOTE The first two files (LNGSPLFRM.FLB and LNGSPLSC1.COM) are ALL-IN-1 V1.3 files, and are not needed for ALL-IN-1 V2. Delete them if you wish. Now follow these steps: 1 Run ALL-IN-1 from a system manager's account. 2 At the System Manager Functions menu, enter SCI (Spelling Check Install) to copy the ALL-IN-1 V2 files from SYS$UPDATE to the appropriate ALL-IN-1 library (OA$LIB: or OA$DO:), and to update the ALL-IN-1 form and help libraries. The steps that follow explain how to make the DECspell commands visible to the user. You may need to refer to the ALL-IN-1 Application Programmer's Reference. 3 Enter FD. The Forms Development menu is displayed. 4 Make an entry for DECspell in the WP (Word and Document Processing) and EMC (Electronic Messaging) menu forms. NOTE You are advised to make an entry for the SCD (Spelling Check Dictionary) option on the WP form only. However, it is accessible from all menus. B-2 For each form, do the following: - Select the form, specifying the name of the library (OA$LIB:OAFORM) and the name of the form (WP or EMC). - Enter E to edit a form. - Enter S to edit the screen image. The Form Editor menu appears. - Enter LAYOUT in the Phase Choice field. - When the form appears, enter a line describing the SC option, and a line describing the SCD option (if the descriptions are not already there). - Press Gold 7 (on the minikeypad) to return to the Form Editor Menu. - Enter EXIT. The following prompt appears: Do you want to save this form? (Y/N) - Enter Y. ALL-IN-1 returns you to the Forms Development menu. 5 Do the following to recompile and reinstall the OAFORM library: - Exit from ALL-IN-1, then run ALL-IN-1 again without initialization, using the following DCL command from an ALL-IN-1 manager's VMS account: $ ALLIN1/NOINIT - Enter the following commands at the Enter CMD: prompt: OA$FLO_OPEN OA$LIB:OAFORM OA$FBT_WRITE_LIBRARY OA$LIB:OAFORM OA$FBT_INSTALL_LIBRARY OA$LIB:OAFORM (Any other form libraries can be recompiled using the Precompile Form Library (PCF) option on the Forms Development (FD) menu.) - Enter the following commands at the Enter CMD: prompt to recompile and reinstall the TXL: OA$TXL_COMPILE B-3 OA$TXL_INSTALL Press CTRL/Z. Refer to the ALL-IN-1 System Manager's Guide for information on the TXL. - Ensure that the compiled forms library, OA$LIB:OAFORM.FLC, has World:Read protection. When you run ALL-IN-1 again, the SC and SCD options appear on the menus you edited. - When you are sure that DECspell is installed correctly into ALL-IN-1, you can delete the files listed at the beginning of this appendix from SYS$UPDATE. 6 If WPS-PLUS/ALL-IN-1 is installed on your system, you must install the following as known images: . SYS$LIBRARY:LNGSPLSHR.EXE . SYS$MESSAGE:LNGSPLMSG.EXE Do this as follows: - From a VMS system manager's account, enter the following command: $ RUN SYS$SYSTEM:INSTALL INSTALL>SYS$LIBRARY:LNGSPLSHR.EXE/OPEN/SHARE INSTALL>SYS$MESSAGE:LNGSPLMSG.EXE/OPEN/SHARE Type CTRL/Z. - Edit the file SYS$MANAGER:A1V2STARTUP.COM to include the lines: SYS$LIBRARY:LNGSPLSHR.EXE/OPEN/SHARE SYS$MESSAGE:LNGSPLMSG.EXE/OPEN/SHARE B-4 B.2 Using DECspell from ALL-IN-1 V2 B.2 Using DECspell from ALL-IN-1 V2 Enter WP or EM from the Main Menu. Enter SEL to select the required document, then enter SC and press RETURN. DECspell will start checking the document. If you want to see a list of the dictionaries to be used to check a document, enter SCD from either the WP or the EMC menu. Then enter DS from the Spelling Check Dictionary Menu. The Dictionary Selection form is displayed. You can specify additional dictionaries to be used for checking. B.3 Creating ALL-IN-1 Personal Dictionaries B.3 Creating ALL-IN-1 Personal Dictionaries The first time a new user runs DECspell from within ALL-IN-1 V2 (using the SC or the SCD option), a default personal dictionary is automatically created for that user. To create other personal dictionaries: 1 Enter WP from the ALL-IN-1 Main Menu. ALL-IN-1 displays the Word and Document Processing menu. 2 Enter SCD. ALL-IN-1 displays the Spelling Check Dictionary menu. 3 Enter C to create a personal dictionary. 4 Type the name of the dictionary. B-5 APPENDIX C SYSTEM FILES ASSOCIATED WITH DECSPELL SYSTEM FILES ASSOCIATED WITH DECSPELL All the files listed in this appendix have a protection of System:RWED, Owner:RWED, Group:RWED, World:RE. The following files will be written onto the system disk during installation: File Directory Size (Blocks) LNGVCA LNGVCB LNGALA LNGALB LNGSPLAED.LGS SYS$LIBRARY 870 Y N Y N LNGSPLAEM.EXE SYS$LIBRARY 71 Y N Y N LNGSPLBED.LGS SYS$LIBRARY 877 N Y N Y LNGSPLBEM.EXE SYS$LIBRARY 71 N Y N Y LNGSPLCOR.EXE SYS$SYSTEM 207 Y Y N N LNGSPLFOR.EXE SYS$SYSTEM 42 Y Y N N LNGSPLHLP.HLB SYS$HELP 58 Y Y N N LNGSPLIVP.TXT SYS$UPDATE 2 Y Y N N LNGSPLMSG.EXE SYS$MESSAGE 23 Y Y N N LNGSPLNDX.EXE SYS$SYSTEM 113 Y Y N N LNGSPLSHR.EXE SYS$LIBRARY 162 Y Y N N If you access DECspell through ALL-IN-1 V1.3, the following files are copied in addition to the above files: File Directory Size (Blocks) LNGVCA LNGVCB LNGALA LNGALB LNGSPLFRM.FLB SYS$UPDATE 6 Y Y N N C-1 LNGSPLSC1.COM SYS$UPDATE 15 Y Y N N C-2 If you access DECspell through ALL-IN-1 V2, the following files are copied in addition to the first list of files above: File Directory Size (Blocks) LNGVCA LNGVCB LNGALA LNGALB LNGSPLSCI.COM SYS$UPDATE 12 Y Y N N LNGSPLCRE.SCP SYS$UPDATE 5 Y Y N N LNGSPLCSY.SCP SYS$UPDATE 6 Y Y N N LNGSPLDEL.SCP SYS$UPDATE 5 Y Y N N LNGSPLDOW.SCP SYS$UPDATE 4 Y Y N N LNGSPLEDI.SCP SYS$UPDATE 3 Y Y N N LNGSPLFMT.SCP SYS$UPDATE 4 Y Y N N LNGSPLINI.SCP SYS$UPDATE 6 Y Y N N LNGSPLPOS.SCP SYS$UPDATE 5 Y Y N N LNGSPLSC2.SCP SYS$UPDATE 14 Y Y N N LNGSPLSEL.SCP SYS$UPDATE 4 Y Y N N LNGSPLVAL.SCP SYS$UPDATE 4 Y Y N N LNGSPLMNU.SCP SYS$UPDATE 4 Y Y N N LNGSPLIDX.SCP SYS$UPDATE 6 Y Y N N LNGSPLIST.SCP SYS$UPDATE 4 Y Y N N LNGSPLSC2.FLB SYS$UPDATE 42 Y Y N N LNGSPLSC2.HLP SYS$UPDATE 16 Y Y N N LNGSPLSCD.HLP SYS$UPDATE 7 Y Y N N LNGSPLFOL.HLP SYS$UPDATE 1 Y Y N N C-3 APPENDIX D SEVERE ERROR MESSAGES SEVERE ERROR MESSAGES This chapter lists all the error messages that appear when DECspell fails, why they have occurred and how to deal with them. D.1 Associated With Master Dictionaries D.1 Associated With Master Dictionaries %LNGSPL-F-BAD_MASTDIC, Master dictionary was specified incorrectly. See your system manager. You specified the master dictionary incorrectly when using the /MASTER qualifier. When using the /MASTER qualifier specify either /MASTER=BRITISH or /MASTER=AMERICAN %LNGSPL-F-FILNOTFOU, Master dictionary not opened - disk file not found The master dictionary you specified does not exist on the system. Either just the American or just the British dictionary is present. You cannot use the /MASTER qualifier. D.2 Associated with DX documents D.2 Associated with DX documents %LNGSPL-F-BAD_DX_CHAR, Illegal DX format for character. Spelling check abandoned. DX characters are encoded according to specific rules. This message is raised if DECspell encounters a character within a DX document that does not conform to the DX data encoding specifications. Remove any unusual character constructions from the document and retransmit it from the WPS to VMS. D-1 %LNGSPL-F-BAD_DX_FUNCT, Illegal DX function. Spelling check abandoned. DX characters are encoded according to specific rules. This message is raised if DECspell encounters a DX function within a DX document that does not conform to the DX data encoding specifications. Remove any unusual constructions from the document and retransmit it from the WPS to VMS. %LNGSPL-F-BAD_DX_HYPHEN, Illegal DX format for hyphen DX characters are encoded according to specific rules. This message is raised if DECspell encounters a hyphen character within a DX document that does not conform to the DX encoding specification. Remove any unusual hyphen constructions from the document and retransmit it from the WPS to VMS. %LNGSPL-F-BAD_DX_EOP, Illegal DX format for end_of_page character. Spelling check abandoned. DX characters are encoded according to specific rules. This message is raised if DECspell encounters an end_of_page character that does not conform to DX encoding specification. Remove any unusual end_of_page constructions from the document and retransmit it from the WPS to VMS. %LNGSPL-F-BAD_DX_EOL, Illegal DX format for end_of_line character. Spelling check abandoned. DX characters are encoded according to specific rules. This message is raised if DECspell encounters an end_of_line character that does not conform to DX encoding specification. Remove any unusual end_of_line constructions from the document and restransmit it form WPS to VMS. D-2 %LNGSPL-F-BAD_DX, Illegal DX format. Spelling check abandoned. DX characters are encoded according to specific rules. This message is raised if DECspell encounters data in a document that does not conform to DX encoding specification. Remove any unusual constructions from the document and retransmit it from WPS to VMS. D.3 Associated with Formatter D.3 Associated with Formatter %LNGSPL-F-SORTWRKSET, Not enough working set space for SORT. See your system manager. The sort facility in the formatter failed to get the working set it needed. Increase the user's working set quota. If the quota is already at maximum, increase the maximum. %LNGSPL-F-SORVIRMEM, Not enough virtual memory for SORT. See your system manager. The sort facility in the formatter failed to get the virtual memory it needed. DECREASE the user's working set quota to release more memory for the system. %LNGSPL-F-SORWRKDEV, SORT work file not a disk device or on local node. See your system manager. The logical names for the sort facility in the formatter temporary work files, SORTWORK1, SORTWORK2, are pointing to unsuitable devices; either to devices on another system, or to devices that are not random access devices (disks). Reassign these logical names to point to a random access device on a system from which you wish to run the SPELL/FORMAT. Alternatively deassign these logical names, so that the sort creates temporary work files in your local directory. %LNGSPL-F-SOREXTWRK, SORT could not extend work file. See your system manager. The sort facility in the formatter creates two work files on the device(s) specified by the logical names SORTWORK1, SORTWORK2. If these logicals are undefined, the work files are created in your login directory. D-3 Ensure you extend your privilege for the device where SORT is creating the temporary work files. If you extended the privilege, increase the free block space on the device. %LNGSPL-F-SORTMAP, SORT could not map work file. See your system manager. Ensure that the system parameter 'maximum process sections' is set to 20. %LNGSPL-F-SORCLNUP, SORT did not clean up work area. Run SPELL/FORMAT again. Sort failed to delete the work files and reinitialize the areas. %LNGSPL-F-SORNOOUT, SORT could not open a work file. See your system manager. Sort failed to open a work file. If the logical names (SORTWORK1, SORTWORK2) are not defined, increase the free disk space on the device(s) they point to. Otherwise, increase the free disk space on your login device. D.4 Miscellaneous D.4 Miscellaneous %LNGSPL-F-FILE_FNM_ERR, document not accessible - was specified incorrectly 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 name 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. -RMS-F-CHN, assign channel system service request failed -SYSTEM-F-IVDEVNAM, invalid device name You have specified the device for a document incorrectly. Check the name of the device and try again. D-4 %LNGSPL-F-FILE_GEN_ERR, document Read access failure. -RMS-E-DNR, device not ready or not mounted The device you specified was not online or mounted. Check that the specified volume is online and mounted and try again. %LNGSPL-F-FILE_PRV_ERR, document is protected against Read access. You do not have Read access to the document you specified. If you can, change the protection of the required document and try again. %LNGSPL-F-FILE_PRV_ERR, document is protected against Write access. Either you do not have Write access to the specified (or defaulted) directory, or you do not have Write access to the document itself. If you do not have Write access to the directory, use the /OUTPUT switch to create an output document in an alternative directory. If you do not have Write access to the document, change its protection. %DEBUGBOOT-W-INSFWSL, insufficient working set limit You are trying to run DECspell with a working set EXTENT that is too small. Increase your working set EXTENT. %LNGSPL-F-FILE_FNF_ERR, document was not found The document does not exist. Check the name and location of the document and try again. %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. D-5 %LNGSPL-F-BAD_KEYPAD, Keypad was specified incorrectly. Use either WPS or EDT You have specified an invalid keypad layout or incorrectly specified a keypad layout when using the /KEYPAD qualifier. Only the keypad layouts WPS and EDT are supported by DECspell when using the /KEYPAD qualifier. Use a valid keypad option when using the /KEYPAD qualifier. %LNGSCR-F-UNSUP_TERM, DECspell is not supported on this terminal type DECspell is supported on the VT100, VT200 and VT52 series of terminals. Use a valid terminal type to run DECspell. %LNGSCR-F-INSUF_CAP, Terminal has insufficient capabilities to display 132 cols You cannot enter 132 column mode because your VT100 terminal does not have the Advanced Video Option (AVO). Use the default 80 column mode. D-6 APPENDIX E IVP OUTPUT EXAMPLES IVP OUTPUT EXAMPLES Product Identifier: LNGVCA This is an example of the text displayed as the installation is verified: VAX DECspell V1.1 LNGVCA Installation Verification Procedure starting VAX DECspell V1.1 Dictionary regression test LNGVCA SUCCESS: Word Parser test completed SUCCESS: American-English Verifier test completed SUCCESS: American-English Verify Line test completed SUCCESS: American-English Corrector test completed SUCCESS: Personal Memory test completed SUCCESS: Personal Dictionary test completed SUCCESS: Replace List test completed VAX DECspell V1.1 Dictionary regression test successful VAX DECspell V1.1 Help library test VAX DECspell V1.1 Help library test was successful VAX DECspell V1.1 Dictionary formatter test using a dummy dictionary %LNGSPL-I-DUPWRDDEL, 105 duplicate words deleted. %LNGSPL-S-FMTCOMPL, formatting complete. Dictionary now contains 171 words. VAX DECspell V1.1 Dictionary formatter test was successful E-1 VAX DECspell V1.1 Interactive test The interactive test file has been stored in the SYS$UPDATE directory for later use. When the installation has completed, login to the system from a video terminal and type the command: $ SPELL/NOPERSONAL/NOOUTPUT SYS$UPDATE:LNGSPLIVP.TXT This test should successfully exercise the verifier corrector interactively. VAX DECspell V1.1 LNGVCA 26-JUN-1984 09:04:00.05 - IVP Successfully completed Product Identifier: LNGVCB This is an example of the text displayed as the installation is verified: VAX DECspell V1.1 LNGVCB Installation Verification Procedure starting VAX DECspell V1.1 Dictionary Regression Test LNGVCB SUCCESS: Word Parser test completed SUCCESS: British-English Verifier test completed SUCCESS: British-English Verify Line test completed SUCCESS: British-English Corrector test completed SUCCESS: Personal Memory test completed SUCCESS: Personal Dictionary test completed SUCCESS: Replace List test completed VAX DECspell V1.1 Dictionary regression test successful VAX DECspell V1.1 Help library test VAX DECspell V1.1 Help library test was successful VAX DECspell V1.1 Dictionary formatter test using a dummy dictionary %LNGSPL-I-DUPWRDDEL, 105 duplicate words deleted. %LNGSPL-S-FMTCOMPL, formatting complete. Dictionary now contains 171 words. VAX DECspell V1.1 Dictionary formatter test was successful E-2 VAX DECspell V1.1 Interactive test The interactive test file has been stored in the SYS$UPDATE directory for later use. When the installation has completed, login to the system from a video terminal and type the command: $ SPELL/NOPERSONAL/NOOUTPUT SYS$UPDATE:LNGSPLIVP.TXT This test should successfully exercise the verifier corrector interactively. VAX DECspell V1.1 LNGVCB 26-JUN-1984 09:04:43.24 - IVP Successfully completed Product Identifier: LNGALA This is an example of the text displayed as the installation is verified: VAX DECspell V1.1 LNGALA Installation Verification Procedure starting VAX DECspell V1.1 Dictionary Regression Rest LNGALA SUCCESS: Word Parser test completed SUCCESS: This is a Verifier/Corrector system SUCCESS: American-English Verifier test completed SUCCESS: American-English Verify Line test completed SUCCESS: American-English Corrector test completed SUCCESS: Personal Memory test completed SUCCESS: Personal Dictionary test completed SUCCESS: Replace List test completed VAX DECspell V1.1 Dictionary regression test successful VAX DECspell V1.1 LNGALA 26-JUN-1984 09:05:15.74 - IVP Successfully completed E-3 Product Identifier: LNGALB This is an example of the text displayed as the installation is verified: VAX DECspell V1.1 LNGALB Installation Verification Procedure starting VAX DECspell V1.1 Dictionary Regression Test LNGALB SUCCESS: Word Parser test completed SUCCESS: This is a Verifier/Corrector system SUCCESS: British-English Verifier test completed SUCCESS: British-English Verify Line test completed SUCCESS: British-English Corrector test completed SUCCESS: Personal Memory test completed SUCCESS: Personal Dictionary test completed SUCCESS: Replace List test completed VAX DECspell V1.1 Dictionary regression test successful VAX DECspell V1.1 LNGALB 26-JUN-1984 09:05:38.04 - IVP Successfully completed E-4 APPENDIX F INTERACTIVE TEST FILE INTERACTIVE TEST FILE The following piece of text is contained in the test file used as part of the interactive test at the end of the verification procedure. Follow the instructions in the test file to complete the IVP. Test Text File for LNGVCB and LNGVCA TEST STARTID -- YOU ARE RUNNING INTERACTIVELY Keep pressing RETURN to correct the highlighted errors. If you have any problems, or you are happy with the verification prosess and wish to finish, tpye the letter F, followed by RETURN. As you can see, this product offers corrections just below the text. By pressing the RETURN key, you can correct them with the suggested correction. Digital beleives you will find this product easy to use. This product offers suggestions on the corrections list which are the required spelling - with a high degree of acurasy. 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 installation prosedure will continue when you have corrected the last error. F-1 APPENDIX G REPORTING PROBLEMS REPORTING PROBLEMS If you encounter problems during the installation, stop the installation and contact either: . Your Customer Support Center, if you have a Basic or a DECsupport contract, or . Your local DIGITAL office to arrange for a service contract, if you do not have a Basic or a DECsupport contract. G-1 INDEX ALL-IN-1 master, messages associated dictionaries with, D-1 mailed from ALL-IN-1, 3-2 personal, 3-1, 3-3 transferred from VMS, 3-2 personal, creating, A-6 forms personal, default, A-5 Dictionary Selection, B-5 sharing, 3-3 Electronic Messaging, B-2 Dictionary Selection form, B-5 Update Argument, A-5 Differences between versions 1.0 Word and Document Processing, and 1.1, 5-1 B-2 DX document error messages, D-1 options Convert Document, 3-2 Editing ALL-IN-1 forms, A-3 Forms Development, A-3 Electronic Messaging form, B-2 Precompile Form Library, B-3 Electronic Messaging menu, B-2 Spelling Check, B-3 Error Messages Spelling Check Dictionary, associated with DX documents, B-2 D-1 Spelling Check Install, B-2 severe, D-1 Update Index Information, 3-4 Error messages ALL-IN-1 V1.3 associated with formatter, D-3 incorporating DECspell into, associated with master A-1 dictionary, D-1 using DECspell from, A-5 ALL-IN-1 V2 File Cabinet menu, 3-2, 3-4 incorporating DECspell into, Files associated with DECspell, B-1 C-1 using DECspell from, B-5 Fixed problems, 5-1 ALL-IN-1, editing forms in, A-3 Form Editor menu, B-3 Form libraries, recompiling, B-3 Basic kit, 1-3, 2-1, 2-6 Formatter, error messages Block sizes, 2-1 associated with, D-3 Forms Development Menu, A-3, B-2 Command qualifiers, 3-5 Forms Development menu, A-3, A-5 Command qualifiers, tailoring, 3-7 Global pages, 4-1 Convert Document option, 3-2 Global sections, 4-1 Creating personal dictionaries, A-6, B-5 Hardware requirements, 1-1 Help facility, 3-4 DCL command qualifiers, 3-5 DECspell kit, 1-3 Imported dictionaries, 3-2 DECspell V1.0, differences Incorporating DECspell into between V1.1 and, 5-1 ALL-IN-1 V1.3, A-1 Default personal dictionary, A-5 Incorporating DECspell into Desk Management menu, A-5 ALL-IN-1 V2, B-1 Dictionaries Installation ALL-IN-1, 3-2 preparation, 2-1 ALL-IN-1, creating, B-5 procedure, 2-3 imported, 3-2 Verification Procedure, 2-6, master, 3-6 2-7, 2-8 Index-1 Verification Procedure, output Qualifiers, tailoring, 3-7 examples, E-1 Installation Verification Recompiling Procedure, 2-6, 2-7 form libraries, B-3 Interactive test, 2-8 TXL, B-3 Interactive test file, F-1 Release notes, 5-1 IVP, 2-6, 2-7 Relinking WPS-PLUS/ALL-IN-1, B-1 completing the, 2-8 Requirements output examples, E-1 hardware, 1-1 software, 1-1 Kit, 1-3 RUNOFF documents, transferring to basic, 1-3, 2-1, 2-6 ALL-IN-1, 3-4 update, 1-3, 2-1 RUNOFF support, restrictions in, 5-4 LNGALA, 1-3, C-1 LNGALB, 1-3, C-1 Sharing dictionaries, 3-3 LNGVCA, 1-3, C-1 Software requirements, 1-1 LNGVCB, 1-3, C-1 Sort facility error messages, D-3 Lost files, 5-2 Spelling Check Dictionary menu, B-1, B-5 Master dictionary, 3-6 Spelling Check Dictionary option, Master dictionary error messages, B-2 D-1 Spelling Check Install option, Media, 1-3 B-2 Menu Spelling Check option, B-3 Desk Management, A-5 SYS$HELP, files in, C-1 Electronic Messaging, B-2 SYS$LIBRARY, files in, C-1 EMC, B-2 SYS$LOGIN:PERSONAL.LGP, A-5 File Cabinet, 3-2, 3-4 SYS$MESSAGE, files in, C-1 Form Editor, B-3 SYS$SYSTEM, files in, C-1 Forms Development, A-3, A-5, SYS$UPDATE, files in, B-2, C-1, B-2 C-2 Spelling Check Dictionary, B-1, System Manager Functions menu, B-5 B-2 System Manager Functions, B-2 System tuning, 4-1 Word and Document Processing, 3-2 Tailoring command qualifiers, 3-7 WP, 3-2 Transferring RUNOFF documents to Messages ALL-IN-1, 3-4 DECspell, 3-3 Tuning the system, 4-1 error, D-1 TXL, recompiling and reinstalling the, B-3 Non-AVO terminals, 5-3 Personal dictionaries, 3-1 Update Argument form, A-5 Personal dictionaries, creating, Update Index Information option, A-6, B-5 3-4 Personal dictionaries, default, Update kit, 1-3, 2-1 A-5 Using DECspell, 3-1 Precompile Form Library option, from ALL-IN-1 V1.3, A-5 B-3 from ALL-IN-1 V2, 3-2, B-5 Problems with DECspell, 5-3 Product identifier, 1-3 Version number, 3-7 Qualifiers, 3-5 VMSINSTAL, 2-3 Index-2 Word and Document Processing form, Words in dictionaries, 3-4 B-2 WP menu, 3-2 Word and Document Processing menu, WPS-PLUS/ALL-IN-1, relinking, B-1 3-2 Index-3