Installation of Suprtool 3.7 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 Installation of Suprtool 3.7 The following instructions apply to existing Suprtool users who are installing a new version. Please use these instructions, rather than those in the User Manual. The change notice always has the latest revision. The whole process should take about 30 minutes, assuming that no one is using Suprtool, Suprlink, or Speed Demon. All of these steps are easily accomplished if you log on as Manager.Sys. To install this update, Suprtool requires the following steps: 1. Upgrade the structure of the Robelle account. 2. Restore the new files from tape. 3. Install the proper program files (NM or Classic). 4. Install the Bonus programs 5. Print extra copies of the documentation. 6. Install Speed Demon in the System SL (Classic only). 7. Install the Suprtool2 interface in the System SL (Classic only). 8. Re-hook Suprtool for MPEX 9. Configure Suprtool for Netbase (MPE/iX only). 10.Install Winhelp documentation files (optional). 11.Purge Installation Files (optional). 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 Suprtool, 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 its three-part version number (e.g., 3.5.05) 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. MPE XL 3.0 (and higher) users do not have to do this, since the operating system prompts for missing passwords. The same is true for some MPE V users, who have security software that inserts passwords. Most MPE V users will have to edit the jobs. For example, if the system manager logon password is QWERTY, you would do as follows: :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: Upgrade Account Structure 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 {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 launches another job, which will send you a message when it has completed. At this point, the Robelle account will have the password XXXX, and the Mgr.Robelle user will 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} Step 2: Restore the Files Stay logged on as Manager.Sys and restore the Robelle files: :file suprtape;dev=tape :restore *suprtape; @.@.robelle The files on the tape require approximately 80,000 sectors. Most of the files will replace files that already exist, so updating to the new version will not take up much more space than the old version. The Suprtool program files are located in the Pub group of the Robelle account. At this point in the installation process the files do not have their correct names. The next step assigns the proper names to the program files. Step 3: Install Suprtool into Production Our installation job installs Suprtool, Suprlink, Speed Demon, and the Suprtool2 interface. No one can be using these programs when you do the installation. Warn people not to use them for a while, and then stream our installation job: :hello mgr.robelle :warn @;please exit from Suprtool and Suprlink NOW! :stream install.suprjob.robelle Check the installation job $STDLIST. If anyone was using Suprtool, Suprlink, or Speed Demon or attempting to back them up, the job will have failed. 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 Suprtool, Suprlink, and Speed Demon to the PubOld group of the Robelle account. You can now try the new Suprtool by entering: :run suprtool.pub.robelle Step 4: Install Bonus and Contributed Programs There are five Robelle Bonus programs: Spell, HowMessy, Xpedit, Compare, and Select. Suprtool also includes a number of Contributed programs, including Prose and Qhelp. To install the correct version of these programs (CM or NM), use the Bonus.Job.Robelle job stream. If you skip this step, you will be running the old versions of the Bonus programs. There have been a few system failures which we suspect may result from using the compatibility-mode version of Qhelp on MPE/iX systems, so this is an important installation step. :stream bonus.job.robelle Optional Installation Steps On MPE/iX, your installation should be complete. If you have copied Speed Demon or the Suprtool2 interface to your own XL files, you will have to copy the latest versions using the instructions in the Speed Demon and Calling Suprtool user manuals. On MPE V, you need to install Speed Demon and Suprtool2 in the System SL in order to use the new versions. MPE/iX users must also do this, if they are calling Speed Demon or Suprtool2 from compatibility-mode programs. Step 5: Print Extra Copies of the Documentation Suprtool is documented in five manuals and this change notice. All manuals have been updated for this release of Suprtool. Use the Printdoc program to print any of these manuals: :run printdoc.pub.robelle Here is the list of documentation files for Suprtool: suprtool.doc.robelle {Suprtool user manual} suprlink.doc.robelle {Suprlink user manual} dbedit.doc.robelle {Dbedit user manual} demon.doc.robelle {Speed Demon user manual} suprcall.doc.robelle {Calling Suprtool user manual} suprtool.docchg.robelle {this change notice} Printdoc is menu-driven, and very easy to use. Printdoc asks you for information, and if you are not sure of your answer, you can ask for help by typing a question mark (?). 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="suprtool.docchg.robelle" A4 Paper To use Printdoc with international A4 size paper, set the OUTA4 JCW before running Printdoc. This will allow you to print the Qedit documentation with more lines per page, in a slightly narrower format. All the Suprtool manuals have been converted to print properly on A4 paper, but the QLIB and Bonus manuals have not. :setjcw outa4 = 1 :run printdoc.pub.robelle Step 6: Speed Demon Installation If you call Speed Demon/V from MPE V programs or from compatibility-mode programs on MPE/iX, you must install the latest version in the System SL. :stream demon.suprjob.robelle If you are on MPE/iX and have native-mode programs that call Speed Demon/iX, you may not need to reinstall. If your programs reference the XL in the Robelle account, Demonxl.Pub.Robelle, then the new version is installed when the files are restored. If you have copied the Suprtool2 interface into your own SL or XL, you will need to copy the latest version using the instructions in the Speed Demon User Manual. Step 7: Suprtool2 Interface Installation The Suprtool2 interface has been revised. If you have any programs that call Suprtool2, you must reinstall the interface in order to take advantage of the new features. If you do not reinstall, any program that calls Suprtool2 to obtain totals will fail. You can install this version without recompiling any of your existing programs. The latest Suprtool2 interface works with all versions of Suprtool, past and present, while the reverse is not true: Suprtool 3.7 does not work with older versions of the interface. System SL Installation If you are on MPE V and have programs that call Suprtool2, or if you are on MPE/iX and have compatibility-mode programs that call Suprtool2, you must reinstall the compatibility-mode interface in the System SL. Use our standard installation job: :stream suprcall.suprjob.robelle User SL or XL Files If you are on MPE/iX and have native-mode programs that call Suprtool2, you may not need to reinstall. If your programs reference the XL in the Robelle account, St2xl.Pub.Robelle, then the new version is automatically installed when the files are restored. If you have copied the Suprtool2 interface into your own SL or XL, you will need to copy the latest version using the instructions in the Calling Suprtool User Manual. Step 8: Re-hook Suprtool for MPEX, If Desired If you are a VESOFT customer, you may be in the habit of running a hooked Suprtool from the VESOFT account. Since you now have a new Suprtool program in the Robelle account, you must re-hook it. :hello manager.vesoft :run mpex.pub.vesoft %hook suprtool.pub.robelle %hook suprlink.pub.robelle Other utilities which may require moving the new Suprtool to an alternate account include OMNIDEX from DISC, and Netbase from Quest. Consult their respective manuals for details. Note that we have not tested Suprtool with these products, and that Suprtool may not always function as expected. If you suspect that the alterations are causing problems for Suprtool, try running Suprtool.Pub.Robelle to see if the problems go away. Step 9: Netbase and Suprtool (MPE/iX only) Netbase is a product from Quest Software that allows for files and databases to be located on remote machines, but they look like local files to the application programs. Suprtool's use of prefetch with certain versions of Netbase can cause system failures. To prevent this situation, you must do one of the following: 1. Have Netbase 0.9.4 or later installed, or 2. Turn off Suprtool's use of prefetch by adding the following line to your Suprmgr.Pub.Sys file: set prefetch 0 {that's a zero} Step 10: Install Winhelp documentation files (optional) All of the Suprtool 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 MS Windows 3.1 or later. Make a temporary directory for the Setup program From Dos or File Manager make a directory to copy the installation files (you can remove this directory after installing the Winhelp files): mkdir \robtemp Download Compressed File The next step is to download the self-extracting Zip file to your PC. Instructions for downloading this file using Reflection are outlined for you. The file on the HP3000 is called suprhelp.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\suprhelp.exe from suprhelp.whelp.robelle binary Expand the compressed files Since we provide the Setup program and help files in one self-extracting Zip-file, you only need the following commands to extract the files. From the Dos prompt type the following commands: cd \robtemp {go to where we downloaded the file to} suprhelp.exe {extract the help files} Run the Setup program From within Program Manager, run the Setup program by hitting the Alt-Key, then R for run and enter c:\robtemp\setup in the Command Line box. Follow the instructions as provided by the setup program. You are now able to access all of the Suprtool documentation by selecting any of the icons in the "Robelle Help" Program Manager Group. Remove the Robtemp directory You can now remove all of the files from the Robtemp directory either from the File Manager or by using 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 Suprtool users. Step 11: Purge Installation Files (Recommended) The easiest way to clean up after an installation is to stream the Cleanup job. This job will purge the files used for the installation, to save you disc space. It will not purge any files needed to run the software. :stream cleanup.purgejob.robelle There is a good chance that your Robelle account has files you do not need. You may have had a trial of Suprtool years ago. That trial tape also came with Qedit and Xpress, which you may not have purged after you tried Suprtool. Now is a good time to purge these files. If you are not licensed for Qedit, stream its purge job: :stream qedit.purgejob.robelle If you are not using Xpress, stream its purge job: :stream xpress.purgejob.robelle