Google
 

Trailing-Edge - PDP-10 Archives - BB-JR93N-BB_1990 - 10,7/nft/nft.hlp
There are 17 other files named nft.hlp in the archive. Click here to see a list.
Network File Transfer Using NFT

Function

The Network File Transfer (NFT) utility allows  you  to  access  files
residing   on   DECnet   hosts   that   provide  network  file  access
capabilities.  By using NFT, you can perform a variety  of  operations
such  as  copying,  deleting,  renaming,  or  listing  files;  listing
directories; and submitting files to a batch system.  NFT  allows  you
to  perform  operations at the local host as well as at a remote host.
You may also use NFT to copy a file from one remote host to another.

NFT processes text files, programs, data files, control files, or  any
other  sequential  file.   However,  only  ASCII  file  transfers  are
supported between a TOPS-10 host and a non-TOPS-10 host.


Format

     R NFT
     * command output-file-spec = input-file-spec/switches

where:  command is one of the NFT commands described below.  file-spec
        is one or more standard file specifications.  Depending on the
        command, either the output-file-spec or both file-specs may be
        omitted.

The NFT commands are:

Command                       Action

COPY [output file-spec=]      Copies files from:
  input file-spec             local node to remote node
                              local node to local node
                              remote node to local node
                              remote node to remote node

DELETE file-spec(s)           Deletes files from  a  local  or  remote
                              node.

DIRECT [output file-spec=]    Lists the directory from the
  input file-spec             specified node.

EXIT                          Exits from NFT.

HELP                          Displays a list of NFT commands.

PRINT file-spec               Prints a file  at  the  specified  node.
                              NFT  does  not  check  that  the file is
                              actually printed at a remote node.   The
                              file  must  be located at the node in an
                              acceptable format;  and  print  spooling
                              must be available at the node.

RENAME output file-spec(s)=
input file-spec               Changes the  name  or  attributes  of  a
                              file.  Valid only for nodes that support
                              remote renaming.

SET DEFAULT [node::=]
  /USERID[:uid[:acct[:psw]]]  Sets  the  defaults   for   the   access
                              information   for  one  or  more  remote
                              nodes.  The defaults  remain  in  effect
                              until  you change them using another SET
                              DEFAULT command or exit from  NFT.   NFT
                              applies the defaults in SWITCH.INI after
                              it  sets  the  defaults  from  the   SET
                              DEFAULT command.

SUBMIT file-spec              Submits  a  batch  control  file  or   a
                              command  file on a local or remote node.
                              NFT does not  check  that  the  file  is
                              actually submitted.  The control/command
                              file  must  be  at  the   node   in   an
                              acceptable  format;  and  the  batch  or
                              command file facility must be  supported
                              and available at the node.

TYPE [output file-spec=]      Displays the specified file on your
  input file-spec             terminal.

In  addition  to  the  standard  commands,  commands  called  DAP-mode
commands   are  available.   They  are  the  DDELET  (delete),  DDIREC
(direct), DRENAM (rename), and DSUBMI (submit) commands.  You can  use
these  commands  to quickly manipulate a single file on a single host,
or if the remote host does not  appear  to  accept  the  standard  NFT
command.   If  you  use these commands, you can include only one input
file specification.   These  commands  may  execute  faster  than  the
standard  commands  because they do not have the same command scanning
and checking as the standard commands.  In some cases,  they  may  not
give the same amount or type of information as the standard commands.

All NFT and DAP-mode commands described  above  work  between  TOPS-10
hosts,  and  with  your  files  on the local host.  However, a command
works on a non-TOPS-10 host only if that  host  has  also  implemented
that facility.  For example, you can copy files between a TOPS-10 host
and a VMS host because both hosts have implemented the COPY facility.

For those commands with input and/or output file  specifications,  the
defaults  for the command string are listed below.  Though most of the
defaults are the  same  for  all  the  commands,  some  commands  have
different  defaults.   The  exceptions  are  noted  with  each field's
default.

Field          Default

node           local node
               all remote nodes for SET DEFAULT
               unchanged for RENAME output

device         DSK:  for local node, none for remote node
               TTY:  for DIRECT and TYPE output
               unchanged for RENAME output

