CBM Funet Archive/cbm-funet-archive-2003.iso/cpm/archivers/nswp207.arc/S.DOC

Text File | 1993-03-26 | 29KB | 977 lines

               nswp - a DISK MAINTENANCE UTILITY.



                            dAVE rAND

                       10232 - 160 sTREET

                        eDMONTON, aLBERTA

                             cANADA

                             t5p 3e9









































































































                              - 1 -

                            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





























































                             - 2 -

iNTRODUCTION



     nswp  IS NEW DISK UTILITY THAN CAN REPLACE MANY OF THE  MORE

COMMON UTILITIES THAT ARE USED, SUCH AS stat, pip, usq, sq, type,

print, sweep, disk7, prot, AND OTHERS. iN ONLY 12k OF DISK SPACE,

IT REPLACES OVER 100k OF UTILITIES!



     nswp IS WRITTEN ENTIRELY IN ASSEMBLY LANGUAGE,  AND WILL RUN

ON ANY cp/m 2.X,  3.X OR mp/m BASED SYSTEM WITH NO CHANGES. sINCE

IT IS CODED IN 8080 ASSEMBLER,  ANY 8080,  8085 OR z80 COMPATIBLE

PROCESSOR WILL SERVE. nOTE THAT THIS PROGRAM will not RUN ON cp/m

1.4.



     wHEN  nswp  WAS  CONCEIVED,  THE DOMINANT FILE  UTILITY  WAS

sweep,  AND THUS nswp IS SYNTAX COMPATIBLE WITH sweep,  BUT  WITH

MANY  EXTENSIONS.  tHIS  ALLOWS  YOU TO DIRECTLY RENAME  nswp  TO

sweep, IF YOU SO DESIRE, WITH NO RETRAINING PERIOD.



     i  HOPE THAT YOU ENJOY THIS PROGRAM,  AND USE IT  WELL.  aNY

PROBLEMS, OR SUGGESTIONS MAY BE DIRECTED TO MYSELF AT THE ADDRESS

ON THE FIRST PAGE, OR ON ONE OF THE FOLLOWING rcp/mS:



eDMONTON rcp/m - [phone] (300 OR 1200 BAUD)

sTADIUM rcp/m  - [phone] (300 BAUD ONLY)



OR VOICE AT:

[phone]



                     dISCLAIMER AND WARNING

     wHILE THIS PROGRAM HAS BEEN TESTED ON MANY SYSTEMS,  i  WILL

HAVE  NO  LIABILITY  OR RESPONSIBILTY TO THE USER  OR  ANY  OTHER

PERSON  OR ENTITY WITH RESPECT TO ANY LIABILITY,  LOSS OR  DAMAGE

CAUSED,  OR  ALLEDGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY THIS

PROGRAM,  INCLUDING,  BUT  NOT LIMITED TO,  ANY  INTERRUPTION  OF

SERVICE,  LOSS OF BUSINESS, ANTICIPATORY PROFITS OR CONSEQUENTIAL

DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.



     fURTHERMORE,  ALTHOUGH THIS PROGRAM HAS BEEN PLACED INTO THE

PUBLIC DOMAIN,  i RETAIN ALL COPYRIGHTS TO THIS PROGRAM,  BOTH IN

THE u.s.a AND IN cANADA,  AND PURSUANT TO THIS,  THIS PROGRAM may

not  be  sold by any party UNLESS SPECIFICALLY AUTHORIZED BY  THE

AUTHOR,  dAVE rAND,  IN WRITING, PREVIOUS TO THE FIRST COPY BEING

SOLD.  aS  WELL,  THIS PROGRAM may not be included in  any  other

package for sale,  EVEN IF THIS PROGRAM IS INDICATED AS BEING 'IN

THE PUBLIC DOMAIN'. aLL OF THE ABOVE APPLIES TO BOTH THE ORIGINAL

AS  WELL  AS DERIVED,  OR MODIFIED COPIES OF  THE  ORIGINAL.  aNY

MODIFIED  COPIES  OF  THIS PROGRAM must not  HAVE  THE  COPYRIGHT

NOTICE VIOLATED, CHANGED OR ALTERED.



     pLEASE REPORT ANY COPYRIGHT VIOLATIONS TO THE AUTHOR, AT ONE

OF THE ABOVE TELEPHONE NUMBERS. tHANK YOU.

















                             - 3 -

                          nswp oVERVIEW



     nswp IS A DIRECTORY AND FILE MANIPULATION PROGRAM.  wITH IT,

YOU CAN COPY,  DELETE,  RENAME,  UNSQUEEZE AND SQUEEZE FILES. tHE

DOCUMENTATION  FOLLOWING  IS  SPLIT INTO TWO  MAJOR  SECTIONS:  a

TUTORIAL  FOR THE INEXPERIENCED,  AND A  REFERENCE  SECTION.  tHE

REFERENCE  NORMALLY WILL BE USED IN CONJUNCTION WITH THE  PROGRAM

TO  ANSWER SPECIFIC QUESTIONS REGARDING nswp.  tHE TUTORIAL IS  A

BROAD  COVERAGE  OF  ALL OF THE FUNCTIONS,  AND  SHOULD  BE  READ

THROUGH AT LEAST ONCE.



     tHE MOST IMPORTANT THING TO REMEMBER WHEN USING nswp IS THAT

