Dec 112017
A very capable shell program for PKZIP.
File ARK25Z.ZIP from The Programmer’s Corner in
Category Utilities for DOS and Windows Machines
A very capable shell program for PKZIP.
File Name File Size Zip Size Zip Type
ARK.EXE 151740 78869 deflated
ARK25Z.DOC 33516 11273 deflated
ARKCUST.ACF 3415 1618 deflated
ARKCUSTX.ACF 1598 797 deflated
ARKDEMO.BAT 226 138 deflated
ARKINST.BAT 521 265 deflated
ARKREG.FRM 3241 962 deflated
ARKSETUP.EXE 74324 47251 deflated
ARKSETUP.HLP 1534 770 deflated
BBS.HLP 1166 649 deflated
CDIR.HLP 1440 621 deflated
DSCR.HLP 1727 856 deflated
ERR.HLP 1585 876 deflated
FMARK.HLP 1122 639 deflated
PKNOTES.HLP 1429 765 deflated
SPECFEA.HLP 1355 724 deflated

Download File ARK25Z.ZIP Here

Contents of the ARK25Z.DOC file


=================================== NOAH'S ARK ---------------
=================================== SHAREWARE RELEASE 2.5Z ---------------
=================================== (C) 1989 EAGLE SHAREWARE ---------------
=================================== ALL RIGHTS RESERVED ---------------
=================================== S. L. HORTON, III ---------------
=================================== ENJOY! ---------------







I. Setup & Installation Procedure
A. ARKSETUP & Pathing (At least read this) ....................... 1
B. Notes for Those Who Will Not Read All of the .DOCs ............ 2
C. What is generally going on .................................... 2
II. Directory Screen
A. Help Index F1 ................................................. 2
1. The .HLP files ............................................ 3
2. Customization of Help Screens ............................. 3
B. Main Menu Selection F2 ........................................ 3
1. PKZIP commands: 16 Standard & Custom Availability ......... 3
2. DOS support: Copy, Move, Delete, Secondary Processor ...... 3
3. ARKSETUP From Within NOAH ................................. 3
4. User Customized Interface ................................. 3
a. .ACF File Syntax ...................................... 4
b. Sample File (ARKCUST.ACF) Documentation ............... 4
5. Quit Commands ............................................. 4
C. File Marking F3-F5 ............................................ 5
1. Levels & Toggles .......................................... 5
2. Sigma Error Marks ......................................... 5
D. Sorting the Directory F6-F9.................................... 6
1. Sort Keys ................................................. 6
2. Rule of Thumb for Sort Ordering ........................... 6
E. Changing Drive & Directory F10................................. 7
F. Quit [ESC] & ALT+X ............................................ 8
G. The Status Window, RAM Warnings ............................... 8

III. Registration & Technical Support, Other
A. Registration .................................................. 7
B. Technical Support BBS (215)-367-4053 (PCB) .................... 8
C. Free Upgrade Policy & Custom Versions ......................... 8
D. Shareware, Greedware, Freeware & Crippleware .................. 8
E. Note to Sysops ................................................ 8

A. Technical Information ....................................... 9
B. Error Handling & Messages ................................... 9
C. A Thanks to the BBS Community ............................... 9
D. Disclaimer & note to Chess players .......................... 9


PREFACE: Comments
NOAH'S ARK (formerly PKSHELL) is quite easy to use. You CAN use it right
away without reading the documentation, but at least read the first two
parts on setup. I hope that you find the package intuitive, and simple
to use. Admittedly, prior releases were not up to this standard. This version
bears only a .4 upgrade, but was in fact started from scratch. Enjoy.

I. Setup & Installation Procedure
A. ARKSETUP & Pathing
Setup procedure: 1) Install all of the files that came with your package in
a subdirectory of your choice. This subdirectory *DOES NOT* necessarily have
to be in your DOS path for NOAH to function properly. When installed outside
the DOS path, you need only place ARKDEMO.BAT in the DOS path.
Use ARKINST.BAT (included) to do copy all of the files to a subdirectory of
your choice. Once invoked, the software can find its own path. No SET command
is needed at any point to operate NOAH'S ARK.

