NetBase for MPE Reference Guide

Using NBCTRL
2-19
ROLL FORWARD
This command causes the posting process to roll forward transactions from the posting queue files
into their shadow files. This command requires SYSTEM MANAGER(SM) capability.
If the posting process encounters an error while opening a shadowed file, the transactions are
preserved in a post queue file. POST reports the exceptional condition encountered during the file
open to the system console, as well as the NetBase job $STDLIST. Once the source of the problem
has been determined and rectified, the ROLL FORWARD command is used to cause the posting
process to update the specified file with the updates that have been queuing.
If a file is found to be in the QUEUE state, and the original error which caused this has been lost, it
is generally safe to attempt a ROLL FORWARD command. If the original cause was a transient
condition, i.e. a file being backed up when POST tried to open it, which has since cleared, this will
most likely succeed. However, if the post encounters the same error again, for example, a bad
database password in the SHADOW directory entry, the file will go back into the QUEUE state.
Syntax
∗> ROLL FORWARD filename
Parameters
Parameter Description
filename
The name of a file that is being shadowed that has post queues associated with
it. These files show on the SHOW POST node display with the queuing flag set
to Q.
Examples
∗> SHOW POST 1
S Q D
Time Stamp of Last Y U I
File Type Updates Record Processed N E S
FT.XDATA.QUEST ??? 0 09/12/91 11:47:32 - Q -
∗> ROLL FORWARD FT.XDATA.QUEST
ROLL FORWARD PROCESS 1 STARTED