NetBase for MPE Reference Guide

Chapter 5
5-30
Structural Changes for Shadowed Databases
NetBase maintains exact physical copies of files that are being shadowed. With TurboIMAGE
databases, whenever a structural change (such as a capacity change, dataset packing or the creating
of new datasets) is made to the master system, it must also be applied to the shadow database.
Handling structural changes can be done three ways: through the 1) the ADAGER interface 2) the
DBGENERAL interface, or by 3) manually coordinating updates. NetBase has an interface with both
ADAGER and DBGENERAL. If you are using a utility other than ADAGER or DBGENERAL, you will
need to manually coordinate the structural changes.
1) NetBase ADAGER Batch Interface
NetBase can now shadow ADAGER changes. It works by capturing the input to ADAGER on the
master system and sending the input to the shadow system. A special command file
ADAGER.PUB.NETBASE is executed on the master side which captures all of the ADAGER commands
and puts them into a special job stream. The NBADAGER.PUB.NETBASE program runs when this job
stream executes to execute the real ADAGER program. Once ADAGER has successfully completed the
changes, the NBADAGER program then writes all of the ADAGER commands into the shadow
transport file, NBM.IPC.NETBASE, and they are sent to the shadow system.
When the posting process NBPOST receives the ADAGER commands, it automatically puts the
database into a queue state. Next, NBPOST invokes ADAGER on the shadow system to make the
changes. Once the ADAGER changes successfully complete, NBPOST does a roll forward on the
database.
Requirements. You must be running a version of ADAGER equal to or greater than
941201 and NetBase 9.6.
On the master system:
1. Execute the command file ADAGER.PUB.NETBASE. This runs ADAGER.PUB.REGO. You will be
prompted for the name of a job stream, the database name and the changes to be made. When
this step is complete, a job stream will have been created.
2. Stream the job created in step 1. This executes the NBADAGER program which in turn executes
the ADAGER changes and sends them to the shadow system.