>> Format for ARKINST.BAT:
A drive\subdir of your choice.

ARKINST BAT ................. Batch installation file (delete after use)
ARK EXE ................. Main executable module for NOAH'S ARK
ARK25Z DOC ................. This documentation file
ARKCUST ACF ................. Ark Custom File demo
ARKCUSTX ACF ................. Second Custom File demo
ARKDEMO BAT *................ A demo batch file for use in ARKCUST.ACF
ARKREG FRM ................. Registration mailer
ARKSETUP EXE ................. Setup routine
ARKSETUP HLP ................. Setup help screen (.HLP are pure ASCII)
BBS HLP ................. Tech support BBS help screen
CDIR HLP ................. Change Drive/Dir help screen
DSCR HLP ................. Directory scroller & screen help
ERR HLP ................. Description of most common error conditions
FMARK HLP ................. File marking help screen
PKNOTES HLP ................. Notes on PKZIP help screen
SPECFEA HLP ................. Special Features help screen

*ONLY ARKDEMO.BAT needs to be in your DOS path (presuming that you will want
to use it.... it facilitates using LIST to view .ZIP contents). ALL of the
other files may be placed in a subdirectory that is not in you DOS path, but
in order to invoke NOAH you will need to provide DOS with a path to the file
ARK.EXE. e.g. C:\NOAH\ARK to run NOAH from the subdirectory NOAH which is not
in your DOS path.

2) Type ARKSETUP [ENTER] while in the subdirectory NOAH is
installed in. The setup options will be apparent. You
might want to read through the documentation first so that
you understand what you are setting. The default values
are sufficient if you are just checking the program out.

3) Invoke NOAH with the command ARK [ENTER] -or- as
D:\PATH\ARK [ENTER] where D:\PATH matches the subdir
that you installed NOAH in.

I. B. Notes for Those Who Will Not Read All of the .DOCs
I know that most of the advanced users will plow away into the .EXE filenames
ASAP, but to get the most out of the software there are a couple of things you
might like to know. The .ACF files are special as they define the CUSTOM menu
choices within the MAIN menu screen (F2). The syntax for their use is very
simple, and full annotated examples are included. See the file ARKCUST.ACF
for the fast tutorial as you work. The other thing you really need to know is
that NOAH will run best from a hard disk, as it drops several files to disk
during operation. Running from a floppy is very slow. One last thing, if
you invoke ARK.EXE without running ARKSETUP you will be prompted for creation
of a default config file. You should start NOAH the first time within the
subdirectory you intend to run it from. Nothing absurd will happen if you
do not do this, but it would be nice to save some time. Enjoy.
TYPE ARK [ENTER] and let it tear!

I. C. What is generally going on (for new users)
Recognizing that some users are new to PCs, a few pointers are placed here.
You will be using NOAH'S ARK to support PKZIP(tm), a utility used to compress
files for transfer, backup, or archival storage. (PKZIP is the product of
PKWARE, INC., and should be registered with that company, not ESA, for the
required fee.) When you invoke NOAH, you will see a directory-like screen on
the top left, a scroll bar that is moved with the pointer keys (left, right),
a set of Fkey definitions in the top right, and a status box with statistical
information in the bottom right. You will mark files with the [ENTER] key, or
an alternative, and then proceed to the MAIN MENU by pressing F2. You will
then have a collection of commands available, most of which take some action on
the files that you marked while in the directory screen. There is a help box
in the bottom right which will indicate precisely what each command does. Rest
assured that NOAH'S ARK will not delete or overwrite a file without
confirmation from you. If you are unfamiliar with PKZIP, and want to learn
more about how to operate it within DOS, watch the help box as it will
explicitly show you what the DOS command format looks like for reference.
[ESC] quits or backs-up, except where an [ENTER] alone or Q+[ENTER] is
displayed as required to quit. Remember that the majority of user error is
simply the result of trying to go too fast .... slow down and read the screens,
they are pretty good and will guide you well. Enjoy!

II. Directory Screen
A. Help Index: F1 from the directory screen.
1. The .HLP files
2. Customization of Help Screens
F1 - Help Index