IT  PROVIDES A LIST OF YOUR FILES IN alphabetical  ORDER.  mOVING

AROUND  IN THIS LIST IS QUITE EASY,  AND WILL SOON BECOME  SECOND

NATURE.



     iN  THIS  DOCUMENTATION,  ALL USER INPUT IS  UNDERLINED.  aS

WELL,   WHEN   THE   "CURRENT"  FILE  IS   REFERENCED   IN   THIS

DOCUMENTATION,  IT MEANS THE FILE JUST TO THE LEFT OF YOUR INPUT.

tHIS  "CURRENT"  FILE  IS OFTEN REFERRED TO AS THE FILE  YOU  ARE

"ON".













































































                             - 4 -

                          iNVOKING nswp



     tO  MAKE EFFECTIVE USE OF nswp,  YOU MUST KNOW  THE  VARIOUS

OPTIONS  AVAILABLE TO YOU WHEN YOU INVOKE nswp.  hERE ARE SOME OF

THE OPTIONS:



a>nswp

     tHIS  FORMAT SIMPLY LOADS nswp,  AND SCANS THE DEFAULT DRIVE

AND  USER FOR FILENAMES.  oNCE INSIDE nswp,  YOU MAY CHANGE TO  A

DIFFERENT  DRIVE  AND/OR  USER,  BUT WHEN YOU EXIT  YOU  WILL  BE

RETURNED TO THE DRIVE/USER THAT YOU CALLED nswp FROM.



a>nswp *.com

     tHIS FORMAT LOADS nswp AND SCANS THE CURRENT DRIVE AND  USER

FOR  ALL FILENAMES WITH THE EXTENSION '.com'.  nOTE THAT nswp CAN

FIND  SYSTEM FILES AS WELL,  SO NO ADDITIONAL INFORMATION NEED BE

GIVEN.



a>nswp b:*.com *

     tHE  PRESENCE OF THE SECOND ASTERISK INDICATES TO nswp  THAT

YOU WISH TO SCAN ALL USER AREAS OF THE INDICATED DISK  DRIVE.  iN

THIS CASE, ALL '.com FILES ON ALL USER AREAS ON DRIVE b.



     cOMBINATIONS  OF THE ABOVE ARE ACCEPTABLE,  AND YOU MAY EVEN

LOG TO ALL USER AREAS,  AND FIND ALL FILES WITH THE SPECIFICATION

'*.* *'.



     oNCE  INSIDE  nswp YOU ARE PRESENTED WITH  A  MENU,  THEN  A

REPORT OF WHICH DRIVE AND USER YOU ARE LOGGED TO,  HOW MUCH SPACE

IS  TAKEN  BY THE FILES YOU HAVE SPECIFIED,  HOW MANY FILES  HAVE

BEEN FOUND WITH THE SPECIFICATIONS GIVEN,  AND HOW MUCH SPACE  IS

LEFT ON THE DISK. a SAMPLE FOLLOWS:



dRIVE a0:  596k IN 36 FILES.  735k FREE.



     a  SPECIAL FORMAT OF THIS LINE SHOWS THAT YOU ARE LOGGED  TO

ALL USER AREAS:



dRIVE b*:  950k IN 234 FILES. 2956k FREE.



     fROM THIS POINT, YOU MAY EXECUTE ANY OF THE MENU OPTIONS.



     a  SPECIAL  DISPLAY  OCCURS IF NO FILES ARE FOUND  WITH  THE

SPECIFICATION  YOU HAVE GIVEN,  OR IF THERE ARE NO FILES  IN  THE

GIVEN DRIVE/USER AREA(S):



nO FILES.



     tHIS  DISPLAY MAY ALSO OCCUR IF YOU DELETE ALL THE FILES OUT

OF A GIVEN SPECIFICATION. wHEN THIS OCCURS, YOUR MENU CHOICES ARE

LIMITED TO only 's', 'l' OR 'x'.  tHIS ALLOWS YOU TO SEE THE FREE

sPACE ON A DRIVE,  TO lOG TO ANOTHER DRIVE/USER,  OR TO ExIT.  nO

OTHER CHOICES ARE VALID, NOR WILL THEY BE ACCEPTED.













                             - 5 -

cOMMAND sTRUCTURE



     tHERE ARE TWO PRIMARY TYPES OF COMMANDS IN nswp:  THOSE THAT

ACT  ON  ONE FILE AND  THOSE THAT ACT ON MANY  FILES.  wE WILL GO

THROUGH  THEM BOTH.  bEFORE DOING THAT THOUGH,  LET'S TRY  MOVING

AROUND IN nswp FIRST.



     tO MOVE IN nswp, YOU MUST FIRST UNDERSTAND THAT THE FILES ON

YOUR  SELECTED  DRIVE/USER WILL BE PRESENTED TO YOU IN  A  SORTED

MANNER.  tHE  FILES  ARE SORTED IN  THIS  ORDER:  fILENAME,  fILE

EXTENSION, USER AREA:



   1. b0: -work   .001    0k :

   2. b0: arcadd  .com    4k :

   3. b0: arccopy .com    2k :



     aS YOU CAN SEE, THE FILES ARE NUMBERED FOR YOUR CONVENIENCE.

yOU MAY NOT DIRECTLY USE THESE NUMBERS.  aS YOU CAN SEE, THE FILE

