NSWP - A disk maintenance utility. Dave Rand 10232 - 160 Street Edmonton, Alberta Canada T5P 3E9 .pa Š.he NSWP 2 - A disk maintenance utility .fo - # - I N D E X Page Introduction ........................ 3 Overview of NSWP ............... 4 Invoking NSWP .................. 5 Single file commands ................ 6 Help ........................... 7 Forward and Backward ........... 7 Exiting ........................ 8 Finding a file ................. 8 Viewing and Printing ........... 8 Deleting a file ................ 8 Copying ........................ 9 Renaming ....................... 9 The Space command .............. 11 The Log command ................ 11 Introduction to Multifile Commands .. 12 The Tag command ................ 12 Wildcard tagging ............... 13 The Untag command .............. 13 The Mass copy command .......... 13 After the mass (Again) ......... 14 Erasing files .................. 14 Squeezing and Unsqueezing files. 14 Setting file status ............ 15 Epilogue ............................ 16 Credits ............................. 16 Contributions ....................... 16 .pa ŠIntroduction NSWР ió ne÷ disë utilitù thaî caî replacå manù oæ thå  morå commoî utilitieó thaô arå used¬ sucè aó STAT¬ PIP¬ USQ¬ SQ¬ TYPE¬ PRINT¬  SWEEP¬  DISK7¬  PROT¬  anä  others®  Iî onlù 12Ë oæ disë space¬ iô replaceó oveò 100Ë oæ utilities! NSWÐ ió writteî entirelù iî assemblù language¬  anä wilì ruî oî anù CP/Í 2.x¬  3.ø oò MP/Í baseä systeí witè nï changes® Sincå iô ió codeä iî 808° assembler¬  anù 8080¬  808µ oò Z8° compatiblå processoò wilì serve® Notå thaô thió prograí WILÌ NOT‚ ruî oî CP/Í 1.4. Wheî  NSWР waó  conceived¬  thå dominanô filå  utilitù  waó SWEEP¬  anä thuó NSWÐ ió syntaø compatiblå witè SWEEP¬  buô  witè manù  extensions®  Thió  allowó  yoõ tï directlù renamå  NSWР tï SWEEP¬ iæ yoõ sï desire¬ witè nï retraininç period. É  hopå thaô yoõ enjoù thió program¬  anä uså iô  well®  Anù problems¬ oò suggestionó maù bå directeä tï myselæ aô thå addresó oî thå firsô page¬ oò oî onå oæ thå followinç RCP/Ms: Edmonton RCP/M - (403) 454-6093 (300 or 1200 baud) Stadium RCP/M - (403) 479-3450 (300 baud only) or voice at: (403) 484-4114 Disclaimer and warning Whilå thió prograí haó beeî testeä oî manù systems¬  É  wilì havå  nï  liabilitù  oò responsibiltù tï thå useò  oò  anù  otheò persoî  oò entitù witè respecô tï anù liability¬  losó oò  damagå caused¬  oò  alledgeä tï bå causeä directlù oò indirectlù bù thió program¬  including¬  buô  noô limiteä to¬  anù  interruptioî  oæ service¬  losó oæ business¬ anticipatorù profitó oò consequentiaì damageó resultinç froí thå uså oæ thió program. Furthermore¬  althougè thió prograí haó beeî placeä intï thå publiã domain¬  É retaiî alì copyrightó tï thió program¬  botè iî thå U.S.Á anä iî Canada¬  anä pursuanô tï this¬  thió prograí MAÙ NOÔ  BÅ  SOLÄ BÙ ANÙ PARTY unlesó specificallù authorizeä bù  thå author¬  Davå Rand¬  iî writing¬ previouó tï thå firsô copù beinç sold®  Aó  well¬  thió prograí MAÙ NOÔ BÅ INCLUDEÄ IΠ ANÙ  OTHEÒ PACKAGÅ FOÒ SALE¬  eveî iæ thió prograí ió indicateä aó beinç 'iî thå publiã domain'® Alì oæ thå abovå applieó tï botè thå originaì aó  welì  aó derived¬  oò modifieä copieó oæ  thå  original®  Anù modifieä  copieó  oæ  thió prograí MUSÔ NOÔ  havå  thå  copyrighô noticå violated¬ changeä oò altered. Pleaså reporô anù copyrighô violationó tï thå author¬ aô onå of the above telephone numbers. Thank you. .pa Š NSWP Overview NSWÐ ió á directorù anä filå manipulatioî program®  Witè it¬ yoõ caî copy¬  delete¬  rename¬  unsqueezå anä squeezå files® Thå documentatioî  followinç  ió  spliô intï twï  majoò  sectionsº  Á tutoriaì  foò thå inexperienced¬  anä á  referencå  section®  Thå referencå  normallù wilì bå useä iî conjunctioî witè thå  prograí tï  answeò specifiã questionó regardinç NSWP®  Thå tutoriaì ió  á broaä  coveragå  oæ  alì oæ thå functions¬  anä  shoulä  bå  reaä througè aô leasô once. Thå mosô importanô thinç tï remembeò wheî usinç NSWÐ ió thaô iô  provideó á lisô oæ youò fileó iî ALPHABETICAÌ  order®  Movinç arounä  iî thió lisô ió quitå easy¬  anä wilì sooî becomå  seconä nature. Iî  thió  documentation¬  alì useò inpuô ió  underlined®  Aó well¬   wheî   thå   "current¢  filå  ió   referenceä   iî   thió documentation¬  iô meanó thå filå jusô tï thå lefô oæ youò input® Thió  "current¢  filå  ió ofteî referreä tï aó thå filå  yoõ  arå "on". .pa Š Invoking NSWP Tï  makå effectivå uså oæ NSWP¬  yoõ musô kno÷  thå  variouó optionó  availablå tï yoõ wheî yoõ invokå NSWP®  Herå arå somå oæ thå options: A>NSWP Thió  formaô simplù loadó NSWP¬  anä scanó thå defaulô drivå anä  useò foò filenames®  Oncå insidå NSWP¬  yoõ maù changå tï  á differenô  drivå  and/oò  user¬  buô wheî yoõ exiô  yoõ  wilì  bå returneä tï thå drive/useò thaô yoõ calleä NSWÐ from. A>NSWP *.COM Thió formaô loadó NSWÐ anä scanó thå currenô drivå anä  useò foò  alì filenameó witè thå extensioî "COM"®  Notå thaô NSWР caî finä  systeí fileó aó well¬  sï nï additionaì informatioî neeä bå given. A>NSWP B:*.COM * Thå  presencå oæ thå seconä asterisë indicateó tï NSWР thaô yoõ wisè tï scaî alì useò areaó oæ thå indicateä disë  drive®  Iî thió case¬ alì "COM¢ fileó oî alì useò areaó oî drivå B. Combinationó  oæ thå abovå arå acceptable¬  anä yoõ maù eveî loç tï alì useò areas¬  anä finä alì fileó witè thå specificatioî "*.ª *". Oncå  insidå  NSWÐ yoõ arå presenteä witè  á  menu¬  theî  á reporô oæ whicè drivå anä useò yoõ arå loggeä to¬  ho÷ mucè spacå ió  takeî  bù thå fileó yoõ havå specified¬  ho÷ manù fileó  havå beeî founä witè thå specificationó given¬  anä ho÷ mucè spacå  ió lefô oî thå disk® Á samplå follows: Drive A0: 596K in 36 files. 735K free. Á  speciaì formaô oæ thió linå showó thaô yoõ arå loggeä  tï alì useò areas: Drive B*: 950K in 234 files. 2956K free. From this point, you may execute any of the menu options. Á  speciaì  displaù  occuró iæ nï fileó arå founä  witè  thå specificatioî  yoõ havå given¬  oò iæ therå arå nï fileó  iî  thå giveî drive/useò area(s): No files. Thió  displaù maù alsï occuò iæ yoõ deletå alì thå fileó ouô oæ á giveî specification® Wheî thió occurs¬ youò menõ choiceó arå limiteä tï ONLÙ S¬  L¬  oò X®  Thió allowó yoõ tï seå thå  freå Spacå oî á drive¬  tï Loç tï anotheò drive/user¬  oò tï eXit®  Nï other choices are valid, nor will they be accepted. .pa ŠCommanä Structure Therå arå twï primarù typeó oæ commandó iî NSWPº  thoså thaô acô  oî  onå filå anä thoså thaô acô oî manù files®  Wå  wilì  gï througè  theí both®  Beforå doinç thaô though¬  let'ó trù  movinç arounä iî NSWÐ first. Tï movå iî NSWP¬ yoõ musô firsô understanä thaô thå fileó oî youò  selecteä  drive/useò wilì bå presenteä tï yoõ iî  á  sorteä manner®  Thå  fileó  arå sorteä iî  thió  orderº  Filename¬  Filå extension¬ useò area: 1. B0: -WORK .001 0K : 2. B0: ARCADD .COM 4K : 3. B0: ARCCOPY .COM 2K : Aó yoõ caî see¬ thå fileó arå numbereä foò youò convenience® Yoõ maù noô directlù uså theså numbers®  Aó yoõ caî see¬ thå filå sizå ió alsï showî (roundeä tï thå nearesô blocë size). Notå  thaô  iæ yoõ havå enableä thå reverså  videï  sequencå (seå  Epilog)¬  yoõ  maù seå somå oæ thå letteró iî thå  filenamå printeä  iî reverså video®  Thå charô belo÷ showó ho÷  tï  decodå thió information® FFFFFFFF RSA 12345678 /YR |||||||| OSC 4. B0: ARCDEL .COM 2K : Aó yoõ caî see¬  thió lookó confusing® Really¬ though¬ iô ió not®  Thå  tagó F1-F¸ normallù arå noô used¬  buô NSWÐ allowó yoõ seô F1-F´ foò youò owî use®  Thå R/Ï taç meanó thaô thå filå  maù bå read¬ buô noô writteî to® Thå SYÓ taç meanó thaô thå filå doeó noô appeaò iî normaì DIÒ listings¬ anä iî CP/Í 3¬ MPÍ anä CP/Í 8¶ alsï meanó thaô thió filå ió avaiablå tï alì useò areas®  Thå ARà taç meanó that¬  iæ set¬ thå filå haó beeî backeä uð sincå iô waó last accessed. No÷ thaô yoõ understanä ho÷ fileó arå presented¬  wå caî  gï througè á samplå session® Remember¬ useò inpuô ió underlined. .pa ŠA>nswp b: NSWEEP - Version 2.xx 10/22/1983 (c) Dave Rand, 1983 Edmonton, Alberta Drive B0: 850K in 64 files. 118K free. 1. B0: -WORK .001 0K :  2. B0: ARCADD .COM 4K :  3. B0: ARCCOPY .COM 2K :  4. B0: ARCDEL .COM 2K :  5. B0: ARCDIR .COM 2K : b 4. B0: ARCDEL .COM 2K : b 3. B0: ARCCOPY .COM 2K : b 2. B0: ARCADD .COM 4K : b 1. B0: -WORK .001 0K : x A> Help Aô anù point¬ yoõ maù requesô thå maiî helð menõ bù pressinç '?'. 1. B0: -WORK .001 0K : ? NSWEEP - Version 2.xx 10/22/1983 (c) Dave Rand, 1983 Edmonton, Alberta A - Retag files | Q - Squeeze/Unsqeeze tagged files B - Back one file | R - Rename file(s) C - Copy file | S - Check remaining space D - Delete file | T - Tag file for transfer E - Erase T/U files | U - Untag file F - Find file | V - View file L - Log new disk/user | W - Wildcard tag of files M - Mass file copy | Y - Set file status. P - Print file | ? - Display this help X - Exit to CP/M | cr, sp - Forward one file Moving forward and backward Aó yoõ caî see¬  thå twï mosô commoî commandó wilì bå movinç forwarä anä backwardó througè thå directory® Eitheò thå SPACÅ baò ()¬  oò thå RETURÎ keù (© maù bå useä tï movå forward® Tï movå backwards¬ simplù uså thå 'B§ key® Notå thaô alì commandó iî NSWÐ caî bå eitheò iî uppeò oò lowercase®  Internally¬  lowercaså wilì  bå  converteä  tï uppercase®  Iæ yoõ reacè thå enä  oæ  thå directorù  witè eitheò command¬  yoõ wilì bå "wrappeä around¢  tï thå otheò enä automatically. ŠExiting Tï exit¬  jusô uså thå 'X§ commanä aó showî above® Thió wilì returî yoõ tï thå samå drivå anä useò areá thaô yoõ invokeä  NSWÐ from¬ regardlesó oæ anythinç yoõ maù havå donå iî NSWP. Finding a file Sincå yoõ maù havå manù hundredó oæ fileó selected¬  yoõ maù wisè  tï  movå  rapidlù tï á particulaò file®  Yoõ  maù  dï  thió througè thå 'F'¬ oò FINÄ command. 1. B0: -WORK .001 0K : f Which file? BASCOM 8. B0: BASCOM .COM 32K : Thå  Finä  commanä alwayó startó lookinç froí  entrù  numbeò one® Yoõ maù uså thå standarä CP/Í syntaø foò wildcardinç (egº tï finä thå firsô .HEØ file¬  yoõ maù uså *.HEX)¬ anä alsï notå thaô thå  Finä commanä wilì filì alì blanë spaceó witè questioî marks® Thió  makeó thå searcè stringó "B*.*"¬  "B"¬  anä "B??????.¢  alì finä thå firsô filå beginninç witè "B"®  Aó yoõ  experiment¬  yoõ wilì finä otheò interestinç useó foò thió command. Aô  thió  point¬  yoõ  no÷  kno÷ ho÷ tï  movå  througè  youò directory¬  botè rapidlù anä onå steð aô á time® Let'ó movå oî tï somå morå usefuì commands. Viewing and Printing a file Thå Vie÷ command¬  invokeä witè á 'V'¬ wilì typå thå currenô filå ontï thå screen¬ unsqueezinç thå filå iæ required® Notå thaô thió commanä wilì NOÔ prevenô yoõ froí listinç ANÙ typå oæ  file¬ sï  yoõ  musô  uså youò owî judgemenô oî whaô caî anä  cannoô  bå listed®  Aô thå enä oæ eacè pagå oî thå screen¬  vie÷ wilì  stop¬ anä allo÷ yoõ tï aborô thå viewinç witè á ^à oò á ^X®  Tï geô onå morå linå froí thå file¬  hiô thå spacå bar® Tï geô anotheò page¬ hiô thå B0: BRUN .COM to A14: with verify Verifying --> file ok. Thå  Ö ió optional¬  anä iô indicateó thaô yoõ wisè tï  havå thå filå verifieä afteò iô ió written. Aó  yoõ caî see¬  thå fileó havå beeî senô tï drivå A¬  useò 14®  Iæ yoõ wisè thå taggeä fileó tï residå iî thå samå useò areá aó thå sourcå fileó afteò thå copy¬ dï noô specifù á useò areá iî thå  Masó command®  Thió wilì causå NSWÐ tï puô thå filå  iî  thå samå useò areá aó thå sourcå file. NSWÐ wilì noô allo÷ yoõ tï copù á filå tï thå samå drivå anä useò areá aó thå source® Thå copù ió simplù noô made. .pa ŠAfter the mass Afteò anù masó filå operation¬  thå tagó arå "reset¢ aó eacè filå ió copied®  Visually¬  theù changå froí á "*¢ tï á "#"®  Thå fileó  arå  logicallù untagged¬  anä wilì responä aó  such®  But¬ sincå  NSWР rememberó them¬  yoõ caî automaticallù  retaç  theså files®  Thió ió usefuì if¬ foò example¬ yoõ neeä tï copù thå samå fileó  tï  á  numbeò oæ differenô disketteó oò useò  areaó  oî  á drive® Tï invokå this¬ uså thå "A¢ command. 12. B0: CDP1 . 40K : a Retagging--> B0: BRUN .COM Tagged files = 16K ( 16K) Erasing files Yoõ maù wanô tï copù á grouð oæ files¬ theî deletå theí froí thå sourcå disë afteò thå copù haó beeî made® Tï dï this¬ yoõ caî uså eitheò thå "C¢ commanä tï copy¬  followeä bù thå "D¢ command¬ whicè ió tedious¬  oò á combinatioî oæ thå "T"¬ "M"¬ "A"¬ anä thå "E¢ commands®  Thå Å commanä Eraseó taggeä oò untaggeä files¬  aô youò option¬ oî á globaì scale. 12. B0: CDP1 . 40K : e Erase Tagged or Untagged files (T/U)? t Do you wish to be prompted (Y/N/A)? n Deleting --> B0: BRUN .COM Iæ  yoõ specifù Untaggeä files¬  thå untaggeä fileó wilì  bå erased®  Yoõ  maù wisè tï bå prompteä beforå eacè filå ió  tï  bå deleted¬ anä yoõ caî dï thió viá thå seconä question. Squeezing and Unsqueezing files Thå  'Q§ commanä allowó yoõ tï Squeezå anä Unsqueezå  taggeä files®  Thió filå squeezå prograí ió compatiblå witè thå originaì squeeze/unsqueezå programó writteî iî thå 'C§ languagå bù Richarä Greenlaw® After hitting Q, you will see the prompt: Squeeze, Unsqueeze or Reverse (S/U/R)? Afteò  answerinç thió skill-testinç question¬  yoõ  wilì  bå askeä  whicè drive/useò yoõ wisè tï placå thå destinatioî  files® Thå syntaø herå ió thå samå aó foò thå Movå command¬ excepô iô ió permissiblå  tï  'Q§ thå fileó bacë tï thå samå  drive/useò  thaô they originated. .pa Š Wheî  Ñ ió invoked¬  yoõ arå askeä iæ yoõ wisè  tï  Squeeze¬ Unsqueezå  oò Reverse®  Á carriagå returî herå wilì returî yoõ tï thå commanä linå oæ NSWP® Iæ  yoõ  selecô  Ó foò Squeeze¬  alì taggeä  fileó  wilì  bå examineä  tï  seå  iæ iô ió "worth¢ squeezinç  them®  Fileó  thaô exibiô ANÙ spacå reduction¬  eveî iæ iô ió onlù onå sector¬  wilì bå squeezed® Iæ thå fileó ió noô "worth¢ squeezing¬ thå filå wilì simplù bå copieä tï thå destinatioî drive/user. Iæ  yoõ  selecô Õ foò Unsqueeze¬  alì taggeä fileó  wilì  bå examineä tï seå iæ theù arå squeezed®  Iæ theù are¬  theù wilì bå unsqueezed¬  anä moveä tï thå destinatioî drive/user® Iæ theù arå not squeezed, then they are simply copied. Iæ  yoõ selecô Ò foò Reverse¬  alì fileó thaô  arå  squeezeä wilì  bå  unsqueezed¬  anä alì fileó thaô arå unsqueezeä wilì  bå squeezeä  (iæ  iô  ió wortè it)¬  anä moveä  tï  thå  destinatioî drive/user. Thå  mosô attractivå featurå oæ thå Ñ commanä iî generaì  ió thå abilitù tï Squeezå fileó ONLÙ iæ iô ió "worth¢ it® Thió meanó thaô  bù  usinç  NSWP¬  yoõ caî archivå datá  intï  thå  absolutå minimuí amounô oæ spacå possible®  Thå SÑ algorithí useä iî NSWÐ ió  betteò thaî thå onå iî thå originaì à squeezer¬  anä produceó the smallest output file possible with current technology. Thå filå squeezeò sectioî waó donå bù Jií  Lopushinsky¬  anä ió  copyrighteä  separatelù bù him®  Hå alsï haó á publiã  domaiî standalone squeezer, call NSQ. Setting the tagged files status Yoõ  maù seô thå attributeó oæ á grouð oæ taggeä fileó  jusô likå STAT¬ oò PROT® Tï dï this¬ taç thå files¬ anä selecô thå "Y¢ command. 12. B0: CDP1 . 40K : y Which flags (1-4,R,S,A)? r,s Setting ---> B0: BRUN .COM to R/O SYS Thå  flagó yoõ maù seô arå thå F1-F´ flags¬  aó welì aó  thå Reaä Only¬  System¬  anä Archivå (MP/M¬  CP/Í ³ only© flags®  Anù flagó  yoõ dï noô specifù wilì bå reset®  Tï reseô alì thå  flagó (IEº  Changå tï R/W¬ DIÒ anä nï "Sysoð tag")¬ jusô enteò á singlå commá oò spacå aô thå "Whicè flags¢ prompt®  Notå thaô thå  flagó iî  thå  "Whicè flags¢ questioî dï noô havå tï bå entereä witè  á commá betweeî them¬  aó anythinç (oò nothinç aô all!© wilì do® Aó faò aó thå prograí ió concerneä "RSA"¬  "Ò Ó A"¬ anä "R,Ó A¢ arå alì valid. .pa Š Epilogue Alì thå functionó oæ NSWÐ havå no÷ beeî described®  Thå besô waù tï geô morå familiaò witè thå prograí ió tï actuallù USÅ  it® É thinë iô wilì bå onå oæ youò mosô frequentlù useä programs. Therå  arå severaì thingó iî thió versioî thaô yoõ wilì wanô to alterº 103H Thió bytå controló thå screeî lengtè useä iî thå "V"ie÷  command® Iô ió currentlù seô tï 23Ä (17H). 104H-10AH - Turn reverse video on Thå firsô bytå iî thió sequencå oæ seveî showó thå lengtè oæ  thå reverså  videï oî sequence¬  whicè followó aô locatioî 105H®  Alì seveî byteó arå currentlù seô tï zero. 10BH-111H - Turn reverse video off Thå  firsô bytå iî thió seqencå oæ seveî showó thå lengtè oæ  thå reverså videï ofæ sequence¬  whicè followó aô locatioî 10DH®  Alì seven bytes are currently set to zero. Credits Mù  thankó  tï  alì  whï madå  thió  prograí  possible¬  anä especiallù  tï  Davå  Mccradù  foò  hió  helð  iî  composinç  thå documentatioî  anä .HLÐ fileó foò NSWP®  Thankó alsï goeó tï  Jií Lopushinsky¬  alsï oæ Edmonton¬  sincå withouô hií thå SÑ sectioî oæ NSWÐ mighô neveò havå beeî completed¡ Thankó tï thå uså oæ hió SQ section, NSWP can produce the smallest possible SQ'ed files. Contributions Iæ yoõ like¬ uså anä enjoù thió program¬ feeì freå tï senä á contributioî  (suggesô  $20)®  Thió  wilì helð  må  expanä  thió program¬  anä adä eveî morå features® É aí currentlù workinç oî á CP/Í 8¶ version¬ anä oncå thaô ió running¬ É intenä tï porô iô tï MSDOS®  Suggestionó foò enhancemenô arå alsï appreciated¬ anä yoõ maù senä theí to: Dave Rand 10232 - 160 Street Edmonton, Alberta CANADA T5P 3E9