From within the main directory screen, there are 10 Fkey defined actions.
The F1 key pops-up a scrolling box indexing the available help files. They
are general in this release, dealing only with the macro activities and
questions. To view them, place the scroll bar on the topic you would like to
read about and press [ENTER]. The help files should be stored within the same
subdirectory as ARK.EXE or NOAH will pop-up a dialog box telling you that it
cannot find one of the help files (by filename). The help files have the
extension .HLP and contain only ASCII text. Hence, you may modify them if you
wish. However, users are discouraged from modifying the help files and then
passing them along in an altered state. There will be extended help available
in future releases.

B. Main Menu Selection
1. PKZIP commands: 16 Standard & Custom Availability.
2. DOS support: Copy, Move, Delete, Secondary Processor
3. ARKSETUP From Within NOAH & options
4. User Customized Interface
a. .ACF File Syntax
b. Sample File (ARKCUST.ACF) Documentation
5. Quit Commands
F2 - Main Menu
Pressing F2 without a file marked marks the file at the scroll bar and
proceeds. The presumption is always that you are going to perform a function
to a file, as that is what NOAH was designed for. However, there are other
options available. From left to right (roll with the L-R arrows) the options

PKZIP commands. 16 are supported by default, and you should note that the 3
using the -g parameter will not properly function until version 1.00 of PKZIP
is released. Versions lower than 1.00 do not support encryption. A custom
version of the software is available to your specifications. e.g. you want
NOAH but with GLUPPIP.EXE support instead. Contact ESA for more information.

DOS supported commands. Copy, Move, Delete, Change Drive/Directory (menu)
and a secondary processor (DOS SHELL). At this time, the ASM library used by
the author not only copies files, but it also restamps them. i.e. the time
and date stamp are updated when you copy or move a file. This is a trivial
point at the least, and a tolerable annoyance at the worst. Future upgrades
will not have this problem. The delete function will erase read-only files
without interrupt. Copy/Move confirm an overwrite of same name files.
For information on the Change Drive/Directory command, see E. below (F10).

OPTIONS commands. You may invoke ARKSETUP, read another Ark Custom File
(.ACF file) for redefinition of the CUSTOM menu selection (see next), read
a new directory (force), redfine the highlight extension, or save the current
configuration to disk. The highlight extension is a three letter user-defined
file extension that NOAH will single out in your directory with a different
color. The color is defined in ARKSETUP only, but you may change the extension
at any time. Moreover, NOAH will search the directory either up/dn for the
next file with that extension if you press the LEFT or RIGHT arrow keys from
within the directory screen.

CUSTOM commands. These commands and the help scroll for them are defined
within the .ACF files. The .ACF file loaded at startup is identified within
ARKSETUP or saved within the OPTIONS menu. This is a piece of the sample
included with NOAH call ARKSETUP.ACF with document comments.


