home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.robelle3000.ai 2014
/
2014.06.ftp.robelle3000.ai.tar
/
ftp.robelle3000.ai
/
faq
/
suprtool_3.7.txt
< prev
next >
Wrap
Text File
|
1995-05-28
|
36KB
|
453 lines
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