SIZE IS ALSO SHOWN (ROUNDED TO THE NEAREST BLOCK SIZE).



     nOTE  THAT  IF YOU HAVE ENABLED THE REVERSE  VIDEO  SEQUENCE

(SEE  ePILOG),  YOU  MAY SEE SOME OF THE LETTERS IN THE  FILENAME

PRINTED  IN REVERSE VIDEO.  tHE CHART BELOW SHOWS HOW  TO  DECODE

THIS INFORMATION.



          ffffffff rsa

          12345678 /yr

          {$7c}{$7c}{$7c}{$7c}{$7c}{$7c}{$7c}{$7c} osc



   4. b0: arcdel  .com    2k :



     aS YOU CAN SEE, THIS LOOKS CONFUSING.  rEALLY, THOUGH, IT IS

NOT.  tHE  TAGS f1-f8 NORMALLY ARE NOT USED,  BUT nswp ALLOWS YOU

SET f1-f4 FOR YOUR OWN USE.  tHE r/o TAG MEANS THAT THE FILE  MAY

BE READ, BUT NOT WRITTEN TO. tHE sys TAG MEANS THAT THE FILE DOES

NOT APPEAR IN NORMAL dir LISTINGS, AND IN cp/m 3, mpm AND cp/m 86

ALSO MEANS THAT THIS FILE IS AVAIABLE TO ALL USER AREAS.  tHE arc

TAG MEANS THAT,  IF SET, THE FILE HAS BEEN BACKED UP SINCE IT WAS

LAST ACCESSED.



     nOW THAT YOU UNDERSTAND HOW FILES ARE PRESENTED,  WE CAN  GO

THROUGH A SAMPLE SESSION. rEMEMBER, USER INPUT IS UNDERLINED.



































                             - 6 -

a>nswp b:



nsweep   -  vERSION 2.00     02/11/1984

        (C) dAVE rAND, 1984

            eDMONTON, aLBERTA



dRIVE b0:   850k IN   64 FILES.   118k FREE.



   1. b0: -work   .001    0k :  <sp>

   2. b0: arcadd  .com    4k :  <sp>

   3. b0: arccopy .com    2k :  <cr>

   4. b0: arcdel  .com    2k :  <cr>

   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



     aT ANY POINT, YOU MAY REQUEST THE MAIN HELP MENU BY PRESSING '?'.



   1. b0: -work   .001    0k : ?



nsweep   -  vERSION 2.00     02/11/1984

        (C) dAVE rAND, 1984

            eDMONTON, aLBERTA



a - rETAG FILES         {$7c} q - sQUEEZE/uNSQEEZE TAGGED FILES

b - bACK ONE FILE       {$7c} r - rENAME FILE(S)

c - cOPY FILE           {$7c} s - cHECK REMAINING SPACE

d - dELETE FILE         {$7c} t - tAG FILE FOR TRANSFER

e - eRASE t/u FILES     {$7c} u - uNTAG FILE

f - fIND FILE           {$7c} v - vIEW FILE

l - lOG NEW DISK/USER   {$7c} w - wILDCARD TAG OF FILES

m - mASS FILE COPY      {$7c} y - sET FILE STATUS.

p - pRINT FILE          {$7c} ? - dISPLAY THIS HELP

x - eXIT TO cp/m        {$7c} CR, SP - fORWARD ONE FILE







mOVING FORWARD AND BACKWARD



     aS YOU CAN SEE,  THE TWO MOST COMMON COMMANDS WILL BE MOVING

FORWARD AND BACKWARDS THROUGH THE DIRECTORY. eITHER THE space BAR

(<sp>),  OR THE return KEY (<cr>) MAY BE USED TO MOVE FORWARD. tO

MOVE BACKWARDS, SIMPLY USE THE 'b' KEY. nOTE THAT ALL COMMANDS IN

nswp CAN BE EITHER IN UPPER OR LOWERCASE.  iNTERNALLY,  LOWERCASE

WILL  BE  CONVERTED  TO UPPERCASE.  iF YOU REACH THE END  OF  THE

DIRECTORY  WITH EITHER COMMAND,  YOU WILL BE "WRAPPED AROUND"  TO

THE OTHER END AUTOMATICALLY.















                             - 7 -

eXITING



     tO EXIT,  JUST USE THE 'x' COMMAND AS SHOWN ABOVE. tHIS WILL

RETURN YOU TO THE SAME DRIVE AND USER AREA THAT YOU INVOKED  nswp

FROM, REGARDLESS OF ANYTHING YOU MAY HAVE DONE IN nswp.



fINDING A FILE



     sINCE YOU MAY HAVE MANY HUNDREDS OF FILES SELECTED,  YOU MAY

WISH  TO  MOVE  RAPIDLY TO A PARTICULAR FILE.  yOU  MAY  DO  THIS

THROUGH THE 'f', OR find COMMAND.



   1. b0: -work   .001    0k : f  wHICH FILE? bascom



   8. b0: bascom  .com   32k :



     tHE  fIND  COMMAND ALWAYS STARTS LOOKING FROM  ENTRY  NUMBER

ONE. yOU MAY USE THE STANDARD cp/m SYNTAX FOR WILDCARDING (EG: TO

FIND THE FIRST .hex FILE,  YOU MAY USE *.hex), AND ALSO NOTE THAT

THE  fIND COMMAND WILL FILL ALL BLANK SPACES WITH QUESTION MARKS.

