OSI/MHS Configuration and Management Manual

Mailbox Save and Restore Utilities
OSI/MHS Configuration and Management Manual—424827-003
C-3
SAVEMBOX Operation
verbose
is used to switch on a verbose mode of operation, in which SAVEMBOX sends a
number of text messages (to the OUT file) that detail its operation. This parameter
has possible values of ON (verbose) and OFF (nonverbose). The default is OFF.
This parameter is optional.
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.
SAVEMBOX Operation
Following is a brief overview of the operation of the SAVEMBOX program. When it is
invoked, SAVEMBOX performs the following functions:
1. Validates its input parameters.
2. Creates an empty mailbox save file that has the specified name.
3. Checks that the specified MS APPL object is in the STOPPED state.
4. Determines the number of messages contained in that APPL’s mailbox.
5. Stores each of these messages in the mailbox save file as a P3’ byte stream.
Other information such as the sequence number, entry status, and creation time of
the message (and of its child entries) is also stored.
6. When all message have been saved, summary statistics are printed that include
the total number of messages and reports saved and the total number of bytes
saved.
7. If the verbose option is enabled, then SAVEMBOX prints messages describing the
processing that is taking place while SAVEMBOX is running. This description
includes the sequence numbers of the messages that SAVEMBOX is saving.
An MS can continue to operate normally while SAVEMBOX is saving the mailbox of an
APPL object supported by that MS. SAVEMBOX does not delete or otherwise alter the
messages it has saved. Deleting or altering is the responsibility of the MS APPL object
or the system administrator.
Each message saved in the save-file consists of one information record (INFO) and a
number of PDU data records depending on the size of the messages. The record size
of the save-file is 4062 bytes, occupying two pages. If the message requires only one
data record, then the total number of messages times two pages times two records
equals the total number of pages consumed. Use this formula to determine the max-
extent-size required.