Simtel MSDOS 1992 June

home *** CD-ROM | disk | FTP | other *** search

/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / zip / bbzippii.arc / ZIPPER.DOC < prev next >

Wrap

Text File | 1989-08-10 | 24.2 KB | 644 lines

▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄ ▀▀▒▒█▀ ▒▒█ ▒▒█▀▒▒█ ▒▒█▀▒▒█ ▒▒█▀▀▀▀ ▒▒█▀▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒█ ▒▒▒▒▒▒█ ▒▒▒▒▒▄ ▒▒▒▒▒█▀ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█▀▀▀▀ ▒▒█▀▀▀▀ ▒▒█▀▀▀ ▒▒█▀▒▒▄ ▒▒█ ▒▒█ ▒▒▒▒▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ by J.L. Pearson of the Bytebrothers FAST LOGIC OUTLAWS Wichita Ks. ZIPPER.DOC ZIPPER II.. by the Bytebrothers J.L. Pearson Zipper is designed to let you easily and quickly convert any and all ARC, LZH, ZIP and PAK files to the new Phil Katz ZIP compression format using PKZIP 1.0. It will use the new default "implosion" compression to save the maximum amount of disk space. You simply tell Zipper the path to the files you want converted and let it go. It will convert whole directories automatically or single files. Simply enter zipper filename(s) and the file(s) will be converted from arc,lzh,oldzip,and pak to imploded Zips.. ╔═══════════════════════════╗ ║ ══════fast setup══════ ║ ╚═══════════════════════════╝ Copy the ZIPPER.EXE COMMENT.EXE and DIRCHECK.EXE files into a directory in your path. Then set an environment variable.. set spat=pathname Put this in your autoexec or a batchfile to call Zipper. For pathname use the path that you keep your archiving files in. ie.. set spat=c:\utils Now just run Zipper. It will build a config file for you and will show it to you. Edit it if you want to change anything or add a custom comment and Zipper is ready. Typing zipper with no arguments will bring up a help screen. ╔══════════════════════════════╗ ║ ══════support files══════ ║ ╚══════════════════════════════╝ For full operation of ZIPPER you will need the compression files PKUNZIP.EXE PKZIP.EXE and the programs for any of the compression routines you want to convert. ZIPPER supports the ARC using PKPAK and PKUNPAK from PK. It also supports Nogate's PAK with the PAK.EXE file. It supports Yoshi's LZH or LHARC format using his LHARC.EXE program. And of course it will use PKZIP to unzip old style ZIP files and add the new tighter "implosion" technique. It looks for the above files when it boots, and will support any it finds. If you only want to convert old ZIP's to new ZIP's you can run it with only ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 2 PKZIP and PKUNZIP. If you add any of the above programs into it's directory they will automagically be supported. At the start of ZIPPER's run it will display very briefly the archive files that it finds are active. Place ZIPPER in the directory that you keep PAK.EXE, LHARC.EXE, PKUNPAK.EXE and PKZIP.EXE in. ZIPPER will automagically sense ARC,PAK or LZH formats and uncompress them and convert them to Phil Katz's new ZIP implosion. ╔════════════════════════╗ ║ ══════options══════ ║ ╚════════════════════════╝ Zipper operates on one file at a time in automated fashion and deletes the original file after verifying the unarchive operation.. The original file date and time are preserved in the new .ZIP file. Any arcs embedded within lzh pak or arc files are caught and rezipped before being zipped into the main file so PC Mag files and others that contain arcs within arcs will be totally zipped.. Five command line switches are available..one to allow batch operation without intervention for sysop Events.. another to create a running log text file of the entire conversion session including all files processed and all bad files and unarc errors.. A third switch causes the deletion of all bad archive files at the end of the conversion session.. a fourth switch shuts off all sound for late night conversions and the last switch tells ZIPPER to ignore all existing zip files. This is so you call up a subdirectory with zips in it and tell ZIPPER to convert all the non-zip files but leave the existing zip files alone and do not recompress them. the switches are.. /b or b run in batch mode without user intervention.. /d or d delete all bad files at the end of conversion.. /l or l keep full log file of all activity for review.. /s or s shutup. kill all sound.. /i or i ignore all exsisting zip files. If you will be using PAK before you rush into conversion read the READ.ME file or the note below on correctly installing the PAK.EXE program from NoGate Technology if you are using a version earlier than version 2.0. It can be dangerous when run uninstalled on the earlier versions only. ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 3 ╔════════════════════════╗ ║ ══════examples═════ ║ ╚════════════════════════╝ Here are some examples of usage.. ZIPPER path/filename /b /l path and filename are standard DOS format.. the /b switch will force batch operation and should be used to run from a batch file.. no operator intervention will be required. All bad archive filenames are always logged in a BADFILE.LOG text file.. The /l switch will cause ZIPPER to create a log file called ZIPPER.LOG which will contain a log of every file conversion every error and every bad file.. as well as the time and date of the conversion run.. ZIPPER c:\arcs /l /b ZIPPER c:\arcs b l are both acceptable.. ZIPPER A:\ this will convert all the files on drive A:, whether arc,pak,lharc or zip. ZIPPER c:\arcs\*.pak this will convert all the .PAK files in directory C:\arcs into .ZIP files. The original .PAK files will be deleted so when ZIPPER is done the .PAK's will be transformed into .ZIPs.. If you have a number of .ARC's, .PAK's and .LZH files mixed in a directory named C:\com the following command can be used.. ZIPPER c:\com this will change all the .LZH, .PAK .ARC and old .ZIP files so that when done directory c:\com will have nothing but imploded .ZIP files.. ZIPPER c:\com /i this as before will change all the .LZH, .PAK and .ARC files to imploded zips. But it will ignore any existing zip files and not try to recompress them in order to save time. ZIPPER c:\com\*.arc /b /l ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 4 this will change all the ARC files to ZIP but leave the ZIP PAK and LZH files intact.. C:\COM can have ZIP and PAK and LZH files in it but no ARC's. It will run without intervention in batch mode and a log will be kept of the session.. Let's say you run a bbs and have a directory full of .LZH files you want to change to .ZIP.. The directory name is C:\bbs\dl1. Enter the following.. ZIPPER c:\bbs\dl1 /l /b /d ZIPPER will go to dl1 and since it is full of LHARC files it will convert every one into a .ZIP file. Entering a directory with no filenames is the same as \*.* and all files will be converted. Notice that if the directory has both .ARC and .PAK files they all will be converted to ZIP. Any .GIF, .MAC or other extension files are always ignored.. again a log will be kept of the entire conversion session, and at the end of the session the /d switch will cause all bad files to be deleted.. the filenames and paths will be in the log file.. Let's say you have a bbs upload directory and want to convert all the arc pak and lzh files, but not hassle with recompressing the existing zip files. And you want to run it late at night from an event batch file. ZIPPER c:\bbs\dl1 /i /b /l this will do it from a batch file and will log all the conversions to the ZIPPER.LOG file. If you have only one file to convert just enter the filename as in ZIPPER pascal.arc The file PASCAL.ARC will be converted to PASCAL.ZIP.. as simple as that.. ╔═════════════════════╗ ║ ══════setup═════ ║ ╚═════════════════════╝ There is only one requirement for setup on ZIPPER. You must set an environment variable SPAT to the path of your archive utilities.. PKUNPAK.EXE, PAK.EXE and PKZIP.EXE. This setting also determines where the logs will be kept and where the Commenter ,Dircheck and the Zipper program leave their logs and stats. example. set spat=c:\utility will tell ZIPPER to look in directory C:\UTILITY for the archving files. And to use this directory to store his config ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 5 file and the badfile list.. This command can be placed in your autoexec.bat file and ZIPPER will automatically be set up every time you boot.. if you should get an error " out of environment space " when you boot use the command.. shell=command.com c:\ /e:1024 /p Dos 3.3 or shell=c:\command.com /e:1024 /p Dos 3.2 in your CONFIG.SYS file.. using the drive that you boot from and where your copy of command.com is located. This will increase your environment area to 1k bytes but will not work on early versions of DOS. Most later versions will accept either command.. If you are running DesqView or some other muti-taskers they DO NOT pass the environment variables correctly by default. Drop from DV to Dos and set SPAT.. it will work in DV then. ZIPPER will also use the SPAT path to create it's own configuration file the first time you run it. You can modify this file ZIPPER.CFG to reflect your unarchive command ( if you have modified the commands in PAK.EXE ), the name you want to call PKUNPAK ( ie. PKXARC etc.. ), and the actual commands you send to PKZIP setting the level of compression. Defaults are provided in the ZIPPER.CFG file for standard operation at ZIP's highest compression level..which is the new "implosion" compression method of PKZIP 1.0. ZIPPER will also use this directory to create a BADFILE.LOG file that lists any and all archive files that were bad and failed to uncompress.. Make sure that you set PAK up right. Read the notes in the READ.ME file or below under the heading IMPORTANT on running the PAKINSTAL program on PAK.EXE if you are running a version earlier than 2.0. Note that the later versions of PAK do not require the installation. With the SPAT variable set ZIPPER will run from any drive or directory as long as he is in your path. It works just like a dos command without the need to trudge thru menus or windows. Note that in revision E a new entry has been added to the CFG file.. It is a comment that you can add to any and all files that ZIPPER converts.. sysop's can put their BBS and phone number in the last four lines of the CFG file and it will comment all their conversions with an advertisement. The comment will be displayed whenever the archive file is unZipped. If you delete your original CFG file on the earlier versions ZIPPER will create a new one with a tag like this.. ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 6 e pkunpak -ex ╔═══════════════════════════════════╗ ║ the Bytebrothers.. Wichita Ks.. ║ ╚═══════════════════════════════════╝ The first line is the command that causes PAK to unarchive files, the default is e. Line two is the name you want to use for PKUNPAK. ie. it could be PKXARC. Line three is the command sent to PKZIP and specifies the compression level as tightest. The fourth line is the new comment line. The rules are if the first character of the comment is a * character, or if the fourth line of your CFG file is blank then no comment will be added to the new zips.. otherwise whatever you place in the last four lines of your CFG file gets tagged onto every ZIP file you create, automatically.. to temporarily disable comments just stick a * character at the start of the fourth line.. ZIPPER will run from whatever directory you are currently in and will create its work directory there.. this is so you can build a ramdisk or sit on your fastest winchester and cd to it and optimize for speed. Just make sure when you run ZIPPER that there is enough disk space under you to unarc the largest archive you will encounter.. ╔══════════════════════════════╗ ║ ══════nuts and bolts═════ ║ ╚══════════════════════════════╝ ZIPPER converts a file at a time and creates a .\LOWER subdirectory under your current directory to work in. The work directory is deleted when done..if there is an abort or error during compression of an already unarced file the program will prompt you, so if you want you can save the work directory data.. The work directory will contain the last unarced file's contents if a file has been unarced and not repacked... Any errors encountered with bad arcs are handled by inserting the time,date and pathname of the bad .ARC or .PAK file into the file BADFILE.LOG and ZIPPER goes onto the next file.. If you want to stop ZIPPER during operation just hit the ESCAPE key. ZIPPER will finish the file it is currently working on so not to screw things up then will abort cleanly for you. Make sure there is enough disk space under you when you run ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 7 ZIPPER to hold the largest arc/pak you plan to convert.. The main problems we have found with users using zipper is trashed config files. They will edit the config file to add a comment or change something and will accidentally put bad commands in the zipper.cfg. If one of the archivers comes up with a help screen instead of running correctly just delete your zipper.cfg file and let Zipper make a new one. You can save your comment to a tiny text file to reinstall it. ZIPPER saves the original date and time of the file and touches the new .ZIP file, so the original file date is preserved.. and you don't wind up with all your directory files dated the day of the conversion.. ZIPPER creates a file in your SPAT directory called BADFILES.LOG. Everytime you run ZIPPER it places the time and date of the run in the BADFILE.LOG file as well as any files it finds which fail to unarchive.. here is a sample of the file.. ZIPPER badfiles Sunday February 5, 1989 time 8:40:26 p.m. d:\arcs\hold\mona.pak d:\arcs\hold\nc12.arc d:\arcs\hold\nc13.arc ZIPPER badfiles Sunday February 5, 1989 time 8:53:25 p.m. d:\arcs\hold\mj12.pak d:\arcs\hold\mono.arc d:\arcs\hold\mj12.arc If you use the /l option with ZIPPER it will create a file in your SPAT directory called ZIPPER.LOG which will contain a log of the entire conversion.. here is an example of a ZIPPER.LOG file.. ZIPPER runlog. Thursday February 10, 1989 time 4:19:42 p.m. ════processing file c:\com\loads\test\bb_vs_ml.arc ════processing file c:\com\loads\test\stant.pak ╔═══════ bad archive file ══════════╗ error occured during extraction of c:\com\loads\test\stant.pak file being processed.. c:\com\loads\test\stant.pak is bad arc badfile logged... ════processing file c:\com\loads\test\ffx.arc ════processing file c:\com\loads\test\badone.arc found embedded ARC file FFF.ARC processing FFF.ARC in c:\com\loads\test\badone.arc bad archive file FFF.ARC in ARC c:\com\loads\test\badone.arc unsalvagable.. ARC logged.. ════processing file c:\com\loads\test\limerick.arc ════processing file c:\com\loads\test\bullet.arc ════processing file c:\com\loads\test\usenet.arc ════processing file c:\com\loads\test\ctype.arc ════processing file c:\com\loads\test\goodone.arc found embedded ARC file CTYPE.ARC processing CTYPE.ARC in c:\com\loads\test\goodone.arc ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 8 found another embedded ARC file SELPSC13.ARC processing SELPSC13.ARC in c:\com\loads\test\goodone.arc ════processing file c:\com\loads\test\stanho.arc as you can see ZIPPER unarcs and rezips arcs that are embedded inside files and of course retains the correct date and time of the file.. Entering ZIPPER with no arguments will bring up a help screen. If you appreciate and use this program please send me $10 for registration. A $20 registration will provide free updates for the next two revisions of Zipper. A registration form is provided at the end of the docs. FAST LOGIC OUTLAWS J.L. Pearson I will not be held responsible for any damage caused by this program.. it is distributed as is. Care should be taken to insure enough disk space to do the conversions. Sometimes PKZIP is not as tight as PAK and LHARC and a tightly packed floppy with files can lack room to hold larger loosely compressed .ZIP files. The program will abort when the disk is full and the last unarchived file will be in the work directory.. The program has been tested on many computers and if your computer will run PK and PAK and you have correctly INSTALLED your PAK.EXE program you should have no problems.. J.L. Pearson President and founder Bytebrothers Member Fast Logic Outlaws Wichita Ks. a note.. (2-89) We have all waited some time during the debacle between Phil Katz's PKWARE vrs. SEA hassles. Phil has lost his PK code and gone back to sqaure one while SEA's releases have found remarkable new performance.. Phil has noted in his ZIP release that the extension ZIP is released to the public domain.. unlike SEA's attitude on ARC. I think this about sums it up.. SEA now has the right to use ZIP on it's tombstone and Phil can't complain let alone sue.. The worm has turned folks..get Zippin. R.I.P. ARC, may it rot in the SEA ! Two extra utilities are included in the Zipper II release. They are designed to aid in running bbs operations, and also to have some fun adding your own custom comments to your zip files in a fast and efficient manner. ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 9 Comment and Dircheck by J.L. Pearson and the Bytebrothers -- power tools for those who zip -- ═══════════════════════════════════════════════║ COMMENT: COMMENT is a utlity for those who have zipped files and want to quickly add their own comments to the files in batch. Comment runs with ZIPPER and uses the same config file. Revision E of comment includes a four line comment editor for entering extended 4 line file comments. The syntax is... comment d:\arcs You will first be prompted to find if you want to use the default comment or enter a new one. The comment can be over 200 characters in length. Pressing CR will use the default comment stored in the zipper.cfg file. The same comment always used by ZIPPER. The other option ( typing y) will bring up a comment editor. A four line window for you to enter your comment in. The comment will be displayed whenever the file is unzipped. After entering the four line comment ( which can be an ad for your bbs, or even a detailed description of what is in the zip file) you are asked if you want this comment to become the default. This will replace the current default comment used by ZIPPER and COMMENT itself. Then all the files in the path you specified will be fast tagged with the comment and the time and datestamp redated to the original zip. You can even get artistic and use TheDraw [tm] to create comments with graphic characters in them. You can edit your ZIPPER.CFG file and the last four lines are wide open to vent your artistic juices on. Sysop's like to use this feature to put advertisements into the zip files. Just remember that PKZIP 1.0 does not support ansi comments so save your graphic image with an ascii and not an ansi save. A more serious use would be to correctly catalog the contents of an important archive, or to even add installation instructions for the software in the archive. A batch switch is also available so if sysop's want to run it as an event the syntax is.. comment d:\arcs /b or comment d:\arcs b This will cause COMMENT to run without prompts or intervention and comment the files with the default comment in ZIPPER's cfg file. Comment correctly resets the file date/time stamp. So you can comment files without changing the filedate or timestamp. ═══════════════════════════════════════════════║ ZIPPER.DOC Wednesday, August 9, 1989 9:52 pm Page 10 DIRCHECK: For bbs sysops another problem with conversion is the filelist. The list of files in directories that need to have their extensions changed from .LZH .PAK or .ARC to .ZIP. Dircheck will do this automagically. Just point him to the filelist file and let him go. It uses the ZIPPER config file and logs.. ie.. dircheck c:\dl1\files.bbs Will go the the filelist files.bbs in the above dir and will change all the .ARC/.LZH/.PAK file extensions to .ZIP for you. The utility runs in batch mode by default so it can be used in events and called from your own batch files.. DIRCHECK will leave its own entry in your ZIPPER.LOG file. Telling the time of the run and the number of .ARC and .PAK and .LZH filenames found and converted. Registration Form: Zipper II by the Bytebrothers registration $10 free updates $20 name __________________________________________________ address __________________________________________________ city state zip __________________________________________________ please send check or money order to: J.L. Pearson Fast Logic Outlaws 344 N. Acadia Wichita Ks. 67212