tHIS  MAKES THE SEARCH STRINGS 'b*.*',  'b',  AND 'b??????.'  ALL

FIND THE FIRST FILE BEGINNING WITH 'b'.  aS YOU  EXPERIMENT,  YOU

WILL FIND OTHER INTERESTING USES FOR THIS COMMAND.





     aT  THIS  POINT,  YOU  NOW  KNOW HOW TO  MOVE  THROUGH  YOUR

DIRECTORY,  BOTH RAPIDLY AND ONE STEP AT A TIME. lET'S MOVE ON TO

SOME MORE USEFUL COMMANDS.



vIEWING AND pRINTING A FILE



     tHE vIEW COMMAND,  INVOKED WITH A 'v', WILL TYPE THE CURRENT

FILE ONTO THE SCREEN, UNSQUEEZING THE FILE IF REQUIRED. nOTE THAT

THIS COMMAND WILL not PREVENT YOU FROM LISTING any TYPE OF  FILE,

SO  YOU  MUST  USE YOUR OWN JUDGEMENT ON WHAT CAN AND  CANNOT  BE

LISTED.  aT THE END OF EACH PAGE ON THE SCREEN,  VIEW WILL  STOP,

AND ALLOW YOU TO ABORT THE VIEWING WITH A ^c OR A ^x.  tO GET ONE

MORE LINE FROM THE FILE,  HIT THE SPACE BAR. tO GET ANOTHER PAGE,

HIT THE <cr> OR return KEY.



     tHE pRINT COMMAND, INVOKED WITH A 'p', WILL SEND THE CURRENT

FILE,  WITH  NO  MODIFICATIONS  OR PAGING,  TO THE  CURRENT  lst:

DEVICE.  yOU  MAY  ABORT THE PRINT WITH A ^c  OR  ^x.  aLL  OTHER

FEATURES OF THE vIEW COMMAND APPLY.





dELETING A FILE



     yOU CAN DELETE THE CURRENT FILE JUST BY HITTING THE 'd' KEY.

bEFORE DELETION OCCURS, YOU WILL BE PROMPTED.



  12. b0: cdp1    .      40k : d  dELETE FILE? y

  12. b0: dead    .dat  100k :













                             - 8 -

     iF  ANY REPLY OTHER THAN 'Y' OR 'y' IS GIVEN THE FILE IS NOT

DELETED.  iF THE FILE IS DELETED, IT IS REMOVED FROM THE LIST AND

THE NEXT FILE IS GIVEN THE CURRENT FILE'S NUMBER.



     iF THE FILE IS A rEAD oNLY FILE, YOU WILL BE PROMPTED AGAIN:



  12. b0: cdp1    .      40k : d  dELETE FILE? y  r/o. dELETE? y

  12. b0: dead    .dat  100k :





cOPYING A FILE



     wHILE ON ANY FILE, YOU MAY COPY THAT FILE TO:

a) aNOTHER NAME, ON THE SAME DRIVE/USER

b) aNOTHER NAME, ON A DIFFERENT DRIVE/USER

c) tHE SAME NAME, ON A DIFFERENT DRIVE/USER



     nswp  WILL  PREVENT  YOU FROM COPYING A  FILE  TO  THE  SAME

DRIVE/USER  THAT  THE SOURCE FILE RESIDES ON.  oTHER  THAN  THAT,

THERE ARE NO RESTRICTIONS ON WHERE YOU WISH THE FILE TO BE.  iF A

FILE  EXISTS  ON THE SAME DRIVE/USER THAT YOU WISH TO  PLACE  THE

DESTINATION  FILE,  THE  EXISTING FILE IS DELETED  AUTOMATICALLY,

EVEN  IF  IT  IS rEAD oNLY.  wHEN nswp COPIES  A  FILE,  ALL  THE

ATTRIBUTES OF THE ORIGINAL FILE ARE PASSED ON TO THE  DESTINATION

FILE.  tHUS,  IF A FILE IS A sys,  r/o FILE,  nswp WILL CAUSE THE

DESTINATION  FILE  TO BE sys,  r/o AFTER THE FILE COPY HAS  TAKEN

PLACE.



  12. b0: cdp1    .      40k : c  cOPY TO (FILESPEC)? c9:back.cdp



     iF YOU WISH TO PRESERVE THE NAME OF THE FILE,  YOU MAY  JUST

ENTER THE DESTINATION DRIVE/USER PART OF THE FILESPEC (EG. c9: IN

THE  PRECEDING EXAMPLE WOULD HAVE COPIED THE FILE TO DRIVE c USER

9,  RETAINING THE NAME cdp1). jUST ENTERING THE DRIVE PART OF THE

FILESPEC  CAUSES  nswp TO RETAIN THE USER NUMBER  OF  THE  SOURCE

FILE.



     iF THE FILENAME IS FOLLOWED BY A SPACE, THEN A 'v', THE FILE

WILL BE VERIFY READ AFTER IT IS WRITTEN.  nswp MAINTAINS A crc OF

THE FILE AS IT IS WRITING THE FILE, AND VERIFIES THIS crc.





rENAMING FILES



     tHE rENAME COMMAND ('r') MAY BE USED TO:

a) cHANGE THE NAME OF ONE FILE

b) cHANGE THE NAMES OF MANY FILES

c) cHANGE THE USER NUMBER OF ONE FILE