directory      no explicit directory
               unchanged for RENAME output

file name      output - input file name
                      - generated name for DIRECT
                      - unchanged for RENAME
               input  - *
                      - must be specified for DELETE

file type      output - input file type
                      - DIR for DIRECT
                      - unchanged for RENAME
               input  - *
                      - must be specified for DELETE
                      - CTL for SUBMIT
                      - none for PRINT

I/O mode       file creation mode, assumed to be ASCII
               ASCII for DIRECT and TYPE


The switches you can use with NFT are listed below:

/ASCII         Transfers in ASCII mode.  Use the /ASCII switch for all
               ASCII file transfers to or from a non-TOPS-10 host.

/[NO]BAUD      Does [not] print the baud rate of data transfer in  the
               totals  summary.   This  switch applies to the COPY and
               TYPE commands only.  The default for network  transfers
               is /BAUD, /NOBAUD is the default for local transfers.

/BINARY        Transfers in binary mode.  Use the /BINARY  switch  for
               all file transfers between TOPS-10 hosts.

/[NO]MOAN      Does [not] issue general warning complaints.   Use  the
               /MOAN  switch to instruct NFT to issue warnings when it
               encounters  a  dubious  condition.   Such  a  condition
               typically requires NFT to make a guess (for example, in
               a file copy operation, the data type or data byte size)
               in  order  to  complete  the  command.   The default is
               /NOMOAN.

/[NO]OKERROR   Use the /[NO]OKERROR  switch  to  control  whether  NFT
               aborts  the  command  if  an  error  occurs.   /OKERROR
               directs NFT to  ignore  file  access  and  I/O  errors,
               issuing  warning messages.  /NOOKERROR instructs NFT to
               abort the current command on the first occurrence of  a
               file  access  or  I/O  error.   The  default setting is
               /NOOKERROR.

/TOTALS[:list] Use the /TOTALS switch to control  the  totals  summary
               displayed  at  the  end  of the command execution.  The
               various TOTALS quantities (files,  errors,  baud  rate,
               and so on) can be individually controlled by specifying
               the :list argument.  If  a  quantity-name  is  preceded
               with  a  NO, that quantity will not be listed.  If more
               than one quantity  is  specified,  separate  them  with
               commas, and enclose the list with parentheses.  /TOTALS
               or /TOTALS:ALL directs NFT to print a totals summary of
               all applicable quantities at the completion (successful
               or otherwise) of  the  current  command.   /TOTALS:NONE
               instructs   NFT  to  omit  the  summary.   The  /TOTALS
               quantities are:

                o  BITS - List the total number of data bits.

                o  BYTES - List the total number of data bytes.

                o  WORDS - List the total number of 36-bit words.

                o  RECORDS - List the total number of records.

                o  BLOCKS - List the total number of 128-word blocks.

                o  PAGES - List the total number of 512-word pages.

                o  FILES - List the total number of files.

                o  BAUD - List the effective data transfer rate  (bits
                   per second).

                o  ERRORS - List the total number of execution errors.

               The default quantities are WORDS,  BLOCKS,  FILES,  and
               BAUD.  NFT ignores inappropriate arguments.

/USERID:id     Use this  switch  to  specify  the  access  information
               (userid,  account,  and  password) when using NFT for a
               non-TOPS-10 host.  You include the /USERID switch  with
               the file specification of the remote file.  If you omit
               an argument from the switch, NFT prompts you  for  that
               argument.   If  the  remote  host  does not require the
               information, you can press the <RET> key.  The form  of
               the /USERID switch is:

                    /USERID:uid:acct:psw

               where uid is user-name, acct is an account string,  and
               psw is a password.  If you omit the account or password
               argument, you must still include  its  preceding  colon
               (:).  For example, if you omit the password:

                    /USERID:smith:1776:

               NFT prompts you for it.  You then  supply  a  password,
               which NFT does not echo.

               NFT automatically prompts you for access information if
               you include /USERID without arguments in the form:

                    NFT   /USERID

               You  can  include  this  command  and  switch  in  your
               SWITCH.INI  file.   If  you  include arguments with the
               /USERID switch in  SWITCH.INI,  you  are  specifying  a
               particular   userid.   You  can  override  this  switch
               setting by including an explicit /USERID:uid switch  on
               a  command  line  to  NFT.   You  can  also use the SET
               DEFAULT command to specify access information  for  one
               or  all  remote nodes.  Defaults set this way apply for
               the duration of the current NFT session.

               For a TOPS-10 remote file, you can omit the PPN if  the
               userid and the project-programmer number are identical.
               For example, you can enter:

               *DIRECT IRIS::[27,777]/USERID:27,777::FOO

               as:

               *DIRECT IRIS::/USERID:27,777::FOO
