STORE Options (contd) [ STORE and TurboSTORE/iX Products Manual ] MPE/iX 5.5 Documentation
STORE and TurboSTORE/iX Products Manual
STORE Options (contd)
Storing Files in Compatible Formats (TRANSPORT)
The TRANSPORT option stores files on media that is compatible with:
* MPE V/E systems (TRANSPORT)
* Pre-POSIX systems (TRANSPORT=MPEXL)
Creating MPE V/E Compatible STORE Tapes.
Use the TRANSPORT parameter of STORE to create STORE backups that are
compatible with MPE V/E. For example, to store all of the files in the
PERSONEL account onto an MPE V/E compatible backup, enter:
:FILE T;DEV=TAPE
:STORE @.@.PERSONEL;*T;TRANSPORT
The backup that is produced with the TRANSPORT parameter uses the same
format as MPE V/E STORE backup format. Therefore, files that are not
compatible with MPE V/E (due to file/record size limitations or new file
types), are not stored if TRANSPORT is specified. The TRANSPORT option
cannot be used with the following STORE and TurboSTORE options:
STORESET
INTER
DIRECTORY
ONVS
FCRANGE
SPLITVS
ONLINE
MAXTAPEBUF
MOSET
NAME
COMPRESS
TREE
NOTREE
RENAME
NOTIFY
LOGVOLSET
PART[IAL]DB
FULLDB
STOREDIR[ECTORY]
NOSTOREDIR[ECTORY]
STATISTICS
Character set specifications, as listed in "Using Wildcard Characters" in
chapter 5, "Storing Files," cannot be used with the TRANSPORT parameter.
Creating Pre-POSIX Compatible Tapes.
With the addition of HFS syntax files and other new POSIX-related
features, mechanisms exist in STORE to allow backups to be created on a
POSIX system and restored on a pre-POSIX system (4.0 or earlier).
Pre-POSIX backups are created using the TRANSPORT=MPEXL option. For
example:
:STORE @.MYGR.SOMEACCT;*T;SHOW;TRANSPORT=MPEXL
There are two general scenarios when files would need to be transferred
to a pre-POSIX system:
* Planned Transport
The user stores off a set of files from one system, to be restored
on another system right away.
* Unplanned Transport
The data stored off from a system (usually a system backup) is
suddenly required to be restored on the same or a different
system. This kind of transport is usually done to recover lost
data and may require a POSIX system's backup to be restored on a
pre-POSIX system.
With these two cases in mind, STORE has the following objectives with
respect to data transport:
* The media created on a POSIX system should be restorable on a
pre-POSIX as well as a post-POSIX release.
* The planned transport operation should be as simple and easy as
possible.
* A default name conflict should not exist. This means that the
naming of non-MPE syntax files on a transport to a pre-POSIX
system should occur such that the user does not inadvertently
overwrite previously transported files.
* For each of the transport situations, the security should be at
least equal to or more restrictive than require on the target
system.
The following sections list the features in STORE which address these
objectives.
HFS Name Mapping.
Every POSIX STORE media is created such that any HFS syntax file can be
restored to a pre-POSIX system with a unique MPE syntax name. When
restoring a backup to a pre-POSIX system, the fileset of @.@.@HFSACCT
will contain all HFS syntax files on that media. These files are named
with the MPE syntax of:
F#######._HFSGRP._HFSACCT
Where ####### represents numbered files starting at 0000001.
A mapping file is also on the media. This file specifies the mapping
between the _HFSACCT name and the actual HFS name. The name of this file
is HFSMAP._HFSGRP._HFSACCT. Sample entries in the file would look similar
to this:
F0000001._HFSGRP._HFSACCT <- /SYS/PUB/dir1/file_a
F0000002._HFSGRP._HFSACCT <- /SYS/PUB/dir1/file_b
F0000003._HFSGRP._HFSACCT <- /SYS/PUB/dir1/file_c
Since _HFSGRP and _HFSACCT are illegal MPE filenames, special steps must
be taken when attempting to restore these files on a pre-POSIX system.
The LOCAL option can be used to restore the HFS files into your logon
group. For example, on a pre-POSIX system, issue:
:FILE T;DEV=TAPE
:RESTORE *T;@.@.@HFSACCT;SHOW;LOCAL
Alternately, you can specify a specific group and account to place the
HFS files, using the CREATE, GROUP, and ACCOUNT options:
:FILE T;DEV=TAPE
:RESTORE *T;@.@.@HFSACCT;SHOW;CREATE;GROUP=NEWGRP;ACCT=MYACCT
This will restore all of the HFS syntax files to the group NEWGRP.MYACCT.
The HFSMAP file will allow to you identify the real names of the F#######
files.
If you want to only restore MPE syntax files from the backup, that can be
accomplished by the following command:
:FILE T;DEV=TAPE
:RESTORE *T;@.@.@ - @.@.@HFSACCT;SHOW;CREATE
NOTE There are certain types of files that exist on a POSIX system that
have no equivalent on a pre-POSIX system, such as symbolic links
and device links. It is not recommended that you attempt to
restore these files on a pre-POSIX system. They will contain no
useful information for that system, and may be difficult to use or
purge.
Preserving File Security.
An argument of the TRANSPORT option allows POSIX style ACD's to be
translated to pre-POSIX systems, while maintaining the correct security.
Using TRANSPORT=MPEXL will cause STORE to write out the pre-POSIX format
ACD's. If a POSIX media is created without TRANSPORT=MPEXL, and then
restored to a pre-POSIX system, the ACD's will not be understood and the
system will enforce a "creator only" security. This provides a more
restrictive security. Also, all POSIX-related fields of the file labels
being stored are cleared on the backup media.
Specifying the Number of Files to Store (FILES)
The FILES parameter works with the TRANSPORT parameter. By default,
MPE/iX stores a maximum of 4000 files at a time. If you are storing more
than 4000 files using the TRANSPORT parameter, use the FILES= parameter
to specify the maximum number of files to be stored. If you do not use
the TRANSPORT parameter, the FILES= parameter is ignored. For example,
to set the maximum number of files stored to 6000 for a TRANSPORT backup,
you might enter the following:
:FILE T;DEV=TAPE
:STORE @.OPERATOR.SYS;*T;TRANSPORT;FILES=6000
Use the MPE/iX RESTORE command to restore files from MPE V/E format
backup tapes to an MPE/iX system. MPE/iX RESTORE automatically detects
that the tapes are in MPE V/E format, and invokes CM(RE)STORE
(Compatibility Mode Restore) to restore the files.
Managing File Security (COPYACD and NOACD)
An additional way to manage the security of files being stored is to use
the COPYACD and NOACD options. The default is COPYACD. This means that
in addition to the MPE security matrix, a file's ACD (if one exists) is
written to backup. This allows you to store the extra security
information associated with an ACD.
If for some reason you want to store files without their ACD, the NOACD
option can be specified. This would remove the extra security associated
with ACD's, which may be desired if you are moving files to a system
where the current ACD's would be inapplicable or undesired. When using
these options, keep in mind that RESTORE also has COPYACD and NOACD
options. So, even if you create a STORE media with ACD's, you have the
choice at RESTORE time to restore or not restore the ACD information.
Storing Files with Certain File Codes (FCRANGE)
Use the FCRANGE parameter to store files with certain file codes. MPE XL
file codes distinguish different types of files. You can select up to
eight file code ranges to store. For example, files with codes 1100,
1101, and 1102 are HPWORD files. Files with codes 1152 and 1153 are
SLATE files. To store all HPWORD and SLATE files in the LETTERS group of
the PERSONEL account enter:
:FILE T;DEV=TAPE
:STORE @.LETTERS.PERSONEL;*T;FCRANGE=1100/1102,1152/1153
Improving Storing Efficiency by Increasing Record Size (MAXTAPEBUF)
Files are stored with greater efficiency by using the maximum backup
record (buffer) size allocated to a given backup device. Performance
increases because data transmission is more efficient and because the
amount of media used for interrecord gaps decreases.
The maximum backup record size of MPE/iX supported backup devices differs
from device to device and is shown in Table 6-1 .
Table 6-1. Maximum Tape Record Sizes
-----------------------------------
| |
| Tape Drive Record Size |
| |
-----------------------------------
| |
| HP 7974 16 KB |
| |
| HP 7978A 16 KB |
| |
| HP 7978B 32 KB |
| |
| HP 7979 32 KB |
| |
| HP 7980(XC,S,SX) 32 KB |
| |
| DDS (all) 32 KB |
| |
| 3480 32KB |
| |
| MO 32KB |
| |
-----------------------------------
MAXTAPEBUF should be used when storing to magnetic tape, DDS, or 3480
cartridges. Currently, it is not necessary to specify MAXTAPEBUF when
storing to MO devices or disk files, since the maximum record size of 32K
is already being used.
Normally when a STORE command is issued, a default record size of 16
kilobytes is used. However, by using the MAXTAPEBUF parameter of the
STORE command, the maximum record size of the specified device is
automatically used. If multiple backup devices are specified, using the
STORESET parameter, in conjunction with MAXTAPEBUF, STORE uses the
maximum record size, which is the lowest common denominator of the
different devices. This is necessary to ensure that the record sizes are
the same on all volumes of the backup set.
NOTE Do not use the MAXTAPEBUF parameter with a backup device of 32 KB
record size if you anticipate that you will later restore the
backup created to a backup device whose maximum record size is 16
KB. Restoring a backup to a larger maximum record size device, on
the other hand, does not cause any problem.
To increase record size when storing files, use the MAXTAPEBUF parameter
in your STORE command. For example:
FILE T;DEV=TAPE
STORE @.OPERATOR.SYS;*T;MAXTAPEBUF
Notification of File Availability (NOTIFY)
During the STORE process, the fileset that you are storing is usually
unavailable for modification. Files can be modified again after STORE is
completed. If you are doing an online backup using:
* TurboSTORE/iX 7x24 True-Online Backup online backup (using the
ONLINE option only), the files being stored are unavailable for a
short time at the beginning of the store. However, once they have
been attached to STORE's logging mechanism, they are available for
modification.
* TurboSTORE/iX 7x24 True-Online Backup with true-online backup,
(using the ONLINE option with START or END), the files being
stored remain available and can be modified while the backup is
occurring. Refer to Chapter 7, "TurboSTORE/iX 7x24 True-Online
Backup," for more information.
The NOTIFY option can be used to help automate the process of performing
some action at the time where the files being stored are available for
modification, either at the end of the STORE, at the end of the attach
phase, or at the end of the sync point.
NOTIFY allows STORE to stream a user-specified job file (using the MPE/iX
STREAM command) either at the end of the attach phase (while using
ONLINE), at the end of a successful STORE operation (normal backup), or
at the end of the sync point (ONLINE=START or ONLINE=END). The job file
is specified by the user by setting up a formal file designator named
NOTIFY, prior to running the store job. This job can contain various
actions that notify users that the files are free, start other jobs that
modify the files, or allow users back on to the system, for example.
If the specified job does not contain passwords, STORE will prompt the
user for the passwords if STORE is being run from a session. If STORE is
being run from a job and passwords are not present, the job stream will
fail.
When the job fails to stream, due to lack of passwords, or other reasons,
all error messages will be sent to the standard list ($STDLIST). All
other output as the result of streaming the job will also be sent to
$STDLIST.
The following is an example of using the NOTIFY command in conjunction
with a user specified job file.
First, set up the file equation, using the FILE command:
:FILE NOTIFY=MYJOB.PUB.SYS
Where the job stream could contain, for example:
!JOB NOTIFY,MANAGER.SYS
!TELL @ Your files are now available!
!EOJ
Then, run STORE with the NOTIFY option:
:FILE T;DEV=TAPE
:STORE @.PUB.SYS;*T;SHOW;ONLINE;NOTIFY
Since this is an online store, the job stream will be executed once the
files have been attached, and a message would then be sent to all users
telling them that their files are now free to be accessed.
Additional Backup Information (STATISTICS)
In addition to the counts of files stored and not stored that are
normally reported at the end of a backup, the STATISTICS option provides
extra data about the backup. This extra information includes:
* Amount of data written to each piece of media for each parallel
set
* Amount of time required to write each piece of media
* Throughput for each piece of media
* Number of retries incurred for each piece of media
If software compression is enabled with the COMPRESS option, additional
data on the amount of compressed data written, and compression ratios and
percentages is displayed.
If an online or 7x24 true-online backup is performed, then information on
the amount of log data written is displayed.
All data totals are shown in bytes. To convert these totals to sectors,
divide by 256.
When displaying the amount of backup data written, up to five columns of
data can be displayed, depending on what options were specified for the
backup. These columns display the following backup data information:
File Data This is the amount of the backup that comes from
the actual data in files. Most of the data in your
backup will be accounted for in this column. If
you are using software compression (COMPRESS=LOW or
COMPRESS=HIGH), then this is the total number of
uncompressed bytes of file data written. The
actual, compressed amount of data written is
displayed in the "Compressed" column.
Misc Data This is data that STORE needs to write to the
backup to manage what files are on the backup, such
as the STORE backup label and a media directory.
The amount of miscellaneous data on a backup is
proportional to the number, but not size, of files
being stored.
Compressed This column is only displayed if software
compression was used to create the backup (with
COMPRESS=LOW or COMPRESS=HIGH). It displays the
total number of compressed bytes of file data
written to the backup. The ratio between this
column and the file data column is used to display
the Compression ratios and percentages later in the
statistics listing.
Log Data If an online backup (ONLINE) or 7x24 true-online
backup (ONLINE=START or ONLINE=END) backup is
performed, this column displays how much log data
was written to the backup. This includes both
before image and after image log data. (For a
definition of before and after image log data,
refer to Chapter 7).
This total depends on how much activity occurred on
the files being backed up during the backup. This
is a good total to check if your online backup is
taking longer or consuming more media than you
think it should. Such a slowdown could be
attributed to too much activity on files being
stored, which slows down both the users and the
online backup.
Total on Reel This column is a sum of all the other columns
displayed for this particular piece of media. It
represents the entire amount of data stored for
that media. Note that if software compression was
used, then the Compressed column, and NOT the File
Data column, is used to compute the media total.
If no software compression is used, then the File
Data column is used.
These data columns are displayed for each piece of media written to
during the backup. If a parallel backup is performed (using the STORESET
or MOSET options), then the media will be grouped by parallel set. After
all parallel sets are displayed, totals for each parallel set, and then
for the entire backup are displayed. Look for the "Backup Total" line to
determine the total amount of all data written for the backup.
The Throughput section follows the data written columns. The throughput
for a particular piece of media is computed by dividing the total amount
of data written for a piece of media by the time it took to completely
write that data. The time required to switch media is NOT accounted for
in this computation. Only time spent actually writing the media is used.
Also, note that if software compression is being used, then the amount of
compressed data written is used to compute the throughput. Your virtual
throughput may actually be higher, if software compression is used.
The number of hardware retries encountered when writing the data is also
displayed here. This only applied to magnetic tape, DDS, and 3480 media.
It has no meaning when writing to disk files or magneto-optical devices,
and will always be zero. Monitoring the number of retries for a piece of
media is important in determining if that media is starting to go bad.
An increased number of retries could indicate that the media should no
longer be used, or that your devices should be cleaned and/or serviced.
After the Throughput section, the total elapsed time for the backup is
displayed. This time does include media switches.
If software compression is used for the backup (with COMPRESS=LOW or
COMPRESS=HIGH), then a section on compression ratios will follow the
Throughput section. For each media, or each media in each parallel set,
the amount of uncompressed file data written is displayed with the amount
of data actually written when that file data is compressed. The ratio
between these two numbers and a compression percentage is also displayed.
The higher the ratio is, the better the data compressed. Similarly, the
higher the percentage, the better the data compressed. A negative
percentage is possible, and indicates that the data you were storing did
not compress at all. If you see this in your statistics display, or see
very low compression ratios, it indicates that you are storing data that
does not compress well, and that it might be better not to use software
compression, or try a different software compression (LOW instead of
HIGH, for example).
NOTE These compression ratios are highly dependent on the type of data
being stored, and may vary from the Hewlett-Packard supplied
compression ratios. In general, data files will compress better
than application and system files. You should carefully pick the
type of data compression used to match the type of data being
stored.
Following are examples of output from the STATISTICS options.
Example 1.
The following example is of a normal backup to a single device without
software compression or online backup.
___________________________________________________________________________________
| |
| |
| BACKUP STATISTICS |
| |
| DATA WRITTEN |
| |
| FILE DATA MISC DATA TOTAL ON REEL |
| MEDIA 1 | 189826798 | 1389164 | 191215962 |
| ---------+-------------+-------------+------------- |
| BACKUP |
| TOTAL 189826798 1389164 191215962 |
| |
| THROUGHPUT |
| MEDIA START TIME MEDIA END TIME THROUGHPUT (K/S) RETRIES |
| MEDIA 1 11:45 AM 12:02 PM 177 K/S 0 |
| |
| TOTAL ELAPSED TIME: 0 hours, 17 minutes, 31 seconds |
| |
___________________________________________________________________________________
Example 2.
The following example is of a backup to two pieces of media.
___________________________________________________________________________________
| |
| |
| BACKUP STATISTICS |
| |
| DATA WRITTEN |
| |
| FILE DATA MISC DATA TOTAL ON REEL |
| MEDIA 1 | 13538720 | 166480 | 13705200 |
| MEDIA 2 | 176288078 | 747888 | 177035966 |
| ---------+-------------+-------------+------------- |
| BACKUP |
| TOTAL 189826798 914368 190741166 |
| |
| THROUGHPUT |
| MEDIA START TIME MEDIA END TIME THROUGHPUT (K/S) RETRIES |
| MEDIA 1 11:41 AM 11:41 AM 669 K/S 0 |
| MEDIA 2 11:41 AM 11:45 AM 835 K/S 0 |
| |
| TOTAL ELAPSED TIME: 0 hours, 3 minutes, 49 seconds |
| |
___________________________________________________________________________________
Example 3.
The following example is of a backup to parallel devices with software
compression and online backup.
_________________________________________________________________________________________
| |
| |
| BACKUP STATISTICS |
| |
| DATA WRITTEN |
| |
| SET 1 |
| FILE DATA MISC DATA COMPRESSED LOG DATA TOTAL ON REEL |
| MEDIA 1 | 63344322 | 418976 | 36349232 | 0 | 36768208 |
| ---------+-------------+-------------+-------------+-------------+------------ |
| SET 1 |
| TOTAL 63344322 418976 36349232 0 36768208 |
| |
| SET 2 |
| FILE DATA MISC DATA COMPRESSED LOG DATA TOTAL ON REEL |
| MEDIA 1 | 66652980 | 307716 | 22195808 | 6144 | 22509668 |
| ---------+-------------+-------------+-------------+-------------+------------ |
| SET 2 |
| TOTAL 66652980 307716 22195808 6144 22509668 |
| |
| SET 3 |
| FILE DATA MISC DATA COMPRESSED LOG DATA TOTAL ON REEL |
| MEDIA 1 | 59869176 | 164384 | 8199956 | 0 | 8364340 |
| ---------+-------------+-------------+-------------+-------------+------------ |
| SET 3 |
| TOTAL 59869176 164384 8199956 0 8364340 |
| |
| SET TOTALS |
| |
| SET 1 | 63344322 | 418976 | 36349232 | 0 | 36768208 |
| SET 2 | 66652980 | 307716 | 22195808 | 6144 | 22509668 |
| SET 3 | 59869176 | 164384 | 8199956 | 0 | 8364340 |
| ---------+-------------+-------------+-------------+-------------+------------ |
| BACKUP |
| TOTAL 189866478 891076 66744996 6144 67642216 |
| |
| THROUGHPUT |
| MEDIA START TIME MEDIA END TIME THROUGHPUT (K/S) RETRIES |
| SET 1 |
| MEDIA 1 12:15 PM 12:19 PM 147 K/S 0 |
| |
| SET 2 |
| MEDIA 1 12:15 PM 12:18 PM 100 K/S 0 |
| |
| SET 3 |
| MEDIA 1 12:15 PM 12:17 PM 50 K/S 0 |
| |
| TOTAL ELAPSED TIME: 0 hours, 4 minutes, 3 seconds |
| |
| COMPRESSION |
| |
| FILE DATA COMPRESSED RATIO PERCENTAGE |
| SET 1 |
| MEDIA 1 63344322 36349232 1.7:1 43% |
| |
| SET 2 |
| MEDIA 1 66652980 22195808 3.0:1 67% |
| |
| SET 3 |
| MEDIA 1 59869176 8199956 7.3:1 86% |
| |
| BACKUP |
| TOTAL 189866478 66744996 2.8:1 65% |
| |
_________________________________________________________________________________________
Storing Files from Volume Sets (ONVS)
To store the files on a particular volume set, use the ONVS parameter of
the STORE command. ONVS lets you store files from up to 20 volume sets
at once. For example, to store all files from the nonsystem volume sets
named VOL_SET_A and VOL_SET_B, enter:
:FILE T;DEV=TAPE
:STORE @.@.@;*T;ONVS=VOL_SET_A,VOL_SET_B
To store files from system and nonsystem volumes, include the system
volume set name within the ONVS parameter. For example:
:FILE T;DEV=TAPE
:STORE @.@.@;*T;ONVS=MPEXL_SYSTEM_VOLUME_SET,&
VOL_SET_A,VOL_SET_B
NOTE Although the ONVS and SPLITVS options can be used together, a
volume set that is specified for ONVS cannot be specified for
SPLITVS and a volume set that is specified for SPLITVS cannot be
specified for ONVS.
Storing Files from Split Volumes (SPLITVS)
Use the SPLITVS option to store files that are located on the specified
split volume sets. These volumes are also known as mirrored disks.
This provides a form of concurrent, or online backup, because you can:
* Split a volume set.
* Allow users to access their files
* Perform a backup on the mirrored volume
The SPLITVS option requires:
* The Mirrored Disk/iX product be installed on the system.
* The specified volume sets must be configured as mirrored volumes.
The basic procedure to use split volumes and STORE together is:
1. Request users to close the files on the volume sets that are to be
backed up for a short duration.
2. VSCLOSE the mirrored volume set with the SPLIT option.
3. VSOPEN the volume set. This will open the user and backup sets.
4. Allow users to begin accessing the files again.
5. Issue the store command, using the SPLITVS option. For example:
:STORE @.@.@;*T;SHOW;SPLITVS=my_split_set
6. After the backup has completed, join the split set back together
using the JOINMIRRSET command in VOLUTIL.
For more information on using mirrored disks, see the Mirrored Disk/iX
User's Guide (30349-90003).
NOTE Although the ONVS and SPLITVS options can be used together, a
volume set that is specified for ONVS cannot be specified for
SPLITVS and a volume set that is specified for SPLITVS cannot be
specified for ONVS.
MPE/iX 5.5 Documentation