NBSpool for MPE Reference Guide

Chapter 3
3-10
ARCHIVE
The
ARCHIVE
command stores and compresses spool files to disk for later unarchiving. This
provides a disk-based alternative to the
STORE
and
RESTORE
to tape feature. Press
Ctrl+y
to
terminate the command. If the
PURGE
option was specified, none of the archived spool files will be
purged.
The archive file is created by this command, so if a file with the same name already exists, it will be
purged after confirmation from the user. Archive files are created with a file code of
888
to identify
them from other files. Files may be extracted from the archive using the
UNARCHIVE
command.
If the
LIMIT
parameter is specified, the archive file will be built with enough directory space to
contain the requested number of files. If the limit is specified, the size of the archive (in sectors)
must also be specified. If this parameter is omitted, the archive will only be built large enough to
hold the current spool file subset. This parameter is ignored if the archive already exists.
Note. An archive cannot contain more than
32,767
files.
The
APPEND
parameter will append the current spool file subset to an existing archive file. If the
archive does not exist, this parameter is ignored. A
LIMIT
must be specified when the archive is
created for an
APPEND
to be used later on that archive. If an archive is too small to hold new spool
files, it may be expanded by copying it to a larger file with the same file code and record size.
However, the size of the directory is fixed and cannot be changed.
The
NOCOMP
parameter disables the normally enabled compression algorithm. This can
considerably speed up the archival of large spool files, but more disk space will be consumed.
By default, normal NBSpool security provisions will prevent users from unarchiving spool files
from an archive file unless they would normally have access to the spool files. The
RELEASE
parameter will allow any user to unarchive any spool file in the archive, assuming the user has read
access to the archive file. This parameter is ignored if appending to an existing archive file.
The
NEWPRI
and
PURGE
parameters affect the condition of the spool files. If
NEWPRI
parameter is
used, each spool file will have its outpri changed to the specified value as each file is successfully
archived. The
PURGE
parameter causes the archived spool files to be purged after all files are
archived.