Dec 272017
 
External protocol shell, version 6.0; one of the best.
File HOTK-Z60.ZIP from The Programmer’s Corner in
Category Communications
External protocol shell, version 6.0; one of the best.
File Name File Size Zip Size Zip Type
HOTKEY-Z.DOC 38125 8026 deflated
HOTKEY-Z.EXE 36912 17343 deflated
JMODEM.COM 4703 2931 deflated
JMODEM.DOC 28282 8136 deflated
REGISTER.ME 1697 520 deflated

Download File HOTK-Z60.ZIP Here

Contents of the HOTKEY-Z.DOC file




HotKey-Z v6.0
Documentation
04-01-89
Copyright 1989 Mark A. Albrecht
All Rights Reserved



Prior to running this application, please read the section titled
SHAREWARE at the conclusion of this document. Also, read the
section titled HISTORY, as it may describe recently added features
undocumented elsewhere.


D I S C L A I M E R

The author, Mark A. Albrecht, makes no warranties expressed
or implied as to the quality or performance of this program,
nor its fitness for a particular purpose. The author will
not be held liable for any direct, indirect, incidental, or
consequential damages resulting from the use of this program
and *YOUR USE OF THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO
THIS DISCLAIMER* as well as your release of the author from
any form of liability or litigation.





DESCRIPTION:


HotKey-Z is a menu-driven interface for the popular file transfer
protocols of Chuck Forsberg's DSZ module. (DSZ is a spectacular
program. If you use DSZ beyond a trial period, please register with
Mr. Forsberg.)

PROTOCOLS SUPPORTED: Support is provided for DSZ's X/Y/Zmodem protocols
as well as two additional user-defined external
protocols. Jmodem is included in the archive and
HotKey-Z's menu provides default settings for
using it.

CONFIGURABLE: All arguments/parameters to be passed to DSZ,
cluding default download directories, may be
specified and saved in HotKey-Z's internal config-
uration utility.

FILE SELECTION MENU: Files to be uploaded are selected via a point-and-
shoot style menu. Up to 100 filespecs may be
"tagged" for Zmodem and Ymodem batch uploads. Any
drive and/or directory is accessible, and a
default upload directory (where the file selection
window will first open) may be specified and saved
in the configuration utility.

MOUSE SUPPORT: All menus feature built-in mouse drivers and are
operated using standard mouse commands.

FAST AND EFFICIENT: HotKey-Z is written in Turbo Pascal 5.0 (tm), with
much of the code (including ALL screen writes)
written in assembler language. Every function of
HotKey-Z has been coded to provide lightning-fast
execution, while reducing disk and RAM overhead to
a minimum.





SYSTEM REQUIREMENTS:


1 - IBM PC or compatible.

2 - PC/MS DOS 3.0 or later.

3 - Approximately 59K planar RAM in addition to that required by DSZ.

4 - Efficiency is enhanced by using HotKey-Z on a hard disk but
performance is acceptable on a floppy.

5 - Color or monochrome monitor.

6 - A communication program supporting access to HotKey-Z via a hotkey
or DOS gateway.





INSTALLATION:


Follow these instructions step-by-step and HotKey-Z should be ready
to run.


1. copy HotKey-Z to any directory in your DOS path;

2. Add DSZ's pathspec to your "PATH=" command in your AUTOEXEC.BAT
file of your root directory;

3. Add the lines "FILES=20" and "BUFFERS=20" to your CONFIG.SYS
file.

4. Run your communications program and attach HotKey-Z to a hotkey of
the communications program. For example, Procomm Plus (R) has two
hotkeys as of this writing: "ALT-J" and "ALT-U".

5. Run HotKey-Z and select it's main menu option "CONFIGURE". The
CONFIGURE option is comprised of three sub-options: "UPLOADS",
"DOWNLOADS", and "OTHER". When submenu option "UPLOADS" is
selected, an input menu pops up which contains edit fields in
which you will enter commandline parameters corresponding to the
five upload protocols of HotKey-Z. When submenu option "DOWNLOADS"
is selected, an input menu pops up which contains fields
corresponding to the download protocols. Submenu option "OTHER"
contains various other configurable parameters. A summary of input
menu editing commands is listed on the status line. A detailed
description for each of the three "CONFIGURE" submenu options
("UPLOADS", "DOWNLOADS", "OTHER") follows. Each menu option's
description follows an illustration of the menu option being
described and subdivided according to the edit fields being
described.



Main option CONFIGURE, sub option UPLOADS:

Upload Download Configure Information System Quit

Uploads
Downloads
Other


Zmodem Upload Commandline:

dsz sz -r ^

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate a Zmodem upload. A caret symbol
("^") MUST be placed as the last parameter in this commandline, as
it symbolizes the exact position HotKey-Z will insert the name of
the file chosen from the directory display window to be uploaded.
The default commandline provided will work as-is provided you have
your modem connected through COM1.

Ymodem Upload Commandline:

dsz sb -k ^

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate a Ymodem upload. A caret symbol
("^") MUST be placed as the last parameter in this commandline, as
it symbolizes the exact position HotKey-Z will insert the name of
the file chosen from the directory display window to be uploaded.
The default commandline provided will work as-is provided you have
your modem connected through COM1 (note that the default contains
the "-k" argument, which instructs DSZ to use 1k data blocks.

Xmodem Upload Commandline:

dsz sx ^

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate an Xmodem upload. A caret symbol
("^") MUST be placed as the last parameter in this commandline, as
it symbolizes the exact position HotKey-Z will insert the name of
the file chosen from the directory display window to be uploaded.
The default commandline provided will work as-is provided you have
your modem connected through COM1.

Name 1: User Defined Protocol 1 Upload Commandline:

Jmodem jmodem S1 ^

| |
| |
| This input field holds the entire commandline that will
| be passed to DOS to call your 1st user-defined protocol,
| (the default will execute JMODEM.COM and instruct it to
| send a file through COM1. A caret ("^") MUST be placed at
| that position in the commandline where HotKey-Z should
| insert the filename chosen from the directory display.
|
Enter the MENU name you wish to give the first of two user-defined
upload protocols. One of the characters in the menu name MUST be
capitalized, and the capitalized character MUST NOT be the same as
any capitalized character in one of the other four upload protocol
menu names (i.e., cannot be "Z", "Y", "X" or the capitalized char-
acter of the other user-defined upload protocol menu name).

Name 2: User Defined Protocol 2 Upload Commandline:

Kmodem dsz sx -k ^

| |
| |
| This input field holds the entire commandline that will
| be passed to DOS to call your 2nd user-defined protocol,
| (the default will execute DSZ [.COM or .EXE] and instruct
| it to send a file via "1k Xmodem" through COM1. A caret
| ("^") MUST be placed at that position in the commandline
| where HotKey-Z should insert the filename chosen from the
| directory display.
|
Enter the MENU name you wish to give the second user-defined up-
upload protocol. One of the characters in the menu name MUST be
capitalized, and the capitalized character MUST NOT be the same as
any capitalized character in one of the other four upload protocol
menu names (i.e., cannot be "Z", "Y", "X" or the capitalized char-
acter of the other user-defined upload protocol menu name).



Main option CONFIGURE, sub option DOWNLOADS:

Upload Download Configure Information System Quit

Uploads
Downloads
Other


Zmodem Download Commandline:

dsz rz -r

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate a Zmodem download. A caret symbol
("^") NEED NOT be placed in this commandline. (Since Zmodem is a
batch protocol, the name is passed by the sender during transfer.)
The default commandline provided will work as-is provided you have
your modem connected through COM1. If you wish to have the file
written to a specific directory, enter the directory's pathspec
as the last argument.

Ymodem Download Commandline:

dsz rb

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate a Ymodem download. A caret symbol
("^") NEED NOT be placed in this commandline. (Since Ymodem is a
batch protocol, the name is passed by the sender during transfer.)
The default commandline provided will work as-is provided you have
your modem connected through COM1. If you wish to have the file
written to a specific directory, enter the directory's pathspec
as the last argument.

Xmodem Download Commandline:

dsz rx ^

This input field holds the entire commandline that will be passed
to DOS to call DSZ and initiate a Ymodem download. A caret symbol
("^") MUST be placed in this commandline, separated from the pre-
ceding commandline argument by one whitespace. The caret instructs
HotKey-Z to prompt you for the name of the file to be downloaded,
then inserts this name in the commandline at the position it finds
the caret symbol. The default commandline provided will work as-is
provided you have your modem connected through COM1. If you wish
to have the file written to a specific directory, then precede the
caret with the pathspec of the directory, e.g., "C:\DIR\^".

Name 1: User Defined Protocol 1 Download Commandline:

Jmodem jmodem R1 ^

| |
| |
| This input field holds the entire commandline that will
| be passed to DOS to call your first user-defined down-
| load protocol. A caret symbol MUST be placed in this
| commandline, separated from the preceding argument by one
| whitespace. The caret instructs HotKey-Z to prompt you
| for the name of the file to be downloaded, then inserts
| this name in the commandline at the position it finds the
| caret symbol. The default commandline provided will work
| provided you have your modem connected through COM1 and
| JMODEM.COM can be found. If you wish to have the file
| written to a specific directory, precede the caret with a
| pathspec, e.g., "C:\DIR\^".
|
Enter the MENU name you wish to give the first of two user-defined
download protocols. One of the characters in the menu name MUST be
capitalized, and the capitalized character MUST NOT be the same as
any capitalized character in one of the other four download proto-
col menu names (i.e., cannot be "Z", "Y", "X", or the capitalized
character of the other user-defined upload protocol menu name).

Name 2: User Defined Protocol 2 Download Commandline:

Kmodem dsz rx -c ^

| |
| |
| This input field holds the entire commandline that will
| be passed to DOS to call your second user-defined down-
| load protocol. A caret symbol MUST be placed in this
| commandline, separated from the preceding argument by one
| whitespace. The caret instructs HotKey-Z to prompt you
| for the name of the file to be downloaded, then inserts
| this name in the commandline at the position it finds the
| caret symbol. The default commandline provided will work
| provided you have your modem connected through COM1.
| (Note that we have defined "Kmodem" as DSZ's "Xmodem" but
| by using the "-c" argument DSZ will use CRC checking and
| if 1k data blocks are sent, DSZ will receive 1k blocks).
| If you wish to have the file written to a specific dir-
| ectory, precede the caret with a path, e.g., "C\DIR\^".
|
Enter the MENU name you wish to give the second of the two user-
defined download protocols. One of the characters in the menu name
MUST be capitalized, and the capitalized character MUST NOT be the
same as any capitalized character in one of the other four down-
load protocol menu names (i.e., cannot be "Z", "Y", "X", or the
capitalized character of the other user-defined upload protocol
menu name).



Main option CONFIGURE, sub option OTHER:

Upload Download Configure Information System Quit

Uploads
Downloads
Other


Default Upload Directory:

?:\????????\????????

This field holds the default disk directory where HotKey-Z will
first open the directory display window for selecting file(s) to
upload. The default is the currently logged directory. Change the
default to any valid directory on any valid drive.


Sound alarm on transfer completions? [y/n] Y

Change the default to "N" if you do not wish to have a beep sound
upon completion of file transfers.


Should screen display in monochrome? [y/n] N

This should default to "N" if a color display is present. If you
want HotKey-Z to display in black and white, enter "Y". If you do
have some type of color display and you want HotKey-Z to use your
color capability, enter "N".


Should HotKey-Z use window whistles? [y/n] Y

Leave the default if you want window whistles, or change to "N" if
you can't stand them!


HotKey-Z should now be fully configured to run. Browse through the op-
erating instructions below, and then get to it!





MENU MECHANICS :


1. Main menu and submenu items may be selected in one of two ways:
* By using the arrow keys to move the cursor bar over
the menu selection, then pressing the carriage
return key.
* By pressing the character key corresponding to the
highlighted capitalized initial of the menu item.
(On mono displays, the capitalized letter will not
be highlighted.)

2. Pressing the ESCAPE key at any time will return the cursor back to
the default main menu item.

3. The main menu consists of six items: UPLOAD, DOWNLOAD, CONFIGURE,
INFORMATION, SYSTEM, and QUIT. A discussion of each follows.





SPECIFIC FUNCTIONS:


Major functions are listed below under illustrations of each of their
associated menu commands.


Main option UPLOAD, sub option ZMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will pop up a directory display
Ymodem where you may tag up to 100 filenames to send via DSZ's
Xmodem Zmodem batch protocol. The tagged names will be written
Jmodem to a text file and DSZ will be passed it's indirection
Kmodem operator ("@") and the text file's name in place of the
caret symbol found in the "ZMODEM UPLOAD COMMANDLINE".


Main option UPLOAD, sub option YMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will pop up a directory display
Ymodem where you may tag up to 100 filenames to send via DSZ's
Xmodem Ymodem batch protocol. The tagged names will be written
Jmodem to a text file and DSZ will be passed it's indirection
Kmodem operator ("@") and the text file's name in place of the
caret symbol found in the "YMODEM UPLOAD COMMANDLINE".


Main option UPLOAD, sub option XMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will pop up a directory display
Ymodem where you may select a file to send via DSZ's Xmodem
Xmodem protocol. The caret symbol found in the "XMODEM UPLOAD
Jmodem COMMANDLINE" will be replaced by the filename selected.
Kmodem The commandline will be passed to DOS for execution.



Main option UPLOAD, sub option JMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will pop up a directory display
Ymodem where you may select a file to send via the first of two
Xmodem user-defined protocols (the default provided is Jmodem).
Jmodem The caret symbol in the "USER DEFINED PROTOCOL 1 UPLOAD
Kmodem COMMANDLINE" will be replaced by the filename chosen and
passed to DOS for execution.


Main option UPLOAD, sub option KMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will pop up a directory display
Ymodem where you may select a file to send via the second user-
Xmodem defined protocol (the default provided is Jmodem). The
Jmodem caret symbol found in "USER DEFINED PROTOCOL 2 UPLOAD
Kmodem COMMANDLINE" will be replaced by the filename chosen and
passed to DOS for execution.


Main option DOWNLOAD, sub option ZMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will cause HotKey-Z to
Ymodem pass the contents of the "ZMODEM DOWNLOAD
Xmodem COMMANDLINE" to DOS for execution.
Jmodem
Kmodem



Main option DOWNLOAD, sub option YMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will cause HotKey-Z to
Ymodem pass the contents of the "YMODEM DOWNLOAD
Xmodem COMMANDLINE" to DOS for execution.
Jmodem
Kmodem



Main option DOWNLOAD, sub option XMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will cause HotKey-Z to
Ymodem pass the contents of the "XMODEM DOWNLOAD
Xmodem COMMANDLINE" to DOS for execution.
Jmodem
Kmodem



Main option DOWNLOAD, sub option JMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will cause HotKey-Z to
Ymodem pass the "USER DEFINED PROTOCOL 1 DOWNLOAD
Xmodem COMMANDLINE" to DOS for execution.
Jmodem
Kmodem



Main option DOWNLOAD, sub option KMODEM:

Upload Download Configure Information System Quit

Zmodem Choosing this menu item will cause HotKey-Z to
Ymodem pass the "USER DEFINED PROTOCOL 2 DOWNLOAD
Xmodem COMMANDLINE" to DOS for execution.
Jmodem
Kmodem



Main option CONFIGURE:

Upload Download Configure Information System Quit

The "CONFIGURE" option is discussed above, under the section header
titled "INSTALLATION".



Main option INFORMATION:

Upload Download Configure Information System Quit

Choosing this menu item pops up a window displaying:
-the current date and time;
-the currently logged disk drive;
-the total size in bytes of the currently logged
disk drive;
-the bytes used on the currently logged disk drive;
-the bytes free on the currently logged disk drive.



Upload Download Configure Information System Quit

Choosing this menu item causes HotKey-Z to drop the Shell
user to the DOS system for running any DOS command. Command
To return to the program, enter "EXIT".



Upload Download Configure Information System Quit

Choosing this menu item causes HotKey-Z to pop up Shell
an input field in which a command may be entered Command
and passed to DOS for execution. If you wish to
select a filename to embed in the command, place a caret symbol ("^")
at the position in the command where the filename should be inserted.
If a caret is found, HotKey-Z will pop up the directory display window,
where you may select a filename to replace the commandline caret (much
like the procedure for uploading files with HotKey-Z).



Upload Download Configure Information System Quit

Exits the user from HotKey-Z.





HISTORY:


Version 1.0 - 4.8:
* added support for batch uploads with Zmodem and Ymodem;
* added support for two additional user-defined protocols;
* added support for disk file manipulation functions;
* added support for protocol commandline modification;
* reduced executable code size by more than 40 percent;
* reduced planar RAM requirement by more than 50 percent;
* eliminated several non-fatal bugs reported by users;
* numerous subtle enhancements to improve execution speed
and program display.

Version 5.0 - 5.4:
* now compiled with Turbo Pascal 5.0 (R), providing faster
invocation, smaller executable code, and greater speed;
* added support for a default upload directory where
HotKey-Z will first open its UPLOAD file display window;
* split up the CONFIGURE main menu option into three submenu
options: one for upload parameters, one for download
parameters, and one for everything else.
* gave several operations back to DOS in order to further
reduce RAM and executable code overhead (HotKey-Z 5.0 is
at least twice as powerful as 1.0, but half the size);
* eliminated some of HotKey-Z's code modularity to reduce
stack usage and provide improved execution efficiency;
* directory display file limit has been changed: HotKey-Z
is now capable of reading up to 350 files per directory;
* added color/monochrome display adaptor auto-detection;
* DOS EXEC functions rewritten to ensure proper hardware
interrupt vector restoration;
* utilized more assembly language for even faster display;
* input prompt procedures were completely rewritten to
resemble those used in other popular applications;
* HotKey-Z may now reside in a directory other than the
directory in which the communication program resides;
* the HOME/END keys will now cause the cursorbar to jump
to the top/bottom of the file directory display window;


* you may now enter menu commands on the DOS commandline
when invoking HotKey-Z in order to bypass the menus:
HotKey-Z will read the commandline and interpret it as a
string of menu initials. For example:
ZMODEM DOWNLOAD: if you called HotKey-Z from your
communication program with the
commandline "HOTKEY-Z.EXE dz" it
will cause the program to begin
a DOWNLOAD (d) using Zmodem (z);
Any combination of main menu and submenu commands may be
issued from the commandline by entering the menu item's
initial in the order you would issue them once inside
HotKey-Z. Commandline arguments are not case-sensitive.
If, for example, you are using Procomm Plus, and you
have HotKey-Z set up as an external protocol (i.e.,
called by pressing Page-Down or Page-Up), then you could
type "dz" at Procomm Plus's commandline prompt and press
Carriage Return and a Zmodem download would commence.
* eliminated a bug that trashed the directory display when
the file displayed was one megabyte or larger in size;
* upon program termination, a null character is placed in
the keyboard buffer to bypass your comm program's "PRESS
ANY KEY..." prompt.
* fixed a bug that prevented changing to some directories
having names comprised of both letters and digits (this
one was a dandy to track down... %$#@*&!);
* modified directory display to resemble DOS's "DIR";
* rewrote directory reading procedure to enhance speed;
* added file creation date display for directory entries;
* eliminated bug when changing display from color to mono;
* COMPLETELY rewrote this .DOC file (improved, hopefully);

Version 6.0:
* eliminated use-counter (I suspect registrations will now
drop to zero but I've grown tired of listening to the
lowlifes complain that use-counters/delays and such make
it difficult for them to be dishonest and dishonorable);
* no more FILES functions per se, instead, the SYSTEM
commands now handle those tasks;
* reduced code size;
* with the elimination of the use-counter, registrants no
longer receive the latest version in the mail (i.e., the
registration allows LEGITIMATE use of the publicly dis-
tributed copy;




SHAREWARE:


HotKey-Z is the culmination of hundreds of hours of work. It has
matured into the most powerful DSZ interface on the market. To assist
in the continued development of HotKey-Z, the author is distributing
the publicly released version under the ShareWare concept. Use of this
application beyond a trial period (typically two weeks) requires regis-
tration. Unfortunately, I have discovered hundreds of instances where
the program has been used beyond what any reasonable person would
define as a trial period. I think this is unfair, particularly given
the nominal registration fee requested. Please support Shareware by
reimbursing authors for their time, effort, and distribution expenses.
Enclosed in this archive is the registration form for HotKey-Z,
titled "REGISTER.ME". Just print it out and fill in the lines. Mail to:

Mark Albrecht
PO Box 2064
Sioux City, IA 51104


UPDATES AND INFORMATION:


Updates to and new releases of HotKey-Z may be found on this BBS
operated by Andy Flatt:

The NightHawk BBS
(319) 338-2961
Iowa City, IA

A well-maintained and active board that is free and open to all users
from their very first call. Callers may leave messages to me (Mark
Albrecht) and I will usually respond within 24 hours. New releases
may be found in the COMM file directory. Just read or leave a message
and you may download the latest release on your very first call.

Thank you for using and supporting HotKey-Z. I hope it fulfills a need.


ACKNOWLEDGEMENT:


NOTE: the following acknowledgements reflect the respective copyrights
and/or trademarks known to be in existence as of this writing.

-Thanks go to Dr. Alex Deluca for beta testing various releases of
the program, and to Andy Flatt for graciously allowing me to field
user questions and distribute HotKey-Z via his bulletin board system.

-DSZ Copyright 1989 Omen Technology, Incorporated. All rights reserved.

-Turbo Pascal 5.0 is a registered trademark of Borland International,
Incorporated.

-Procomm Plus is a registered trademark of Datastorm Technologies, Inc.



 December 27, 2017  Add comments

Leave a Reply