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 / backup.hlp < prev    next >
Text File  |  1995-04-05  |  14KB  |  330 lines
  1. Commands to BACKUP are in the form of verbs.  BACKUP prompts with a "/",
  2. and has three kinds of verbs:
  3.  
  4.      1.  Action
  5.  
  6.      2.  Status setting
  7.  
  8.      3.  Tape positioning.
  9.  
  10.  
  11. The action verbs are:
  12.  
  13. SAVE spec-list          save the specified disk files on tape
  14. RESTORE spec-list       restore the specified files from tape to disk
  15. CHECK spec-list         verify that the disk and tape files agree
  16. [N]PRINT spec           print a directory of the entire tape on spec
  17.  
  18. The action verbs perform I/O and operate on the tape  specified  by  the
  19. last  TAPE  verb  (one  of  the  status  setting verbs).  A tape must be
  20. specified before using any of the action commands.
  21.  
  22. The action commands  take  as  an  optional  argument  a  list  of  file
  23. specifications  in the standard format of dev:filename.ext[directories].
  24. The file specifications may have wild cards.  The user may specify  both
  25. an  input and an output side (output=input) or just the input file spec.
  26. This allows files to be renamed as they are  saved  or  restored.   File
  27. spec entries in the list ar separated by commas.
  28.  
  29. If no argument is supplied with an action command BACKUP will default  a
  30. file  spec in the following way.  The default file spec for the operator
  31. is ALL:*.*[*,*,*,*,*,*].  This specifies all files on all UFDs  and  all
  32. SFDs of all file structures with no renaming.
  33.  
  34. For a user not logged in under [1,2] the default for all action verbs is
  35. ALL:*.*[PPN,*,*,*,*,*]  where PPN is the user's PPN.  This specifies all
  36. files in the user's areas to be saved with a disk  structure  specified,
  37. and restored to the appropriate structure.
  38.  
  39. The argument for the PRINT verb is a single file spec.  Its  default  is
  40. LPT:BACKUP.LOG.
  41.  
  42. Note that you can specify one or more fields of a file spec.  The  field
  43. that  you  specify will supersede the corresponding field in the default
  44. file spec.  The file spec fields are  the  file  name,  file  extension,
  45. structure  name,  and  directory  area specification.  Therefore, if you
  46. specify only [PPN], it will be substituted  for  the  default  directory
  47. area.   Under  no  circumstances do the file spec fields become "sticky"
  48. parameters, e.g.  specifying the PPN for one spec does NOT carry over to
  49. the next spec in the list.
  50.  
  51. BACKUP will read command files.  The command:
  52.  
  53. /@filespec
  54.  
  55. will cause the commands contained in filespec to be read and performed.
  56.  
  57.  
  58. The status setting commands set a parameter which affects future  action
  59. commands.   Once  a  status parameter is set, it remains in effect until
  60. changed  by  the  user.   The  format   for   date/time   arguments   is
  61. DD-MMM-YY:HH:MM:SS.  The status setting commands are:
  62.  
  63. ABEFORE date            include only files accessed before date
  64. [NO]APPEND              append to log file (default)
  65. ASINCE date             include only files accessed since date
  66. BEFORE date-time        include only  files  last  created  or  modified
  67.                         before date-time
  68. [NO]CPOINT              use checkpointing
  69. [NO]DATE75              always  accept  files   with   possible   DATE75
  70.                         problems (default)
  71. [NO]DELETE              delete disk files after saving them
  72. DENSITY (200,556,800,1600,6250)
  73.                         set tape density
  74. [NO]DIRECTORIES         type each directory while running (default)
  75. [NO]ENCRYPTION          encrypt the mag tape (asks for key later;  a key
  76.                         is  similar  to a password and may have up to 30
  77.                         characters)
  78. [NO]EXEMPT              exempt PPNS of the form [A,*] and [*,B] where  A
  79.                         and   B   .LE.   7  from  date/time  and  length
  80.                         restrictions (default)
  81. [NO]FILES               type each file name while running
  82. INITIAL spec            start processing at spec
  83. [NO]INTERCHANGE         run in INTERCHANGE mode (ignore system dependent
  84.                         data)
  85. LENGTH l:h              include only files whose length is between l, h
  86. [NO,N]LIST spec         while running, make a listing on  spec  (default
  87.                         spec   is  LPT:BACKUP.LOG).   The  N  prefix  is
  88.                         similar to that of the PRINT verb.
  89. MBEFORE date-time       include only files moved before date-time
  90. MESSAGE [NO]PREFIX      suppress error message prefix
  91. MESSAGE [NO]FIRST       suppress error message first text line
  92. MSINCE date-time        include only files moved since date-time
  93. [NO]MULTIREEL           allow multiple reels on save (default) (multiple
  94.                         reels on a RESTORE are always permitted)
  95. [NO]NFS                 allow user to  ignore  RP.NFS  rib  status  (i.e
  96.                         dumps)
  97. OPTION name             use option BACKUP:name from SWITCH.INI
  98. PARITY (EVEN,ODD)       set tape parity
  99. [NO]REPEAT              repeat a split file on the continuation tape
  100. RESET                   reset all status parameters
  101. RESUME n                start at block n of initial file
  102. [NO]SDELETE             delete   disk   files   after    saving    them,
  103.                         irrespectie of owner protection
  104. SILENCE                 suppress directory and file name  typeout  while
  105.                         running
  106. SINCE date-time         include only files  created  or  modified  since
  107.                         date-time
  108. SORT DIRECTORY x        sort directories within each file  structure  in
  109.                         order x when saving (x = ALPHABETICAL, LOCATION,
  110.                         or NONE)
  111. SORT FILES x            sort files within each directory in order x when
  112.                         saving (x = ALPHABETICAL, LOCATION, or NONE)
  113. SSNAME a                save-set name is a (up to 30 chars;  use  quotes
  114.                         to include non-alphabetics;  ALL = all save sets
  115.                         on tape)
  116. SUPERSEDE ALWAYS        always restore file from tape
  117. SUPERSEDE NEVER         restore file from tape unless already on disk
  118. SUPERSEDE OLDER         restore  from  tape  if  disk  file   is   older
  119.                         (default)
  120. TAPE MTAX               use tape unit MTAX
  121. TPNUMB                 set the tape number to x (decimal).
  122. UPROTECTION nnn         set protection of all created directories
  123. [NO]USAGE               enable USAGE Accounting
  124. [NO]USETI               use super-USETI (faster saves with /SINCE, etc.)
  125. [NO]WRITE               suppress disk writing during a RESTORE
  126.  
  127.  
  128. BACKUP's tape positioning commands take immediate effect.  They  take  a
  129. list  of  tapes  as  an  argument.   If no tape is specified for a given
  130. command, the last tape declared with the TAPE verb is  positioned.   The
  131. tape positioning commands are:
  132.  
  133. EOT tape-list           skip to end of tape
  134. REWIND tape-list        rewind to beginning of tape
  135. SKIP n tape-list        skip n save sets forward
  136. SKIP 0 tape-list        backup to start of current save set
  137. SKIP -n tape-list       skip n save sets backward
  138. UNLOAD tape-list        unload tape from drive if  label  processing  is
  139.                         not  in  effect,  otherwise  this  command  is a
  140.                         no-op.
  141.  
  142.  
  143. Switches which may be included within the file  specification  list  for
  144. the action verbs are:
  145.  
  146. ABEFORE date          (input)   include file  only  if  accessed  before
  147.                                 date
  148. ASINCE date           (input)   include file only if accessed since date
  149. BEFORE date-time      (input)   include only if last created or modified
  150.                                 before date-time
  151. ERNONE                (input)   give error if no files match
  152. ERPROTECTION          (input)   give error if protection failure
  153. ERSUPERSEDE           (output)  do not restore file from tape if on disk
  154. ESTIMATE n            (output)  estimate output file size
  155. LENGTH l:h            (input)   include only if length is between l, h
  156. MBEFORE date-time     (input)   include only if moved before date-time
  157. MSINCE date-time      (input)   include only if moved since date-time
  158. OKNONE                (input)   no error if no files match
  159. OKPROTECTION          (input)   no error if protection failure
  160. OKSUPERSEDE           (output)  always restore file from tape
  161. [NO]PHYSICAL          (in/out)  ignore logical names
  162. PROTECTION nnn        (output)  set output file protection
  163. SINCE date-time       (input)   include  only  if  created  or  modified
  164.                                 since date-time
  165. [NO]STRS              (input)   if NO option is used,  only  save  files
  166.                                 which  exist  on  the first structure in
  167.                                 the Job Search List where a match occurs
  168.                                 (the default is STRS)
  169. VERSION v             (output)  set output file version
  170.  
  171.  
  172. The following run-time commands may be given while BACKUP  is  executing
  173. an action verb.  BACKUP prompts with an exclamation point (!) when ready
  174. to accept a run-time command.  Commands preceeded by an asterisk (*) may
  175. also be typed when the slash (/) prompt is given, any differences are in
  176. parenthesis.
  177.  
  178. *[NO]DIRECTORIES        start typing every directory processed
  179. *EXIT                   exit to  monitor  when  done  with  the  current
  180.                         action  (when  typed  to a slash prompt, exit to
  181.                         the monitor immediately)
  182. *[NO]FILES              start typing every file and directory processed
  183. GO                      continue from a STOP
  184. *HELP                   list these run-time commands (when  typed  to  a
  185.                         slash prompt, type this help text)
  186. KILL                    abort execution of the current action verb
  187. PAUSE                   return to command level when all done (default)
  188. *RESET                  reset all status parameters when all done  (when
  189.                         typed  to  a  slash  prompt,  reset  all  status
  190.                         parameters immediately)
  191. *SILENCE                stop typing every directory or file name
  192. STOP                    stop temporarily
  193. *WHAT                   display current file  name,  status  and  status
  194.                         parameters   (when  typed  to  a  slash  prompt,
  195.                         display status parameters)
  196.  
  197.  
  198. NOTE:  Tape rewinds are not automatic when running BACKUP.
  199.  
  200.  
  201.  
  202.  
  203. EXAMPLES:
  204.  
  205.  
  206. 1. SAVE spec-list       SAVE FROM DISK TO TAPE
  207.  
  208. One save set will be created on tape for each SAVE  command.   The  save
  209. set may be named by using the SSNAME status setting command.
  210.  
  211.  
  212.      A) Saving only recently accessed files
  213.  
  214. An operator may use BACKUP to save only those files accessed  today  and
  215. concurrently print a directory by typing:
  216.  
  217.           .R BACKUP
  218.           /TAPE MTA0
  219.           /LIST
  220.           /ASINCE:1-JUL-1975
  221.           /SSNAME "July 1 incremental"
  222.           /SAVE
  223.  
  224. A directory file named BACKUP.LOG will be spooled to LPT.
  225.  
  226.  
  227.      B) Recovering from a system crash
  228.  
  229. BACKUP's default typeout level is directories, so in the above  example,
  230. BACKUP  would type each UFD as it began to save files from that UFD.  If
  231. the system should crash during the save while BACKUP is in  the  process
  232. of  saving  files  from  UFD  [10,123] the operator could restart at UFD
  233. [10,123] after the system is brought up by typing:
  234.  
  235.           .R BACKUP
  236.           /TAPE MTA0
  237.           /LIST
  238.           /ASINCE:1-Jul-1975
  239.           /SSNAME "July 1 incremental"
  240.           /INITIAL [10,123]
  241.           /SAVE
  242.  
  243. Note that all the status parameters must be reset.  Note also  that  the
  244. tape should NOT be rewound.
  245.  
  246.  
  247.      C) Saving a user's disk area
  248.  
  249. A user may save his own disk area with BACKUP by typing:
  250.  
  251.           .R BACKUP
  252.           /TAPE MTA0
  253.           /SAVE
  254.           /^C
  255.  
  256. 2. RESTORE spec-list    RESTORE FROM TAPE TO DISK
  257.  
  258. If a save set has been named before this command is typed,  BACKUP  will
  259. restore  files only from the named save set.  To restore files from more
  260. than one save set, the save set name should be reset to ALL.
  261.  
  262.  
  263.      A) Restoring a set of files from a distribution tape
  264.  
  265. BACKUP format distribution tapes are made in interchange mode  to  avoid
  266. including  system dependent data, and related files are grouped together
  267. in named save sets.  To copy all files in the SCAN  save  set  to  DEC:,
  268. type:
  269.  
  270.           .R BACKUP
  271.           /TAPE MTA0
  272.           /INTERCHANGE
  273.           /SSNAME SCAN
  274.           /RESTORE DEC: = DSK:
  275.  
  276.  
  277.      B) Restoring individual files from a BACKUP tape
  278.  
  279. To Restore Files FOO.BAR and TST???.MAC saved under UFD  [10,123]  on  a
  280. BACKUP tape, type:
  281.  
  282.           .R BACKUP
  283.           /TAPE MTA0
  284.           /RESTORE [10,123]FOO.BAR, [10,123]TST???.MAC
  285.           /EXIT
  286.  
  287.  
  288. 3. [N]PRINT spec        PRINT DIRECTORY OF THE ENTIRE TAPE ON spec
  289.  
  290. The prefix N indicates  a  narrow  (72  column)  listing.   The  current
  291. directory  always  fits  within  72  columns (so NPRINT is equivalent to
  292. PRINT) but in the future a wider format which  includes  more  directory
  293. information  may be developed.  To create a directory file on disk named
  294. BACKUP.LOG type:
  295.  
  296.  
  297.           .R BACKUP
  298.           /TAPE MTA0
  299.           /PRINT DSK:
  300.  
  301. 4. CHECK spec-list      VERIFY THAT THE TAPE AND DISK AGREE
  302.  
  303. This command causes BACKUP to do a word by word comparison of  the  disk
  304. files  specified  by the output side and the tape files specified by the
  305. input side of the entries in the spec list.  For  example,  to  save  on
  306. tape  all  COBOL  files  and  then  verify that the saved tape files are
  307. identical to those on disk type:
  308.  
  309.           .R BACKUP
  310.           /TAPE MTA0
  311.           /SSNAME COBOL
  312.           /SAVE *.CBL
  313.           /REWIND
  314.           /CHECK *.CBL
  315.  
  316. To restore all EXE and MAC files from the same tape and then verify that
  317. the files were restored correctly type:
  318.  
  319.           /REWIND
  320.           /SSNAME ALL
  321.           /RESTORE *.EXE, *.MAC
  322.           /REWIND
  323.           /CHECK *.EXE, *.MAC
  324.           /^C
  325.  
  326. [End of BACKUP.HLP]
  327.  
  328. .KJOB
  329. .
  330.