Installing Qedit/ix Pre-Release Tape

Installing other tape types...

The following instructions apply to existing Qedit users who are installing a new pre-release version. The whole process should take about 30 minutes, assuming that no one is using Qedit or any of its components. 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. (only XL)
4. Fix the MPEV compilers. (optional)
5. Purge installation files. (optional)

Installation Assistance

If you have any questions or run into any problems, please call us. Technical support is available on weekdays from 7 a.m. to 4 p.m. Pacific time at 1-800-453-8970. Installation should take less than 20 minutes. No one can use Qedit while step 1 is in progress. Bonus and QLIB programs cannot be used while step 2 is in progress.

Important Note About Passwords

None of the jobs we supply have passwords in them. Before streaming a job, you might have to add your system's passwords to the first line. Users of MPE XL version 3.0 and later do not have to do this because the operating system prompts you for missing passwords. The same is true for MPEV users who have security software that inserts passwords. Most MPEV 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.job.robelle
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 step prevents STREAMX from generating an error if the Robelle account does not yet exist. For example,

:setjcw streamxtempnonest 1
:stream robelle.job.robelle

Combined Qedit/Suprtool Tapes

If the tape you received has more than one product on it (e.g., Qedit and Suprtool), you can take a shortcut instead of following the complete instructions for both products. Steps that are common to both installations need only be done once. That is, there is no need to restore twice, or setup the Robelle account twice, or install the Qlib and Bonus programs twice, or clean up unneeded files twice. Note that if you do not use this shortcut it is not a problem; it will just take you a few minutes longer, and you will have to mount the restore tape a second time. Say you install Qedit first, followed by Suprtool:

1. Do all of the Qedit steps, except for the final Purge Installation Files step.
2. Then do the Suprtool installation starting with the :stream Install.Suprjob step. Skip the initial Restore and Robelle Accoount steps, and skip the Qlib/Bonus step. Do the final Purge Installation Files step.

Step 1: Install Qedit

This step requires three separate procedures: restoring all Robelle files from tape to disc, building (or upgrading) the Robelle account with the job stream that we provide, and streaming the installation job stream. All these procedures can easily be accomplished if you log on as Manager.Sys.

Restore All Robelle Files

First, you have to restore all the files from tape.

:hello manager.sys                    {log on as system manager}
:file rtape;dev=tape                  {mount Robelle tape}
:restore *rtape; @.@.robelle; create  {=reply on the console}

Check the :Restore listing for files that were busy and could not be restored. There are a number of reasons why a file could have been busy: someone may have been using it or backing it up, it may have been held as a suspended son process (menu system), or it may have been allocated. If files were busy, chase away any users, deallocate any busy programs, then try the :Restore command again.

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.

: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.

:stream robelle.job.robelle

This job stream will send you a message when it is finished. 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. Once Qedit has been installed, you can remove OP capability.

File Names

The following Qedit program files are restored to the Pub group of the Robelle account: Program Purpose 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 MPEV PMAP

Install Program Files

Our installation job puts the proper Qedit files into the Pub group of the Robelle account. To make sure no one uses these programs during the installation, send a warning. Then stream the 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. If the job failed, 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.

Once you have installed Qedit, users can now access it 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.

:hello mgr.robelle
:stream bonus.job.robelle         {or Qlib.Job.Robelle}

If you skip this step, you may end up running old versions of these programs.

Building the Spell Dictionary

Before you can use the Spell Bonus program or the Words command in Qedit, you have to build the main dictionary for Spell with an additional installation job. This job stream can take 30 to 60 minutes; you do not have to wait for it to finish before going to the next step. By default, the Spell program uses American spellings. To use British spellings, set the SpellAmerican JCW to False in the installation 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 (only XL)

If you don't need to compile source files that are saved as permanent Qedit workfiles (file code=111), then this step is optional. It is also optional if you have not installed a new version of MPE since your previous Qedit installation. 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 on 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 (3) changes to the Pub.Sys compiler command files:

:stream qcompxl.qeditjob.robelle

This job makes the following changes to the compiler command files:

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 within Qedit or at the MPE/iX prompt, simply by invoking the normal command file.

:pasxl source                     {from MPE}
:run qedit.pub.robelle
/pasxl source                     {from Qedit}
Within Qedit, you can specify an asterisk (*) for the current workfile.
:run qedit.pub.robelle
/text source
/pasxl *
/exit
:pasxl qeditscr

Step 4: Install CM Compiler Interface (optional)

If you don't need to compile source files that are saved as permanent Qedit workfiles (file code=111), then this step is optional. When installing Qedit on MPE/iX, you might have to install the NM compiler interface (described earlier) and the CM compiler interface (described here). For MPEV, 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 is faster to install and easier to remove later. You can start with the isolated method and easily convert to the integral method later. To determine if you currently use the isolated or integral method, run Qedit and enter /verify whichcomp If the displayed line ends with "IN ROBELLE," you are using the isolated method. If it ends in "IN SYS," you are using the integral method.

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 need to 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 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 write-enabled tape and :Reply. Save this tape and use it for future cold loads. The CM compiler interface is now installed. Compiling 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 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 finished, you can use the CM compilers on Qedit files from within Qedit, but not at the MPE prompt.

Step 5: Purge Installation Files (optional)

The easiest way to clean up after an installation is to stream the Cleanup.Purgejob.Robelle job. This job saves you disc space by purging the installation files. It does not purge the files that are necessary to run the software.

:stream cleanup.purgejob.robelle