d) cHANGE THE USER NUMBER OF MANY FILES



     tO JUST CHANGE THE NAME OF ONE FILE, THE SYNTAX IS SIMPLE:



  12. b0: cdp1    .      40k : r  nEW NAME, OR *? cdp2

  12. b0: cdp2    .      40k :











                                - 9 -

     yOU MAY ALSO CHANGE THE USER NUMBER OF THE FILE, AS FOLLOWS:



  12. b0: cdp1    .      40k : r  nEW NAME, OR *? b1:cdp2

  12. b1: cdp1    .      40k :



     nOTE  THAT IF ALL USER AREAS ARE NOT SPECIFIED IN THE  LOGON

OF nswp,  THE FILE MAY NOT BE SHOWN ON YOUR LIST WHEN RENAMING TO

ANOTHER USER AREA.



     tO CHANGE A GROUP OF FILES FROM ONE NAME TO ANOTHER, YOU MAY

ENTER THE FOLLOWING COMMAND AT ANY FILE:



   9. b0: basic   .com   24k : r  nEW NAME, OR *? *



oLD NAME? *.hex

nEW NAME? *.bak



     aT  THIS  POINT  ALL FILES WITH THE EXTENSION .hex  WILL  BE

RENAMED  TO THE SAME FILENAME BUT WITH THE  EXTENSION  .bak.  yOU

WILL SEE A RUNNING DISPLAY ON THE SCREEN AS EACH FILE IS RENAMED.

aNY  VALID WILDCARD MAY BE USED TO SELECT THE SOURCE  FILES,  AND

THE DESTINATION FILES WILL TAKE ONE CHARACTER FROM THE SOURCE FOR

EACH  '?'  IN  THE NAME.  aN ASTERISK QUALIFIES  AS  FILLING  THE

REMAINDER OF THE FIELD WITH '?'.  iF THE DESTINATION FILE EXISTS,

THE RENAME IS NOT MADE.





































































                             - 10 -

     yOU  MAY  ALSO CHOOSE TO RENAME A GROUP OF FILES TO  ANOTHER

USER AREA, OPTIONALLY CHANGING THEIR NAMES AS WELL:



   9. b0: basic   .com   24k : r  nEW NAME, OR *? *



oLD NAME? *.hex

nEW NAME? b1:*.bak







     tHIS COMMAND WILL RENAME ALL .hex FILES ON DRIVE b USER 0 TO

THE  SAME FILENAME,  BUT WITH THE EXTENSION .bak,  AND PLACE  THE

RESULTANT FILE IN USER 1.  yOU MAY WANT TO TRY THIS COMMAND A FEW

TIMES TO GET THE HANG OF IT, BUT IT IS EXTREMELY POWERFUL.





tHE sPACE COMMAND



     tHE  sPACE COMMAND ('s') SIMPLY ASKS YOU FOR A  DRIVE  CODE,

THEN  TELLS  YOU  THE REMAINING SPACE ON THE DRIVE  YOU  SPECIFY.

bEFORE DOING THE SPACE CHECK, A DRIVE RESET IS PERFORMED, SO FEEL

FREE TO CHANGE DISKS.





tHE lOG cOMMAND



     tHE lOG COMMAND ('l') ALLOWS YOU TO CHANGE YOUR DIRECTORY TO

ANOTHER DRIVE OR USER.  aDDITIONALLY, IT ALLOWS YOU TO RE-SPECIFY

THE WILDCARD MASK JUST LIKE ENTERING THE nswp PROGRAM FROM  cp/m.

aS WELL,  THE DRIVE SYSTEM IS RESET,  SO AGAIN YOU SHOULD BE ABLE

TO  CHANGE  TO A DIFFERENT DISKETTE AT THIS POINT OR  TO  ANOTHER

PART  OF  THE SAME DISKETTE.  wHEN THE lOG COMMAND IS  USED,  THE

INSTRUCTIONS ARE REPRINTED FOR REVIEW.





  16. b0: dd      .com    4k : l  nEW DRIVE/USER/MASK? a14:*.hex





nsweep   -  vERSION 2.00     02/11/1984

        (C) dAVE rAND, 1984

            eDMONTON, aLBERTA



dRIVE a14:   44k IN   2 FILES.  1118k FREE.



  1. a14:nswp    .hex    22k:





























                             - 11 -

               iNTRODUCTION TO mULTIFILE COMMANDS



     nOW THAT ALL THE COMMANDS THAT AFFECT SINGLE FILES HAVE BEEN

DESCRIBED,  IT  IS  TIME TO INTRODUCE THE  CONCEPT  OF  mULTIFILE

COMMANDS. tHESE COMMANDS ARE ONES THAT AFFECT AS FEW AS ONE OR AS

MANY AS ALL OF THE FILES ON A SINGLE DISK. tO AFFECT THESE FILES,

THOUGH,  WE  MUST HAVE SOME WAY OF DESCRIBING WHICH FILES NEED TO

BE AFFECTED.  cp/m HAS A WAY TO DO THIS,  USING "WILDCARDS". tHIS

PROGRAM, ON THE OTHER HAND, USES THE CONCEPT OF A FILE "TAG".



tHE tAG COMMAND



     tAGGING A FILE,  IN ITS SIMPLEST FORM,  CAN BE  ACCOMPLISHED

JUST  BY  DEPRESSING  THE  't' KEY WHEN THE  FILE  TO  BE  TAGGED