! Syntax:
! ! = Comment to file.... although NOAH will ignore any and all lines that
! are unrecognized, this is a good habit to get into.
! % = Title within menu. 16 maximum PER FILE in use 25 char max.
! * = On-screen comment. 4 lines at 39 characters each, per %
! - = A command invoked ACROSS all marked files.. called repeatedly and passed
! each marked filespec until all filespecs have been passed.
! + = A command passed only once... not passed a parameter....
! [ = The placement within the command line of the passed filespecs
! & = Modification toggle... when placed after the command line identifier
! causes NOAH to reread a directory. Otherwise NOAH will NOT read a
! new set of filenames from disk. You can force a read from the main menu
! options section, if needed.
! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
! New example... use the supplied sample batch file ARKDEMO.BAT to
! LIST the contents of the marked .ZIP files.... interesting.
* Requires that LIST.COM by V. Beurg
* & the ARKDEMO.BAT file bundled with
* NOAH be in your DOS path.
! Example one. Invoke V. Beurgs's LIST across the set of marked files..
* View each file on-screen with LIST.
- LIST [
! Example two. Invoke J. Derr's SHEZ ... note the & causing NOAH to read a DIR
* Flip view of .ZIPs from the inside
* out. Fine Shareware by Jim Derr.
* (c) J. Derr 1989 == Will modify
* the color palette.
! EOF ARKCUST.ACF partial listing for documentation.

Edit/create .ACF files as needed. There is a limit of 16 commands or % lines
within the .ACF files each, but no limit to the ACF files that NOAH can handle.
When you ask to LOAD another .ACF file from the OPTIONS menu, you will be
given a scrolling directory to select from which will display ONLY files with
the extension .ACF within the ARK.EXE startup directory. You may define any
file as the default within ARKSETUP, but the only the .ACF extension will be
picked up within the scrolling menu. In this version, the software just
ignores anything that does not make sense, and this may produce wacky (but
harmless, unless you specify dangerous commands) results if syntax is bad.
However, if you follow the general format outlined in ARKCUST.ACF and
ARKCUSTX.ACF (more samples) you should have no trouble. The most common
errors are spelling.... resulting in the DOS response "Bad Command or
Filename" flashing by just before NOAH restarts. Watch for this and be aware
that it is caused by faulty definition and/or pathing. Even if you spelled it
right, it might not be in your DOS path. When in doubt, SHELL to DOS and
try it manually to be sure. A future version will support prompting the
user for a variable carried out to the command line. This feature is already
available in fully customized versions.

QUIT commands. From either the MAIN menu or the directory screen, ALT+Q
will quit to DOS without confirmation. [ESC] exits with confirmation.
If [ESC] will not function, then the combination to QUIT will be made plain.
There is only one prompt at which Q+[ENTER] is needed to quit, and that is to
facilitate a default filespec treatment.

C. File Marking F3-F5
1. Levels & Toggles
2. The Status Window (Lower Right)
a. Statistics
b. Space Free flash
3. Sigma Error Marks

There are a total of four levels of file marks within NOAH.
Each has a specific meaning......

Denotes a MARKED file. These files are selected and ready to have
operations performed across them such as zip, copy, move, delete,
or custom.

Second Level - Toggled with the F5 key. The marks drop in order
Third Level | at all times. Used where coverage for odd-lot jobs
Fourth Level - is a must. Always a manual activity.

A special mark NOAH creates on the files PKZIP reports an error
condition on. e.g. insufficient disk space, bad archive, etc. NOAH
pops-up a dialog box describing the problem, and then continues when
it encounters an error. This feature allows remedial action and
unattended operation of NOAH. Suggested by a user, this is one of
the most useful new features of this release.

Marking a file changes the values in the STATUS box as well. By using
file marking and the status indicators, you can fully control what is
happening during your PKZIP session. The status box tells you how many
files are marked out of the total in the subdirectory, how many bytes the
marked files account for, what percentage that is of the total bytes in
the subdirectory, and two estimates of the final size of the .ZIP file that
might result if you were to ZIP the files. If the FREE bytes indicator
flashes, it means that UNLESS you have a SET PKTMP= variable in your
environment, then you are likely to run out of disk space when PKZIP
creates its temporary file(s).

Use the [+] [-] [SPACE] and [ENTER] keys to mark/unmark files. The [-] key
is special as it marks the file at the scroll bar and the moves the scroller
UP instead of down.

For the most part, NOAH retains the marks when you change directories, and
does not automatically toggle the marks for you. The only exception is that
NOAH will retag the files upon which a DELETE COPY or PKZIP operation
reported a failure.

D. Sorting the Directory F6-F9
1. Sort Keys
2. Rule of Thumb for Sort Ordering

The sort keys are self-explanatory. Available sort keys are:
F6- Sort By Name
F7- Sort By Extension
F8- Sort By Size
F9- Sort By Date

When you select one of these, you will be asked for the sort order. There
is an easy rule of thumb that I use, and it is:
Ascending = A-Z Alpha
Descending = 1-10 Decimal
Using this rule, then you may determine which is the best sort order for you
to use. Pressing [ENTER] always defaults to Descending order. You may
select SAVE configuration from within the main menu (F2) or use ARKSETUP.EXE
to hard-code the present sort key and order as the default. The settings
during a session are otherwise lost when you exit.

E. Changing Drive & Directory F10

Pressing F10 allows you to change the default drive/dir while using NOAH.
NOAH reads the default information, and then displays a point & pick menu
of the current directories subordinate to the one you are presently in.
For example, if you were in the ROOT of the following TREE:

| |----MACLIB
| |----FINPLAN

NOAH would display this as the menu pick:

If you then selected LOTUS, NOAH would display:

Hopefully future versions will have a rolling point & pick system, but for
now that will have to be supported as a CUSTOM command. An example of using
PC Magazine's RN [(c) 1987 Ziff Davis] utility to do this is provided within

Selecting .. always backs up one step in the tree, and \ selects the ROOT
directory automatically. exits back to NOAH's directory display.
A set of logical drive letters is also laid out on the right side, and
selection of one will change the default drive for you. Remember, MARKS
on files will follow if the marked files exist in the new path.


F. Quit [ESC] & ALT+X
G. The Status Window, RAM Warnings
Pressing [ESC] from the main menu will EXIT TO DOS with confirmation. (Except
after too many unregistered starts) Pressing ALT+Q always exits to DOS
immediately without confirmation of any kind. This ALT+Q feature is also
enabled within the MAIN MENU (F2) for your convenience.

The window on the bottom left of the directory screen is meant to assist you
in marking files for zipping/moving etc. The window will contain information
like this:

543,022 Bytes <- Bytes marked with arrows.
OF 2,104,174 Total <- Total in the current directory
OR 25.8% <- Marked as a % of total
41 / 120 Marked <- Number of files marked & total in DIR
50% 271,511 Bytes <- (Marked bytes)*.5
75% 135,755 Bytes <- (Marked bytes)*.25
Free = 3,555,328 Bytes <- Free space on current drive

As an example, suppose that within this subdirectory you wanted to create
4 floppy disks containing one .ZIP file each. You would simply mark until
you obtained settings like the one above, ZIP the files, and MOVE the ZIPs.
By clearing and toggling the marks (F5) you may clearly see that you have
covered the entire subdirectory. Remember that if the FREE SPACE indicator
changes color, then the number of bytes marked times 2 is greater than the
free disk space. This is relevant only when you intend to ZIP to a target
on the same disk, and where a SET PKTMP=D:\DIR\.. command has not been used.
The reason is that PKZIP (according to its documentation) will create a
temporary file which may be quite large. The idea is to provide you with
and indication that you MAY run into trouble.

The RAM flag on the left bottom will also change color (red) if you have less
than 150K of FREE RAM available.

III. Registration & Technical Support, Other
A. Registration
B. Technical Support BBS (215)-367-4053 (PCB)
C. Free Upgrade Policy & Custom Versions
D. Shareware, Greedware, Freeware & Crippleware
E. Note to Sysops

To register, print the form file ARKREG.FRM and return it with your
contribution. If you do not want to do that, simply provide a mailing
name & address along with your check for $35 to ESA, 1445 Mensch Lane,
Gilbertsville, PA 19525. You may print the form to LPT1: while in
ARKSETUP, or type this command at the DOS command line:



I appreciate the support. Upgraded registered versions, upgrades, and
requests for custom versions can be handled on the BBS. Specific problems,
requests, and some technical support questions can only be handled via voice
communication, and if you would like a call leave your evening ph# on the
BBS or drop a line to ESA. Registered users can also download the latest
ALPHA and BETA versions of unreleased ESA shareware for testing/perusal.
Immediate access to the most recent Shareware version is granted.

Registered users will receive the latest version on disk in the mail, and
one major upgrade FREE. Subsequent upgrades will cost only shipping/handling
of $3 per copy. The registered version does differ slightly... screen
layouts, references to registering, and more importantly the counter are all
absent. The ability to define user-requested prompts within an .ACF file
will always be a registered-only feature. Supporting users deserve a -bit-
more bang for the buck, agreed?

NOAH'S ARK represents plenty of effort. It is not even partially
crippled, and it is not free. In an effort to compromise, a counter
mechanism is present. After 25 unregistered starts, you will be gently
reminded of these facts. My apologies in advance to heavy users who are
simply waiting for a registered copy to arrive. If you find yourself in
that situation, then call the BBS and log-in answering S)cript questionnaire
number two. I will authorize you quickly so that you may download the
latest registered version for immediate use. If you are a SYSOP I will
call your BBS and upload it to your private directory.

SYSOPS NOTE: Please DELETE all prior versions of PKSHELL & NOAH'S ARK.
A. Technical Information
B. Error Handling & Messages
C. A Thanks to the BBS Community
D. Disclaimer & Chess players note
NOAH'S ARK was written under QB v4.5 using the GLIB 1.65 ASM library from
InfoSoft. As a result of being compiled under QB, DOS version 3.xx+ is
required to operate it. 150K available RAM to load, 42+/- bytes per file
read into memory plus about 10K is needed to run the software. Figure no
more than 200K as required. This is not a rehash of the last versions, it
was started 2/89 with a blank screen.

Almost all error conditions are trapped with these exceptions:

1) Insufficient disk space to write the NOAH temporary directory. The error
followed by a list of potential problems. This is almost certainly the
result of a LACK of sufficient disk space ON THE DRIVE NOAH STARTS
FROM. NOAH finds the path to itself (e.g. executable file is in the
subdirectory C:\UTILITY) and uses THAT SUBDIRECTORY for nearly all temp
file storage. NOAH stores primarily directory and subdirectory
information in those temp files to conserve RAM.
2) Absolutely nothing happens when a menu pick is chosen: PKZIP commands or
custom commands. Try watching closely as NOAH attempts to execute: you
will see a quick DOS error pop out saying "Bad Command or Filename" --
this is an indication that PKZIP is NOT in your default path or DOS path,
or that your custom command utility has the same problem. Another cause
is found in spelling errors. Check you spelling when you edit your .ACF
files. When in doubt, try it in DOS first.
3) All lines in any .ACF file which make no sense are ignored completely.
No error message at all. (Next release....)


