OSI/MHS Configuration and Management Manual

Mailbox Save and Restore Utilities
OSI/MHS Configuration and Management Manual—424827-003
C-6
RESTMBOX Operation
It is best to specify a disk file or spooler location as the OUT file, in case you need
to provide it in connection with a problem report.
Note that a single equals (=) sign must exist between parameter keywords and
parameter values and that no spaces are allowed on either side of the equal sign. The
only delimiter allowed between parameters is a space. It is possible to specify
parameters on separate lines, provided that each line (except the last) is terminated by
an ampersand (&) character. In this case, a space character is still required to delimit
parameters.
RESTMBOX Operation
Following is a brief overview of the operation of the RESTMBOX program. When it is
invoked, RESTMBOX performs the following functions:
1. Validates its input parameters.
2. 2Checks that the specified mailbox save file exists.
3. Checks that the specified MS APPL object is in the STOPPED state.
4. If the MODE is RESTORE, then RESTMBOX checks to see that the MS APPL
object’s mailbox is empty.
5. Stores all of the messages contained in the mailbox save file in the MS APPL
object’s mailbox. If the MODE is RESTORE, then the sequence number and entry
status of messages will be recreated to match those in the mailbox originally saved
using SAVEMBOX.
6. As each message is stored, RESTMBOX checks to make sure the MS APPL
object is still in the STOPPED state and locks the corresponding record in the
OSI/MHS user database while that message is stored.
7. When all messages have been restored, RESTMBOX prints summary statistics
that include the total number of messages and reports restored and the total
number of bytes restored.
8. If the verbose option is enabled, then RESTMBOX prints messages describing the
processing that is taking place while RESTMBOX is running. This description
includes the sequence numbers of the messages that RESTMBOX is restoring.
An MS can continue to operate normally while RESTMBOX is restoring the mailbox of
an APPL object supported by that MS. If the APPEND mode of RESTMBOX is used,
the resulting mailbox might contain duplicate user or report MPDUs, that is, MPDUs
with the same message or report identifier.
In APPEND mode, RESTMBOX modifies the save-file so that messages successfully
restored will not be restored again. This means that after a save-file has been restored
in APPEND mode, an attempt to restore the same save-file again will result in no
messages being restored.