|
|
Stagein Man Page
25 August 1999
STAGEIN(l) (12/11/95) STAGEIN(l)
NAME
stagein - allocate space in a disk pool and copy files from
tape to disk or from disk to disk
SYNOPSIS
stagein [ -b max block size ] [ -C charconv ] [ -d density ]
-------------- -------- -------
[ -E error action ] [ -F record format ] [ -f file id ] [ -G
------------ ------------- -------
] [ -g device group name ] [ -h host ] [ -I
----------------- ----
external filename ] [ -L record length ] [ -l label type ] [
----------------- ------------- ----------
-N nread ] [ -o ] [ -p pool ] [ -q file sequence number ] [
----- ---- --------------------
-S tape server ] [ -s size ] [ -T ] [ -U fun ] [ -u user ] [
----------- ---- --- ----
-V visual identifier(s) ] [ -v volume serial number(s) ] [
----------------- - -------------------- -
-X xparm ] [ -z ] [ files ]
----- -----
DESCRIPTION
This command sends a request to a stage daemon which checks
its catalog. If the file has already been staged, the
catalog is updated (number of accesses, last access time)
and if file is different from previous job, a symbolic link
----
is created and the control given back to the user. If the
file is not staged yet, pools have been configured and -p
NOPOOL is not specified, the file is allocated in a pool of
which the space is managed by the stage daemon. If the
request gives tape parameters, the internal file name is in
the form vid.fseq.label while if an external file name is
specified with the option -I (disk stageing), the internal
file name is in the form xfile basename.reqid. If no pool
-
has been configured or -p NOPOOL is specified, the tape is
staged directly in the location given by file and no space
----
management is done. To do the actual copy, a tpread is
issued. When complete, if file is specified, a symbolic
----
link pointing at the actual file is created with that name.
file may be a local path, the combination machine:fullpath
---- ------- --------
(NFS syntax), a full path starting with the NFS ROOT, i.e.
-
/shift, or absent.
OPTIONS
-b blocksize
---------
Specifies the maximum block size. If the tape is
labelled, the block size is taken from the header
label; otherwise, the default is 32760.
-C charconv
--------
The data is converted from this character set when
doing the copy. charconv may be ascii (no conversion
--------
is done) or ebcdic. The option value may also be
block. In this case, the trailing blanks are stripped
off and a newline is appended to each record. Option
values may be combined; they are separated by comma in
this case.
For example:
Page 1 (printed 8/25/99)
STAGEIN(l) (12/11/95) STAGEIN(l)
-C ebcdic,block
-d density
-------
1600 or 6250 for round (IBM 3420) tapes, 38000 for
standard IBM 3480 cartridges, 38KC for 3480 cartridges
with compaction (IDRC), 38KD for double density IBM
3490 cartridges, 38KDC for 3490 cartridges with
compaction (IDRC), 8200 or 8500 for Exabytes, 2G, 6G,
10G or 10GC for DLT cartridges. It must match the
device group specified in TMS (if installed). If this
parameter is missing, the value is taken from TMS.
-E error action
------------
Specifies the action to be taken in case of tape read
error. This action may be:
skip unreadable blocks are skipped. For each, an error
message indicates the error type and the block
number. A maximum of 10 blocks may be skipped.
keep the file up to the block where the error occurred
is kept on disk. By default, the disk file is
removed.
-F recfm
-----
Specifies the record format of the data on the tape. It
may be one of the following:
U Blocks may be of unknown length. A single logical
record on disk corresponds to one tape block. The
disk copy of the file is formatted according to
the convention for sequential FORTRAN unformatted
I/O.
F Each tape block is exactly blocksize bytes long
---------
(See the -b option) with the exception of the last
block which may be shorter. If both blocksize and
---------
lrecl are provided, they should be equal.
-----
Data is copied from tape to disk as a continuous
data stream. This format is suitable for use with
direct access Fortran unformatted I/O.
FB This allows to group several records of lrecl
-----
bytes into tape blocks of blksize bytes. blksize
------- -------
must be a multiple of lrecl.
-----
If the tape is labelled, the record format is taken
from the header label; otherwise the default is U.
-f fid
---
Specifies the fileid in HDR1. If more than 17
characters long, only the last 17 are taken. It is then
Page 2 (printed 8/25/99)
STAGEIN(l) (12/11/95) STAGEIN(l)
converted to upper case. fid is checked against the
---
fid in HDR1. In the case of multiple files, a series
of file identifiers may be given, separated by ":"s.
These apply to the tape files in the specified order.
If there are more files than identifiers, the last one
will be used for all remaining files. Thus, a single
file identifier may be given which applies to all files
on the tape.
-G Specifies that the tape copy operations should be
issued on the tape server by the 'group user'. A 'group
user' may be defined for each group in /etc/shift.conf.
For example:
GRPUSER ws opalprod
-g dgn
---
Requests a device from an installation defined set of
"device groups". It must match the device group
specified in TMS (if installed). If this parameter is
missing, the value is taken from TMS or defaults to
CART.
-h host
----
Sends the request to the stager on host. This may also
----
be specified thru the environment variable STAGE HOST.
-
-I external filename
-----------------
Gives the name of an external disk file. In this case,
rfcp is used to copy this file to the staging pool.
-L lrecl
-----
Specifies the logical record length for fixed length
record format files.
-l lab type
--------
Specifies the type of label which should be checked or
generated. The following label types are supported:
al ANSI label
blp bypass label processing
nl no label
sl standard IBM label
It must match the label type specified in TMS (if
installed). If this parameter is missing, the value is
taken from TMS or defaults to sl.
-N nread
-----
If specified, only nread records will be copied.
-----
Page 3 (printed 8/25/99)
STAGEIN(l) (12/11/95) STAGEIN(l)
-o Implies old fileid. The existing fileid is checked if
the option -f is also specified.
-p poolname
--------
Allocates the file in the pool poolname. This may also
--------
be specified thru the environment variable STAGE POOL.
-
-q fseq
----
Specifies the file sequence number(s) of the tape
file(s) to be copied or created. Default is 1.
Multiple files may be specified using the following
syntax:
f1-f2 Files f1 to f2 inclusive.
-- -- -- --
f1- Files f1 to the last file on the tape.
-- --
f1-f2, f4, f6- A series of non-consecutive ranges of
-- -- -- --
files.
u Position the tape by fid.
ux Position the tape by fid on x different
- -
files.
-S server
------
Specifies that the tape copy operation has to be issued
on the tape server server.
------
-s size
----
If specified, only size Mbytes will be copied. The
----
value must be smaller than 2048 (2 Gbytes). In the
case of multiple files, a series of size values may be
given, separated by ":"s. These apply to the tape files
in the specified order. If there are more files than
size values, the last one will be used for all
remaining files. Thus, a single size value may be given
which applies to all files on the tape.
-T Does not check trailer labels.
-U fun
---
Fortran unit number. This is internally converted to a
local path ftnfun (HP-UX) or fort.fun (all other
--- ---
platforms). The -U option and the file parameter may
----
be both specified for single file stageing only.
-u user
----
A file allocated in a pool will be stored in a
subdirectory user. This may also be specified thru the
----
environment variable STAGE USER. The default
-
subdirectory name is stage. user must be a valid user
----
Page 4 (printed 8/25/99)
STAGEIN(l) (12/11/95) STAGEIN(l)
name and belong to the same group as the requestor.
-V vid
---
Specifies the tape VID if different from the VSN . In
the case of multi-volume files a series of vids may be
---
given, separated by ":"s, in the order in which the
tapes are to be used.
-v vsn
---
Specifies the volume serial number of the tape. In the
case of a multi-volume file a series of vsns may be
---
given, separated by ":"s, in the order in which the
tapes are to be used. When -v and -V are both used,
each vsn must be matched by a vid in the same order.
--- ---
-z Gives on standard error, as an option string, the main
characteristics of the tape file just staged. This
includes block size (-b), record format (-F), file
identifier (-f), record length (-L), full pathname of
diskfile in the pool (-P) and file sequence number (-
q). The line is prefixed by the string "STG47 - ".
This flag is set by copytape.
EXAMPLES
To get the data from a tape into the default stage pool:
stagein -v CIN111 inp
RETURN CODES
0 Ok.
1 Bad parameter.
2 System error.
4 Configuration error.
28 ENOSPC: unable to find enough disk space.
192 Request cancelled by stageclr.
193 Blocks were skipped.
194 Blocks were skipped and stageing limited by size.
195 Stagein stopped: too many tape errors, but -E keep.
197 Stageing limited by size.
|
|