APPEARS.  wHAT  EXACTLY IS A TAG?  a TAGGED FILE IS A FILE IN THE

LIST  OF FILENAMES THAT HAS AN ASTERISK NEXT TO THE  COLON  AFTER

THE NAME OF THE FILE, AS SHOWN BELOW.



   9. b0: basic   .com   24k :*



     a TAGGED FILE IS DIFFERENT FROM AN UNTAGGED FILE IN THAT YOU

MAY  NOW  REQUEST AN OPERATION THAT DEALS WITH SEVERAL  UNRELATED

FILES (EG.  fILES THAT WILL NOT MATCH USING ONLY ONE WILDCARD). a

SAMPLE "TAG" SESSION IS SHOWN:



   9. b0: basic   .com   24k : t  tAGGED FILES =   24k (  23k).

  10. b0: brun    .com   16k : t  tAGGED FILES =   40k (  39k).



     nOTE  THAT  THE 't' COMMAND AUTOMATICALLY PERFORMS  A  "MOVE

FORWARD" OPERATION.



     tO  THE RIGHT OF THE 'tAGGED FILES' MESSAGE TWO  NUMBERS ARE

DISPLAYED. tHE NUMBERS ARE THE TOTAL SIZE, IN k, OF THE FILES YOU

HAVE  TAGGED SO FAR.  tHIS IS USEFUL IF,  FOR  EXAMPLE,  YOU  ARE

MOVING FILES FROM ONE SIZE OF DISKETTE TO ANOTHER,  SMALLER, SIZE

DISKETTE.  iF  THE  SOURCE DISK HOLDS 500k,  AND THE  DESTINATION

HOLDS 256k,  YOU CAN STOP THE TAGGING OPERATION WHEN YOUR SIZE IS

JUST LESS THAN 256k.  tHE TAG FUNCTION IN ITSELF DOES NOT PERFORM

ANY  OPERATION,  OTHER THAN TO MARK THE FILE FOR A FUTURE  "MASS"

OPERATION.



     bY NOW THE ASTUTE READER WILL NOTICE  THAT i  HAVE  CLEVERLY

SKIPPED OVER THE FUNCTION OF THE SECOND  NUMBER  DISPLAY, THE ONE

IN PARENTHESIS.  tHIS NUMBER IS THE COMBINED  SIZE OF THE  TAGGED

FILES, in 1k blocks.  iF YOU ARE  USING  A COMPUTER  SYSTEM  THAT

SUPPORTS  MANY DIFFERENT  DISK  SIZES/FORMATS, OR A SYSTEM WITH A

HARD DISK  ATTACHED, YOU MAY  ALREADY KNOW THAT cp/m CAN ALLOCATE

STORAGE ONLY IN "blocks", AND  THAT  THESE "blocks" MAY  BE UP TO

16K IN LENGTH. tHIS MEANS THAT nswp WOULD SHOW A FILE CONTAINING,

SAY, 512 BYTES IN INFORMATION, AS BEING UP TO 16K LONG, DEPENDING

ON YOUR COMPUTER.  tHE SECOND NUMBER IN THE TAG DISPLAY SHOWS HOW

MUCH STORAGE THE CUMULATIVE FILES WOULD TAKE IF THEY WERE  STORED

ON A SINGLE-SIDED, SINGLE-DENSITY, 8" DISKETTE.













                             - 12 -

wILDCARD TAGGING



     aNOTHER WAY TO TAG FILES IS THE WILDCARD TAG FUNCTION.  tHIS

FUNCTION ACCEPTS A cp/m TYPE WILDCARD AND PROCEEDS TO TAG ALL THE

FILES THAT MATCH THE WILDCARD.  tO INVOKE THIS,  JUST HIT 'w' AND

YOU WILL BE PROMPTED WITH THE MESSAGE 'wHICH FILES?  '. eNTER ANY

cp/m WILDCARD,  RIGHT DOWN TO A UNIQUE FILENAME, AND IF THAT FILE

EXISTS IT WILL BE TAGGED AND DISPLAYED.



uNTAGGING FILES



     iF  YOU CAN TAG A FILE,  YOU MUST BE ABLE TO uNTAG A FILE AS

WELL.



   9. b0: basic   .com   24k :*u  tAGGED FILES =   16k (  16k).

  10. b0: brun    .com   16k :*



     aS  YOU CAN SEE,  THE UNTAG FUNCTION SUBTRACTS  THE  CURRENT

FILE'S  SIZE  FROM  THE TOTAL,  THEN DISPLAYS THE  TOTAL  OF  THE

REMAINING FILES.





tHE MASS COPY COMMAND



     nOW  THAT WE HAVE A NUMBER OF FILES "TAGGED",  WHAT DO WE DO

WITH THEM?  wELL, THE mASS COPY FUNCTION IS ONE OF THOSE THAT ACT

ON MANY FILES. iTS PURPOSE IS TO COPY THE TAGGED FILE(S) FROM ONE

DRIVE/USER AREA TO ANOTHER DRIVE/USER.



  12. b0: cdp1    .      40k : m

  cOPY TO DRIVE/USER? a14: v



cOPYING   --> b0: brun    .com  TO a14:  WITH VERIFY

vERIFYING --> FILE OK.



     tHE  v IS OPTIONAL,  AND IT INDICATES THAT YOU WISH TO  HAVE

