QEDIT Version 4.5.02 Full-Screen Text Editor for the HP 3000 Installation If you are a new Qedit user, please follow the installation instructions in the Qedit User Manual. The following instructions assume that you are an existing Qedit user who is upgrading to version 4.5.02. If you need to install this upgrade in an account other than the Robelle account, follow the installation instructions in the appendix at the end of this change notice. To install this upgrade of Qedit, follow these 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 30 minutes to complete all the steps; no one can use Qedit during this time. 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. You can also 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 easily recognize a pre-release by its three-part version number (e.g., 4.3.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. If you are a user of MPE XL version 3.0 or later, you do not have to do this because the operating system prompts you 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 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. :setjcw streamxtempnonest 1 :stream robelle.pub.sys Step 1: Install Qedit This step requires three separate procedures: building (or upgrading) the Robelle account by using the job stream that we provide, restoring all the Robelle files from tape to disc, and streaming the installation job. All of these procedures can easily be accomplished if you log on as Manager.Sys. Create/Update Robelle Account You must build (or upgrade) the Robelle account with the job stream that 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 after the installation. :hello manager.sys {log on 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 stream will send you a message when it has completed. Stay logged on as Manager.Sys and put a password on the Robelle account. If you are upgrading your Robelle account, use the old password. :altacct robelle;pass=hardpass {hard to guess} Please note that during installation, we add OP capability to the Robelle account. When the Qedit installation is complete, you have the option to remove 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 files that could not be restored. If a file was "busy", then someone was using it or backing it up, or it was held as a suspended son process (menu system), or it was allocated. Chase away any users, deallocate any busy programs, then try the :Restore again. Filenames The Qedit program files are restored to the Pubnew group of the Robelle account. These 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 the proper Qedit files into the Pub group of the Robelle account. No one can use these programs during 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 during the installation, the job will fail. Chase away any users, ensure that a 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. Now you can access Qedit by entering :run Qedit.pub.robelle Step 2: Install QLIB and 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 CPU 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 be used only on authorized machines, and you may not distribute them to anyone. 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 Before you can use the Spell Bonus program, you have to build its main dictionary with an additional install job. This job stream could take 30 to 60 minutes; there is no reason to wait for it to finish before going on to the next step. By default, the Spell program uses American spellings. To use British spellings, set the SpellAmerican JCW to False in the install job. :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 For more information, see the Spell User Manual. Step 3: Install NM Compiler Interface If you use any NM compilers on MPE/iX, you will want to install the new NM compiler interface. If you still use the CM compilers as well, you will also want to install that compiler interface (described in step 4 below). 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 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 ;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 so that errors in either Qedit or MPE/iX will abort the command file. Compiling Instructions Now you should be able to compile a Qedit file or a Keep file either from within Qedit or at the MPE/iX prompt, 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). For MPE V, however, you only have to worry about the original "CM" compilers. 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 can be installed quickly and it is easier to remove. You can start with the isolated method and easily convert to the 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 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. Qedit workfiles can be compiled only from within Qedit because the "Qedit" compilers are not in Pub.Sys. 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 an MPE update from HP. Before you start, you should :Store @.Pub.Sys and save it on tape, because this job modifies the compiler program files in Pub.Sys. You will need another small tape for a new cold load tape. Ensure that no one compiles during the installation. 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 This job runs Qedify.Pub.Robelle, which updates the compilers in Pub.Sys and installs nonprivileged hooks into them so that the compilers 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 future cold loads. The CM compiler interface is now installed. Compiles done inside or outside Qedit will now work on either Qedit workfiles or on regular Keep files. Isolating CM Compiler Changes The job stream Qeditj1a.Qeditjob.Robelle fixes the compilers, but it isolates the changes in the Q.Robelle group. Ensure that no one compiles during the installation. 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 it "fixes" them so that they can 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 documentation for both MPE and HP-UX is now available in the WinHelp format of Microsoft Windows. You can only use these files if you have MS Windows 3.1 or later. To install the WinHelp files on a PC, follow these instructions. Make a Temporary Directory for the Setup Program From either DOS or the File Manager, make a directory for the installation files. You can remove this directory after installing the WinHelp files. mkdir \robtemp Download the Compressed Files In the next step, use Reflection to download the self-extracting Zip file to your PC. This Zip 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. Make sure you use the binary transfer. receive c:\robtemp\qedhelp.exe from qedhelp.whelp.robelle binary Expand the Compressed Files You only need the following commands to extract the files because we provide the Setup program and Help files in one self-extracting Zip file. From the DOS prompt, type these commands: cd \robtemp {go to the new Robtemp directory} qedhelp.exe {extract the Help files} Run the Setup Program From the Program Manager, run the Setup program by choosing Run from the File menu, then type c:\robtemp\setup in the Command Line box. Follow the instructions in 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 Now you can remove all the files from the Robtemp directory. Either delete them from the File Manager or use the following DOS commands: cd \robtemp del *.* {delete all the files} cd .. rmdir robtemp {remove the Robtemp directory} You can also copy the files in Robtemp to a diskette and distribute them to other Qedit users.