 |
» |
|
|
|
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
;DATE>=moddate}]
[;PURGE]
[;PROGRESS [=minutes]]
[;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
filestoexclude
Both filestostore and filestoexclude may be entered in MPE or HFS syntax.
Wildcards are permitted for both MPE as 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: 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
[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 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
/acct/group/
All files (MPE and HFS) in one 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
/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
(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, 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 accdate
Instructs STORE to store only selected files. 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 or To store all MPE named files (and exclude HFS files and directories), enter 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 or 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
|
|
