QEDIT Version 4.4 Full-Screen Text Editor for the HP 3000 Installation Instructions Robelle Consulting Ltd. Unit 201, 15399-102A Ave. Surrey, B.C. Canada V3R 7K1 Toll-free: 1-800-561-8311 Phone: (604) 582-1700 Fax: (604) 582-1799 E-mail: support@robelle.com WWW: http://www.robelle.com October, 1995 Installation These notes assume that you are an existing Qedit user who wishes to upgrade to version 4.4. If you are a new Qedit user, please follow the installation instructions in the user manual. To install this version of Qedit, use the following steps: 1. Install Qedit. 2. Install the QLIB and/or Bonus programs. 3. Fix the NM compilers (XL only). 4. Fix the MPE V compilers (both systems). 5. Install the WinHelp files (optional). It should take about half an hour to complete all the steps. No one can use Qedit during this time. If you need to install this upgrade in an account other than the Robelle account, refer to the appendix at the end of this change notice before starting any installation steps. Installation Assistance If you have any questions about the upgrade process, or run into any problems, please call us. Technical support is available on weekdays from 7 a.m. to 4 p.m., Pacific time. As well, you can receive emergency support outside of these hours by calling our regular phone number and asking the operator to page a support person for you. Replace Any Pre-Release If you are currently running a pre-release version of Qedit, you should replace it with this new official release. Pre-release versions expire within two years of their creation date, whereas this new release has no expiry date. You can tell a pre-release by a three-part version number (e.g., 4.2.52) and the words "Pre-Release" next to the version number. Important Note About Passwords None of the jobs we supply have passwords in them. Before streaming a job, you may have to add your system's passwords to the first line. Users of MPE XL 3.0 and higher versions do not have to do this, since the operating system prompts for missing passwords. The same is true for MPE V users who have security software that inserts passwords. Most MPE V users have to edit the jobs. For example, if the system manager logon password is QWERTY, you would do the following: :editor HP32201A.07.22 EDIT/3000 /text robelle.pub.sys FILE UNNUMBERED /modify 1 MODIFY 1 !job robelle,manager.sys,pub;hipri i/qwerty !job robelle,manager.sys/qwerty,pub;hipri /keep robtemp /exit END OF SUBSYSTEM :stream robtemp :purge robtemp STREAMX Users Please Note: Users of STREAMX, a part of SECURITY/3000 from VESOFT Inc., must set a Job Control Word before streaming jobs. This prevents STREAMX from generating an error if the Robelle account does not yet exist. For example, :setjcw streamxtempnonest 1 :stream robelle.pub.sys Step 1: Install Qedit There are three steps to install Qedit on your system. First, build (or upgrade) the Robelle account using a job stream that we provide. Second, restore all Robelle files from tape to disc. Third, stream the installation job stream. All of these steps are easily accomplished if you log on as Manager.Sys. Create/Update Robelle Account You must build (or upgrade) the Robelle account with the job stream we provide. This job removes the passwords from the Robelle account and from the user Mgr.Robelle. You need to know the existing passwords, so that you can put them back once the installation is complete. :hello manager.sys {logon as system manager} :listacct robelle;pass {look for PASSWORD: } :listuser mgr.robelle;pass {look for PASSWORD: } Once you have written down the passwords, stay logged on as Manager.Sys and stream the job that builds and updates the Robelle account. :file rtape;dev=tape {mount Robelle tape} :restore *rtape; robelle.pub.sys {=Reply on the console} :stream robelle.pub.sys This job launches another job, which sends you a message when it has completed. At this point, the Robelle account has the password XXXX, and the Mgr.Robelle user does not have a password. You should put the previous passwords back, or change the passwords to something that will be hard for outsiders to guess. :altacct robelle;pass={robelle account password} :altuser mgr.robelle;pass={mgr.robelle user password} Please note that during installation, we add OP capability to the Robelle account. When the Qedit installation is complete, you can, if you wish, remove the OP capability. Restore Files Stay logged on as Manager.Sys and restore the Robelle files: :file rtape;dev=tape :restore *rtape;@.@.robelle {=reply on console} Check the :Restore listing for any files that could not be restored because they were Busy. Either someone is using them, they are held as suspended son processes (menu system), they are allocated, or someone is backing them up! Chase away any users; deallocate any busy programs; then try the :Restore again. Filenames The Qedit program files are located in the Pub group of the Robelle account. Here are the names of the various files: qeditnm {NM Qedit program} qeditcm qeditpm {CM Qedit programs} qcompxl {NM compiler interface} qedify qcompusl {CM compiler interface} qloadxl {NM Qedit options} ederrnm ederrcm {:Editerror support} qmap {reformat MPE V PMAP} Install Program Files Our installation job installs Qedit. No one can be using these programs when you do the installation. Warn people not to use Qedit for a while, and then stream our installation job: :hello mgr.robelle :warn @;please exit from Qedit NOW! :stream install.qeditjob {supply passwords} Check the installation job $STDLIST. If anyone was using Qedit or attempting to back it up, the job will fail. Chase away any users, ensure that backup is not in progress, then stream the installation job again. The installation job renames your current versions of Qedit to the PubOld group of the Robelle account. If you need to move these versions back into production, use the Previous.QeditJob job stream. You can now access Qedit by entering :run Qedit.pub.robelle Step 2: Install QLIB, Bonus Programs Qedit comes with an array of contributed software in the QLIB library (in the QLIB groups of the Robelle account). QLIB programs may be used on any CPUs and may be given away freely. Your Robelle license may also entitle you to receive our Bonus programs: Compare/iX, HowMessy, Select, Spell, and Xpedit. These programs reside in the Pub group of the Robelle account. Bonus programs can only be used on authorized machines, and you may not distribute them to your friends. If you received Bonus programs with this version of Qedit, use the job stream called Bonus.Job.Robelle to install both the QLIB and Bonus programs. If you did not receive Bonus programs, use the job stream Qlib.Job.Robelle to install the QLIB programs. If you skip this step, you may end up running old versions of these programs. :hello mgr.robelle :stream bonus.job.robelle {or Qlib.Job.Robelle} Building the Spell Dictionary The Spell Bonus program requires an additional install job to build its main dictionary. This job is required if you want to use Spell, and the Spell and Word commands in Qedit. By default, the American spellings are used. To use British spellings, modify the line that sets the SpellAmerican JCW so that the JCW is set to False. This job stream could take 30 to 60 minutes to complete; there is no reason to wait for it to finish before going on to the next step. :run qedit.pub.robelle {or use :Editor} /text dictmain.spjob /modify "setjcw SpellAmerican" {For British spelling...} /keep robtemp {...change True to False} /exit :stream robtemp :purge robtemp See the Spell user manual for more information on using Spell. Step 3: Install NM Compiler Interface On MPE/iX, if you use any NM compilers, you will want to install the new NM Compiler Interface. If you still use the CM compilers as well, you will want to install that compiler interface too, as described under step 4. Installing the Interface Assuming that you have Restored the Robelle files onto your system and that you have not done this step before, Stream Savecmdf.Qeditjob to make backup copies of the existing HP command files in the Stdcmd.Sys group. You will need to know the Manager.Sys password: :stream savecmdf.qeditjob.robelle {wait for it to finish} :listf @.stdcmd.sys Then Stream Qcompxl.Qeditjob to make three changes to the Pub.Sys compiler command files: :stream qcompxl.qeditjob.robelle 1. Change the run of the compiler program to have ;xl ="qcompxl.pubnew.robelle, qcompxl.pub.robelle", 2. Add ";shr" to the File commands for the text and master files. 3. Change "setjcw jcw=fatal" to an invalid command to abort the command file on errors in either Qedit or MPE/iX. Compiling Instructions At any point, either within Qedit or at the MPE/iX prompt, you now should be able to compile a Qedit file or a Keep file, just by invoking the normal command file: :pasxl source {from MPE} :run qedit.pub.robelle /pasxl source {from Qedit} Within Qedit, you can specify "*" for the current workfile: :run qedit.pub.robelle /text source /pasxl * /exit :pasxl qeditscr Step 4: Install CM Compiler Interface When installing Qedit on MPE/iX, you may have to install the NM Compiler Interface (described earlier) and the CM Compiler Interface (described here). MPE V, on the other hand, has only the original "CM" compilers to worry about. After Restoring the files from tape, you have to choose an installation method: integral or isolated. Choosing a CM Installation Method There are two methods of fixing the compilers on your system: integral into Pub.Sys or isolated in the Robelle account. The isolated method is best for new or trial-period users, because it is faster to install and easier to remove later. You can start with the isolated method and convert easily to integral method later. Integral Method. The compilers in Pub.Sys are "fixed" directly and a segment is added to the System SL. The standard :Cobol and :Pascal commands of MPE will then compile Qedit workfiles. :Sysdump is used to make a new cold load tape for the next time you must boot the system. Isolated Method. The MPE compilers are copied into the Q.Robelle group and the original compilers are left in the Pub.Sys group. No code is added to the System SL. Because the "Qedit" compilers are not in Pub.Sys, you can not compile Qedit workfiles except from within Qedit. Integrating CM Compiler Changes The job stream Qeditj1.Qeditjob.Robelle makes integral compiler fixes. Use it either to update the fixes to a new version or to re-install the fixes after a MPE update from HP. Because this job modifies the compiler program files in Pub.Sys, you should :Store @.Pub.Sys before starting and save the tape. You will need another small tape for a new Cold Load tape. Ensure that no one will compile until the installation is complete. Stop all jobs and send an operator warning. Log on as Manager.Sys, modify the first line of the Qeditj1 job to include the passwords, then :Stream the job. :stream qeditj1.qeditjob.robelle The job runs Qedify.Pub.Robelle to update the compilers in Pub.Sys and install non-privileged hooks into them, so that they can access Qedit workfiles. The job adds a code segment from Qcompusl.Pub.Robelle into Sl.Pub.Sys and then requests a tape mount for a new cold load tape. Mount a tape with a write ring and :Reply. Save this tape and use it for any future cold loads. The CM Compiler Interface is now installed. Compiles done inside or outside Qedit will work on either Qedit workfiles or on regular Keep files. Isolating CM Compiler Changes The job stream Qeditj1a.Qeditjob.Robelle fixes the compilers, but isolates the changes in the Q.Robelle group. Ensure that no one will compile until the installation is complete. Stop all jobs and send an operator warning. Modify the first line of Qeditj1a to include the Robelle password, then stream the job: :stream qeditj1a.qeditjob.robelle The job uses Qedify.Pub.Robelle to copy the compilers from Pub.Sys to the Q.Robelle group, then "fix" them to read Qedit files. The original compilers in the Pub.Sys group are not modified. Once this step is completed you can use the CM compilers on Qedit files from within Qedit, but not at the MPE prompt. Step 5: Install WinHelp Documentation Files (optional) The Qedit for MPE and Qedit for HP-UX documentation is now available in Microsoft Windows WinHelp format. To install these files onto a PC, do the following. To use WinHelp with our Help files, your PC must have Microsoft Windows 3.1 or a later version. Make a Temporary Directory for the Setup Program From DOS or File Manager make a directory for the installation files (you can remove this directory after installing the WinHelp files): mkdir \robtemp Download Compressed File Now download the self-extracting Zip file to your PC. Instructions for downloading this file using Reflection are outlined for you. The file on the HP 3000 is called qedhelp.whelp.robelle. You should be logged on as Mgr.Robelle. Press Alt-Y to go to the Reflection command line window (you must use binary transfer): receive c:\robtemp\qedhelp.exe from qedhelp.whelp.robelle binary Expand the Compressed Files Since we provide the Setup program and Help files in one self-extracting Zip file, you need only the following commands to extract the files. From the DOS prompt type the following commands: cd \robtemp {go to where we downloaded the file} qedhelp.exe {extract the help files} Run the Setup Program From within Program Manager, run the Setup program by choosing Run from the File menu, then enter c:\robtemp\setup in the Command Line box. Follow the instructions as provided by the Setup program. You can now access all the Qedit documentation by selecting any of the icons in the "Robelle Help" Program Manager Group. Remove the Robtemp Directory You can now remove all the files from the Robtemp directory. Either delete them from the File Manager or use the following DOS commands: cd \robtemp del *.* cd .. rmdir robtemp You could also copy the files in robtemp to a diskette and distribute to other Qedit users. Documentation If you wish to print copies of the revised user manual, use the file Qedit.Doc.Robelle. To print it on your printer, whether LaserJet or line printer, run the Printdoc program. :run printdoc.pub.robelle Printdoc is menu-driven and very easy to use. Printdoc asks you for information, and if you are not sure of the answer, you can ask for help by typing a question mark (?). Printdoc supports all types of LaserJet printers and regular line printers. You can also print documentation other than user manuals, if you know the filename. If you wish, you can include the filename in the :Run command. For example, to print this change notice, type :run printdoc.pub.robelle;info="qedit.docchg.robelle"