Google
 

Trailing-Edge - PDP-10 Archives - red405a2 - 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			23-Apr-79

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	The user name or identification you would use to log in
		at the accessed node.

  password	The password you would use to log in as "user-id" at the
		accessed node. (or the remote systems Network password)
		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>filenam.extension.generation

  VAX/VMS	node::device:[username]filenam.extention;generation

  RSX and RSTS	node::device:[UIC]filnam.extension


The node specification is optional for local files.  Note that the network-
filespec is merely the node identifier followed by the file descriptor in
a form acceptable to it's host.



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 hte transfer.  Only one network-filespec may refer to a
remote node.

Wild cards are allowed in the souce filespec if the source node is local.
Wild cards are allowed in the destination filespec if the source filespec
is in a form understandable to TOPS20 and the wild replacement can be made.


  Switches	Switches are never required for transfers between TOPS20
		nodes.  The following switches establish data modes when
		transferring 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.  This switch is
		required to transfer PDP11 object code.  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 conistis of fixed length records.  This switch
		is required when transferring ascii files to a system which
		does not understand stream ascii data.

  /VARIABLE:nn	The file data consists of variable length records.  This switch
		is required when transferring ascii files to a system which
		does not understand stream ascii data.


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.


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.  This value is used during filespec parsing
		to determine what type of filespec to expect.  If this
		switch is not specified TOPS20 is assumed.


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 you 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.

  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.


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]