NOAH drops the directory to disk in a temporary file and then reads it. This
is required in order to read all of the relevant file data into memory. It is
possible that in future versions this will not be required. It does imply that
you should ALWAYS run NOAH from a hard disk by default. i.e. set up on a
hard disk only. NOAH writes all temporary files and directories to the
setup subdirectory, with the exception of the temp batch for PKZIP support.

THE DELCHUG USERS GROUP, Peter Rucci for Zenith compatibility testing, Howard
Palmer for a myriad of technical answers. To Steve Kolterman for extensive
feedback and suggestions, Judith Lebel for a fine idea, and to Joe Zurlo for
testing and support. To Mike at InfoSoft for fast ASM fixes and valuable
code-debug efforts, and to Phil Katz for feedback on two releases. Thanks
also to Ed Watson and cohorts on a particular BBS for gracious assistance and
timely Shareware/Greedware/Crippleware/Freeware debate.

A special thanks to the BBS community which, through endless conversation,
technical advice and debates helped shape all that you see. Please enjoy
using NOAH'S ARK. Also to my wife who never understood this, but fed me

If you see a version floating around with modified (absurd) messages in the
help screens (.HLP files) or wacky .DOCs, please delete it and let me know
where it came from. With your help I can ALWAYS track down who dunnit!!

That legal disclaimer......... in plain English!

I will not accept any responsibility for damages rising from the use of, or
(rather) the inability to use this product. All rights are reserved. NOAH
was designed *NEVER* to cause destruction... and because of the way it has
been written, it is almost impossible for NOAH to damage anything unless you
confirm a file deletion. This does not go for hacked copies... be careful.
Chess players who _beat_ me on my BBS will receive a *FREE* registered
version of NOAH'S ARK along with one upgrade. Get out the check book..........
(That holds for Masters as well.)

Above all, follow the one and only rule in the public domain ........
E N J O Y !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

GLIB (c) InfoSoft, 1987-1989
PO BOX 782057
Witchita, KS 67278-2057
I'd recc. this ASM LIB for any QB programmer who wants to step into the real
power of QB 4.xx

PKZIP(tm) (c) 1989 PKWARE, Inc.
7545 N. Port Washington Rd.
Suite 205
Glendale, WI. 53217
Please support the Shareware that you find useful, such as Phil's PKZIP.

NOAH'S ARK (c) 1989 Eagle Shareware Associates
1445 Mensch Lane
Gilbertsville, PA 19525
Sam Horton


 December 11, 2017  Add comments

Leave a Reply