home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.robelle3000.ai 2017
/
ftp.robelle3000.ai.tar
/
ftp.robelle3000.ai
/
changes
/
supr4p4ix.txt
< prev
next >
Wrap
Text File
|
2001-12-03
|
43KB
|
1,063 lines
SUPRTOOL Version 4.4
Database Handyman for the HP e3000
Change Notice
Installation Instructions
Addendum to 4.3 User Manual
Suprtool 4.4
Dbedit 4.4
Suprlink 4.4
STExport 4.4
Speed Demon 4.4
Suprtool2 4.8
Robelle Solutions Technology
Suite 201, 15399-102A Ave.
Surrey, B.C. Canada V3R 7K1
Toll-free: 1.888.robelle
Phone: 604.582.1700
Fax: 604.582.1799
E-mail: support@robelle.com
Web: www.robelle.com
February 2001
Program and Manual Copyright Robelle Solutions Technology Inc.
1981-2001
Permission is granted to reprint this document (but not for
profit), provided that copyright notice is given.
QEDIT and SUPRTOOL are trademarks of Robelle Solutions Technology
Inc. Other product and company names mentioned herein may be the
trademarks of their respective owners.
Introducing Suprtool Version 4.4
* Highlights
* Compatibility
* CPU Serial Number and CPU Name
* Compatibility Mode vs. Native Mode
* Documentation
* Documentation in WinHelp Format
Suprtool provides fast access to your data on the HP e3000. With
Suprtool, you can perform many necessary DP functions easily, with
just a few simple commands. At Robelle we are constantly working
on your enhancement requests so that we can include them every
year when we release an updated version of Suprtool. This change
notice provides you with detailed installation steps and a
description of Suprtool's new features.
Highlights
* Suprtool now supports string expressions in both the Extract
and If commands. String expressions allow users to select and
format their byte-type data in numerous new ways. This
includes combining byte-type fields together, upshifting and
downshifting data, and trimming blanks. These new features
combine to reduce the number of tasks needed to select and
format the data the way you need it.
* Suprtool, Speed Demon and HowMessy now support the new database
limits of 1,200 items, 240 sets and 64 paths for a master
dataset.
* Suprtool now supports the new Entrynumber format for databases
available in IMAGE version C.09.00 and later.
* Suprtool now supports 5,100 bytes of constants to be extracted.
(only NM and HP-UX)
* Suprtool, Suprlink and STExport now have the ability to create
their own persistent redo stacks. The contents of these stacks
can be recalled not only in the current session, but also in a
future session.
Known Problems
There are no known problems at this time.
Compatibility
Suprtool/iX is compatible with MPE V, MPE XL, and MPE/iX,
including MPE/iX 6.5 and MPE/iX 7.0.
Suprtool has been changed to no longer save an output file if no
records have been written and an error has occurred.
CPU Serial Number and CPU Name (HPSUSAN & HPCPUNAME)
This program runs only on CPUs whose serial numbers have been
encoded ("showvar hpsusan" on MPE/iX). This program may also be
encoded with your HPCPUNAME values. If it fails to run and you
get an "invalid HPCPUNAME" or "invalid HPSUSAN" error message,
contact Robelle for assistance.
Compatibility Mode vs. Native Mode
Throughout this change notice and in all of the Suprtool
documentation, there are references to compatibility mode and
native mode. If you are on a Classic HP e3000 (i.e., not MPE/iX),
you can use the compatibility-mode version of Suprtool. Our job
streams automatically install the correct version for your
machine. We use the terms MPE XL and MPE/iX interchangeably in
our documentation.
Documentation
This release includes updated user manuals for Suprtool and its
components. To print these manuals, use the Printdoc program.
:run printdoc.pub.robelle
This is the list of documentation files for Suprtool :
suprtool.doc.robelle {Suprtool user manual}
stexport.doc.robelle {STExport 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}
If you know the file names of other Robelle documents, you can
print them with Printdoc or you can include the file name in the
:Run command. For example, to print this change notice, type
:run printdoc.pub.robelle;info="suprtool.docchg.robelle"
Documentation in WinHelp Format
The user manuals for Suprtool and its components are all available
in the WinHelp file format of Microsoft Windows. Your tape
includes a WinHelp file, which is a self-extracting compressed
file that contains all the Help files and a Setup program. Use
the installation instructions in this change notice to install the
WinHelp files on your PC.
Installation of 4.4
If you need to install this upgrade in an account other than the
Robelle account, use the installation instructions in the appendix
at the end of this change notice.
The following installation instructions are for existing Suprtool
users who are installing a new version in the Robelle account.
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
no one uses Suprtool or its components during the installation.
To install this update of Suprtool, follow these steps:
1. Restore the new files from tape.
2. Upgrade the structure of the Robelle account.
3. Install the proper program files (NM or Classic).
4. Install Speed Demon in the system SL (only Classic).
5. Install the Suprtool2 interface in the system SL (only
Classic).
6. Limit Suprtool's run time priority (optional).
7. Install WinHelp documentation files (optional).
8. Install QLIB and Bonus programs.
9. Purge the installation files (optional).
Ecometry Users
Users of the Ecometry application need to use the installation
instructions supplied by Ecometry Corporation. Those instructions
have extra steps for updating the Ecometry code accounts.
You will find the Ecometry version of these instructions at
http://www.robelle.com/ecometry/
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 at 1.888.robelle
(1.888.762.3553).
Important Note about Passwords
None of the jobs that 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 3.0 and later 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: Restore the Files
You begin by restoring all the files from the tape.
:hello manager.sys
:file rtape; dev=tape {use appropriate
device}
:restore *rtape; @.@.robelle; create {restore everything}
The files on the tape require approximately 120,000 sectors. If
you are upgrading Suprtool, most of these files will replace
existing files, because the new version of Suprtool 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 yet have the correct names. The install job assigns
the proper names to the program files.
Step 2: Set Up the Robelle Account
Even if you already have the Robelle account, you must stream the
Robelle job to ensure that the Robelle account and all its groups
have the proper security and capabilities.
:stream robelle.job.robelle
When the job stream is finished, it will send you a message. The
job removes the password from the Robelle account. 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}
Note that during installation we add OP capability to the Robelle
account. After installing Suprtool, you have the option to remove
OP capability.
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
Once Suprtool has been installed, 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 will fail. Chase away any users and 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 a
copy of Speed Demon or the Suprtool2 interface in your own XL
files, you will have to update them with the new versions (use the
instructions in the Speed Demon and Calling Suprtool user
manuals).
To use the new versions on MPE V, you still 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 the Suprtool
documentation in the popular WinHelp format of Microsoft Windows.
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 (only Classic)
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: Limit Suprtool's Run Time Priority (optional)
Some system managers like to limit the amount of resources that
Suprtool consumes. One way to do this is by running Suprtool in
the D queue. You can configure this using 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 the priority of Suprtool only if they are familiar with
MPE process queues and the Tune command.
Step 7: Install WinHelp Documentation Files (optional)
The Suprtool documentation for both MPE and HP-UX is now available
in the WinHelp file format of Microsoft Windows. To install the
WinHelp files on a PC, follow these instructions.
Make a Temporary Directory for the Setup Program
From either DOS or Windows Explorer, make a directory into which
you can copy the installation files. For example, at the DOS
prompt type
mkdir \robtemp
You can remove this directory after installing the WinHelp files.
Download the Compressed File
Use Reflection to download the self-extracting Zip file to your PC
and continue with these steps. This Zip file on the HP e3000 is
called Suprhelp.WHelp.Robelle. Log on as Mgr.Robelle, and press
Alt-Y to go to the Reflection Command Line window. Then use the
following command to download the file using a binary transfer:
receive c:\robtemp\suprhelp.exe
from suprhelp.whelp.robelle binary
Expand the Compressed Files
You only need the following commands to extract the files because
we provide both 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
To run the Setup program, select the Run command from the Start
menu. When the Run window appears, enter C:\robtemp\setup in the
Command Line window and follow the instructions in the Setup
program.
When the Setup program ends, you can access all of the Suprtool
documentation by selecting any of the icons in the "Robelle Help"
Program Manager Group.
Remove the Robtemp Directory
Before you remove the WinHelp files, you can copy them to a
diskette or a CD and distribute them to other Suprtool users.
To delete all the WinHelp files and remove the Robtemp directory,
use either Windows Explorer or the following DOS commands:
cd \robtemp
del *.* {delete all the files in Robtemp}
cd ..
rmdir robtemp {remove the Robtemp directory}
Step 8: Install QLIB and Bonus Programs
Suprtool 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 only be used on authorized machines, and you may not
distribute them to anyone.
If you received Bonus programs with this version of Suprtool, 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 might end up running old versions of
these programs.
Step 9: 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.
Enhancements
Every year we provide Suprtool users with new features. The
following section describes the new enhancements to Suprtool since
the last major release.
IMAGE Limits
Starting with MPE/iX 6.5 Express 2, a new version of IMAGE,
C.09.00, will be available. This version of IMAGE, as well as
later versions, now supports 1,200 items, 240 datasets and 64
paths from a master dataset. The previous limits for a master
were 1,023 items, 199 datasets and 16 paths.
Suprtool, Speed Demon, Dbedit and HowMessy now support this new
version of IMAGE.
Large Datasets
IMAGE now supports datasets larger than 80 GB. In order to do
this, the IMAGE label was changed to keep track of records and the
pointers that hold them together. Prior to version C.09.00, IMAGE
stored records in what is known as Entryname format. In IMAGE
version C.09.00 and later, you can now select a new option called
the Entrynumber format.
This change to IMAGE must be invoked either by building a new
database or by converting a database with an HP-supplied utility
called Dbbigset.Pub.Sys. You can read more about this change in
the MPE/iX 6.5 Express 2 Communicator (available at www.docs.
hp.com) or get more details from the Robelle Web site.
Suprtool has been enhanced to support this new internal change to
IMAGE. HowMessy currently returns an error when you attempt to
report on a dataset with this feature enabled, because the block
number calculations are no longer relevant for this type of
database. We are currently reviewing how best to report on the
efficiency of databases that use this new format.
Extracting Constants
Until now, Suprtool was limited to 1,530 bytes of constants for
MPE/iX and HP-UX versions of Suprtool. This limit has now been
increased to 5,100 bytes. The MPE/V version of Suprtool is still
limited to 1,275 bytes.
Persistent Redo
Commands entered at the Suprtool prompt are saved in something
called the redo stack. You can recall commands from this stack by
using other commands such as Before, Do and Redo. By default, the
redo stack is stored in a temporary file and discarded as soon as
you exit Suprtool. This temporary stack is not preserved across
Suprtool invocations.
The new Set Redo command assigns a permanent file to the redo
stack, allowing the stack to become available for future Suprtool
invocations. For example, to assign the Myredo file as a
persistent redo stack, enter
>set redo myredo
If the file does not exist, Suprtool creates it. Otherwise,
Suprtool uses the existing file. All subsequent commands are
written to the persistent redo stack. This setting is valid for
the duration of the Suprtool session. As soon as you exit
Suprtool, the setting is discarded. Next time you run Suprtool,
you will get the temporary stack.
If the file name is not qualified, the redo stack is created in
the logon group and account. This may be desirable if you want to
have separate stacks. If you want to always use the same
persistent stacks, you should qualify the name.
The Verify command shows which stack is currently in use. If it
shows <temporary>, then Suprtool is using the default stack.
Anything else is the name of the file used on the Set Redo
command.
If a file with the specified name already exists, it must be
specifically created by a Set Redo command. Suprtool, Suprlink
and STExport do not overwrite an existing file.
Concurrency
When Suprtool uses the default temporary stack, it is accessible
only to that particular instance of Suprtool. You can run as many
Suprtool instances as you need and each one gets its own redo
stack. With temporary stacks, you will never have concurrency
problems.
If you start using a persistent redo stack, however, you might
start running into concurrency problems. A persistent redo stack
can be used by only one Suprtool instance at a time. If you try
to use a persistent redo stack that is already in use, you will
get the following message:
>set redo myredo
EXCLUSIVE VIOLATION: FILE BEING ACCESSED (FSERR 90)
Unable to open file for REDO stack
In this situation, Suprtool continues to use the redo stack active
at the time and lets you continue working as normal.
Qedit can also have permanent redo stacks. To prevent products
from writing to each other's redo stack, it is advisable to have
separate stacks for each product by giving them different file
names. For example, if you use
>set redo myredo
you will have a redo stack called Myredo for your Suprtool
commands. If you exit Suprtool, then run Qedit and supply the
same Set Redo command, your Qedit commands will be written to the
same file that was used for your Suprtool commands.
String Expressions
Both the Extract and If commands have been enhanced to allow
string expressions, which can be used to:
1. Combine two fields together (using the + operator).
2. Remove spaces (using the built-in trim functions).
3. Upshift or downshift characters.
String expressions reduce the number of tasks required for many
common operations involving byte-type fields. Fewer tasks means
that Suprtool delivers data to your applications faster than ever
before.
These changes are so extensive that string expressions are
described separately for the Extract and If Commands. See the
sections below for specific details and examples of string
expressions.
Extract Command
You can now use string expressions in the Extract command. They
allow you to combine byte-type fields together (using the +
operator) or operate on byte-type fields with special functions.
In many cases, you can now reduce the number of tasks required to
format your data the way you want. Fewer tasks means that
Suprtool delivers the data where you need it faster than ever
before. To extract a string expression, use this syntax:
EXTRACT target-field = expression
Target-Field
The target-field determines the byte-length of the expression.
The data-type must be Byte or Char. The expression is extracted
during the output phase and cannot be used by other Suprtool
commands that accept fields (e.g., Sort).
Examples
>extract id-no = warehouse-no + bin-no
>extract full-name = first-name + last-name
Constants vs. Expressions
If you have a string expression that starts with a string,
Suprtool assumes that you are attempting to extract a single
string value and not a string expression. To specify a string
expression that starts with a constant, surround the expression
with parentheses. For example,
Incorrect
>extract name = " " + product-desc
Error: Missing comma or invalid arithmetic expression
Correct
>extract name = (" " + product-desc)
Variable Length Strings
String expressions use variable-length strings. Suprtool keeps
track of the length of every string, and all operations are done
using the actual string length. For fields, the length of the
string is the length of the field. If you do not want to retain
all the spaces in a field, use one of the built-in trimming
functions.
String constants are created with the exact length of the
constant. For example, the string "abc" is three characters long
and the string "a" is one.
When assigning the string expression to the target field, Suprtool
pads the final string value with spaces to fill out the target
field. String expressions longer than the target field generate
an error.
>in testfile
>def a,1,10,byte
>ext a="I'm too long for this container"
Error: String is too long for the specified item
String Truncation
Suprtool produces an error if the string expression is longer than
the target field. You cannot override this error with Set Ignore
On. To help avoid the error, you may want to trim trailing spaces
from the expression before assigning it to the target field. For
example,
>extract new-field = $trim(a + b + c)
Upshifting Strings ($Upper)
Use the built-in function $upper to upshift all the characters of
a string expression into uppercase characters. This function can
be used to upshift a single field, a complicated string
expression, or any subpart of an expression. Both ASCII and
Roman-8 characters are upshifted by $upper. For example,
>extract city-up = $upper(city)
>extract full-name = $upper(first + last)
>extract desc = desc-1 + $upper(desc-2)
Downshifting Strings ($Lower)
If you want to downshift all characters of a string expression to
lowercase, use the built-in function $lower. This function can be
used to downshift a single field, a complicated string expression,
or any subpart of an expression. Both ASCII and Roman-8
characters are downshifted by $lower. For example,
>extract city-lower-case = $lower(city)
>extract city-state = $lower(city + state)
>extract desc = desc-1 + $lower(desc-2)
Trimming Spaces ($Trim, $Ltrim, $Rtrim)
Use one of three built-in string functions to remove leading or
trailing spaces from a string expression. The three functions
are:
$Trim: Remove leading and trailing spaces from the string
expression.
$Ltrim: Remove leading spaces.
$Rtrim: Remove trailing spaces.
If Command
You can do comparisons with byte-type fields in numerous ways
using Suprtool. These powerful features minimize the number of
tasks you must execute in order to select the data you need. The
fewer the number of tasks, the faster your data is delivered to
the users and applications that need it.
You can combine byte-type fields together and use the built-in
string functions to create string expressions. String expressions
involve the + operator and any of the built-in string functions,
which are $lower, $upper, $trim, $ltrim and $rtrim.
Fixed vs. Variable Length Strings
String comparisons are done using fixed- and variable-length
strings. For most users, there should be no difference between
the two types of strings. When doing string comparisons, Suprtool
always pads shorter strings with spaces, with the one exception of
comparing two fixed-length fields (see "Byte Fields" below).
String expressions involving the + operator or the $lower, $upper,
$trim, $ltrim and $rtrim built-in functions are done using
variable-length strings. Suprtool keeps track of the length of
every string, and all operations are done using the actual string
length. For fields, the length of the string is the length of the
field. If you do not want to retain all the spaces in a field,
use one of the built-in trimming functions.
When creating string expressions, string constants are created
with the exact length of the constant. For example, the string
"abc" is three characters long and the string "a" is one.
Byte Fields
For historical reasons, comparing two byte-type fields to each
other is a special case. If the two fields are exactly the same
length, Suprtool compares them completely. If one field is
shorter, the comparison is done for the length of the shortest
field. Suprtool does not check for spaces in the trailing
characters of the longer field. For example,
>define short, 1,10 {10-character field}
>define long ,11,15 {15-character field}
>if short = long
In this example, Suprtool compares the 10 bytes in the short field
with the first 10 bytes of the long field, but ignores the last
five bytes of the long field. If the expression on either side of
the equal sign consisted of more than one field (using the +
operator) or involved any of the built-in string functions, such
as $lower, $upper, $trim, $ltrim and $rtrim, Suprtool would have
compared both sides of the equal sign by padding the shorter field
with spaces. It is only the case where you are directly comparing
one byte-type field to another that Suprtool uses the length of
the shortest field for the comparison.
Trimming Spaces ($Trim, $Ltrim, $Rtrim)
Use one of three built-in string functions to remove leading or
trailing spaces from a string expression. The three functions
are:
$Trim: Remove leading and trailing spaces from the string
expression.
$Ltrim: Remove leading spaces.
$Rtrim: Remove trailing spaces.
Because Suprtool pads shorter strings with spaces when doing
comparisons, trimming spaces is most useful when creating a
combined string with several fields. For example, you might want
to combine a person's first and last name (including a space
between the two):
>if $trim(first) + " " + $trim(last) = "Joe Smith"
Mixed Case ($Upper and $Lower)
By default, Suprtool does an exact match when comparing two string
expressions. If the expressions vary in the capitalization of
characters, Suprtool finds them to be unequal. To do caseless
string comparisons or pattern matches, use the $upper or $lower
functions. Both ASCII and Roman-8 characters are shifted by
$upper and $lower. For example,
>if $upper(city) = "VANCOUVER"
>if $lower(city) = "edmonton"
Note that if you use the $upper or $lower functions, Suprtool does
not shift any constants in the comparison. You must explicitly
specify the constants in the correct case or you can use $upper or
$lower with the constant:
>if $upper(city) = $upper("vancouver")
Use the $upper or $lower functions for caseless pattern matching.
As with other comparison operators, you must specify constants in
the correct case when doing pattern matching:
>if $upper(city) == "VAN "
>if $lower(city) == "ed "
You can use $upper and $lower with string expressions that combine
many fields and string functions. In the following example, we
create
>if $read
- $upper($trim(first) +
- " " +
- $trim(last))
- = "JOE SMITH"
-
Bugs Fixed
Arithmetic Operations. Suprtool now has a better error message when an
arithmetic operation has an invalid decimal operand length.
Extract Command. When extracting constants, Suprtool no longer
incorrectly reports that the constant limit has been reached.
Extract Command. When extracting one field into another, invalid data
is no longer produced if the two fields are exactly the same
length and type, but have a different number of implied decimal
places.
Extract Command. When the maximum limit of extracted constants is
reached, Suprtool no longer incorrectly reports the following
message:
Error: Number of constants in >EXTRACT exceeds maximum
This error message has now been changed to
Error: Total size of constants in >EXTRACT exceeds maximum
Get Command and Speed Demon. Suprtool no longer incorrectly determines
the highwater mark if the dataset is non-Jumbo, the capacity is
large, and the blocking factor is one or two.
Prefetch'point Failure. Suprtool no longer fails with a prefetch'point
failure if the input file has an odd record size and the record
being selected is the last record in the file.
Set Ignore On. Suprtool now honors the Set Ignore On flag when
encountering an illegal packed decimal number in the $stddate
function.
Suprmgr Commands. Suprtool no longer prints a blank line for every
command in the Suprmgr.Pub.Sys file.
QLIB and Bonus Enhancements
Suprtool comes with an array of contributed tools in the QLIB
library. Your Robelle license may also entitle you to receive our
five Bonus programs. All of these tools are updated throughout
the year, not necessarily in sync with Suprtool or any other
Robelle product.
If you have the Bonus programs, you may use them only on
appropriately licensed CPUs. The QLIB programs, however, may be
used on any CPU and given away freely. The most recently released
Bonus and QLIB tools are as follows:
Bonus QLIB
Compare/iX 2.7 Helpcomp 2.2
HowMessy 2.8 Printdoc 1.7
Select 4.0 Prose 4.3
Spell 1.9 Pscreen 89C
Xpedit 1.8 Qcopy 4.6
Qhelp 2.2
Bonus Programs
Since the last major release of Suprtool, version 4.3, the Bonus
programs have been enhanced with the following new features:
HowMessy 2.8
HowMessy provides fast reports on the internal efficiency of your
database. It is compatible with IMAGE C.09.00, and now supports
an increased number of items, sets, and paths for a master
dataset. See HowMessy.Docchg.Robelle for a detailed change notice
for HowMessy.
QLIB Programs
Since the last major release of Suprtool, version 4.3, there have
been no changes to the QLIB programs.
Appendix: Non-Robelle Installation
Suprtool is usually installed on your HP e3000 in the Robelle
account (see the installation instructions earlier in this change
notice). However, you can easily install Suprtool into another
account by following these general steps:
1. Restore the files into your account instead of the Robelle
account.
2. Stream the account upgrade job (with modifications).
3. Stream the installation jobs (with modifications).
For example, to install Suprtool into an account called Tools and
into the same groups as Suprtool would have used in the Robelle
account (Pub, Doc, Help, etc.), follow these steps.
Step 1: Restore Files
Restore the files into your account (Tools in this example):
:restore *rtape;@.@.@;create;account=tools
Step 2: Stream the Account Upgrade Job (with modifications)
With a text editor, change all account references in the
Robelle.Job.Tools job from "robelle" to "tools." Don't worry
about changes to some of the comments in the job. Note that this
job will change the capabilities, access flags, and logon password
of the Tools account. Examine the job carefully to ensure that
the changes do not cause problems for other software in the Tools
account.
:qedit {or editor/quad/etc.}
/text robelle.job.tools
/change "robelle"(upshift) "tools" all
Step 3: Stream the Installation Jobs (with modifications)
Now log on to the Tools account instead of the Robelle account.
:hello mgr.tools
:qedit {or editor/quad/etc.}
Before streaming any jobs, you must alter them so that they log on
to the Tools account instead of the Robelle account. Make the
following change to each job in the Suprjob, Job, and Purgejob
groups:
/text install.suprjob
/change "robelle"(upshift smart) "tools" all
/keep
/exit
:stream install.suprjob
In the example above, we have used Robelle's Qedit text editor to
make the required changes to the account name, but you can use any
editor. Just make sure that all occurrences of "robelle" are
changed, regardless of whether "robelle" is in uppercase,
lowercase, or mixed case. But change "robelle" only when it is a
separate word, not when it is embedded in a longer word.