OSI/MHS Configuration and Management Manual

Mailbox Save and Restore Utilities
OSI/MHS Configuration and Management Manual—424827-003
C-5
RESTMBOX
RESTMBOX
RESTMBOX restores a specified mailbox from a specified mailbox save file. The
syntax for RESTMBOX is:
run-options
are the standard options allowed for the RUN command as defined in the TACL
Reference Manual. Note that the IN option is not applicable since this program
does not read any input. The OUT option is applicable and important; see the
description of the VERBOSE parameter, below.
appl-name
is the name of the MS APPL object whose mailbox is to be restored. This name is
in the form $mgr-pname.#ms-appl-name. The MS APPL object must be in a
STOPPED state and must remain in a STOPPED state until RESTMBOX has
completed its processing. This parameter is required.
mailbox-save-file
is the name of the mailbox save file that contains the saved mailbox. This file must
already exist when RESTMBOX is invoked. This parameter is required.
installation-sv
is the name of the installation subvolume of the OSI/MHS subsystem containing
the MS APPL object. RESTMBOX requires access to the database files contained
in this subvolume. This parameter is required.
mode
determines whether RESTMBOX restores the saved mailbox to a currently empty
mailbox or appends it to the end of an existing mailbox. Possible value are
RESTORE and APPEND. The default is RESTORE. This parameter is optional.
verbose
is used to switch on a verbose mode of operation in which RESTMBOX sends a
number of text messages (to the OUTfile) that detail its operation. This parameter
has possible values of ON (verbose) and OFF (nonverbose). The default is OFF.
This parameter is optional.
[RUN] RESTMBOX [/run-options/]
APPL=appl-name &
SAVEFILE=mailbox-save-file &
INSTALL-SV=installation-sv &
[MODE=RESTORE|APPEND] &
[VERBOSE=OFF|ON]