SUPRTOOL Version 4.0 Database Handyman for the HP 3000 Installation of 4.0 The following instructions apply to existing Suprtool users who are installing a new version. Please use the instructions from this change notice instead of the user manual because the change notice always has the latest version. The whole process should take about 30 minutes, assuming that no one is using Suprtool or its components. You can perform this installation easily if you log on as Manager.Sys. Follow these steps to install this update of Suprtool: 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 Speed Demon in the system SL (Classic only). 5. Install the Suprtool2 interface in the system SL (Classic only). 6. Optionally limit Suprtool's runtime priority. 7. Install WinHelp documentation files (optional). 8. Purge the installation files (optional). 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 easily recognize a pre-release by its three-part version number (e.g., 3.5.05) and the words "Pre-Release" next to the version number. 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-888-ROBELLE (1-888-762-3553). 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. Important Note About Passwords None of the jobs that 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) do not have to do this because 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 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. For example, :setjcw streamxtempnonest 1 :stream robelle.pub.sys Step 1: Upgrade or Build the Robelle Account Even if you already have the Robelle account, the first thing you must do is stream the Robelle job: :hello manager.sys :file suprtape;dev=tape :restore *suprtape;robelle.pub.sys {=reply on console} :stream robelle.pub.sys {supply passwords} This job stream sends 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 Suprtool installation is complete, you have the option to remove OP capability. 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. If you are upgrading Suprtool, most of these files will replace files that already exist, so the new version does 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 the correct names. The next step assigns the proper names to the program files. Step 3: Install Suprtool into Production Our installation job installs Suprtool, STExport, Suprlink, Speed Demon, and the Suprtool2 interface. No one can use these programs during the installation. Before you stream this installation job, warn people not to use these programs for a while. :hello mgr.robelle :warn @;please exit from Suprtool and Suprlink NOW! :stream install.Suprjob Check the installation job $stdlist. If anyone was either using Suprtool, STExport, Suprlink, or Speed Demon, or attempting to back them up, the installation job fails. 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 Suprtool and its components to the PubOld group of the Robelle account. If you need to move these versions back into production, use the Previous.Suprjob job stream. You can now access Suprtool by entering :run suprtool.pub.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 (use the instructions in the Speed Demon and Calling Suprtool user manuals). To use the new versions on MPE V, you need to install Speed Demon and Suprtool2 in the system SL. MPE/iX users must also do this if they are calling Speed Demon or Suprtool2 from compatibility-mode programs. With so few changes to Speed Demon and Suprtool2, you can safely ignore them for this version of Suprtool. If you have a Windows PC, you can install all of the Suprtool documentation in the popular Microsoft Windows WinHelp format on your PC. Step 4: Speed Demon/V Installation (optional) To use the new features of Speed Demon/V, you must install the latest version in the system SL. You should follow the installation instructions in the Speed Demon user manual. These instructions assume that you have used the Install.Suprjob job stream to move Suprtool and its components into the Pub group of the Robelle account. :stream demon.Suprjob.robelle Step 5: Suprtool2 Interface Installation (Classic only) The Suprtool2 interface has been revised. On MPE V you must re-install the interface. If you do not have the latest Suprtool2 interface, programs that attempt to use totals from Suprtool2 will fail. You can install this interface without recompiling any of your existing programs. System SL Installation To install the latest Suprtool2 interface in the system SL, use our standard installation job: :stream suprcall.Suprjob.robelle User SL or XL Files If you have a copy of the Suprtool2 interface in your own SL or XL, you will need to update it. For instructions on how to do this, consult the user manual for Calling Suprtool. Step 6: Optionally Limiting Suprtool's Runtime Priority Some system managers like to restrict the amount of resources that Suprtool consumes. One way to do this is by running Suprtool in the D queue, which lets you use HP's Linkedit program. :linkedit >altprog suprtool;maxpri=ds >exit By forcing Suprtool to always run in the lower queue (even when Suprtool runs on-line), it competes less with on-line users because most users run in the C queue. System managers should restrict only the priority of Suprtool if they are familiar with MPE process queues and the Tune command. Step 7: Install WinHelp Documentation Files (optional) All of the Suprtool documentation is now available in the WinHelp format for Microsoft Windows. You can use these files only if you have MS Windows 3.1 or later. Make a Temporary Directory for the Setup Program From either DOS or the File Manager, create a new directory for the installation files. You can remove this directory after the WinHelp files have been installed. mkdir \robtemp Download the Compressed File In the next step, download the self-extracting Zip file to your PC with Reflection. The file on the HP 3000 is called Suprhelp.Whelp.Robelle. You should be logged on as Mgr.Robelle. Press Alt-Y to go to the Reflection Command Line window. Make sure that you use the binary transfer. receive c:\robtemp\suprhelp.exe from suprhelp.whelp.robelle binary Expand the Compressed File You need only the following commands to extract the files because we provide the Setup program and the Help files in one self-extracting Zip file. From the DOS prompt, type the following commands: cd \robtemp {go to the new Robtemp directory} suprhelp.exe {extract the Help files} Run the Setup Program From the Program Manager, run the Setup program by choosing the Run option from the File menu, then enter c:\robtemp\setup in the Command Line box. Follow the instructions in the Setup program. You can now access all of the Suprtool documentation by selecting any of the icons in the "Robelle Help" Program Manager Group. Remove the Robtemp Directory Delete all of the files in the Robtemp directory either from the File Manager or with 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 Suprtool users. Step 8: 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 files that are needed to run the software.