THE FILE VERIFIED AFTER IT IS WRITTEN.



     aS  YOU CAN SEE,  THE FILES HAVE BEEN SENT TO DRIVE a,  USER

14.  iF YOU WISH THE TAGGED FILES TO RESIDE IN THE SAME USER AREA

AS THE SOURCE FILES AFTER THE COPY, DO NOT SPECIFY A USER AREA IN

THE  mASS COMMAND.  tHIS WILL CAUSE nswp TO PUT THE FILE  IN  THE

SAME USER AREA AS THE SOURCE FILE.



     nswp WILL NOT ALLOW YOU TO COPY A FILE TO THE SAME DRIVE AND

USER AREA AS THE SOURCE. tHE COPY IS SIMPLY NOT MADE.



























                             - 13 -

aFTER THE MASS



     aFTER ANY MASS FILE OPERATION,  THE TAGS ARE "RESET" AS EACH

FILE IS COPIED.  vISUALLY,  THEY CHANGE FROM A '*' TO A '#'.  tHE

FILES  ARE  LOGICALLY UNTAGGED,  AND WILL RESPOND AS  SUCH.  bUT,

SINCE  nswp  REMEMBERS THEM,  YOU CAN AUTOMATICALLY  RETAG  THESE

FILES.  tHIS IS USEFUL IF, FOR EXAMPLE, YOU NEED TO COPY THE SAME

FILES  TO  A  NUMBER OF DIFFERENT DISKETTES OR USER  AREAS  ON  A

DRIVE. tO INVOKE THIS, USE THE 'a' COMMAND.



  12. b0: cdp1    .      40k : a



rETAGGING--> b0: brun    .com   tAGGED FILES =    16k (  16k)







eRASING FILES



     yOU MAY WANT TO COPY A GROUP OF FILES, THEN DELETE THEM FROM

THE SOURCE DISK AFTER THE COPY HAS BEEN MADE. tO DO THIS, YOU CAN

USE EITHER THE 'c' COMMAND TO COPY,  FOLLOWED BY THE 'd' COMMAND,

WHICH IS TEDIOUS,  OR A COMBINATION OF THE 't', 'm', 'a', AND THE

'e' COMMANDS. tHE 'e' COMMAND eRASES TAGGED OR UNTAGGED FILES, AT

YOUR OPTION, ON A GLOBAL 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



     iF  YOU SPECIFY uNTAGGED FILES,  THE UNTAGGED FILES WILL  BE

ERASED.  yOU  MAY WISH TO BE PROMPTED BEFORE EACH FILE IS  TO  BE

DELETED, AND YOU CAN DO THIS VIA THE SECOND QUESTION.







sQUEEZING AND uNSQUEEZING FILES



     tHE  'q' COMMAND ALLOWS YOU TO sQUEEZE AND uNSQUEEZE  TAGGED

FILES.  tHIS FILE SQUEEZE PROGRAM IS COMPATIBLE WITH THE ORIGINAL

SQUEEZE/UNSQUEEZE PROGRAMS WRITTEN IN THE 'c' LANGUAGE BY rICHARD

gREENLAW.  aFTER HITTING q, YOU WILL SEE THE PROMPT:



sQUEEZE, uNSQUEEZE OR rEVERSE (s/u/r)?



     aFTER  ANSWERING THIS SKILL-TESTING QUESTION,  YOU  WILL  BE

ASKED  WHICH DRIVE/USER YOU WISH TO PLACE THE DESTINATION  FILES.

tHE SYNTAX HERE IS THE SAME AS FOR THE mOVE COMMAND, EXCEPT IT IS

PERMISSIBLE  TO  'q' THE FILES BACK TO THE SAME  DRIVE/USER  THAT

THEY ORIGINATED.

















                             - 14 -

     wHEN 'q' IS INVOKED, YOU ARE ASKED IF YOU WISH  TO  sQUEEZE,

uNSQUEEZE  OR rEVERSE.  a CARRIAGE RETURN HERE WILL RETURN YOU TO

THE COMMAND LINE OF nswp.



     iF  YOU  SELECT 's' FOR sQUEEZE, ALL TAGGED  FILES  WILL  BE

EXAMINED  TO  SEE  IF IT IS "WORTH" SQUEEZING  THEM.  fILES  THAT

EXIBIT any SPACE REDUCTION,  EVEN IF IT IS ONLY ONE SECTOR,  WILL

BE SQUEEZED. iF THE FILES IS NOT "WORTH" SQUEEZING, THE FILE WILL

SIMPLY BE COPIED TO THE DESTINATION DRIVE/USER.



     iF YOU  SELECT 'u' FOR uNSQUEEZE, ALL TAGGED FILES  WILL  BE

EXAMINED TO SEE IF THEY ARE SQUEEZED.  iF THEY ARE,  THEY WILL BE

UNSQUEEZED,  AND MOVED TO THE DESTINATION DRIVE/USER. iF THEY ARE

NOT SQUEEZED, THEN THEY ARE SIMPLY COPIED.



     iF YOU SELECT 'r' FOR rEVERSE, ALL FILES THAT  ARE  SQUEEZED

WILL  BE  UNSQUEEZED,  AND ALL FILES THAT ARE UNSQUEEZED WILL  BE

SQUEEZED  (IF  IT  IS WORTH IT),  AND MOVED  TO  THE  DESTINATION

DRIVE/USER.



     tHE MOST ATTRACTIVE FEATURE OF THE 'q' COMMAND IN GENERAL IS

