NetBase for MPE Reference Guide

NetBase Shadowing
5-33
Flushing Shadow Updates
It can be useful to know when all updates have been posted to the shadow copies after the update
processes have completed. NetBase provides a process called NBFLUSH that can be used to
accomplish this task. The NBFLUSH utility is used to flush updates to the shadow copy of a file so it
can be released by the posting process.
NBFLUSH is run on the machine where the master copy of the file resides. The program writes a
special record to the shadow log file. When that record is read by the posting process on the shadow
machine, the posting process closes the shadow copy of the file and/or stops completely, based on
the entry point specified when run.
NBFLUSH Syntax
:RUN NBFLUSH.PUB.NETBASE[,entry point][;INFO="filename"];PARM=node
where
entry point = CHECKPOINT
CHECKWAIT
STOP
STOPWAIT
QUIET
QUIETWAIT
WAIT
If NBFLUSH is run without an entry point, writes a stop record for the file specified on the node
specified and then completes. When the posting process receives the stop record, it closes the file
specified. The alternate entry points and the values for INFO and PARM operate as described in the
following table.
Entry Point Description
CHECKPOINT
The CHECKPOINT entry point is used to flush all logged updates to a file
that is shadowed using IMAGE log files.
CHECKWAIT
The CHECKWAIT entry point is also used to flush updates to a file that is
shadowed using IMAGE log files. However, NBFLUSH will wait for an
acknowledgment from the posting process on the remote node before
terminating.
Continued