Trailing-Edge
-
PDP-10 Archives
-
TOPS-20_V6.1_DECnetDistr_7-23-85
-
subsys/nft.hlp
There are 17 other files named nft.hlp in the archive. Click here to see a list.
NFT - Network file transfer program
NFT is the user interface to the network file transfer system. The services
NFT provides are actually performed by a FAL process (File access listener)
at the accessed node.
NFT requests access information which will be verified by the FAL at the
accessed node. The following information is requested:
user-id In general, the user name or identification you would use
to log in at the accessed node. If the remote system
is a TOPS-20 system this is the directory name on the
structure you are trying to access.
password In general, the password you would use to log in as
"user-id" at the accessed node. If the remote system
ia a TOPS-20 system this is the password for the directory
specified as the "user-id". The remote TOPS-20 user-id
and password may specify directory information on a non-PS
structure. In such a case, one may not be able to login
as user-id, but file access is allowed if the password is
correct. If the password switch is specified it must
follow the user switch.
account The account you would use to log in as "user-id" at the
accessed node.
You will be prompted for any access information during the first command
which references a node that has no default access information established.
If the access is successful the information you supplied will be used as
the default access information for all subsequent commands which access
this node.
You may change the access information for a single command by specifying
the /USER or /ACCOUNT or /PASSWORD switches. The default access information
for a specific node may be establishes with the SET DEFAULTS command.
NFT will look for NFT.INIT in you logged in directory at startup time. This
file may contain NFT commands which you wish to execute every time you run
NFT. Typically you would include a SET DEFAULT command for each node you
reference frequently.
Network-filespecs
All NFT commands which reference remote files accept a network-filespec
to identify the file. The format of a network-filespec follows:
TOPS20 node::device:<directory>filename.filetype.generation
TOPS10 node::device:[path]filename.extension
VAX/VMS node::device:[username]filename.extension;version
RSTS,RT node::device:[UIC]filname.extension
RSX,IAS node::device:[UIC]filename.extension;version
Note that the network filespec is merely the node identifier followed by
the file descriptor in a form acceptable to its host. Note that file
specifications cannot be quoted.
NFT20 Command summary
COPY (FROM) network-filespec{/switches} (TO) network-filespec{/switches}
Transfers files to or from a remote node. The network-filespecs indicate
the direction of the transfer. Only one network-filespec may refer to a
remote node.
Wild cards are always allowed in the file specifications if the
COPY command is local to remote. Otherwise wildcards are allowed
only if the remote node supports the wildcard feature for that command.
Switches Switches are never required for transfers between TOPS20
nodes or ascii file transfers between any nodes. The
following switches can be used to override defaults or
establish data modes when transferring image files to
or from non TOPS20 nodes.
/ASCII Sets file processing mode to ASCII. This is the default
for all transfers to and from non TOPS20 nodes.
/IMAGE Sets file processing mode to IMAGE. This is the default
for all TOPS20 to TOPS20 transfers. Image indicates no
special processing is to be performed. The file is to
be sent or recieved exactly as it is stored on disk.
/MACY11 Sets file processing mode to MACY11. MACY11 is the
file format produced by the TOPS10/20 PDP11 cross-assemblers.
Switches only valid in destination network-filespec
/FIXED:nn The file data consists of fixed length records.
/VARIABLE:nn The file data consists of variable length records.
TYPE (REMOTE FILES) network-filespec{/switches}
Types the specified files on the controlling terminal. The files must be
ascii files.
DELETE (REMOTE FILES) network-filespec{/switches}
Deletes the specified files. There is no undelete command so don't delete
a file you might later like to undelete. Wild cards may be specified in
the network-filespec.
DIRECTORY (OF REMOTE FILES) network-filespec{/switches}
Returns a directory listing of the specified remote files. Wild cards may
be specified in the network-filespec. Not all implimentations support the
directory command.
PRINT (REMOTE FILES) network-filespec{/switches}
Queues the specified file to be printed at the remote node. No
monitoring is done to make sure that the request is actually honored.
SUBMIT (REMOTE FILES) network-filespec{/switches}
Submits the specified file to the batch input processor at the remote node.
No monitoring is done to make sure that the request is actually honored. The
file is merely submitted.
SET DEFAULTS (FOR NODE) node::{/switches}
The switches establish the default access information to be used
with all subsequent commands which access this node. If you do not
issue a SET DEFAULTS command prior to the first command which accesses
a node the defaults will be established from the information given in
the first command.
/OSTYPE:type Specifies the type of operating system expected at the
remote node. If this switch is not specified TOPS20
is assumed. This switch is required when using the
COPY command and wildcards with RSX11 systems.
INFORMATION (ABOUT) DEFAULTS
Displays the current defaults for the specified node or all nodes
if node:: is omitted. These defaults are used with all commands
that access the specified node when the user doesn't specify the
associated switch with the command.
INFORMATION (ABOUT) DECNET
Displays a list of accessible DECNET nodes.
HELP (WITH NFT20)
Displays this text from HLP:NFT.HLP
TAKE (COMMANDS FROM) filespec (LOGGING OUTPUT ON) filespec{/Switches}
Executes NFT commands from the specified command file. When commands
are executed which cause a prompt for access information the take file
execution is momentarily suspended and you are prompted for the access
information at your terminal. Once the access information has been
obtained the take file execution is resumed. This is provided so that
your command files don't have to include passwords. The logfile
does not record output from the TYPE command or the COPY command
if the destination file specification is the local terminal.
Switches for the TAKE command are:
/DISPLAY display program output and commands on terminal
durring command file execution
/NODISPLAY Suppress terminal output during command file
execution. Information is still recorded in
the logfile.
Note that the indirect file facility is available, but the indirect
file is limited to one line of text.
EXIT (TO MONITOR)
Terminates NFT execution.
NFT Switch summary
Access information switches:
These switches are valid with all commands which access a remote
file as well as the SET DEFAULTS command.
When a switch is specified with the SET DEFAULT command it establishes
the defaults which will be used for all subsequent commands accessing
the specified node.
When a switch is specified with a command it establishes the values
to be associated with this command only.
If no defaults have been established for the specified node the
values given with access switches or obtained by prompting the user
will be used as the defaults for all subsequent requests involving
the specified node.
If the colon is omitted from the following switches you will be promted
for the specified information. All prompting for access information will
be done to the controlling TTY. Echoing will be suppressed while you
enter passwords.
/ACCOUNT:account Sets the account-id associated with this
node.
/PASSWORD:password Sets the password associated with this node.
If specified, it must follow the user switch.
/USER:user-id Sets the user-id associated with this node.
Causes a prompt for the password associated
with this user-id unless the value is
specified with the /PASSWORD switch.
NFT examples
@NFT
NFT>SET DEFAULTS (FOR NODE) BOSTON::/USER:SMITH/ACCOUNT:PAYROL/OSTYPE:TOPS20
NFT>SET DEFAULTS (FOR NODE) ALPHA::/USER:[301,377]/OSTYPE:RSX
NFT>SET DEFAULTS (FOR NODE) BETA::/USER/ACCOUNT/OSTYPE:VMS
NFT>COPY (FROM) FOO.DAT (TO) BOSTON::
Access information for node BOSTON::/USER:SMITH/ACCOUNT:PAYROL
Password:
PS:<SMITH>FOO.DAT.5 => BOSTON::PS:<SMITH>FOO.DAT.1 [OK]
NFT>COPY (FROM) FOO.* (TO) BOSTON::FOO.*.-1
PS:<SMITH>FOO.DAT.5 => BOSTON::PS:<SMITH>FOO.DAT.2 [OK]
PS:<SMITH>FOO.DMP.1 => BOSTON::PS:<SMITH>FOO.DMP.1 [OK]
PS:<SMITH>FOO.TXT.1 => BOSTON::PS:<SMITH>FOO.TXT.1 [OK]
NFT>DELETE (REMOTE FILES) BOSTON::FOO.DMP.1
BOSTON::PS:<SMITH>FOO.DMP.1 [OK]
NFT>COPY (FROM) BOSTON::FOO.* (TO) FOO.*
BOSTON::PS:<SMITH>FOO.DAT.2 => PS:<SMITH>FOO.DAT.6 [OK]
BOSTON::PS:<SMITH>FOO.TXT.1 => PS:<SMITH>FOO.TXT.2 [OK]
NFT>COPY (FROM) FOO.TXT (TO) ALPHA::FOO.TXT/ASCII/VARIABLE:132
Access information for node ALPHA::/USER:[301,377]
Account:TEMP
Password:
PS:<SMITH>FOO.TXT.1 (TO) ALPHA::FOO.TXT [OK]