THE ABILITY TO sQUEEZE FILES only IF IT IS "WORTH" IT. tHIS MEANS

THAT  BY  USING  nswp,  YOU CAN ARCHIVE DATA  INTO  THE  ABSOLUTE

MINIMUM AMOUNT OF SPACE POSSIBLE.   tHE sq ALGORITHM USED IN nswp

IS BETTER THAN THE ONE IN THE ORIGINAL 'c' SQUEEZER, AND PRODUCES

THE SMALLEST OUTPUT FILE POSSIBLE WITH CURRENT TECHNOLOGY.



     tHE FILE SQUEEZER SECTION WAS DONE BY jIM  lOPUSHINSKY,  AND

IS COPYRIGHTED  SEPARATELY  BY HIM.  hE ALSO HAS A PUBLIC  DOMAIN

STANDALONE SQUEEZER.





sETTING THE TAGGED FILES STATUS



     yOU  MAY SET THE ATTRIBUTES OF A GROUP OF TAGGED FILES  JUST

LIKE stat, OR prot. tO DO THIS, TAG THE FILES, AND SELECT THE 'y'

COMMAND.



  12. b0: cdp1    .      40k : y  wHICH FLAGS (1-4,r,s,a)? r,s



sETTING ---> b0: brun    .com TO r/o sys





     tHE  FLAGS YOU MAY SET ARE THE f1-f4 FLAGS,  AS WELL AS  THE

rEAD oNLY,  sYSTEM,  AND aRCHIVE (mp/m,  cp/m 3 ONLY) FLAGS.  aNY

FLAGS  YOU DO NOT SPECIFY WILL BE RESET.  tO RESET ALL THE  FLAGS

(ie:  cHANGE TO r/w, dir AND NO "sYSOP TAG"), JUST ENTER A SINGLE

COMMA OR SPACE AT THE "wHICH FLAGS" PROMPT.  nOTE THAT THE  FLAGS

IN  THE  "wHICH FLAGS" QUESTION DO NOT HAVE TO BE ENTERED WITH  A

COMMA BETWEEN THEM,  AS ANYTHING (OR NOTHING AT ALL!) WILL DO. aS

FAR AS THE PROGRAM IS CONCERNED  'rsa',  'r s a', AND 'r,s a' ARE

ALL VALID.















                             - 15 -

                             ePILOGUE



     aLL THE FUNCTIONS OF nswp HAVE NOW BEEN DESCRIBED.  tHE BEST

WAY TO GET MORE FAMILIAR WITH THE PROGRAM IS TO ACTUALLY use  IT.

i THINK IT WILL BE ONE OF YOUR MOST FREQUENTLY USED PROGRAMS.



     tHERE  ARE SEVERAL THINGS IN THIS VERSION THAT YOU WILL WANT

TO ALTER:



103h

tHIS BYTE CONTROLS THE SCREEN LENGTH USED IN THE 'v'IEW  COMMAND.

iT IS CURRENTLY SET TO 23d (17h).



104h-10ah - tURN REVERSE VIDEO ON

tHE FIRST BYTE IN THIS SEQUENCE OF SEVEN SHOWS THE LENGTH OF  THE

REVERSE  VIDEO ON SEQUENCE,  WHICH FOLLOWS AT LOCATION 105h.  aLL

SEVEN BYTES ARE CURRENTLY SET TO ZERO.



10bh-111h - tURN REVERSE VIDEO OFF

tHE  FIRST BYTE IN THIS SEQENCE OF SEVEN SHOWS THE LENGTH OF  THE

REVERSE VIDEO OFF SEQUENCE,  WHICH FOLLOWS AT LOCATION 10dh.  aLL

SEVEN BYTES ARE CURRENTLY SET TO ZERO.





                             cREDITS



     mY  THANKS  TO  ALL  WHO MADE  THIS  PROGRAM  POSSIBLE,  AND

ESPECIALLY  TO  dAVE  mCCRADY  FOR  HIS  HELP  IN  COMPOSING  THE

DOCUMENTATION  AND .hlp FILES FOR nswp.  tHANKS ALSO GOES TO  jIM

lOPUSHINSKY,  ALSO OF eDMONTON,  SINCE WITHOUT HIM THE sq SECTION

OF nswp MIGHT NEVER HAVE BEEN COMPLETED! tHANKS TO THE USE OF HIS

sq SECTION, nswp CAN PRODUCE THE SMALLEST POSSIBLE sq'ED FILES.





                          cONTRIBUTIONS



     iF YOU LIKE, USE AND ENJOY THIS PROGRAM, FEEL FREE TO SEND A

CONTRIBUTION  (SUGGEST  $20).   tHIS  WILL HELP  ME  EXPAND  THIS

PROGRAM,  AND ADD EVEN MORE FEATURES. i AM CURRENTLY WORKING ON A

cp/m 86 VERSION, AND ONCE THAT IS RUNNING, i INTEND TO PORT IT TO

msdos.  sUGGESTIONS FOR ENHANCEMENT ARE ALSO APPRECIATED, AND YOU

MAY SEND THEM TO:



dAVE rAND

10232 - 160 sTREET

eDMONTON, aLBERTA  canada

t5p 3e9

























                             - 16 -

AVE rAND

10232 - 160 sTREET

eDMONTON, aLBERTA  canada

t5p 3e9