home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pdp10 / tops-10 / nft.hlp < prev    next >
Text File  |  1995-04-05  |  9KB  |  238 lines
  1. The NFT program is used to access files on remote systems over  DECnet
  2. or  ANF-10.   The  remote  files  can  be  listed  (on your terminal),
  3. deleted, copied from system to  system,  renamed,  queued  to  a  line
  4. printer,  or  submitted  to  the batch processor.  NFT can perform the
  5. same functions on the local system as well as the remote system.
  6.  
  7. The NFT program can be run by using the following monitor command:
  8.  
  9.      .R NFT<RET>
  10.  
  11.      *
  12.  
  13. * is the command prompt.  To the prompt you can type a command  string
  14. in the following format:
  15.  
  16.      *command file-spec=file-spec
  17.  
  18. This construct varies with  the  command  that  you  are  using.   The
  19. file-spec  is  a  file  specification which includes any or all of the
  20. following:
  21.  
  22.      node::dev:[dir]file.ext.gen/USERID:user:account:password/swt
  23.  
  24. Where "node" is the network node name (or blank for the  local  host),
  25. "dev"  is  the  device  or  file  structure  name,  "dir"  is the file
  26. directory containing the file, "file" is the file name, "ext"  is  the
  27. file  extension or file type "gen" is the file generation number, and
  28. "swt" is/are any file switches desired.  The usual TOPS-10  file  spec
  29. wildcarding  rules apply (although the various remote file systems may
  30. be more restrictive).  /USERID specifies access  information  for  the
  31. file,    and    can    optionally    take    the    three    arguments
  32. (userid:account:password).   See  below  for  more  information  about
  33. /USERID.
  34.  
  35. Some commands (e.g., DELETE) require no output specification, and  for
  36. these  commands the equal sign should also be omitted.  Other commands
  37. (e.g., EXIT) take no arguments.
  38.  
  39. The NFT commands are:
  40.  
  41. COPY           copy files from one  system  to  another  or  one  file
  42.                structure to another.
  43.  
  44. DDT            enter DDT (if DDT is present).
  45.  
  46. DELETE         delete the specified file(s).
  47.  
  48. DIRECT         list the file(s) on your terminal.
  49.  
  50. EXIT           exit from NFT to monitor level.
  51.  
  52. HELP           display  information  about  the  commands   that   are
  53.                available.
  54.  
  55. NETWRK       display information about network nodes
  56.  
  57. PRINT          print a file (queue to system line printer spooler).
  58.  
  59. RENAME         rename a file (an output file must be specified on  the
  60.                left-hand side of the equal sign).
  61.  
  62. SUBMIT         submit a batch control file to the batch job processor.
  63.  
  64. TYPE           display the contents of a file on your terminal.
  65.  
  66. DDELETE        delete a single file quickly.
  67.  
  68. DDIRECT        list a single file quickly.
  69.  
  70. DRENAME        rename a single file quickly.
  71.  
  72. DSUBMIT        submit a single batch control file quickly.
  73.  
  74. FAL            enter FAL mode.
  75.  
  76. You may include the /USERID switch for each file  specification.   The
  77. /USERID  switch  can be included in your SWITCH.INI file after the NFT
  78. command.  The /USERID switch requires up to  three  arguments  in  the
  79. following format:
  80.  
  81.      /USERID:userid:account:password
  82.  
  83. Each argument corresponds to  account  information  for  the  specific
  84. system.   If you do not include some of the arguments, NFT will prompt
  85. you for them.  The userid may be your PPN  or  user  name,  optionally
  86. enclosed  in <> or [].  The account can be omitted if defaulted by the
  87. system, but you  must  include  the  colon  (:)  if  you  specify  the
  88. password.
  89.  
  90. Other general switches that can be specified for any NFT command are:
  91.  
  92. /[NO]MOAN      see warning messages about problems.
  93.  
  94. /[NO]OKERROR   prevent NFT from aborting the command on an error
  95.  
  96. /TOTALS:arg    control  the  information  in   the   totals   summary.
  97.                Arguments  are:   BITS,  BYTES, WORDS, RECORDS, BLOCKS,
  98.                PAGES, FILES, BAUD, and ERRORS.
  99.  
  100. The COPY and TYPE commands accept certain switches that apply only  to
  101. these operations.  Those switches are:
  102.  
  103. /[NO]ARROW     convert control characters to up-arrow format.
  104.  
  105. /[NO]BAUD      show the baud rate of the transfer in the summary.
  106.  
  107. /[NO]CONCAT    concatenate (combine) the input files into  one  output
  108.                file.
  109.  
  110. /CRLF:nn       specify    the    column    at    which    to     place
  111.                carriage-return/line-feed characters into the file.
  112.  
  113. /[NO]CSN       place card sequence numbers on each line in the file.
  114.  
  115. /CSNCOL:nn     specify starting column for card sequence numbers.
  116.  
  117. /CSNINC:nn     specify  the  incremental  value  for   card   sequence
  118.                numbers.
  119.  
  120. /CSNWID:nn     specify the number  of  digits  in  the  card  sequence
  121.                numbers.
  122.  
  123. /DIAL:number   dial the phone number that you specify.
  124.  
  125. /EBCDIC        read data in EBCDIC format.
  126.  
  127. /FLAG:arg      specify the type of characters to flag.  The  arguments
  128.                are  UPPER  and  LOWER.   NFT will place a single-quote
  129.                character  (')  before  each  uppercase  or   lowercase
  130.                character.
  131.  
  132. /[NO]LSN       generate line sequence numbers for each line (record).
  133.  
  134. /[NO]LSNCON    continue line sequence numbers over page boundaries.
  135.  
  136. /LSNINC:nn     specify  the  incremental  value  for   line   sequence
  137.                numbers.
  138.  
  139. /[NO]NULLS     preserve ASCII null characters in the file.
  140.  
  141. /[NO]SPACES    convert  ASCII  tab   characters   into   ASCII   space
  142.                characters.
  143.  
  144. /[NO]TABS      convert multiple spaces into tab characters.
  145.  
  146. /[NO]TRUNCA    suppress trailing ASCII blanks (spaces, tabs).
  147.  
  148. /WRAP:nn       insert a carriage-return/line-feed for the first  space
  149.                or tab after the specified number of characters on each
  150.                line.
  151.  
  152. For more on-line information about  the  NFT  program,  refer  to  the
  153. NFT.MAN  file  distributed  with DECnet-10.  Use of the NFT program is
  154. documented in the DECnet-10 User's Guide.
  155.  
  156.             Accessing Files On Different Types of Systems
  157.  
  158.                        File Generation Numbers
  159.  
  160. Although TOPS-10 does not support file generation  numbers,  NFT  does
  161. accept  them.   The  generation  number  is  always  preceded by a "."
  162. character (yes, even if a VAX or a RSX or other system which  normally
  163. uses  ";").   Naturally, this requirestht the generation number must
  164. follow  the  file  extension  (which  is  also  preceded  by   a   "."
  165. character!).
  166.  
  167.                            TOPS-10 systems
  168.  
  169. In general, you need do nothing special in order  to  talk  to  remote
  170. TOPS-10  nodes with NFT-10.  Files will automatically be copied in all
  171. the right modes, protections, and so on.
  172.  
  173. FAL-10 will default the userid to a generic "network"  userid  if  the
  174. remote accessor doesn't supply one explicitly.  As such, if you access
  175.  
  176. the -10 from a remote node, you may not need to give a userid  if  the
  177. file  you  are  accessing is sufficiently unprotected (e.g., to read a
  178. file on a -10 generally doesn't require a userid, to write a file on a
  179. -10 generally does).
  180.  
  181.                            TOPS-20 systems
  182.  
  183. In general, you need do nothing special in order  to  talk  to  remote
  184. TOPS-20  nodes  with  NFT-10.  Files will automatically be copied in a
  185. fair semblance of the original file (7-bit files  will  be  copied  as
  186. ASCII  files,  all  others will be copied as 36-bit binary (or IMAGE))
  187. files.  Non-contiguous files cannot be copied.
  188.  
  189.                              RSX systems
  190.  
  191. In general, ASCII files copy correctly from the RSX  with  no  special
  192. action  required  on  behalf  of the user.  Sometimes however you will
  193. have to explicitly specify /ASCII (clue:  if you get the error message
  194. "Illegal  ASCII  record  attributes  for  IMAGE/BINARY  data" you must
  195. specify /ASCII).
  196.  
  197. To read or write binary files however is a pain.  To read a RSX binary
  198. file,  you  must  specify  that the file is binary (/BINARY), and what
  199. size bytes it has (/BYTESIZE:8).  In  general,  you  do  not  need  to
  200. supply any record formatting information.
  201.  
  202. To store a RSX binary file on the -10 in such a way that you can  give
  203. it back to the RSX and have the RSX be able to understand it, you must
  204. use MACY11 format.  Simply put /MACY11 on the -10 file  spec  and  all
  205. (well, the binary file anyway) will work well.
  206.  
  207. To write a RSX binary file, you mus speify that the file  is  binary
  208. (/BINARY),  what  size  bytes  it  has (/BYTESIZE:8), and what type of
  209. records the file should contain (/RECFORMAT:  FIXED or VARIABLE).   If
  210. FIXED  length  records  are  specified, then you must also specify the
  211. record size explicity (/RECSIZE:size).  Additionally, some RSX  binary
  212. files  require that they be contiguous on the disk (/CONTIGUOUS).  RSX
  213. task images (.TSK files) are of this sort.  If  contiguous  allocation
  214. is  required  then  the  file allocation must be prespecified - either
  215. explicitly via /ALLOCATE (or /ESTIMATE) or implicitly via the  "input"
  216. file allocation.  In the later case the /BLOCKSIZE switch must be used
  217. to enable NFT to convert the input file size  into  the  corresponding
  218. output file size (measured in "blocks").
  219.  
  220. For example:
  221.  
  222. *TYPE RSX::PROG.FOR
  223. *COPY FOO = RSX::PROG.FOR
  224. *COPY RSX::PROG.FOR = FOO.FOR
  225. *COPY FOO/MACY11 = RSX::PROG.OBJ/BINARY/BYTESIZE:8
  226. *COPY RSX::PROG.OBJ/BIN/BYT:8/RECFORMAT:VARIABLE = FOO.OBJ/MACY11
  227. *COPY FOO/MACY11 = RSX::PROG.TSK/BINA/BYTES:8
  228. *COPY RSX::/BIN/BYT:8/FIX/EC:512/BLOC:512/CONTI = FOO.TSK/MACY
  229.  
  230.                              VAX systems
  231.  
  232. Overall, VAX  systems  are  pretty  much  indistinguishable  from  RSX
  233. systems (as described above).
  234.  
  235.  
  236. .KJOB
  237. .
  238.