VSTORE



VSTORE


Verifies that the data on a backup media are valid (for example,
there are no media errors), and reports errors incurred by STORE
when writing the tape. (CM)

SYNTAX


VSTORE [vstorefile][;filesetlist][;option[;...]]

where option is

[;SHOW[=showparmlist]]

[;ONERR[OR]={QUIT}]
{SKIP}

[;DIRECTORY]
[;PROGRESS[=minutes]]

[;COPYACD] [;NOACD]
[;TREE] [;NOTREE]
[;NODECOMPRESS]

[;STOREDIR[ECTORY]=directoryname]
[;PART[IAL]DB]

[;RESTORESET=(device[,...])]

** TurboSTORE/iX II and TurboSTORE/iX 7x24 True-Online Backup
products only:

[;RESTORESET=(device[,...])[,(device[,...])[,...]]]

[;MOSET=(ldev[,...])[,(ldev[,...])[,...]]]
[;NAME=backupname]

PARAMETERS


vstorefile The name of the device that contains the files you
want verified on the system. This file must be
backreferenced, using an asterisk (*). A FILE
equation for vstorefile should be set up before
invoking VSTORE. If you want to verify files from
a file called SOURCE enter this file equation
before running VSTORE:

FILE SOURCE;DEV=TAPE

The vstorefile can now reference a remote device.
For example,

FILE REMOTE;DEV=REMSYS#TAPE
VSTORE *REMOTE;@;SHOW

NM Vstore will verify all files from the specified
remote device. Although the initial tape mount
request will appear on the remote console, all of
Vstore's console messages will be displayed on the
local console. Currently, labeled tapes and
Magneto-optical devices cannot be used for remote backup.

A message is displayed on the system console
requesting the operator to mount the tape
identified by the vstorefile parameter and to
allocate the device.

If vstorefile is not supplied and the RESTORESET
option is not used, then VSTORE creates a default
file name. The default file name is the user's
logon username. No file equation is used.

Sequential and parallel devices are specified with
the RESTORESET option. Similarly, magneto-optical
devices are specified using the MOSET option.
Vstorefile should not be specified when using
RESTORESET or MOSET.

A disk file can also be specified with a file
equation for vstorefile. An example of such a file
equation would be:

FILE MYDISC=DISCBACK.DAILY.BACKUP;DEV=DISC

Note that DEV=DISC must be specified for VSTORE to
verify files from disk backups. All other
information in the file equation will be ignored
by VSTORE.

NOTE TurboSTORE/iX 7x24 True-Online Backup must be used
to create disk backups.

filesetlist Specifies the set of files to be verified. The
 default depends on the user's capability, as shown below:

Default Capability

@ None
@.@ Account manager (AM)
@.@.@ System manager (SM)
and/or system supervisor (OP)

This parameter has the form

filesetitem[,filesetitem[...]]

where filesetitem may consist of

^indirectfile

or

fileset

indirectfile A file name that backreferences a disk file.
The syntax is:

^indirectfile or !indirectfile

This file may consist of fileset(s) and option(s),
but only options can appear after the first
semicolon (;) on each line. An option specified
on one line will operate on all files in the
filesetlist.

NOTE ^indirectfile is the preferred format. If you use
!indirectfile, the CI will interpret this as a
variable reference, so you will have to specify
!!indirectfile instead.

fileset Specifies a set of files to be verified, and
optionally those files to be excluded from the
VSTORE operation. The fileset parameter has the form

filestovstore[-filestoexclude[-...]]

Any file that matches filestovstore will be
verified unless the file also matches a
filestoexclude, which specifies files that are to
be excluded from the VSTORE operation. An
unlimited number of filestoexclude may be
specified.

NOTE Since "-" is a valid character for HFS syntax file
names, a blank character must separate it from HFS
file sets to obtain the special negative file set meaning.

filestovstore
filestoexclude Both filestovstore and filestoexclude may be
entered in MPE or HFS syntax. Wildcards are
permitted for both MPE as well as HFS syntax.

The MPE syntax is as follows:

filename[.groupname[.accountname]]

A lockword may be specified for files to be
stored, in the form:

filename/lockword.group.account

The HFS syntax is as follows:

/dir_lev_1/dir_lev_2/.../dir_lev_i/.../filedesig

or

./dir_lev_i/dir_lev_j/.../dir_lev_k/.../filedesig

If the name begins with a dot (.), then it is
fully qualified by replacing the dot with the
current working directory (CWD).

