Merciful 1

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

/ Merciful 1 / Merciful - Disc 1.iso / software / a / archivers_collection / archiverscollection.lha / OWS / OWS.DOC < prev next >

Wrap

Text File | 1992-08-15 | 26.3 KB | 908 lines

OWS version 1.20b RELEASE VERSION By Michael Pendec (C) 1993 (CPS) Creative Productions Software The Manual 0.00 NEWS UPDATE ......................................... 0.99 Introduction ........................................ 1.0 What is a Warper? ................................... 1.1 What can i use it for ?.............................. 2.0 How to Start ........................................ 2.01 Defaults ............................................ 2.02 Examples ............................................ 2.1 Hardware Requirements! .............................. 2.2 Bug Reports ......................................... 2.3 Future Updates ...................................... 2.4 Workbench version ................................... 3.0 BBS owners .......................................... 4.0 OWSCHECK ............................................ The Commands: 5.0 Help ................................................ 5.01 ? ................................................... 5.02 Ext ................................................. 5.1 Read ................................................ 5.11 Write ............................................... 5.2 Repack .............................................. 5.3 View ................................................ 5.31 Full ................................................ 5.32 Test ................................................ 5.4 Append .............................................. 5.5 Encrypt ............................................. 5.51 Decrypt.............................................. 5.6 Low ................................................ 5.61 High ................................................ 5.7 Lower ............................................... 5.71 Upper ............................................... 5.8 From ................................................ 5.9 To ................................................ 5.10 Cmode ............................................... 5.11 Text ................................................ 5.12 Notext .............................................. 5.13 Nopause ............................................. 5.14 Mfm ................................................. 5.15 Indexmode ........................................... 5.16 Gap ................................................. 5.161 Defgap .............................................. 5.17 Len ................................................. 5.18 Sync ................................................ 5.19 Nodos ............................................... 5.20 Diskbuffer .......................................... 5.21 Dmar ................................................ 5.211 Dmaw ................................................ 5.22 Listtrk ............................................. 5.23 Noverify ............................................ 5.24 Appendtext .......................................... 5.25 Nozero .............................................. *************************************************************************** THIS PROGRAM "OWS" AND ITS CONTENTS, MAY NOT BE SOLD OR DISTRIBUTED BY ANY SOFTWARE / PUBLIC DOMAIN SOFTWARE HOUSE, BEFORE THE COMPANY HAVE A WRITTEN CONFIRMATION FROM CPsoftware. *************************************************************************** 0.00: NEWS UPDATE ^^^^^^^^^^^^^^^^^ > 0.20b > ^^^^^ !> Implemented compability with DMS user interfaces. In the update file, you will find a OWS Window interface included, but other DMS userinterfaces may work as well. If you want to use some other DMS user interfaces, try and rename the OWS to DMS and i think it works without any further changes. The User interface included have the MFM option available but for more advanched MFM options, a special UserInterface for OWS will be made. The ows window interface is found in the directory >OWSui10< . > 0.20a > ^^^^^ !> A implementation of an keyfile for future registrations. !> Nozero: The command was already included, but due to the fast documentation, i simply forgot to write about it. !> Ext : The command was already included, but due to the fast documentation, i simply forgot to write about it. !> View : More detailed information about the .OWS file. > File: test.OWS Size: 53736 Created: 1993 Feb 1 22:10 > Lowtrack in Archive: 0 Hightrack in Archive: 4 > Packed Bytes: 53618 UnPacked Bytes: 56320 > Serial Number of Creator: 0 > Machine Used: AMIGA > Diskette Type: 1 Megabyte Diskette (837K) > Machine CPU: 68020 > CPU Coprocessor: NONE > Time to Create Archive: 00 mins. 17 secs. > Version Number of Creator: 1.20 > Version Needed to Extract: 1.20 > Disktype of Archive: KICKSTART 1.2/1.3 OFS > Compression Mode Used: -LH5- > General Info: NONE > >Extended Info on MFM information: > > DISKSYNC: 0 DISKLENGTH: 0 using No indexmode !> DISKBUFFER: Changed default diskbuffering to 32K, to increase speed. !> Included an errormessage for indexreading. OWS aborts the operation is the disk drive isn't responding. !> Included a new packer. LhA is included as interface, meaning, with future updates and the LhA V 2.0 coming soon, you will be supported with better compressing, without having the problem of getting a new update of OWS. Both Speed and efficiency is now at highest level. I have made three different versions of OWS. OWS_SYSLHA : With this version, you must have the LhA program placed in your SYS:C directory. People with a harddrive can use this version, without really loosing any speed. OWS_RAMLHA : With this version, you must have the LhA program placed in your RAM: . This version gives the best result in speed on Amiga's without harddrive, but using diskdrives as Destination (for the .OWS file) OWSLHA : This version is especially made for users of a registered version of LhA. LhA is linked with OWS, and dont need loading of LhA for packing of the disk, which gives the optimal speed. The linked LhA is currently, version 1.50r . OWSLHACHECK: The new version of OWSCHECK, compatible with the new LhA interface. NOTE: LhA must be found, in your SYS:C directory. Of cours you must rename the file you want to use to >OWS< . For your own purpose, and for future programs to run with it. On the disk, can you find the latest EVALUATION release of LhA. which can be used with OWS. Destination drives: It is now possible to read a RAD:, ramdisk, or PCx: (KICKSTART 3.0), or write to it. but with writing to RAD: , you must reset the computer to activate the files unpacked to rad: after. I will be working on that one for the next update. Example: OWS READ <FILENAME> FROM RAD: **************************************************************************** 0.99: Introduction. ^^^^^^^^^^^^^^^^^^^ This program is written entirely in 680x0 assembler, for optimal speed. With the LhA interface, it is now the fastest disk compressor for Amiga. By adding several useful commands, like the MFM reading, and other commands, the OWS is the most flexible disk packer out for amiga. The OWS also works with High density disks, which is a brand new AmigaDOS standard for Amiga. 1.1: What can i use it for ? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The OWS can read normal AMIGA DOS diskettes, including the new High Density format diskettes. NONDOS diskettes like IBM, atari diskettes can also be packed. NOTE: If your diskette is a nondos diskette, then the type will be set default to 1 Megabyte disk, and it will read the disk as a 1 megabyte disk. ( 80 tracks, 2 sides, 11 sectors per side. ) 2.0: How to Start. ^^^^^^^^^^^^^^^^^^ Load the program and write a "?" after. As shown below: "OWS ?" Some help will pop up. Continue reading for futher information about the commands. 2.01: Default. ^^^^^^^^^^^^^^ OWS has some default options which are already set. Normally you would pack a whole disk and this is set as default. Reading from track 0 to track 79. 2.02: Examples. ^^^^^^^^^^^^^^^ You have a disk which is normal dos, BUT has a single NONDOS track here's what to do: ex. >>>> OWS READ <FILENAME> MFM FROM DF0: in case the disk is a normal AmigaDOS diskette, you can just leave out the MFM option. ex. >>>> OWS READ <FILENAME> FROM DF0: ---------------------------------------------------------------------- And for more experienced users. ---------------------------------------------------------------------- You know that the tracklength of the disk, AND SYNC of the tracks. ex. >>>> OWS READ <FILENAME> FROM DF0: MFM LEN 1900 SYNC 4489 NODOS Now you want to write the file you just read. ex. >>>> OWS WRITE <FILENAME> If you know that your drive doesn't support the length that the data is read with, you can change it. ex. >>>> OWS WRITE <FILENAME> LEN 18B0 Some problems with the verify of the MFM coded data can occur, and by writing NOVERIFY at the end you can fix this problem, and the speed of writing increases a lot more. >>>> OWS WRITE <FILENAME> LEN 18B0 NOVERIFY NODOS Or you can choose writing of a single track, the NOVERIFY is selectable. >>>> OWS WRITE <FILENAME> LEN 18B0 NOVERIFY NODOS LOW 18 HIGH 18 UPPER Reading of files with INDEXMODE. Some disks can have multiply SYNC identifiers, and the best way of reading those tracks are with the INDEXMODE set, or if only one tracks differs from the other tracks use the SYNC option. To read a disk with index, try this. >>>> OWS READ <FILENAME> INDEXMODE NODOS Writing of files packed with INDEXMODE: For the writing of Index'd tracks, you must use some informations to write the tracks back to disk right. the SYNC information is a must!, and the LEN option is also needed in some cases. >>>> OWS WRITE <FILENAME> SYNC 4489 LEN 18A0 NOVERIFY OWS will go out in an error if no SYNC was specified. 2.1: Hardware Requirements! ^^^^^^^^^^^^^^^^^^^^^^^^^^^ The OWS takes up a lot of memory, 512K atleast is required, and you will proberly need two drives, if you only have 512K of memory. For writing LONG tracks you need a special drive(Read Glossary). Not a hardware dependent add-on(interface) , but a drive which can be adjusted to write more than the normal drives(you can slow down the speed on these drives). Kickstart 1.2 and up. Writing of High Density files needs a HD drive. *Information about the High Density drive can found in the Glossary.* 2.2: Bug Reports. ^^^^^^^^^^^^^^^^^ If you find some bugs, please send your report to the address you can find in the program, or at the end of this documentation. You can also write OWS in your CLI, without any extensions to get the address. 2.3: Future Updates. ^^^^^^^^^^^^^^^^^^^^ Updates of the program, will probably come, because there's always something new coming up, ie: new diskformats for maybe Kickstart 4.0. At the moment, the program does not detect the length of a track but that feature will soon be included. 2.4: Workbench version. ^^^^^^^^^^^^^^^^^^^^^^^ No Workbench version is planned yet, but if people want a version which runs in workbench , iconbased, they must write to me. If i receive enough requests for a workbench version, i will probably make a workbench based version. 3.0: BBS OWNERS NOTE. ^^^^^^^^^^^^^^^^^^^^^ Use the test option for verifying the OWS file for possible CRC errors. Also adding of DISPLAY.ME files can be done, read about this later in the documentation. You can also use the OWSLHACHECK program, if memory is low. Remember, using the OWSLHACHECK program, the LhA program MUST be found in your SYS:C 4.0: OWSLHACHECK. ^^^^^^^^^^^^^^^^^ This program checks the .OWS file for possible errors. ex.1 >>>> OWSLHACHECK TEST <FILENAME> FULL the full command can be used to show the information about the packed file, before testing the file. **************************************************************************** The Options. ^^^^^^^^^^^^^ 5.0: Help. ^^^^^^^^^^^ It speaks for itself. You will get some information about the available options. 5.01: ?. ^^^^^^^^ Same as help. 5.02: Ext. ^^^^^^^^^^ Show only information on Extended options. 5.1: Read. ^^^^^^^^^^^ Use this option when you want to pack a disk, just like in the famous DMS, but without the LOW, HIGH option. ex.1 >>>> OWS READ <FILENAME> 5.11: Write. ^^^^^^^^^^^^^ Use this option when you want to pack a whole disk, just like in the famous DMS. ex.1 >>>> OWS WRITE <FILENAME> 5.2: Repack. ^^^^^^^^^^^^^ The option repacks a file which is already packed with OWS. You can choose between the compression methods explained later in this documentation. ex.1 >>>> OWS REPACK <FILENAME> TO <NEWFILE> 5.3: View. ^^^^^^^^^^^ This option views a file which is packed with OWS. You get more info about it in this documentation. ex.1 >>>> OWS VIEW <FILENAME> Viewing a OWS file would look like this: > File: test.OWS Size: 10338 Created: 1993 Jan 23 20:13 > Lowtrack in Archive: 0 Hightrack in Archive: 0 > Packed Bytes: 10260 UnPacked Bytes: 11264 > Serial Number of Creator: 0 > Machine Used: AMIGA > Diskette Type: 1 Megabyte Diskette (879K) > Machine CPU: 68020 > CPU Coprocessor: NONE > Time to Create Archive: 00 mins. 01 secs. > Version Number of Creator: 1.00 > Version Needed to Extract: 1.00 > Disktype of Archive: KICKSTART 3.0 DIRCACHE > Compression Mode Used: LZ > General Info: NONE 5.31: Full. ^^^^^^^^^^^^ Use this with the VIEW option and you will get a more specific explanation about the file. You can see the efficiency of packing each track, and what kind of track it is, and if they are ok. ex.1 >>>> OWS VIEW <FILENAME> FULL example screenshot. > > DOS Track 0 Side 2 Org. Size 11264 Pack Size 10248 Gained 10 TRK=OK > 5.32: Test. ^^^^^^^^^^^^ Use this option when you want to check the file for possible errors. ex.1 >>>> OWS TEST <FILENAME> 5.4: Append. ^^^^^^^^^^^^^ If you have partly packed some tracks, and you want to pack a single track or several tracks, you can append this or these tracks to the original file. ex.1 >>>> OWS APPEND < FILENAME> 5.5: Encrypt. ^^^^^^^^^^^^^^ DEFAULT: = no encryption When you want to protect a file, you can use the encrypt command. ex.1 >>>> OWS READ < FILENAME> ENCRYPT <PASSWORD> 5.51: Decrypt. ^^^^^^^^^^^^^^^ DEFAULT: = no decryption This option is used when you want to write an encrypted file. A wrong password will result in a file error. ex.1 >>>> OWS WRITE < FILENAME> DECRYPT <PASSWORD> 5.6: Low. ^^^^^^^^^^ DEFAULT: = 0 This command is used when you want to pack a disk or write a disk, and you want to start from a track higher than 0. ex.1 >>>> OWS READ < FILENAME> LOW 2 >>>> OWS WRITE < FILENAME> LOW 2 5.61: High. ^^^^^^^^^^^^ DEFAULT: = 79 This command is used when you pack a disk or write a disk, and you want to finish from a track lower than 79. ex.1 >>>> OWS READ < FILENAME> HIGH 10 >>>> OWS WRITE < FILENAME> HIGH 10 5.7: Lower. ^^^^^^^^^^^^ DEFAULT: = BOTH SIDES Some diskettes like on ATARI ST or IBM PC or like the multiformat diskettes by Rob Northen Computing used on the front pages of computer magazines, only use the lower side. Here is when this command comes in handy. It only reads the Lower side. >>>> OWS READ < FILENAME> LOWER >>>> OWS WRITE < FILENAME> LOWER 5.71: Upper. ^^^^^^^^^^^^^ DEFAULT: = BOTH SIDES Just like the option LOWER, but in this case, it reads the upper side. >>>> OWS READ < FILENAME> UPPER >>>> OWS WRITE < FILENAME> UPPER 5.8: From. ^^^^^^^^^^^ DEFAULT: = DF0: When you want to read the diskette from a drive other than DF0: >>>> OWS READ <FILENAME> FROM DF1: 5.9: To. ^^^^^^^^^ DEFAULT: = DF0: When you want to write the diskette to a drive other than DF0: >>>> OWS READ <FILENAME> TO DF1: 5.10: Cmode. ^^^^^^^^^^^^^ DEFAULT: = 1 If you want to change compression method, you can do it with the CMODE option. The speed depends on your equipment, but with the use the LhA program, you will be provided with the best results in compressing datas, and the fastest too. CMODE can be set to either 0 or 1. ex. >>>> OWS READ <OWS FILENAME> CMODE 0 5.11: Text. ^^^^^^^^^^^^ You can add a text to the file, which will be displayed when unpacking the file. >>>> OWS READ <FILENAME> TEXT <TEXTNAME> 5.12: Notext. ^^^^^^^^^^^^^^ You can choose not to display the textfiles added to the OWS file, which then will be skipped if NOTEXT is choosen. >>>> OWS WRITE <FILENAME> NOTEXT 5.13: Nopause. ^^^^^^^^^^^^^^^ This option disables the "press return" request after a displayed text. >>>> OWS WRITE <FILENAME> NOPAUSE 5.14: MFM. ^^^^^^^^^^^ Use this option when you want to read a NONDOS diskette, like IBM, ATARI, or any other NONDOS diskette. >>>> OWS READ <FILENAME> MFM 5.15: Indexmode. ^^^^^^^^^^^^^^^^^ When you're packing a NONDOS disk and you don't know the info about the diskette, you can choose the INDEXMODE, and you will get the disk packed. Normally these files would be around 1.0 Megabytes and upto 2.4 megabytes large, depending on the size of the tracks. More info about this later in this documentation. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS READ <FILENAME> MFM INDEXMODE 5.16: Gap. ^^^^^^^^^^^ If a diskette is not indexed, you can choose a gap for the writing of the data. The value MUST be in hexadecimal form, and must be written as four digits. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS READ <FILENAME> MFM GAP 0400 >>>> OWS WRITE <FILENAME> MFM GAP 0400 5.161: Defgap. ^^^^^^^^^^^^^^^ This option works in the same way as the GAP option, but set to a default value: 0300. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS WRITE <FILENAME> MFM DEFGAP 5.17: Len. ^^^^^^^^^^^ DEFAULT: = 18B0 When writing a OWS NONDOS file, you can choose to specify the length of the tracks for the whole disk. Value MUST be in hexadecimal, and must be written as four digits. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS WRITE <FILENAME> MFM LEN 1800 5.18: Sync. ^^^^^^^^^^^^ DEFAULT: = 4489 When reading/writing the NONDOS data, a sync for identification is needed. It is default set to 4489, but is changeable to other identifiers. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS READ/WRITE <FILENAME> MFM SYNC 2112 5.19: Nodos. ^^^^^^^^^^^^^ If you know that the disk is completely full of nondos data, not readable data, you can set this option. Only track 0 side 0 (BOOTTRACK), will be read as dos if it is, and the rest of the tracks will remain mfm data. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS READ <FILENAME> MFM NODOS 5.20: Diskbuffer. ^^^^^^^^^^^^^^^^^^ DEFAULT: = 32K For computers with less memory, but using an external floppy drive as the destination, they can choose extended diskbuffering so it only writes a few times to the destination disk. Maximum size is 48 kilobytes. >>>> OWS READ <FILENAME> DISKBUFFER 30 5.21: Dmar. ^^^^^^^^^^^^ If you are reading/writing special format disks like IBM diskettes, you may want to change the dma status. This is possible. Enter the dma value and OWS reads with this information. Use it carefully. Value MUST be in hexadecimal, and must be written as four digits. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS READ <FILENAME> DMAR 9500 >>>> OWS WRITE <FILENAME> DMAR 9500 5.211: Dmaw ^^^^^^^^^^^^ This works in the same way as above mentioned, but writes with specified DMA status. Use it carefully. Value MUST be in hexadecimal, and must be written as four digits. NOTE: CAN ONLY BE USED WITH THE "MFM" OPTION. >>>> OWS WRITE <FILENAME> MFM DMAW 9100 5.22: Listtrk. ^^^^^^^^^^^^^^^ Like the APPEND option, you can append different tracks but specified as shown below. This is only for multiple reading of 2-3 different tracks, not 50. But this is up to you. Remember the CLI command line only accepts 255 chars. ex. >>>> OWS READ <FILENAME> LISTTRK 14.0,15.1,21.0,30.1 >>>> OWS WRITE <FILENAME> LISTTRK 14.0,15.1,21.0,30.1 these ex. would read/write: track 14 side 0 track 15 side 1 track 21 side 0 track 30 side 1 The list ends with a return or a blank space . 5.23: NOVERIFY. ^^^^^^^^^^^^^^^^ If you want to turn off the verify option, you must choose this option. All writing has verify turned on, to ensure the safety of the written data, why loose data? If a verify error occurs the text information about the track will stay one line above the status line. >>>> OWS WRITE <OWS FILENAME> NOVERIFY 5.24: APPENDTEXT. ^^^^^^^^^^^^^^^^^^ For those who want to add extra display texts to the OWS file, you can use this command to do this. >>>> OWS APPENDTEXT READ <OWS FILENAME> TEXT <FILENAME> 5.25: Nozero. ^^^^^^^^^^^^^^ If the disk in the drive is partly a non AmigaDOS disk, meaning some tracks are not allocated by the DOS, you can select packing of all tracks, without the OWS checking the disk Allocation map. Without this option set, the program will CLEAR every sector, which is cleared in the allocation table. Use the Nozero option to skip this. >>>> OWS READ <OWS FILENAME> NOZERO **************************************************************************** Glossary ******** Nondos ------ A diskette which is not compatible with the AmigaDOS standard. High Density ------------ A High Density diskette is a diskette with double capacity. HARDWARE Details: If you want to buy such a drive for your amiga , the type of the drive is : CHINON FB 357B (DUAL SPEED) A High density drive from a PC won't work. ************************************************************************** DISCLAIMER THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS WITH YOU. SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ------------------------------------------------------------------------------ If you use OWS on a regular basis, please consider a $35 registration fee to help support future releases. For a registration fee of $55 or more, you will receive the latest versions of OWS plus extra utilities and programs not available elsewhere, when available (See documentation for more details). Send a Check or Money Order (US Dollars please.) along with your name, address, phone number, and computer configuration to: CPSoftware C/O Michael Pendec Islandshøjparken 5, ST. TH. DK-2990 NIVÅ, NIVERØD DENMARK Or you can contact me on the following bbs, by writing a letter to, MICHAEL PENDEC. Perto's Asshole BBS +45-86720273 16k8 DUAL FIDONET: 2:230/815 Perto's Asshole BBS +45-86720274 14k4 HST FIDONET: 2:230/816 Perto's Asshole BBS +45-86293910 9k6 V32b FIDONET: 2:230/817 ------------------- XenoLink DK HQ Support BOARD -------------------- *************************************************************************** THIS PROGRAM "OWS" AND ITS CONTENTS, MAY NOT BE SOLD OR DISTRIBUTED BY ANY SOFTWARE / PUBLIC DOMAIN SOFTWARE HOUSE, BEFORE THE COMPANY HAVE A WRITTEN CONFIRMATION FROM CPsoftware. *************************************************************************** ------------------------------------------------------------------------------ The AmigaDOS trademark is, (C) Copyright 1985 - 1993 Commodore-Amiga, Inc. All Rights Reserved OWS And Its Code is, (C) Copyright 1993 - Creative Productions Software. All Rights Reserved LhA And Its Code is, (C) Copyright 1991,92 by Stefan Boberg. All rights reserved ------------------------------------------------------------------------------- All suggestions for improvement welcome. -------------------------------------------------------------------------------