OSI/MHS Configuration and Management Manual

Mailbox Save and Restore Utilities
OSI/MHS Configuration and Management Manual—424827-003
C-2
SAVEMBOX
basis of which the user will retrieve or filter messages from the message store.
You specify them when you define the APPL object for the user.)
SAVEMBOX
SAVEMBOX stores a specified mailbox in a specified mailbox save file. The syntax for
SAVEMBOX 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 saved. 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 SAVEMBOX has
completed its processing. This parameter is required.
mailbox-save-file
is the name of the mailbox save file that will be used to save the mailbox. This file
is created by SAVEMBOX and must not exist when SAVEMBOX 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. SAVEMBOX requires access to the database files contained
in this subvolume. This parameter is required.
max-extents
specifies the maximum number of extents to be defined for the mailbox-save-file
created by SAVEMBOX. max-extents is an integer in the range 16 through 978.
This value is controlled by the file system. The default max-extents value is 100,
with the primary and secondary extent sizes of 50 and 250 pages, respectively.
This default value corresponds to a maximum file size of approximately 50 MB.
The maximum value of 978 corresponds to a file size of approximately 500 MB.
This parameter is optional.
[RUN] SAVEMBOX [/run-options/]
APPL=appl-name &
SAVEFILE=mailbox-save-file &
INSTALL-SV=installation-sv &
[MAXEXTENTS=max-extents] &
[VERBOSE=OFF|ON]