Each of the components dir_lev_i and filedesig can
have a maximum of 255 characters with the full
path name being restricted to 1023 characters.
Each of the components dir_lev_i and filedesig can
use the following characters:

Letters a to z
Letters A to Z
Digits 0 to 9
Special characters - _ .

For HFS syntax, the lowercase letters are distinct
from the uppercase letters (no upshifting). Names
in MPE syntax are upshifted.

Both MPE and HFS name components can use the
characters @, #, and ? as wildcard characters.
These wildcard characters have the following meaning:

@ specifies zero or more alphanumeric characters.
# specifies one numeric character.
? specifies one alphanumeric character.

The characters can be used as follows:

n@ -- All files starting with the character n.

@n -- All files ending with the character n.

n##...# -- All files starting with character n
followed by up to seven digits (useful
for storing all EDIT/3000 temporary
files).

n@x -- All files starting with the character n and
ending with the character x.

?n@ -- All files whose second character is n.

n? -- All two-character files starting with
the character n.

?n -- All two-character files ending with the
character n.

Also, character sets may be specified in the
following syntax:

[ct] specifies letter c or t.
[c-t] specifies any letter from range c to t.
[e-g1] specifies any letter range e to g
or digit 1.

Examples of using character sets are:

[A-C]@ All files that begin with the
letters A, B, or C.

myset[e-g1] All files that begin with the name
myset and end in e, f, or g, or 1.

myset[d-e1-6] All files that begin with the name
myset and end in d or e, or 1, 2, 3,
4, 5, or 6.

Up to a maximum of sixteen characters may be
specified for each character set and brackets may
not be nested.

A character set specifies a range for only one (1)
ascii character. The range [a-d]@ gets all files
that begin with the letter "a" through the letter
"d". The range [ad-de] may cause unpredictable
results.

Since the hyphen (-) is a valid character for HFS
syntax file names, it is allowed inside a
character set, immediately following a left
bracket ([) or preceding a right bracket (]).
When specified between two characters, the hyphen
implies a range of characters.

Specifying Database Files

When specifying TurboIMAGE and ALLBASE/SQL
databases to be verified, only the root file or
DBCon file needs to be specified. VSTORE will
determine which other files belong to that
database, and will verify all of them. If
dataset file(s) are specified without specifying a
root file, then a warning will be printed for
each file, and they will not be verified.
Individual database files can be verified
without the root file by specifying the
;PARTIALDB option on the VSTORE command line.

MPE and HFS Naming Equivalences

When the MPE filename component is a single "@"
wildcard, the "@" will be "folded" to include all
MPE and HFS named files at that level and below.
To specify only MPE-named files, use "?@" instead.

MPE wildcards are not expanded in filestoexclude.
This means that @.@.@-@.@.@ is NOT an empty
fileset. It contains all of the HFS named files
on the system.

A fileset may be entered in any of the following
formats and may use wild card characters.
Equivalent MPE and HFS formats are grouped
together.

file.group.acct
One particular file in one particular
group in one particular account.

file.group
One particular file in one particular
group in the logon account.

file
./file One particular file in the CWD.

@.group.acct
/ACCT/GROUP/
All files (MPE and HFS) in one
particular group in one particular
account.

?@.group.acct
All MPE name files in one particular
group in one particular account.

@.group
/LOGONACCT/GROUP/
All the files (MPE and HFS) in one
particular group in the logon account.

?@.group All MPE named files in one particular
group in the logon account.

@.@.acct
/ACCT/ All the files (MPE and HFS) in all the
groups in one particular account, plus
all the files and directories under the
specified account.

?@.@.acct All MPE named files in all the groups in
one particular account.

thisisit.@.acct
Any MPE file named thisisit in all the
groups in one particular account.

@ All (MPE and HFS) files in the CWD.
This is the default for everyone,
regardless of permissions.

@.@ All (MPE and HFS) files in the logon
account.

?@.@.@ All MPE named files in the system.

@.@.@
/ All the files and directories (MPE and
HFS) in the system.

SHOW Request to list names of verified files. If you
do not specify SHOW, the listing will contain only
the total number of files verified, a list of files
not verified (including the reason each was not
verified), and the count of files not requested to
be verified with VSTORE. The listing is sent to
$STDLIST (formal designator SYSLIST) unless a FILE
command is entered to send the listing to some
other device. For example, if you enter the command
"FILE SYSLIST;DEV=LP" before the VSTORE command,
the output will go to a line printer.