Characteristics

The NFT program:

     Requires LOGIN.

     Destroys your core image.

     Leaves your terminal at user level.


Examples

     1.  Copy a file from  the  local  node  to  a  remote  VMS  host.
         Override the /USERID specified in your SWITCH.INI file.

              .R NFT
              *COPY ROSE::/USER=PLANNI
              For remote ROSE::*.*
               User-id: BARSTOW
               Account:
               Password:
               ROSE::COMMUNITY:[BARSTOW]PLANNI..2 <=
              DSKC:[52,654]PLANNI
              Total of 398 words in 4 blocks in 1 file at 20395 baud

     2.  Copy a file from a TOPS-20 host to a RSTS host  while  logged
         in  on a TOPS-10 host.  You must specify a /USERID switch for
         each remote host.

              .R NFT
              *COPY LILY::/USER=DAISY::PLANNING-GUIDE/USER
              For remote DAISY::PLANNING-GUIDE.*
               User-id: THRING
               Account:
               Password:
              For remote LILY::*.*
               User-id: 15,177
               Account:
               Password:
               LILY::SY:[15,177]PLANNI <=
              DAISY::PS:[THRING]PLANNING-GUIDE..5
              Total of 483 words in 4 blocks in 1 file at 5851 baud

     3.  Delete all the files with name UUOSYM from a directory  on  a
         TOPS-20  host.  You must include the /USERID switch, but need
         not explicitly specify the directory because it is  the  same
         as the userid.

              .R NFT
              *DELETE DAISY::UUOSYM.*/USER
              For remote DAISY::UUOSYM.*
               User-id: THRING
               Account:
               Password:
              DAISY::PS:[THRING]UUOSYM.REL.1
               DAISY::PS:[THRING]UUOSYM.UNV.1
              Total of 33 blocks in 2 files

     4.  Access a directory not your own  on  a  remote  TOPS-10  host
         called  IRIS.   Since  your  account on the system allows you
         read access to the  directory,  you  can  specify  the  other
         directory and your userid and read the directory.

              .R NFT
              *DIRECT IRIS::[17,353]/USER
              For remote IRIS::[17,353]*.*
               User-id: 27,777
               Account:
               Password:
              IRIS::DSKA:[1,2]DSKA.BAK
              IRIS::DSKA:[1,2]DSKA1.FUL
              IRIS::DSKA:[1,2]INC.BAK
              IRIS::DSKA:[1,2]FUL.BAK
              IRIS::DSKA:[1,2]DSKA.INC
              IRIS::DSKA:[1,2]INC.MIC
              IRIS::DSKA:[1,2]FUL.MIC
              Total of 7 files

     5.  To access  accounts  with  different  access  information  on
         several  remote nodes, set the default access information for
         all of them.

              .R NFT
              *SET DEFAULT ROSE::=/USER:BARSTOW:HAHA:HOHUM
              *SET DEFAULT IRIS::=/USER:27,777:WRITER:FOFUM
              *SET DEFAULT LILY::=/USER:15,177:SCHOLAR:FEEFI
              *SET DEFAULT DAISY::=/USER
              *COPY ROSE::=DAISY::FCC.ASC
              For remote DAISY::FCC.ASC.*
               User-id:thing
               Account:
               Password:
                              .
                              .
                              .

     6.  Submit a command file to the VMS command  file  processor  on
         host ROSE:.  You have included a /USERID switch for that host
         in your SWITCH.INI file so you do not have  to  include  that
         switch in the command string.

              .R NFT
              *SUBMIT ROSE::ABVAX.CTL
               ROSE::COMMUNITY:[BARSTOW]ABVAX.CTL.1
              Total of 1 file