SysIII/usr/src/man/man1/fget.1c

.TH FGET 1C
.SH NAME
fget \- retrieve files from the \s-1HONEYWELL\s+1 6000
.SH SYNOPSIS
.B fget
[ options ] [ files ]
.SH DESCRIPTION
.I Fget\^
arranges to have
one or more
.SM GCOS
files sent to
\s-1UNIX\s+1.
.SM GCOS
identification must appear in
the
.SM UNIX
password file (see
.IR passwd (5)),
or be supplied by the
.B \-i
option.
Normally, the files retrieved will appear in the
.SM UNIX
user's
current directory under the
.SM GCOS
file name.
.PP
The
.SM GCOS
catalog from which the files are obtained
depends on the form of the file name
argument.
If the file name has only embedded slashes,
then it is assumed to be a full
.SM GCOS
path name and that file is
retrieved.
If the file name has no embedded slashes or begins with
a slash,
then the
.SM GCOS
catalog from which the file is
retrieved is the same as the
.SM UNIX
login name of the person
who issues the command.
If, however, a user has a different name in the
third field of the
.SM GCOS
``ident card image''
(which image is extracted from the
.SM UNIX
password file\-see
.IR passwd (5)),
this name is taken as the
.SM GCOS
catalog name.
Whatever
.SM GCOS
catalog is finally
used, the files must either have general read permission
or the user must have arranged that the user
.SM ID
.I network\^
has read permission on that catalog (see
.IR fsend (1C)).
This can be accomplished with the
.SM GCOS
command:
.RS
.PP
filsys \|mc \|<user \s-1ID\s+1>,(r)/network/
.RE
.PP
The
.SM UNIX
file into which the retrieved
.SM GCOS
file will
ultimately be written is initialized with one line
containing the complete
.SM GCOS
file name.
If the file contains the initial line for an extended period,
it means that
.SM GCOS
is down or something has gone horribly wrong
and you should try again.
.PP
The following options, each as a separate argument
(or in the case of
.B \-d
and
.BR \-u ,
as two separate arguments),
may appear in any order,
but must precede all file arguments.
.PP
.PD 0
.TP 7
.B  \-a
Retrieve files as
.SM ASCII
(default).
.TP 7
.B  \-b
Retrieve files as binary.
.TP 7
.B  \-d
Use the next argument as the
.SM UNIX
directory into which
retrieved files are written.
.TP 7
.B \-i
Supply the
.SM GCOS
``ident card'' image as the parameter
.B \-iMxxxx,Myyy
where
.B Mxxxx
is the
.SM GCOS
job number and
.B Myyy
the
.SM GCOS
bin number.
.TP 7
.B  \-m
When the request has been forwarded to \s-1GCOS\s+1, report by
.IR mail (1)
the so-called
.I snumb\^
of the receiving
job;
mail is sent by the
.SM UNIX
daemon;
there is no guarantee that the
.SM GCOS
job ran
or that
.SM UNIX
retrieved the output.
This is the default option.
.TP 7
.B  \-n
Do not report the forwarding of the request by
.IR mail (1).
.TP 7
.B  \-o
Print the on-line
.SM GCOS
accounting output.
.TP 7
.B  \-t
Toss out the on-line
.SM GCOS
accounting output.
This is the default option.
.TP 7
.BI \-s n\^
Submit job to
.SM GCOS
with service grade
.I n\^
.RI ( n "=1, 2, 3)."
Default is
.BR \-s1 .
.TP 7
.B  \-u
Use the next argument as the
.SM GCOS
catalog name for all files.
.PD
.SH EXAMPLES
The command:
.RS
.PP
fget \|\-u \|gcosme \|\-t \|\-n \|\-d \|/usr/me/test \|file1 \|file2
.RE
.PP
will retrieve the
.SM GCOS
files
.B gcosme/file1
and
.BR gcosme/file2 ,
as the
.SM UNIX
files
.B /usr/me/test/file1
and
.BR /usr/me/test/file2 ,
respectively,
but will not generate any mail or
.SM GCOS
accounting output
as a result of the transaction.
.SH FILES
.PD 0
.TP 20
/etc/passwd
user's identification and
.SM GCOS
ident card.
.TP
/usr/lib/dpd
sending daemon.
.TP
/usr/spool/dpd/\(**
spool area.
.TP
/usr/lib/fget.demon
retrieval daemon.
.PD
.SH SEE ALSO
dpd(1C), dpr(1C), fsend(1C), fget.demon(1C), passwd(5).