showparmlist Tells VSTORE what information to display for the
files that are verified. If you specify ;SHOW and
you omit showparmlist, then the default is SHORT
if the recordsize of SYSLIST is less than 132
characters, or LONG if the recordsize is equal to
or greater than 132. The format for showparmlist is:

showparm [,showparm[,showparm[,...]]]

where showparm may be one of the options described
below. If you do not specify SHORT or LONG, then
the base information is SHORT if SYSLIST is less
than 132 characters, or LONG if SYSLIST is 132
characters or more.

If a HFS-named file is specified in the
filesetlist, or the expansion of a wildcard
includes a HFS-named file, then a HFS-style output
listing will be used. This listing shows the same
information as the MPE format, but puts the name
of the file at the right end of the listing, to
allow for longer HFS names. If a HFS name is too
long to fit in the record size of the output file,
it will be wrapped onto the next line. Wrapping
is signified by a "*" as the last character on the line.

showparm SHORT Overrides a default of LONG and displays
file, group, and account name or the
fully qualified path name, volume
restrictions, file size (in sectors),
file code, and media number.

LONG Overrides a default of SHORT and
displays all the information that SHORT
does and adds the ending reel number,
record size, blocking factor, number of
extents, EOF, and file starting and
ending media number. For spoolfiles,
the old spoolfile name is also displayed.

NAMESONLY Displays only the filename and the
starting and ending media number.
NAMESONLY is not allowed with SHORT or LONG.

DATES Displays the creation date, the last
date of access, and the last date of
modification.

SECURITY For MPE format listing, causes SHOW to
display the creator and the file access
matrix for all the files which do not
have an active ACD. For files with
active ACDs only, the phrase
*ACD EXISTS* is displayed.

For HFS format listing, the phrase
*ACD EXISTS* or *ACD ABSENT* is
displayed, depending on whether the file
has an ACD.

PATH Forces all file listings to be in HFS
format. Full HFS pathnames are
displayed instead of MPE style names.

OFFLINE Sends another copy of the SHOW output to
the formal file designator OFFLINE,
which defaults to device LP.

ONERROR Tells VSTORE what to do if there is a tape read
error. If you omit this parameter, then the
default option is QUIT for labeled tapes and SKIP
for unlabeled tapes. ONERR is a synonym for ONERROR.

QUIT Tells VSTORE to abort after a tape read error.

SKIP Tells VSTORE to perform a file-skip-
forward past a tape error, resynchronize,
and resume reading from the tape.

DIRECTORY Specifies that the file system directory is to be
verified. Requires OP or SM capability. HFS
directories on the media are always verified.

PROGRESS Instructs VSTORE to report its progress at regular
intervals by displaying the message VSTORE
OPERATION IS nnn% COMPLETE. For interactive
users, this message is displayed on $STDLIST. For
jobs, this message is sent to the system console.

minutes A positive number specifying the number of minutes
between progress messages. The maximum is 60.
The default is 1 (one) minute.

COPYACD Directs VSTORE to copy the ACD associated with the
files or directories on the media. This option is
on by default.

NOACD Directs VSTORE to not copy the ACD associated with
the files or directories on the media. This
option overrides the default COPYACD option.

TREE Forces each fileset to be scanned recursively.
This is equivalent to using the trailing slash (/)
in an HFS name. The TREE option yields a
recursive scan in the hierarchical directory.
This option is mutually exclusive with NOTREE.

NOTREE Forces each HFS syntax fileset to not be scanned
recursively. The NOTREE option yields a
horizontal cut in the hierarchical directory. The
NOTREE option is mutually exclusive with TREE.

NODECOMPRESS Normally, VSTORE will decompress the data on a
Store-compressed media when verifying the files.
However, when NODECOMPRESS is specified, the files
will not be decompressed. Instead, just the
integrity of the raw data read from the media will
be checked. This results in a faster VSTORE of
the media, which just verifies physical consistency.

STOREDIR[ECTORY] Specifies that VSTORE should use the supplied
directoryname when looking for the disk store
directory file. This option should be specified if
the disk directory file for this backup resides in a
directory other than the default path of
/SYS/HPSTORE/store_dirs/. This file should be
either a directory file created by STORE, or
a symbolic link pointing to one.

directoryname The name of the disk directory file to be used
by VSTORE. It can be in either MPE or HFS
format. If it is not a fully qualified
filename, it will be qualified by the CWD. This
file should either be a disk directory file
created by STORE or a symbolic link pointing to one.

PART[IAL]DB Specify to allow VSTORE to verify individual
database dataset files without specifying the
database's root or DBCon file.

THE FOLLOWING OPTIONS ARE AVAILABLE ONLY IF TURBOSTORE/iX II OR
TURBOSTORE/iX 7x24 TRUE-ONLINE BACKUP IS INSTALLED ON YOUR SYSTEM.
TURBOSTORE/iX PRODUCTS ARE NOT PART OF THE FUNDAMENTAL OPERATING
SYSTEM, BUT MAY BE PURCHASED SEPARATELY.

For additional information on TURBOSTORE/iX products, refer to the
STORE and TurboSTORE/iX Manual (30319-90001).

RESTORESET Specifies parallel and sequential backup devices.

Consecutive tapes are specified in the following way:

;RESTORESET = (*tape1,*tape2,*tape3,...)

This instructs MPE/iX to use only one drive at a
time for the VSTORE operation. When the first
reel of tape is exhausted, VSTORE will shift to
the next available drive, leaving the first free
for rewinding and changing reels. Thus, at any
given time, only one drive is occupied with the
VSTORE operation. The effect is to accelerate the
VSTORE process.

FOS VSTORE can verify files using serial devices.
However, it cannot verify files using parallel
devices.

Parallel devices are specified by

;RESTORESET=(*tape1),(*tape2),(*tape3)...

In this example, all three tapes will be used in
parallel during the VSTORE.

A set of sequential tapes to be verified from in
parallel would be specified by

;RESTORESET=(*tape1,*tape2),(*tape3,*tape4)

In this example, two tapes would be verifying at
any particular moment, while the other two are
rewinding, permitting the operator to switch reels.

This option cannot be use if the vstorefile
parameter is specified.

device Specifies the device from which the file is to be
verified. It must be a magnetic tape or DDS.
This device should be specified in a file equation
before you invoke the VSTORE command, ie:

FILE DEVICE;DEV=TAPE

This file equation can also specify a remote
device or a disk file.

MOSET Specifies parallel Magneto Optical (MO) backup devices.

Parallel devices are specified by:

;MOSET = (12),(13),(15)

or

;MOSET = (MO),(MO),(MO)

All MO devices are used in parallel during the
VSTORE. The preferred format is specifying just
"MO", since STORE will use the the NAME
parameter to locate the correct media.

This option is not available if the vstorefile
option is specified.

NAME This parameter must be specified with the MOSET
option, and cannot be specified without it. If
specifies the logical name to be used for the
backup. For example:

VSTORE @.@.@;;MOSET=(12);NAME=DAILY.D23OCT90.BOZO

This name could indicate that the VSTORE should be
taken from the daily backup done on 23 Oct 1990 on
the system called BOZO.

backupname A three field name of a total maximum length of 26
characters. The format is fname.gname.aname. The
name represents the "handle" to this particular
backup and can is used to retrieve files from this
backup. The fname, gname and aname can be up to 8
alphanumeric characters. For example:

DAILY.D24OCT90.SYSTEM

OPERATION


This command verifies that there are no media errors on backup
media. It reports any errors that may have occurred during the
STORE procedure.

This command may be issued from session, job, or program, but not
in BREAK. If you press [Break] during a VSTORE operation,
verification continues while you interact with the CI.

Your capabilities determine which files you may verify. If you
have system manager or system supervisor capability, you can
verify any file from a STORE tape If you have account manager
capability, you can verify any file in your account. To verify
files with negative file codes, you need Privileged Mode (PM),
system supervisor (OP), or system Manager (SM) capability. If
you have standard user capability, you can verify only those
files in your logon account.

This command applies only to NMSTORE tapes created in Native
Mode. It does not work on tapes created by Compatibility Mode Store.

The LOCAL option is no longer needed to verify files. All
files will be verified and displayed with their real filenames,
even if parts of a file's accounting structure do not exist on the system.

EXAMPLE

     To verify all files in a system

     1.  Write a file equation to set up a device file.

         FILE T;DEV=TAPE

     2.  Use the VSTORE command and backreference the device file.

         VSTORE *T;@.@.@;SHOW

ADDITIONAL INFORMATION

Commands:   STORE, RESTORE

Manuals :  STORE and TurboSTORE/iX Manual (30319-90001)
           Magneto-Optical Media Manager User's Guide (36398-90001)