HP 3000 Manuals HP 3000 Manuals
STORE
This command enables the system administrator to copy one or more disk
files onto a magnetic tape. The administrator can recover copied files
using the RESTORE command.
Syntax
STORE [[filesetlist][;[storefile][;option[;option[...]]]]]
where option is:
[;SHOW[=showparmlist]] [{;DATE<=accdate}] [;PURGE] [;PROGRESS [=minutes]]
[{;DATE>=moddate}]
[;DIRECTORY] [;TREE][;NOTREE]
Parameters
filesetlist Specifies the set of files to be stored. The default is @
(all files in the current working directory) regardless of
capabilities. The form of this parameter is as follows:
filesetitem[,filesetitem[...]]
where filesetitem can be ^indirectfile or fileset.
indirectfile A file name that backreferences a disk file. The syntax
is:
^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.
fileset Specifies a set of files to be stored and optionally those
files to be excluded from the STORE operation. The fileset
parameter has the form:
filestostore[-filestoexclude[-filestoexclude[-...]]]
The system stores any file that matches filestostore unless
the file also matches filestoexclude, which specifies files
to be excluded from the STORE operation. You may specify
an unlimited number of filestoexclude.
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.
filestostore Both filestostore and filestoexclude may be entered in MPE
filestoex- or HFS syntax. Wildcards are permitted for both MPE as
clude well as HFS syntax, however, MPE wildcards are not expanded
in filestoexclude. This means that @.@.@-@.@.@ is NOT an
empty fileset. It would contain all of the HFS named files
on the system.
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:
letter a to z
letter A to Z
digit 0 to 9
special characters - _ .
For HFS name syntax, the lowercase letters are treated
distinctly from the uppercase letters (no upshifting).
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.
These wildcard characters can be used as follows
n@ Store all files starting with the character
n.
@n Store all files ending with the character n.
n##...# Store all files starting with character n
followed by up to seven digits (useful for
storing all EDIT/3000 temporary files).
n@x Store all files starting with the character n
and ending with the character x.
?n@ Store all files whose second character is n.
n? store all two-character files starting with
the character n.
?n Store 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 All files that begin with the name myset and
[d-e1-6] 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 are not allowed to 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 ranged [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. When a MPE name component is a single
@ wildcard, the@ will be folded to include all MPE and HFS
named files at that level and below. To specifiy only
MPE-named files, use ?@ instead.
A fileset may be entered in any of the following formats
and may use wildcard characters. Equivalent MPE and HFS
formats are grouped together as follows.
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 One particular file in the logon group
and account.
@.group.acct All files (MPE and HFS) in one
/acct/group/ particular group in one particular
account (including the GROUP
directory).
?@.group.acct All MPE name files in one particular
group in one particular account.
@.group All the files (MPE and HFS) in one
/logonacct/group/ 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
(including the ACCT directory), plus
all the files and directories under the
specified account.
?@.@.acct All MPE named files in all the groups
in one particular account.
@ All (MPE and HFS) files in the CWD.
@.@ 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.
thisisit.@.acct Any MPE file named thisisit in all the
groups in one particular account.
storefile The name of the device to which the stored files are to be
written. This may be any magnetic tape or DDS device.
This file must be backreferenced, by using an asterisk (*).
You must do this by using a FILE equation before invoking
STORE.
A message is displayed on the system console requesting the
operator to mount the tape identified by the storefile
parameter and to allocate the device.
SHOW Specifies that STORE is to report information for every
file that is stored. If you omit the SHOW parameter, then
only the names of the files not stored are lilsted, along
with the number of files stored and the number of files not
stored. This listing is sent to $STDLIST (formal file
designator SYSLIST) unless a FILE command is entered to
send the listing to some other device. For instance,
FILE SYSLIST; DEV=LP
entered before the STORE command would send the listing to
a line printer.
showparmlist Tells STORE what information to display for the files that
are restored. If you specify ;SHOW and 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 characters. 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 or more characters.
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 name, group name, 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
record size, blocking factor, number of
extents allowed, allocated, end- of-file, and
file starting and ending media number.
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 diaplayed.
For HSF 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.
The full HFS pathname is displayed instead of
MPE style names.
OFFLINE Sends an additional copy to the format file
designator OFFLINE, which defaults to device
LP.
ONERROR Tells STORE what to do if there is a tape
write error. If you omit this parameter,
then the default option is REDO.
ONERR is a synonym for ONERROR.
QUIT Tells STORE to abort after a
tape write error.
REDO STORE should perform error
recovery on the tape write
error. First the tape is
rewound, and a bad record is
written to the beginning of the
tape. The tape is then
unloaded, and a new tape is
loaded. STORE then continues
rewriting the files that were
on the damaged media.
moddate or Instructs STORE to store only selected files.
accdate A moddate value (indicated by >=, equal to or
greater than) limits the STORE to those files
that were modified on or after a particular
date.
An accdate value (indicated by <=, less than
or equal to) limits the STORE to those files
that were accessed on or before a particular
date.
The date is expressed in the form
mm/dd/yy[yy]. The year may be expressed in
two or four digits (for example, 87 or 1987).
This option cannot be used for files that are
attached to a log set.
PURGE Instructs MPE/iX to purge all the files that
were successfully stored, after the STORE
operation has ended. In an interactive
session, MPE/iX prompts the user to enter any
lockwords that have been omitted if the user
does not have system manager, system
supervisor, or account manager capabilities.
In a job, if the user does not have SM, AM,
or OP capability, the lockword(s) must be
provided.
A file code with a negative file code can be
purged only by a user who has Privileged Mode
(PM) capability.
If a file cannot be purged, a file system
error message is sent to the user, stating
that the file was not purged.
PROGRESS Instructs STORE to report its progress at
regular intervals by displaying the message
STORE 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.
DIRECTORY Specifies that the file system directory plus
all HFS directories are to be stored. This
option requires system manager (SM) or system
supervisor (OP) capability.
If ONVS or SPLITVS is not specified, the
DIRECTORY defaults to dumping the system
directory. Otherwise, the directories of the
specified volume sets are dumped. This way,
operators and manager can dump or copy
private volume sets in their entirety.
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 the NOTREE and
USENAME options.
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 and USENAME options.
Operation Notes
* Usage
You can use this command to store one or more disk files onto
magnetic tape or DDS cassettes. It will store only those files
whose home volume set(s) is (are) mounted.
* Required capabilities for restoring files
If you have system manager (SM) or system supervisor (OP)
capability, you can store any file in the system. If you have
account manager (AM) capability, you can store any file in your
account, but you cannot store files having negative file codes
unless you have Privileged Mode (PM) capability.
Before entering a STORE command, you must identify storefile as a
magnetic tape or DDS device by using the FILE command (creating a
file equation).
* Issuing the STORE command
You can issue the STORE command with the RUN command (for example,
RUN STORE.PUB.SYS). The INFO= parameter of the RUN command can be
used to specify the STORE option, filesets, and keywords. If no
;INFO= parameters are specified, the STORE: prompt will appear.
Acceptable responses are a complete STORE command, a complete
RESTORE command, or a complete VSTORE command.
If you have purchased a Turbostore product, it will be installed
as TSTORE.PUB.SYS. As long as a non-zero length TSTORE program
exists in PUB.SYS, typing any CI STORE, RESTORE, or VSTORE command
will invoke Turbostore instead.
If you press [Break] during a STORE operation, the operation
continues while you interact with the Command Interpreter. Both
ABORT and RESUME can be used within BREAK.
You can issue this command from a session, job, or program, but
not in BREAK. The user must have Privileged Mode (PM) capability
to execute this command for privileged files.
Examples
To store all files on the system (including HFS files), enter
:STORE /
or
:STORE @.@.@
To store all MPE named files (and exclude HFS files and directories),
enter
:STORE ?@.@.@
To store all (MPE and HFS) files in the group GP4X in your logon account
to a tape file named BACKUP, enter
:FILE BACKUP;DEV=TAPE
:STORE @.GP4X;*BACKUP;SHOW
The console operator receives a request to mount the tape identified as
BACKUP. A listing of the files stored appears on your standard list
device.
To store all files on the system except the MPE files in the SYS account,
enter
:FILE TAP;DEV=TAPE
:STORE @.@.@-@.@.SYS;*TAP;SHOW=SECURITY,DATES,LONG,OFFLINE
The console operator receives a request to mount the tape identified as
TAP. A listing of the files stored appears on both standard list and at
the system line printer. The listing will include all information
available from STORE.
To store from indirect file INDFILE which contains
:FILE1,FILE2;SHOW
:FILE3,@.PUB.SYS;DATE>=6/1/87
enter:
:FILE T;DEV=TAPE
:STORE ^INDFILE;*T
The console operator receives a request to mount the tape identified as
T. Files FILE1, FILE2, FILE3, and all files in PUB.SYS will be stored if
they have been modified since June 1, 1987. A listing of the files
stored appears on your standard list device.
To store files from a group and account with a default storefile, enter
:STORE @.GROUP.ACCOUNT
or
:STORE
Note that the console operator receives a request to mount the tape
identified as the user's user name.
To store files from a group and account and to purge them after the
STORE, enter
:FILE T;DEV=TAPE
:STORE @.GROUP.ACCOUNT;PURGE
Related Commands
RESTORE
VSTORE
REPLY
RECALL