NAME

fget − retrieve files from the HONEYWELL 6000

SYNOPSIS

fget [ options ] [ files ]

DESCRIPTION

Fget arranges to have one or more GCOS files sent to UNIX.  GCOS identification must appear in the UNIX password file (see passwd(5)), or be supplied by the −i option.  Normally, the files retrieved will appear in the UNIX user’s current directory under the GCOS file name. 

The 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 GCOS path name and that file is retrieved.  If the file name has no embedded slashes or begins with a slash, then the GCOS catalog from which the file is retrieved is the same as the UNIX login name of the person who issues the command.  If, however, a user has a different name in the third field of the GCOS “ident card image” (which image is extracted from the UNIX password file−see passwd(5)), this name is taken as the GCOS catalog name.  Whatever GCOS catalog is finally used, the files must either have general read permission or the user must have arranged that the user ID network has read permission on that catalog (see fsend(1C)). This can be accomplished with the GCOS command:

filsys mc <user ID>,(r)/network/

The UNIX file into which the retrieved GCOS file will ultimately be written is initialized with one line containing the complete GCOS file name.  If the file contains the initial line for an extended period, it means that GCOS is down or something has gone horribly wrong and you should try again. 

The following options, each as a separate argument (or in the case of −d and −u, as two separate arguments), may appear in any order, but must precede all file arguments. 

−a Retrieve files as ASCII (default). 

−b Retrieve files as binary. 

−d Use the next argument as the UNIX directory into which retrieved files are written. 

−i Supply the GCOS “ident card” image as the parameter −iMxxxx,Myyy where Mxxxx is the GCOS job number and Myyy the GCOS bin number. 

−m When the request has been forwarded to GCOS, report by mail(1) the so-called snumb of the receiving job; mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran or that UNIX retrieved the output.  This is the default option. 

−n Do not report the forwarding of the request by mail(1).

−o Print the on-line GCOS accounting output. 

−t Toss out the on-line GCOS accounting output.  This is the default option. 

−sn Submit job to GCOS with service grade n (n=1, 2, 3). Default is −s1. 

−u Use the next argument as the GCOS catalog name for all files. 

EXAMPLES

The command:

fget −u gcosme −t −n −d /usr/me/test file1 file2

will retrieve the GCOS files gcosme/file1 and gcosme/file2, as the UNIX files /usr/me/test/file1 and /usr/me/test/file2, respectively, but will not generate any mail or GCOS accounting output as a result of the transaction. 

FILES

/etc/passwd user’s identification and GCOS ident card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/∗ spool area. 

/usr/lib/fget.demon retrieval daemon. 

SEE ALSO

dpd(1C), dpr(1C), fsend(1C), fget.demon(1C), passwd(5). 

May 16, 1980