NetBase Release Notes Version 9.7

NetBase and TPS (Third Party Shadowing)
Technical Overview
Requires IMAGE version C.06.13. In order to get this version of IMAGE, the following patch must
be ordered from HP, Patch id TIXJX36. The patch can be ordered by calling the HP Response
Center and ordering it by the patch id. At this time, the patch will not be part of the MPE/ix 5.5
release but may be incorporated into a power patch at a later date.
HP has added TPS (Third Party Shadowing) to IMAGE. This means that for every IMAGE
DBPUT, DBUPDATE, or DBDELETE, NetBase will be called from within the IMAGE transaction.
The advantage to NetBase is that
1) The write to the NBM file is a part of the IMAGE transaction,
2) Since IMAGE single threads the puts and deletes we no longer need to use SYNC@
files to synchronize the writes to the NBM file
3) Since IMAGE is passing the full preimage and postimage, as well as the record
number, NetBase no longer needs to make IMAGE calls in order to build the shadow
record. This eliminates the need for NetBase to do the additional DBOPEN Mode 5
on a database that is being shadowed.
The NetBase TPS procedures are in an XL named XLNETBSE.PUB.SYS. The file is created
during the NetBase installation job.
With TPS Shadowing the ;SYNC option on FILE statements on the Master and the ;DBX option
on SHADOW statements on the Shadow system are obsolete and not required.
Because the convention with a third party interface is that the third party interface returns errors in
a range of n000-n999, NetBase has changed the error number returned if a fatal error occurs. In
previous versions of NetBase, fatal errors were in the range 9001/9153. Now, NetBase fatal
errors are in the range, 1801/1954 where the number minus 1800 corresponds to the NetBase
fatal error number printed on the console.
DBUTIL has been changed to make it possible to enable or disable a database for TPS. If TPS is
enabled on a database, but the database is not in the NetBase directory, shadowing will not
occur. If a database is in the NetBase directory, but it is not enabled for TPS, shadowing will
occur as it did in previous versions of NetBase.
Enabling a database for TPS
The first time that a database is enabled for TPS, it must be enabled programmatically via a utility
called NBTPSUTL. The utility, NBTPSUTL, will TPS enable the database specified in the INFO
string, or TPS enable all the databases listed in a file that is specified in the INFO string. This
utility only enables a base for TPS. After a database has been enabled via the NBTPSUTL
program, DBUTIL must be used to disable a database for TPS. DBUTIL can also be used to re-
enable it.
The utility is run:
RUN NBTPSUTL;INFO="[^]name"
where name is the name of a database or, if preceded
by a carat (^), the name of a file containing
a list of databases
The program prints a message for every database that the program attempts to TPS enable. For
example: