home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Jason Aller Floppy Collection
/
158.img
/
HOTWIRE.ZIP
/
HOTWIRE.HLP
< prev
next >
Wrap
Text File
|
1990-01-01
|
123KB
|
2,206 lines
Sorry, help is not available.
TREE Command Mode (1 of 9)
Welcome to HOT WIRE! This command mode is the top-most command menu. All
other command modes are accessible by selecting options from this menu. Basic
tree functions at the TREE command mode allow changing, making, removing, and
renaming directories on the displayed directory tree.
Menu options are selected by using the space bar or backspace key to move the
highlight bar over the desired option. Pressing the carriage return key will
select the highlighted option. A menu option may also be selected by pressing
the "hot key" associated with that menu option.
Except when in TREE command mode, pressing the escape key from a command menu
will always return to the previous command menu. Pressing the escape key from
the TREE command menu is equivalent to pressing function key F10, which allows
you to exit the program and return to the DOS command line.
The displayed directory tree is a graphical representation of the directory
structure on the current disk drive. Each directory is represented by a node
in the tree. Nodes are connected in accordance with the parent-child
relationships between them. The root directory is always the top node in the
tree. The program sorts alphabetically all nodes which share a common parent
node.
TREE Command Mode (2 of 9)
The current directory on the tree is highlighted with a reverse video bar.
Whenever a new tree is logged, the current directory is set to the same
directory which is current for DOS on that disk drive. This directory is also
referred to as the origin/exit directory because it was the originating
directory when the tree was logged, and it will be the current DOS directory
after exiting the program. The origin/exit directory is displayed with its
own special highlight color. By using the CHDIR command, the origin/exit
directory can be changed, thus changing the directory which is current for
that disk drive after exiting the program.
Traversing the directory tree will move the highlight bar between nodes in the
tree. The keys used to traverse the tree are listed and described below.
The top of the screen displays information about the currently displayed tree
including the volume label, number of directories, number of files, and the
total used and unused disk space. If there are any tagged files in the tree,
the total number of bytes in the tagged files is also displayed. Note that
disk space is represented in K bytes, where 1 K is equal to 1024 bytes.
Towards the bottom of the screen, the current directory status is displayed.
Included here is the drive designator, complete directory path, total number
TREE Command Mode (3 of 9)
of user files and bytes used, directory creation information, and directory
number and level indicators (denoted as (D#,L#)). Tagged file information for
the directory is also displayed when necessary.
The current directory number indicates how many tree nodes have been traversed
to arrive at the current node (or how many nodes away the current directory is
from the root). The level indicates how many node positions to the right the
current directory is from the root. This information is intended only as an
aid in the navigation of very large or complex directory trees.
Directory trees are generally saved to and read from the current drive to
allow quick startup of the program. Tasks such as making and removing
directories which are performed outside of this program will not be evident in
the currently displayed tree until it is physically recreated by using the F8
function key. This will resolve any inconsistencies in the tree. To recreate
the tree each time the program is started, see the help text for the General
Setup information screen (press F2 to access the SETUP command mode).
Getting around in the tree is controlled primarily by the cursor control keys
and other typical movement keys. These are summarized as follows.
TREE Command Mode (4 of 9)
Tree Traversal Keys:
+/- Next/previous tree (if more than 1 is logged)
Home/End Top/bottom node on current display screen
Ctrl Home/End Top/bottom node in tree
/ Next/previous node at same level
─/─ Next/previous node in tree
Ctrl ─/─ Next/previous level on tree
PgUp/PgDn Next/previous tree node display screen
Ctrl-O Go to the origin/exit (DOS) directory node
Using the Home key when the top node on the current display screen is already
highlighted will cause a traversal to the top of the directory tree.
Similarly, using the End key when bottom node is already highlighted will
cause a traversal to the bottom node in the tree.
Using the Ctrl ─ key combination has another special interpretation. It
traverses directly to the parent directory of the currently highlighted
directory node. Note that using Ctrl ─ does not necessarily result in
traversing to the first child of the currently highlighted directory node.
TREE Command Mode (5 of 9)
Other commands such as the FIND command and the F4 and F6 function keys may
also result in a tree traversal.
Command Descriptions:
LIST - This command displays the LIST command mode menu options. When
selected, the program displays the list of files within the currently
highlighted directory, and then allows operations to be performed on
individual files or groups of files in that directory.
SPLIT - This command displays the SPLIT command mode menu options which are
identical to those in the LIST command mode. This command mode is
different from LIST in that it allows simultaneous display of the files
from any two directories, and its operations affect only those two
directories. If the program is started up in "remote" mode, this
command mode will be automatically selected after the remote connection
has been established.
GLOBAL - This command displays the GLOBAL command mode menu options which
allow operations to be performed on the entire directory tree or a
particular directory subtree.
TREE Command Mode (6 of 9)
Command Descriptions:
DISK - This command displays the DISK command mode menu options which allow
you to control which directory trees are available (logged) and to
select which one is currently displayed.
CHDIR - Change the origin/exit directory to the one currently highlighted
by the reverse video bar. When exiting the program, this will become
the current DOS directory on the disk drive referenced by the current
tree. Changing the origin/exit directory also changes the effect of the
Ctrl-O function.
MKDIR - Make a subdirectory (child) at the currently highlighted (parent)
directory. The program will move the highlight bar to the newly created
directory position and prompt for the directory name. An error message
will occur if the directory can not be created. This usually occurs
when the directory already exists in the tree or when a file with the
same name already exists in the parent directory. If the directory
already exists on the disk drive, but was not previously displayed in
the tree, an error message will occur, and the directory will be added
to the tree (you may want to update your tree by using function key F8).
TREE Command Mode (7 of 9)
Command Descriptions:
MKDIR (continued) - After a directory is added successfully, the program
will redisplay it in its correct sorted position relative to its parent.
RMDIR - Remove the currently highlighted directory. Only directories which
are completely empty can be removed. An error message will occur if the
directory contains any files or child directories. Once successfully
removed, the new current directory will become the previous child
directory, if one exists, or the parent directory otherwise. If the
origin/exit directory is removed, it will be reassigned automatically.
RENAME - Change the name of the currently highlighted directory. If
positioned at the root directory node, this command allows adding or
changing the current disk volume label which is displayed at the top
line of the screen. Otherwise, the program will position the cursor at
the current directory name to allow changes. An error message will
occur if the new name is the same as an existing directory which has the
same parent, or if the directory contains a file or child directory with
the same name. If the name is successfully changed, the program will
reposition the node in the correct sorted order.
TREE Command Mode (8 of 9)
Command Descriptions:
FIND - Use this command to locate a directory or file on the disk. To
locate directories, use Ctrl-F when selecting this command. When
prompted, enter a directory name or file specification, including the
"*" and "?" wildcard characters as needed. The program will begin
searching from the top of the directory tree. If a matching directory
or file name is found, the highlight bar will be positioned at that
directory. If it was a file that was found, the program will then
automatically enter the LIST command mode and highlight that file entry.
Use the F6 function key to search for the next occurrence of the
directory or file specification.
F1-HELP - Use the F1 function key to access the on-line help facility. The
Quick Help Summary is initially displayed. Pressing F1 again will
display context-sensitive help for the current command mode. By using
Shift-F1, you can bypass the Quick Help Summary and immediately display
the context-sensitive help. The help file should be located in the
directory specified by your HW environment variable, or in the root
directory of the startup disk if HW is not specified. If the file
cannot be found, only the Quick Help Summary screen will be available.
TREE Command Mode (9 of 9)
The use of the "+" and "-" keys is consistent throughout the program. For
typing convenience, the "=" key can be used in place of the "+" key.
When only a directory tree is displayed, these keys will display the next or
previous tree in the list of currently logged trees. The list is circular so
that when the last tree in the list is displayed, the next tree to be
displayed will be the first tree in the list.
When a file list is displayed, either in LIST or SPLIT mode, these keys will
display the next or previous directory's file list. If already at the top or
bottom of the tree these will have no effect. In LIST mode, the program will
skip directories which have no files to display.
When viewing the contents of a file when no file position marks have been set,
these keys will bring into view the contents of the next or previous file in
the current file list. If you are viewing the last file in the file list, the
"+" key will return you back to the previous command mode. This will also
occur when pressing the "-" key while viewing the first file in the list.
When marks have been set while viewing a file, these keys go to the next or
previous marked file position. The list of set marks is also circular.
DISK Command Mode (1 of 4)
This command mode allows you to control which directory trees are available
(logged) and to select which one is currently displayed. A tree is
distinguished by the drive designator with which it was logged. A drive
designator can be any alphabetic character from "A" to "Z".
In addition, this program allows the "#" symbol to be entered as the drive
designator for the currently displayed tree on the slave machine. This
non-alphabetic character is used because the master and slave machines could
be referencing physically different disk drives which have identical drive
designators (ie: the "A" disk drive on each machine). The "#" symbol is used
to distinguish between them. As a result, only one tree at a time may be
logged from the slave machine. Select the SLAVE command from this menu to
change which tree is currently logged from the slave machine.
A circular list of currently logged trees is maintained by the program. By
using the "+" and "-" keys, the program will display each logged tree in the
list.
Note that two different drive designators could also reference the same
physical disk drive. This is occurrence on local area networks. In
this situation, the logged trees have identical directory trees except for
DISK Command Mode (2 of 4)
their drive designators. You must exercise extreme caution when performing
operations between trees which reference the same physical disk drive. Given
the right circumstances, it is possible to inadvertently delete a file. For
instance, attempting to copy a file into a target directory on another tree
which is actually the same (physical) directory as the source directory will
cause a failure (a file cannot be copied onto itself). The program knows that
something wrong happened to the target file. So instead of leaving an
"invalid" file in the target directory, the program will delete it. But it is
physically the same file that was being copied from the source directory! The
file ends up not being copied at all, but deleted instead.
The same situation could occur between drives created with DOS's SUBST
command, or directories which reference whole drives as can be accomplished
with DOS's JOIN command. You are cautioned against using these commands as
they are unreliable in many situations. In fact, many DOS reference manuals
state that these commands are both unreliable and unpredictable when used
together or with commands such as ASSIGN, BACKUP, CHKDSK, DISKCOMP, DISKCOPY,
FDISK, FORMAT, LABEL, RECOVER, and SYS. Even commands such as CHDIR, MKDIR,
RMDIR, and PATH should be used with care when they can adversely affect a
substituted disk drive. Until such time that the SUBST and JOIN commands are
more stable, you are strongly advised against their use.
DISK Command Mode (3 of 4)
Command Descriptions:
LOG TREE - This option prompts for the drive designator of the tree to be
logged from disk and displayed on screen. Use "#" to indicate the
current tree at the slave machine. If the tree is already logged, it
will be redisplayed. After successful completion of this option, the
program will automatically return to the previous command menu.
UNLOG TREE - This option will remove the specified tree from the list of
available trees. The tree information will be saved to disk if the
setup options are set accordingly (see Setup help). When unlogging the
currently displayed tree, the program will prompt for another tree to
display. When unlogging the slave tree, its tree information is sent
from the master back to the slave. This allows the slave machine to
maintain all changes which may have occurred to its tree.
RECREATE TREE - This option rereads the disk for the specified tree and
displays the updated directory tree information. Use this option when a
tree's information is no longer valid. Function key F8 is equivalent to
recreating the currently displayed tree. When successfully recreated,
the program will automatically return to the previous command menu.
DISK Command Mode (4 of 4)
Command Descriptions:
+NEXT TREE - This option will display the next tree in the list of
available trees. If only one tree is logged, this command has no
effect. If you are currently viewing the last tree in the list, this
command will display the first tree in the list.
-PREV TREE - This option will display the previous tree in the list of
available trees. If only one tree is logged, this command has no
effect. If you are currently viewing the first tree in the list, this
command will display the last tree in the list.
SLAVE - This option is only available when the slave tree is currently
displayed. Use it to log another tree from the slave machine. The
program will prompt you to enter a drive designator. After a valid
entry, the program will unlog the current slave tree and log the new
slave tree.
LIST/SPLIT Command Mode (1 of 9)
These command modes display a list of files for the currently highlighted
directory and allow operations to be performed on the individual files. The
same set of command line options are available for both the LIST and SPLIT
command modes. SPLIT mode differs from LIST mode in that it allows
simultaneous display of any two directories, and its operations can affect
only those two directories. To enter SPLIT mode you must select a second
unique directory to be listed.
SPLIT mode can be entered automatically at program startup if the "Startup
Mode" is set to REMOTE in the Miscellaneous section of the General Setup
screen. In this case, a remote connection is attempted at startup, and if
successful, SPLIT mode will be entered with the master's current directory
file list on the left side of screen and the slave's file list on the right.
Pressing the escape key will exit LIST or SPLIT mode and return to the tree
and directory which are currently active.
Menu options are selected by using the space bar or backspace key to move the
highlight bar over the desired option. Pressing the carriage return key will
select the highlighted option. A menu option may also be selected by pressing
the "hot key" associated with that menu option.
LIST/SPLIT Command Mode (2 of 9)
A file list is very similar to what is displayed by DOS's DIR command. HOT
WIRE, however, will display all files in the current directory including those
which have the hidden file attribute set. It will not display any child
directories which may exist as these are represented in the displayed
directory tree. Files are displayed in sorted order in accordance with the
criteria which have been defined in the General Setup information screen. A
file list may also be uniquely sorted regardless of the setup information.
Each file is represented by its name, extension, size, date, time, and set
attributes. If a file's size is 1,000,000 bytes or greater, its size will be
displayed in kilobytes (a "K" will be appended to the displayed size value).
One kilobyte is equal to 1024 bytes. A file's attributes can be any
combination of the following: "R" for read-only, "H" for hidden, "S" for
system, and "A" for archive. The archive attribute is usually set each time a
file is written to and closed. Many backup utilities make use of this
attribute when determining which files have changed since the last backup
operation was performed. Typically, these backup utilities will reset the
archive attribute after the file is successfully backed up.
Towards the bottom right of the screen where the directory information is
displayed, a current file number indicator (denoted as (F#)) is displayed.
LIST/SPLIT Command Mode (3 of 9)
This number is assigned to each file according to its position in the current
file list. As with the current directory number and level indicators, this
information is intended only as an aid in traversing the file list.
The total size and number of files in the current file list, and, if required,
the total size and number of tagged files, are also displayed as part of the
directory information. In SPLIT mode, total size and file information is
displayed only when there are no tagged files in the file list. Otherwise
just the tagged file information is displayed.
Getting around in the file list is controlled primarily by the cursor control
and paging keys. These are summarized as follows.
File List Traversal Keys:
+/- Next/previous file list
Home/End Top/bottom of file list on display
Ctrl Home/End Top/bottom of file list
/ Next/previous file in list
PgUp/PgDn Next/previous file list display screen
Tab Toggle tag on current file and move to next file
LIST/SPLIT Command Mode (4 of 9)
Other commands such as the FIND command and the F4 and F6 function keys may
also result in a file list traversal, and possibly a tree traversal depending
upon the type of find command last issued.
When in SPLIT mode, the left and right cursor arrow keys are used to change
between the left and right windows. If the window you are changing to is a
directory with no files, the program will prompt you for a new directory path
for that window. This prompt is the same that occurs when pressing the F7
function key. To return back to the other window without changing paths,
press the escape key. To perform file operations, the program requires that
at least one of the split window directories has files displayed.
Many of the commands available in this command mode, as well as other command
modes accessible from this one, require that you specify the scope of the
pending operation. Scope means the number or range of files to be affected.
After the initial command selection, the program will present an additional
set of command options from which the scope is selected. Choices include the
current file, tagged files, or all files in the file list.
In addition to the operation scope, commands such as COPY and MOVE require
further information before the operation can be performed. Each of these
LIST/SPLIT Command Mode (5 of 9)
commands operates between a source and destination (target) directory. In the
SPLIT command mode, the target directory is already known because it was
selected when entering SPLIT mode. The target directory is always the
inactive side of the SPLIT mode screen (the file list without a current file
highlight bar).
In the LIST command mode, only the source directory is known in advance. To
copy or move files, the program will have to prompt you for the target tree
and directory path before proceeding. Help for entering paths is available
when the program prompts you for this information.
To confirm the selected target before copying or moving, set the "Confirm
Before Copying/Moving" switch to YES in the General Setup information screen.
Command Descriptions:
COPY - Select this command to copy file(s) to a specified target directory.
The "File Copy and Move Parameters" in the General Setup information
screen control the conditions under which files are copied. If a copy
operation fails for some unspecified reason (no error message), check
the setup parameters to aid in diagnosis of the failed operation.
LIST/SPLIT Command Mode (6 of 9)
Command Descriptions:
MOVE - Select this command to move file(s) to a specified target directory.
As with copying, the "File Copy and Move Parameters" control the
conditions under which files are moved. Moving files to a target
directory on the same tree (disk drive) is quick and equivalent to
assigning a new directory path to each file. Moving files between
different trees (across drive boundaries) is equivalent to copying the
files to the target directory and then deleting the source files.
DELETE - Select this command to remove file(s) from the current directory
file list. To avoid accidental deletions, make sure the "Confirm
Deletes" parameter is set to YES in the Miscellaneous section of the
General Setup screen. When YES, the program will always prompt you for
confirmation prior to deleting any files. If you try to delete a file
which is marked read-only or is currently in use, an error message will
occur. If all the files in a list are deleted, the HOT WIRE will
automatically exit from LIST mode, or prompt you for a new source
directory path when in SPLIT mode (same prompt as function key F7).
TAG - This option presents the TAG command mode menu options. These
LIST/SPLIT Command Mode (7 of 9)
Command Descriptions:
TAG (continued) - options allow marking specific files in the current file
list for an operation which can then be performed on the tagged files.
UNTAG - Select this option to display the UNTAG command mode menu options.
These options are the same as those available in the TAG command mode
but they undo marks on specific files rather than setting marks.
VIEW - The VIEW command mode provides three different ways to view a file's
contents. Included in the menu options is a FIND command which allows
quick text searches to be performed.
ALTER - Select this option to display the ALTER command mode menu options.
These options allow changing a file's name, date, time, and attributes.
The file contents can be changed with the EDIT FILE option. Help for
these options is available when this is the current command mode.
SORT - This option allows you to change the order of the files in the
current file list. The default sort is defined in the General Setup
information screen.
LIST/SPLIT Command Mode (8 of 9)
Command Descriptions:
FIND - Use this command to locate a directory or file on the disk. When
searching for files, the FIND command searches from the top of the
current file list and continues to the end of the list. To search for
files throughout the tree, use Alt-F when selecting this command. To
locate directories, use Ctrl-F when selecting this command. When
prompted, enter a directory name or file specification, including the
"*" and "?" wildcard characters as needed. When searching in the
current file list only, a successful find will cause the highlight bar
to be repositioned on the file which was found. When searching for
files throughout the tree, a successful find will change the current
directory, display the file list for that directory, and place the
highlight bar on the file which was found. When searching for
directories, a successful find will change the current directory and
display the file list for the directory which was found. In the SPLIT
command mode, the current target directory (the inactive side of the
split screen) will be skipped while searching for directories or files
throughout the tree. An error message will occur when a search is
unsuccessful. Use the F6 function key to continue searching for next
occurrence of the directory or file specification.
LIST/SPLIT Command Mode (9 of 9)
Command Descriptions:
PRINT - The PRINT command mode has options which allow printing a file's
contents or a directory's file list or subtree. This information can be
sent to the display screen, a file, or a printer.
RUN - Use this command to execute the currently highlighted file. Only
files with extensions .BAT, .COM, and .EXE can be run. After the
program executes the file, it will pause for a keystroke before
returning. When running batch files, HOT WIRE will use the COMSPEC
environment variable to locate the file COMMAND.COM. If either cannot
be found, an error message will be displayed. Do not attempt to load a
memory-resident (TSR) program with this command. Doing so will create a
"hole" in memory when HOT WIRE is exited. Subsequent execution of other
programs may cause your system to crash. This option cannot be selected
for files which exist on a slave machine.
GLOBAL Command Mode (1 of 6)
The GLOBAL command mode provides a set of options very similar to those
available in the LIST command mode. The fundamental difference with the
global commands is that they affect operations on files at the "tree" or
directory level versus the "file list" level. In other words, global
operations are performed by selecting the directories that will be affected as
opposed to selecting individual files within a single directory.
The number of directories affected by a global operation depends on the
settings of the "Global Parameters" in the General Setup information screen.
The global commands are very powerful. Before performing any global
operation, make sure that these parameters are set as expected. By default
both parameters are set to YES.
When the "Include All Subdirectories" parameter is set to YES, the program
will perform the current operation on every applicable file in the current
directory as well as every applicable file in all subdirectories which are
children or descendants of the current directory. To operate on an entire
tree, select the root directory as the current directory before selecting a
global command option. When set to NO, the program will perform the operation
on all applicable files in the current directory only. No subdirectories will
be affected.
GLOBAL Command Mode (2 of 6)
When the "Match Subdirectories at Target" parameter is set to YES, the global
copy and move operations will cause directories to be created at the target
tree which have the same names as those in the source tree. In other words,
the source directory subtree will be recreated at the target and all files
that are copied or moved will be placed into their corresponding target
directories. If this parameter is set to NO, then all files will be placed
into the same single target directory. This setup parameter has no effect if
the "Include All Subdirectories" parameter is set to NO.
Many of the commands available in this command mode, as well as other command
modes accessible from this one, require that you specify the scope of the
pending operation. Scope means the number or range of files to be affected.
After the initial command selection, the program will present an additional
set of command options from which the scope is selected. Choices include the
tagged files, or all files in the current directory or subtree. In the GLOBAL
command mode, you may also select to copy, move, or delete directory
structures.
The COPY and MOVE options, as in the LIST command mode, require that you
specify a target tree and directory path before proceeding. Help for entering
paths is available when the program prompts you for this information.
GLOBAL Command Mode (3 of 6)
Command Descriptions:
COPY - Select this command to copy file(s) in the current directory or
subtree to a specified target directory. The "File Copy and Move
Parameters" in the General Setup information screen control the
conditions under which files are copied. If a copy operation fails for
some unspecified reason (no error message), check the setup parameters
for further diagnosis. This command can also be selected to copy a
directory structure without copying its files. In this case, the
selected target directory will become the parent directory of the
resulting subtree which is created. If the source subtree begins with
the root directory, no corresponding target directory will be created
for it.
MOVE - Select this command to move file(s) in the current directory or
subtree to a specified target directory. As with copying, the "File
Copy and Move Parameters" control the conditions under which files are
moved. Moving files to a target directory on the same tree (disk drive)
is quick and equivalent to assigning a new directory path to the source
files. Moving files between different trees (across drive boundaries)
is equivalent to copying the files to the target directory and then
GLOBAL Command Mode (4 of 6)
Command Descriptions:
MOVE (continued) - deleting the source files. Any files remaining in the
source subtree are those which could not be moved or deleted. This
command can also be selected to move a directory structure and all its
files simultaneously. In this case, the selected target directory will
become the parent directory of the resulting subtree which is created.
If the source subtree begins with the root directory, no corresponding
target directory will be created for it. After moving everything, the
program will remove the source directory subtree structure providing it
has no files left.
DELETE - Select this command to remove file(s) from the current directory
or subtree. This command can also be selected to remove all directories
in a subtree provided that there are no files left in the subtree. To
avoid accidental file deletions, make sure the "Confirm Deletes"
parameter is set to YES in the Miscellaneous section of the General
Setup screen. When YES, the program will always prompt you for
confirmation prior to deleting any files. If you try to delete a file
which is marked read-only or is currently in use, an error message will
occur.
GLOBAL Command Mode (5 of 6)
Command Descriptions:
TAG - This option presents the TAG command mode menu options. These
options allow marking specific files in the current directory or subtree
for an operation which can then be performed on the tagged files.
UNTAG - Select this option to display the UNTAG command mode menu options.
These options are the same as those available in the TAG command mode
but they undo marks on specific files rather than setting marks.
ALTER - Select this option to display the ALTER command mode menu options.
These options allow changing the names, dates, times, and attributes of
files in the current directory or subtree.
FIND - Use this command to locate a directory or file on the disk. To
locate directories, use Ctrl-F when selecting this command. When
prompted, enter a directory name or file specification, including the
"*" and "?" wildcard characters as needed. The program will begin
searching from the top of the directory tree. If a matching directory
or file name is found, the highlight bar will be positioned at that
directory. If it was a file that was found, the program will then
GLOBAL Command Mode (6 of 6)
Command Descriptions:
FIND (continued) - automatically enter the LIST command mode and highlight
that file entry. Use the F6 function key to search for the next
occurrence of the directory or file specification.
PRINT - The PRINT command mode has options which allow printing a file's
contents or a directory's file list or subtree. This information can be
sent to the display screen, a file, or a printer.
LIST - This command displays the LIST command mode menu options which
displays the list of files within the currently highlighted directory
and allows operations to be performed on individual files or groups of
files in that directory.
SUBTREE - This option will pop open a window and display the statistics for
the current directory subtree. Included here is the number of
directories, files, bytes, and tagged file information in the current
subtree. To examine statistics for the entire directory tree, traverse
to the root directory before selecting this option. Press any key to
clear the window and return to the previous command menu.
ALTER Command Mode (1 of 4)
This command mode allows changes to be made to a file or group of files.
These changes include the file's name, contents, date and time stamps, and
attributes. Changes can be made from GLOBAL, LIST, and SPLIT command modes.
Changing a file's contents is not available from the GLOBAL command mode.
If a file list is displayed, changes to its files can affect the sort order of
the files. After every operation, the program will check the sort criteria
and resort the file list if necessary. In GLOBAL mode, the file list will be
resorted the next time it is displayed.
If you are currently using function key F4 to traverse to each tagged file,
keep in mind that an alteration to a file which results in an automatic resort
of the file list could reposition the current file ahead or behind other
tagged files which have not or have already been visited by a previous F4
operation. This means that you could inadvertently skip some of the files
which you have tagged. The automatic resort is disabled during macro loop
operations to avoid this potential problem.
Command Descriptions:
RENAME - Select this option to change the name of each file in the selected
ALTER Command Mode (2 of 4)
Command Descriptions:
RENAME (continued) - scope. At the prompt, enter a file name
specification, including the "*" and "?" wildcard characters as needed.
Wildcards are necessary when renaming more than one file at a time. If
renaming the current file only, the program will display the current
file name in the input field for quick changes. When using the "?"
wildcard character, it is possible to rename a file while requesting
more characters than are available from the original file name. For
example, suppose you use DOS's RENAME command to rename the file
"ABC.DOC" as "?????XYZ.*". The resulting file name would be
"ABC XYZ.DOC". The two spaces between the C and X are extra characters
which were properly inserted, but probably unwanted as a file with such
a name cannot be recognized by DOS commands or other programs (spaces
are used by DOS to delimit arguments on a command line). HOT WIRE,
however, avoids the pitfall of such a situation by replacing any blanks
inserted into the middle of a file name with underscore characters. In
this example, the resulting file name would be "ABC__XYZ.DOC".
EDIT FILE - Select this option to change the contents of the current file.
The program will execute the editor program specified in the General
ALTER Command Mode (3 of 4)
Command Descriptions:
EDIT FILE (continued) - Setup information screen, passing to it the name of
the file to be edited. After returning from the editor, the program
will update the file list to show any changes to the file's size, date,
and time. Read-only files generally cannot be edited, so a warning
message will be displayed if this is attempted. An error message will
occur if you have not specified an editor in the General Setup
information screen. This option is not available in GLOBAL mode.
DATE STAMP - This option will allow you to change the date stamp for each
file in the selected scope. The program will prompt for a new date
value. The minimum date which can be entered is 01/01/80. If 01/01/01
is entered, the program will assume that the year is 2001. To quickly
retrieve the current system date, just press the carriage return key.
Date stamps will not be changed on files which are marked as read-only.
TIME STAMP - This option will allow you to change the time stamp for each
file in the selected scope. The program will prompt for a new time
value (hours and minutes) between 00:00 and 23:59. To quickly retrieve
the current system time, just press the carriage return key. Time
ALTER Command Mode (4 of 4)
Command Descriptions:
TIME STAMP (continued) - stamps will not be changed on files which are
marked as read-only.
SET ATTRIB - Select this option to set certain attributes for each file in
the selected scope. The program will prompt you for the list of
attributes to set. Help on entering attributes is available after
selecting this option.
UNSET ATTRIB - Select this option to unset certain attributes for each file
in the selected scope. The program will prompt you for the list of
attributes to unset. Help on entering attributes is available after
selecting this option.
ENTERING ATTRIBUTES (1 of 2)
File attributes are used by DOS to record certain properties of a file. A
file can have any combination of these attributes or none at all. This
program makes use of four different DOS file attributes. Each attribute is
specified by the first letter of its description.
R - This letter indicates a read-only file. This attribute protects a file
from being changed or deleted.
H - This letter indicates a hidden file. Hidden files will not appear in a
directory listing when using the DOS DIR command.
S - This letter indicates a system file. System files are generally used
by DOS during boot operations. They also will not appear when using the
DIR command.
A - This letter indicates an archive file. DOS will set this attribute on
whenever a file is created or changed. This information is often used
by backup utilities to determine which files have changed since the last
backup operation was performed. These utilities will usually set the
archive attribute off after a file is backed up.
ENTERING ATTRIBUTES (2 of 2)
The program will prompt you to enter attributes whenever the ATTRIBUTE option
is selected from the TAG/UNTAG command mode or the SET/UNSET ATTRIB option is
selected from the ALTER command mode. Each attribute is entered by pressing
the first letter of its description. Use the Clear option to erase the
current input and home the cursor position. Press the carriage return key to
accept the current input, or the escape key to abort the operation.
When tagging files by attribute, the program will tag any file found which has
at least one of the attributes specified. For example, if the attributes H
and A were entered, the program will tag all files which have either an H or
an A attribute set. If the same attributes were specified for an untag
operation, the program will untag all files which have an H or A attribute.
If you do not specify attributes, the program will tag or untag all files
which have no attributes set (a special case).
When setting or unsetting attributes, the program will set or unset all
specified attributes for the current scope of files. For example, if the
attributes R and H were specified for a SET ATTRIB operation on a file which
has only an A attribute set, the result would be a file with the R, H, and A
attributes set. If you do not specify attributes, the program will ignore the
current operation.
TAG/UNTAG Command Mode (1 of 4)
This command mode allows you to select groups of files through the use of file
tagging functions. These functions are available from the GLOBAL, LIST, and
SPLIT command modes. Once files are selected, you can choose an operation to
be performed on all the tagged files rather than just one file at a time.
The directory tree information at the top of the screen will indicate the
number and total size in Kbytes of tagged files in the tree. Similar
information is displayed for the current directory in the directory status
information area near the bottom of the screen. The SUBTREE option in the
GLOBAL command mode can be used to display the tagged file totals in a
directory subtree. After a tag/untag operation has completed, the tree and
current directory information will be updated and redisplayed. A message will
be displayed if the operation resulted in no change in tag information.
Files will remain tagged in a logged directory tree until explicitly untagged
by you or by a program operation such as DELETE or MOVE. The F5 function key
can be used to quickly untag all files in a directory tree or file list. The
F8 function key, which is used to recreate a directory tree or file list, will
also untag all tagged files in a tree or list. Unlogging or recreating a tree
from the DISK command mode will have a similar effect. A General Setup option
can also be set so that tagged files will be automatically untagged after they
TAG/UNTAG Command Mode (2 of 4)
are successfully copied.
The TAB key invokes a special tagging function that can be used any time a
file list is displayed. It will toggle the tag status on the current file; an
untagged file will become tagged, and a tagged file will become untagged. The
current file highlight bar will then be moved to the next file in the list.
The F4 function key can be used from many command modes to locate and traverse
to the next tagged file in the directory tree. If you were not viewing a file
list before pressing F4, the program will move the directory highlight bar to
the directory which contains the tagged file, and then will go directly into
the LIST command mode. The tagged file will be displayed at the top of the
file list. When in the SPLIT command mode with the source and target
directories both selected from the same tree, F4 will skip tagged files in the
target directory of the split screen while searching for the next tagged file
in the tree.
Command Descriptions:
CURRENT - This option will tag/untag the current file in the displayed file
list and then move the highlight bar down to the next file in the list.
TAG/UNTAG Command Mode (3 of 4)
Command Descriptions:
WILDCARD - This option allows you to specify a wildcard file specification
using the characters * and ?. Once entered, the program will tag/untag
all files matching the file specification. For example, to tag all
files with a .DOC extension, enter *.DOC in the input field and then
press carriage return.
ALL FILES - This option will tag or untag all files in the current
directory or directory subtree. When the operation has completed, the
program will automatically return to the previous command mode.
DATES - This option allows you to select a range of file dates to be tagged
or untagged. The program will prompt for a "FROM" value and a "THRU"
value, and then will tag/untag all files which have dates which fall
within the range entered (inclusive). The minimum date which can be
entered is 01/01/80. If 01/01/01 is entered, the program will assume
that the year is 2001. To quickly retrieve the current system date,
just press the carriage return key.
SIZES - This option allows you to select a range of file sizes to be
TAG/UNTAG Command Mode (4 of 4)
Command Descriptions:
SIZES (continued) - tagged or untagged. The program will prompt for a
"FROM" value and a "THRU" value, and then will tag/untag all files which
have sizes which fall within the range of values entered (inclusive).
ATTRIBUTE - When this option is selected, the program will prompt for up to
four attributes to be examined. The program will then tag/untag all
files which have at least one of the specified attributes.
INVERT - This option will toggle the tag status on all files in the current
directory or directory subtree. All tagged files will become untagged,
and all untagged files will become tagged. For example, to tag all
files which do not fall within a particular range of date stamps, first
use the DATES option to tag all files within the range, and then select
the INVERT option to toggle all the tags (note: there are other ways to
achieve the same results).
TAG/UNTAG - This option will toggle or reverse the function of the options
in the current command mode.
VIEW Command Mode (1 of 7)
This command mode allows viewing a file's contents in any of three different
display modes. Each display mode is useful for different types of files.
Options available in the VIEW mode allow for fast text searches, marking
certain locations in the file, and jumping directly to any file offset.
The status information at the top of the screen displays the name of the file
which is being viewed, the current display mode, the 8th-bit character mask
status, and the range file offsets which are represented by the current
display lines. A file offset should be thought of as the number of characters
past the start of the file. The start of a file is its first character, so
the offset of the first character is 0. When the last character of a file is
displayed, an end-of-file indicator, <EOF>, will appear next to the range of
offsets.
In the unformatted and hexadecimal display modes, all characters in the file
are displayed on the screen. In the normal text display mode, the characters
which represent carriage return, linefeed, and tab will be interpreted as text
formatting characters and will not be displayed. In the range of ASCII
characters, ASCII values 0 and 255 have no displayable symbol. For these
characters only, the period symbol (.) will be substituted and displayed so
that they can be easily distinguished from space characters.
VIEW Command Mode (2 of 7)
When switching between display modes, the current starting file offset will be
preserved. Because of this, switching to the text display mode may cause the
first line of the display to appear as if it chopped off the first part of the
text line. To see the entire text line as it would normally appear, press the
cursor down key follow by the cursor up key. The same situation could result
when jumping to a particular file offset.
Traversing through a file's contents is controlled with the cursor movement
and paging keys.
File Traversal Keys:
+/- View next/previous file in file list, or traverse between
file marks when any have been set
Home/End First/last screen of file contents
/ Next/previous display line
─/─ Move display text left/right 1 column (TEXT mode only)
Ctrl ─/─ Move display text left/right 40 columns (TEXT mode only)
PgUp/PgDn Next/previous screen of file contents
Tab Toggle tag on current file and move to next file
VIEW Command Mode (3 of 7)
Command Descriptions:
TEXT - This option selects the regular ASCII text display mode. 19 lines of
text can be displayed at a time, and each line may be up to 257
characters in length. An end-of-line condition is defined by a single
carriage return or linefeed character, or by the sequence of carriage
return followed by linefeed, or by the 257th character read, whichever
occurs first. In this display mode, a tab character in a text line will
cause the next character to be displayed at the next eight-character
boundary to the right of the tab character (DOS's default tab stop).
Each text line is displayed 80 characters at a time. If a text line
extends further to the right, use the right arrow key to shift the text
display to the right. When text is shifted, a small arrow () will
occur at the far left of the status line indicating that there is text
to the left of the current display screen. Use the left arrow key to
text display area back to the left. The Ctrl key can be used with the
left and right arrow keys to shift text 40 characters at a time instead.
UNFRMT - This option selects the unformatted ASCII display mode. In this
mode each of the 19 display lines are 80 characters in length, and each
screen of information consists of 1520 total characters. There is no
VIEW Command Mode (4 of 7)
Command Descriptions:
UNFRMT (continued) - text formatting performed, and there is no left or
right scrolling capability. Carriage return, linefeed, and tab
characters are displayable with the UNFRMT option and treated just like
any other character. This mode is useful for viewing the contents of
non-standard text files and binary (.EXE and .COM) files.
HEX - This option selects the hexadecimal display mode. In this mode each
of the 16 display lines represent 16 characters from the file. The
display is divided into three sections. On the left is the hexadecimal
file offset of the line. In the center is the hexadecimal
representation of each character in the line. On the right is the ASCII
representation of each character in the line. Each screen of
information consists of 256 total characters from the file. This
display mode is similar to the unformatted display mode in that no text
formatting is performed and there is no left/right scrolling. HEX mode
is useful for viewing binary files.
FIND - This option allows you to specify text to searched for in the file.
Normally the FIND function is case-insensitive. To perform a
VIEW Command Mode (5 of 7)
Command Descriptions:
FIND (continued) - case-sensitive search, enter a ~ character as the first
character in the input field. Press carriage return to begin the
search. Searching always begins from the top of the file. If a match
is found, the display will be updated and the text will be highlighted
on the first display line. Use the F6 function key to continue
searching for the next occurrence of the text. An error message will
occur when the search fails. Searches for text which contains spaces
due to a tab formatting character will be unsuccessful. A search in
progress can be aborted by pressing the escape key.
MASK - This option will toggle the status of the 8th-bit character mask.
The current mask setting is displayed in the status line at the top of
the screen. When set OFF, the full range of 256 ASCII values is
represented on the screen. When set ON, the 8th-bit of each character
will be ignored, causing only the first 128 ASCII values to be
represented. The mask may improve the readability of files which were
created with certain text editors which use special codes to format the
file contents.
VIEW Command Mode (6 of 7)
Command Descriptions:
JUMP - Select this option to go directly to a particular file offset. The
program will prompt you for the target offset. Entering H as the first
character in the input field will specify the entry as a hexadecimal
number. Entering a + or - at the end of the input will specify that the
number entered is to be added or subtracted from the current starting
offset (jump relative). Otherwise the number entered will become the
new starting offset (jump absolute). If the offset is greater than the
file size, an error message will occur. Otherwise, the display will be
updated at the new starting file offset.
SET MARK - Select this option to record a mark at the current file offset.
The program will display a message indicating which mark was set. Marks
are convenient for quickly traversing to specific locations in a file.
The program will retain the 10 most recently set marks for the currently
viewed file.
GOTO MARK - This option will display a window listing each set file mark
and the file offset which it references. The program will wait for you
to input a mark number. Once entered, the window will be cleared, and
VIEW Command Mode (7 of 7)
Command Descriptions:
GOTO MARK (continued) - the display will be updated to the mark's file
offset. If no marks have been set, an error message will occur.
RESET - Select this option to reset all set file marks. The program will
prompt for confirmation. Once reset, the + and - keys will traverse
between files instead of file marks. If no marks have been set, this
option will have no effect.
+/-[F/M] - Pressing the + and - keys can have two different effects in the
VIEW command mode. An F is displayed between the square brackets when
no file marks have been set. In this case, pressing + or - will display
the contents of the next or previous file in the current file list. If
there is no next or previous file available, the program will return to
the LIST command mode. Once a file mark has been set, an M will be
displayed between the square brackets. Now pressing + or - will
traverse between the next or previous set file marks. Marks must be
reset to be able to traverse between files again.
ENTERING SORT CRITERIA (1 of 4)
A file list can be sorted by any combination of the criteria used to display a
file list entry. Sorting a file list organizes the displayed data and can
help you locate a particular file or group of files more quickly. The program
will also use the sort criteria when performing operations such as copying,
moving, and printing. When no sort criteria are specified, the order in which
files are displayed will correspond exactly to how they displayed when using
the DOS DIR command (sorted by physical location on disk).
The default sort criteria can be specified in the General Setup information
screen so that any file list will initially be displayed in a particular
sorted order.
The order of a displayed file list can be specified individually as well.
However, an individual sort will be used only while the file list is displayed
or is retained in memory because of existing file tags. If the file list has
no tagged files, the default file list sort will be used the next time that
list is displayed.
After changing the default sort criteria, it will automatically be applied to
all existing file lists whose current sort was the same as the previously
defined default sort.
ENTERING SORT CRITERIA (2 of 4)
After selecting the SORT option, the program will display the current sort
criteria along with the command descriptions. Pressing carriage return at any
point will accept the current sort criteria and return to the previous
command menu. To return without making any changes, press the escape key.
Sort commands are entered by pressing the first letter of the command
description. The order in which sort criteria are entered determines the
precedence of each of each entry. For example, if the criteria were entered
as "NS +", the program will display files in ascending order sorted first
by name and then by size among any duplicate names.
To simply reverse the order in which files are currently displayed, press "I"
to invert the sort and then press carriage return. If the first command
entered is anything other than "I", the program will clear the current sort
criteria, display the selected letter, and position the cursor for the next
entry.
Command Descriptions:
Name - Sorts by the names of the files (excluding extensions).
ENTERING SORT CRITERIA (3 of 4)
Command Descriptions:
Ext - Sort by the extensions of the files.
Size - Sorts by the sizes of the files.
Date - Sorts by the dates the files were created or last modified. The
earliest date a file can have is 01/01/80. The date 01/01/79 is assumed
to be the year 2079 (01/01/00 is the year 2000).
Time - Sorts by the times the files were created or last modified. Time
stamps are recorded down to thirtieths of second, but are displayed only
down to minutes. Files are sorted by their recorded time stamps.
Attr - Sorts by the attributes assigned to the files. There are four
different attributes which a file can have. Each attribute has a
different precedence which affects the order in which files are sorted.
This precedence is: none < R < H < S < A. For example, if a file list
is sorted in ascending order by attribute, all files which have no
attributes will occur first (least precedence), followed by those which
have just a read-only attribute, and so forth.
ENTERING SORT CRITERIA (4 of 4)
Command Descriptions:
Invert - Toggles sort order between ascending (+) and descending (-).
Clear - Removes the current sort criteria and repositions the cursor at the
beginning of the input field.
PRINT Command Mode (1 of 5)
The PRINT Command Mode has options which allow printing a file's contents or a
directory's file list or subtree. This information can be sent to a printer,
the display screen, or a file. This command mode is accessible from the
GLOBAL, LIST, and SPLIT command mode menus.
After selecting an option from the PRINT command mode, you will be prompted to
select the scope of the operation. When printing file contents or a list of
files, scope refers to the selections CURRENT FILE, TAGGED FILES, and ALL
FILES. When printing a directory tree, the scope is determined by the global
"Include All Subdirectories" parameter in the General Setup information
screen.
Command Descriptions:
FILE CONTENTS - Select this option to print the contents of each file
within the specified scope. Each printed line can be up to 236
characters in length. Printers which don't support this length may
either wrap the text around to the next line, or truncate the text at
the maximum supported length. An automatic formfeed will be issued
between each printed file.
PRINT Command Mode (2 of 5)
Command Descriptions:
LIST OF FILES - This option prints the same information which the program
displays for each file in a file list. This includes the file name,
extension, size, date and time stamps, and set attributes. A separate
directory header is printed for each directory processed. This includes
the directory path, number of files and bytes, and creation information.
The top of the output has volume and tree information, and the bottom of
the output has a summary of the printed information which includes the
number of directories and files printed and the total size of all files.
DIRECTORY TREE - This option will print directory information for a single
directory or directory subtree. The scope of directories printed
depends on the current position in the directory tree and the value of
the global "Include All Subdirectories" parameter. If this parameter is
set to YES, the scope will include the current directory as well as all
directories which are descendants of the current directory. If the
parameter is set to NO, only the current directory information will be
printed. To print the entire directory tree, make sure the root
directory is current and the global parameter is set to YES. Each
directory printed includes its name, creation date, and the number of
PRINT Command Mode (3 of 5)
Command Descriptions:
DIRECTORY TREE (continued) - files and bytes within the directory. Each
entry is indented in accordance with its relationship to its ancestor
directories. The top of the output has volume and tree information, and
the bottom of the output has a summary of printed information with
respect to the volume information.
After a print option is selected and the scope is determined, the program will
display another set of menu options and prompt you to select a destination for
the generated output. After printing has started, the escape key can be
pressed to abort the operation.
Command Descriptions:
DISPLAY SCREEN - Select this option to send all output to the display
screen. The program will ask you if an automatic pause should occur
between each screen of information. If you answer YES, the program will
wait for a key to be pressed after each pause. If you answer NO, you
can initiate a pause at any time by pressing a key. The pause will be
automatically terminated after the next key press. You can also control
PRINT Command Mode (4 of 5)
Command Descriptions:
DISPLAY SCREEN (continued) - the rate at which each line of output is
displayed. Use the numeric keys 1 to 9 to increase or decrease the
delay between each printed line (1 is the shortest delay between lines
and therefore produces the fastest output).
FILE - Select this option to place all output into a file. The program
will prompt you for the path and file name to use. The default
selection is defined in the General Setup information screen. If no
path is specified, the file will be created or updated in the active
directory. If the file already exists, the program will ask you if it
should be overwritten. If you answer YES, the resultant file will
contain only the new data. If you answer NO, the output will be
appended to the file. Press the escape key to abort any modification to
the existing file. When the output is being generated, text formatting
is included. This means that the current form length is observed, and
formfeeds are inserted into the file where necessary. When the file
containing the output is to be sent to a printer, you should answer NO
at the prompt after selecting the PRINTER command. This will suppress
additional formfeeds which would otherwise be issued while printing.
PRINT Command Mode (5 of 5)
Command Descriptions:
PRINTER - Select this option to send the output to the printer which is
specified in the General Setup information screen. You should make sure
the printer is ready before selecting this option. The program will ask
you if you want to issue formfeeds while printing. Answering YES means
that the program will issue formfeeds in accordance with the Form Length
parameter specified in the General Setup information screen. Answering
NO will suppress these formfeeds, and should be selected when printing
the contents of a file which contains previously generated output.
SETUP Command Mode (1 of 3)
Through this command mode you can define the operating characteristics of the
program and tailor the system to suit your own personal preferences, or to
meet the requirements of special situations.
Setup is divided into four different command modes. Each command mode
displays a particular screen of setup information and allows changes to be
made. Setup values may be accessed and changed from any place in the program
except from the VIEW command mode. The COLORS command mode is available only
when the SETUP command mode is accessed from the TREE command mode.
The program has predefined default values for all setup information. These
values are used whenever an external setup file is not available.
If changes are made to the current setup information, the changes may be saved
to a file stored on disk. If saved, the program will place the setup
information file in the directory specified by the environment variable HW or
in the root directory of the disk drive you started the program from if no
environment variable has been specified. If you press the escape key at this
menu after having made changes, the program will prompt you whether or not to
save the changed information.
SETUP Command Mode (2 of 3)
Command Descriptions:
SAVE - Select this option to save the current setup information to disk and
return to the previous command mode. If the setup file does not exist
it will be created; otherwise it will be overwritten.
QUIT - Select this option to return to the previous command mode without
saving changes to disk. This means that any changes you made will only
be in effect until you exit the program.
GENERAL - This option displays the General Setup information screen which
contains most of the available setup choices.
HOT KEYS - This option displays a setup screen which allows function keys
to be mapped to the names of external programs. By using hot keys,
arguments such as path and file names can be automatically passed to the
external program for immediate processing.
MODEM - Select this option to display or change the setup information
pertaining to remote connections via modem.
SETUP Command Mode (3 of 3)
Command Descriptions:
COLORS - This option allows changes to be made to the colors or screen
attributes used by HOT WIRE. This option is available only when the
SETUP command mode is accessed from the TREE command mode.
GENERAL Command Mode (1 of 19)
This screen displays many different categories of information. The
information in each category can be changed by selecting a category option
from the command menu. The program will expect input for each item of
information in a given category. Pressing carriage return for any input item
will keep the current item's data and move the cursor to the next item.
Pressing the escape key before traversing all the items in a category will
abort all changes which were made in that category and redisplay the previous
values.
Command Descriptions:
FILE - This category identifies the criteria which control how file copy
and move operations behave.
Confirm Before Copying/Moving - When set to YES, this option enables a
system prompt which displays the status of a pending copy or move
operation and then asks you for final confirmation. The status
information includes the number of files to be copied or moved, the
total number of bytes involved, and the target directory path. The
operation can be cancelled by pressing the escape key or answering
"no" at the prompt.
GENERAL Command Mode (2 of 19)
Command Descriptions:
FILE (continued) -
Rename Files at Target Directory - If set to YES, this option will
prompt you for the file specification used in naming the target files
as they are copied or moved. When copying or moving multiple files,
a wildcard specification must be used.
Confirm Before Overwriting - When set to YES, the program will prompt
you before each copy or move operation that would result in
overwriting an existing target file. This allows you to selectively
control which files are overwritten at the target.
Overwrite Newer Files at Target - When set to NO, this option causes the
program to check the date and time of a file about to be overwritten
by a copy or move operation. Only when the source file is newer than
the target file will the copy or move operation take place. If the
"confirm overwrites" option is set to YES, the program will only
prompt you before overwriting target files which are older than the
source file.
GENERAL Command Mode (3 of 19)
Command Descriptions:
FILE (continued) -
Include Hidden and System Files - If set to YES, this option will
include files marked with a hidden or system attribute during an "all
files" copy or move operation. During a "tagged files" or "current
file" operation, tagged or current hidden and system files are copied
without regard to the current setting of this option.
Pause for Unsuccessful Copy/Move - When set to YES, the program will
pause for every unsuccessful copy or move operation and prompt you to
continue or abort the current operation. Continuing allows the
program to proceed with the remaining copy or move operations. When
set to NO, the program continues automatically with the next copy or
move operation after an unsuccessful one. In addition, when copying
or moving files to a remote machine, transmission errors will be
retried until the information is correctly transferred, or until you
abort the operation by pressing the escape key. Critical errors,
however, such as those associated with hardware failures, will always
require a response from you, regardless of how this option is set.
GENERAL Command Mode (4 of 19)
Command Descriptions:
FILE (continued) -
Remove Tag After Successful Copy - If set to YES during a "tagged files"
copy operation, this option causes the program to remove the tag
identifier from each file successfully copied. This allows the
progress of a copy operation to be monitored more closely because the
tag information is updated as each file is copied. The number of
files and bytes not yet copied is displayed for the current directory
as well as the entire directory tree. Also, when the copy operation
has completed, any files that are still tagged are those which were
not successfully copied. Tags are not removed for "current file" or
"all files" copy operations. Note that during move operations, file
tags are always removed.
Verify Disk Write Operations - This option sets the DOS environment
variable (VERIFY=) on or off to enable or disable disk write
verifications. When set on, file copy and move operations will take
a bit longer due to the verification function performed by DOS. For
file copy and move operations between the master and slave machines,
GENERAL Command Mode (5 of 19)
Command Descriptions:
FILE (continued) -
Verify (continued) - make sure the "I/O Pause" flag is set to YES when
the receiving machine has its verify flag set to YES.
GLOBAL - These parameters control the scope of directories affected by a
global operation. The global commands are very powerful. Before
performing any global operation, make sure that you understand what
these parameters mean and how they affect the operation.
Include All Subdirectories - When set to YES, this parameter causes
the program to perform the current global operation on every
applicable file in the current directory as well as every applicable
file in all subdirectories which are children or descendants of the
current directory (affects an entire directory subtree). To operate
on an entire tree, select the root directory as the current directory
before selecting a global command. When set to NO, the program
will perform the global operation on all applicable files in the
current directory only. No subdirectories will be affected.
GENERAL Command Mode (6 of 19)
Command Descriptions:
GLOBAL (continued) -
Match Subdirectories at Target - This parameter only affects the global
copy and move file operations, and only when the Include All
Subdirectories parameter is set to YES. If this option is set to
YES, then for each subdirectory processed at the source a
subdirectory with the same name will be created at the target. In
other words, the source directory subtree will be recreated at the
target and all files that are copied or moved will be placed into the
corresponding target directory. If this option is set to NO, then
all files will be placed into the same single target directory.
COM - This category defines the communications parameters for establishing
a connection between the master and slave machines. The master machine
controls which baud rate and block size are used, and if I/O pause is
enabled or disabled. Once a connection has been established, only the
block size, I/O buffer size, and I/O pause can be changed. These
parameters are used only during file transfers. It is also possible to
change the baud rate, but only with DIRECT connections.
GENERAL Command Mode (7 of 19)
Command Descriptions:
COM (continued) -
COM Port - Assigns which serial port is used by this machine to
communicate with the remote machine. The program supports COM1
through COM8. Once selected, the program will display the default
base address and IRQ line for that serial port. The default values
assigned to COM3 through COM8 are for IBM PS/2 machines. To use COM3
or COM4 on an IBM PC machine, change the default values for base
address and IRQ line to 3E8/IRQ4 for COM3 or to 2E8/IRQ3 for COM4
(these values are somewhat standard, but depending on the hardware
may be reversed as COM3=2E8/IRQ3 and COM4=3E8/IRQ4). If the port
assignment is invalid for the machine, an error message will occur
when a remote connection is attempted.
Base Address - This value is the hexadecimal base address for the
current serial port.
IRQ Line - This value is the IRQ line number supported by the serial
port. The program supports IRQ values 0 through 7.
GENERAL Command Mode (8 of 19)
Command Descriptions:
COM (continued) -
Connection - The connection type can be assigned to DIRECT or MODEM.
DIRECT connections use a null-modem serial cable connected between
the two machines, whereas MODEM connections use modems and telephone
lines to make the connection. Use the space bar to toggle the
current selection. If MODEM is selected, the baud rate displayed
below is the modem's maximum baud rate which is defined in the modem
information screen (select option MODEM from the SETUP command mode).
The modem baud rate can only be changed at the modem information
screen.
Baud Rate - If the connection type is DIRECT, the baud rate can be
changed by using the space bar to display each of the six available
selections. Use the AUTO baud selection to let the program
automatically select a suitable baud rate between the master and
slave machines. If numerous block errors occur during remote
operations, try reducing the baud rate to correct the problem.
GENERAL Command Mode (9 of 19)
Command Descriptions:
COM (continued) -
Block Size - This parameter sets the size of blocks sent between the
master and slave machines during file transfers. Each block sent is
checked for 100% accuracy at the receiving machine. When "noise" is
introduced into a transmission a block error will occur, and the
program will send the block again. Larger block sizes require less
overhead in verification of the transferred data, but require more
time to retransmit after an error has occurred. Use the space bar to
display each of the seven available block sizes. A large block size
is recommended when the machines are directly connected. A smaller
block size is recommended for modem connections where noise is more
common, so that retransmissions are less costly. Also, a smaller
block size can help you monitor transfer progress more closely
because the displayed progress bar is updated more frequently.
I/O Buffer - This parameter determines the amount of information which
is sent or received before the next disk read or write operation
occurs. A larger buffer size means that the program will have to
GENERAL Command Mode (10 of 19)
Command Descriptions:
COM (continued) -
I/O Buffer (continued) - perform disk reads and writes less frequently
than with a smaller buffer size. Use the space bar to toggle between
the available selections. The buffer size ranges from 8K bytes (8192
bytes) up to a maximum of 32K bytes in increments of 8K. The maximum
size may be less than 32K if the amount of RAM available was small
when the program was started. However, it will always be at least
8K. When two machines are connected, the maximum buffer size
available will be the lesser of each machine's maximum size. The
size of the buffer used may affect overall file transfer speeds.
When used in conjunction with the I/O Pause parameter (described
below) set to YES, a larger I/O buffer size is recommended. When I/O
pause is set to NO, a smaller buffer size may be more efficient.
I/O Pause - When this flag is set to YES, the master and slave machines
will pause between disk write operations before sending the next
block of information. This may be necessary when the "Verify Disk
Write Operations" flag is set to YES on the receiving machine, or
GENERAL Command Mode (11 of 19)
Command Descriptions:
COM (continued) -
I/O Pause (continued) - when using high baud rates and working with
machines which have significantly different CPU or disk access speeds
or disk caches. If a transmission is regularly failing with short
blocks, set this option to YES. Otherwise you may leave it set to NO
for faster overall transfers.
SORT - This option determines the default sort used when displaying file
lists. When selected, the program will display the current sort
criteria and prompt you to enter changes. Except for the invert option,
once a keystroke is entered the current sort criteria are cleared and
the new criteria can be entered. Press the carriage return key to
accept the changes or the escape key to abort from any changes.
EDITOR - This option allows you to enter the name of the file editor which
will be used when the EDIT FILE option is selected from the ALTER
command mode. If no path name is specified, your DOS PATH will be
searched for the program. An error message will occur if you select the
GENERAL Command Mode (12 of 19)
Command Descriptions:
EDITOR (continued) - EDIT FILE option when no editor has been specified.
MISC - This option allows changes to be entered for several miscellaneous
operating characteristics of the program.
Save Trees to Disk - Set this option to YES if you want directory tree
information to be saved to disk whenever unlogging a tree or exiting
the program. By doing so, the program can read that information at
other times and quickly log the specified tree. Trees are written to
the root directory of the current disk unless otherwise specified
(set the ALT DIR menu option). If the directory tree information has
changed outside of the program, the tree can be recreated using the
F8 function key so that the tree information is updated the next time
it is saved to disk. If this option is set to NO, the program will
have to scan the disk each time the tree for that disk is logged,
which can be a time-consuming process.
GENERAL Command Mode (13 of 19)
Command Descriptions:
MISC (continued) -
Remove Screen Snow - When set to NO, this option tells the program that
it can write directly to the screen's video buffer without causing
interference ("snow") or flickering to appear on the display screen.
If set to YES, the program will wait for the video hardware to reset
before writing any information to the video buffer. This slows
screen updates dramatically. Snow removal generally is required only
for older style CGA cards.
Use Sound Effects - When set to YES, the program will produce sounds
when opening or closing windows or when displaying messages. Set
this option to NO to disable all sound effects except for those
associated with error messages.
Fast Command Mode - Operations such as copying, moving, and deleting
normally require you to select the scope of files on which the
operation is to be performed. The choices available are the current
file, tagged files, or all files. To avoid this scope selection
GENERAL Command Mode (14 of 19)
Command Descriptions:
MISC (continued) -
Fast Command (continued) - process, set Fast Command Mode to YES. Doing
so will make the current file the default scope selection. To select
tagged files, use the Ctrl key when selecting the option. To select
all files, use the Alt key when selecting the option. The Ctrl and
Alt key combinations are always available independent of the current
setting of this option. Global operations requiring a scope
selection will not be affected by this setup option as "current file"
is not a valid selection in the GLOBAL command mode.
Use Aux File Tags - Set this option to YES to use an auxiliary file tag
indicator () when viewing a directory file list. This is helpful
for monochrome display screens where contrast is weak or difficult to
detect. The file tag indicator will appear between the file's
extension and size.
Confirm Deletes - When this option is set to YES, the program will
prompt you before performing any file delete operations to help avoid
GENERAL Command Mode (15 of 19)
Command Descriptions:
MISC (continued) -
Confirm Deletes (continued) - accidental deletions. When set to NO, the
program will not prompt you before performing a delete operation.
Keyboard Speedup - Set this option to YES to speed up the typematic rate
on an enhanced keyboard. This can dramatically speed up tree and
list traversal operations. After the typematic rate is increased, it
cannot be decreased until the machine is rebooted.
Startup Mode - Use the space bar to toggle between the two available
selections: REMOTE and LOCAL. This option determines what the
program does when it is first executed from the DOS command line. If
the option is set to REMOTE, the program will log and display the
disk's tree and then attempt to connect to the remote machine. If no
command line switch was used, the first machine which loads and
executes the program will attempt to connect as the master machine.
When the program is run on the other machine, it will automatically
connect as the slave. A command line switch can be used to force a
GENERAL Command Mode (16 of 19)
Command Descriptions:
MISC (continued) -
Startup Mode (continued) - machine to assume the master or slave role.
This lets you avoid always having to start the master machine first.
Use /m for master or /s for slave on the DOS command line. If one of
these switches is used, the startup mode defaults to REMOTE. When
the two machines establish a connection, the master machine will
automatically enter the SPLIT command mode with its current directory
file list displayed on the left side of the split window and the
slave's current file list displayed on the right. Entry into the
SPLIT command mode occurs only when the program is first started. If
the program was started up in LOCAL mode, any remote connection which
is made will not result in an entry into the SPLIT command mode.
When the startup mode is set to LOCAL, the machine will log its tree
and remain in the TREE command mode. No remote connection will be
attempted. A command line switch /l may be used to force a LOCAL
startup.
PRINTER - These parameters allow you to define the printer and output
GENERAL Command Mode (17 of 19)
Command Descriptions:
PRINTER (continued) - formats used by the program.
Device - This parameter determines where the output of a printed file or
report is directed. Enter the device name of the parallel or serial
port which is connected to the printer. DOS has several reserved
device names which are generally used for this parameter. PRN or
LPT1 can be entered to reference the first parallel printer attached
to the machine. Other device names which are commonly used include
LPT2, LPT3, AUX, COM1, and COM2.
Init Code Sequence - This parameter defines a printer initialization
sequence which is sent to the printer each time a file or report is
printed. This can be used to cause a printer to reset itself, or set
a particular line spacing, or suppress automatic form feeds, or any
of many other typical printer setup options. These printer commands,
often called escape sequences, are sets of special characters or
values which the printer recognizes as commands rather than data to
be printed. Often the values required in an escape sequence are not
part of the displayable ASCII character set. To allow input of these
GENERAL Command Mode (18 of 19)
Command Descriptions:
PRINTER (continued) -
Init Code (continued) - values, the program recognizes a backslash ("\")
followed by a sequence of three digits which correspond to the ASCII
value to be sent to the printer. For example, the Esc character can
be sent by entering "\027" into the input field for this option. The
sequence Esc followed by the ASCII value 19 would be entered as
"\027\019".
Form length - This parameter's value defines when the program generates
printer form feeds while printing files or reports. Form length is
measured in lines per page, and can have any value from 1 to 255.
Default Print File - This parameter allows you to specify a path and
file name to be used when redirecting output to a file rather than
the printer. If no drive or path is entered, the file will be
created or updated in the currently active directory. When choosing
to print to a file, the program will prompt you whether to use the
default print file or some other file.
GENERAL Command Mode (19 of 19)
Command Descriptions:
ALT DIR - Select this option to specify an alternate directory path to use
when reading or writing the tree information for a particular drive. If
no path is specified, the default is the root directory of that drive.
This is useful for disk organization as well as for drives where write
access to the root directory is not allowed, as is common with networks.
A tree can actually be saved to a different drive if necessary.
HOT KEYS Command Mode (1 of 5)
Hot keys are function keys which are assigned to external programs or DOS
commands. They allow running up to twenty-four different programs at the
touch of a key from any place within the program. Arguments such as paths or
file names can be passed automatically to the external program. You can also
specify that the program prompt you for arguments.
The hot keys are assigned to function keys F1 through F12 when pressed in
conjunction with the Ctrl or Alt keys. For example, to run a program mapped
to the key combination Ctrl-F1, first press down the Ctrl key, and then while
holding it down, press the F1 function key. The F11 and F12 key combinations
are only available on machines which support an extended keyboard.
To enter a hot key definition, select one of the two available menu options.
The program will prompt you for a value from 1 to 12 which corresponds to the
Ctrl or Alt function key F1 through F12. Once entered, the program will place
the cursor at the appropriate entry on the display screen.
First, enter the name of the external program or command. Use a full path
name if the program is not already accessible through the PATH environment
variable. You don't need to include the .BAT, .COM, or .EXE extension. Next
consider if the program will require some kind of input. The argument
HOT KEYS Command Mode (2 of 5)
substitution codes (described below) may be used to retrieve information
directly from a directory tree or file list, or from you after you press the
hot key. When all the information for running the program is entered, press
the carriage return key.
The cursor is now in the ARG field for the current hot key. This input field
requires a yes or no entry. Placing a "Y" in the ARG field means that the
program will display the entire hot key command line for reviewing or changing
before it gets sent to the DOS command processor. When displayed, all
argument substitutions will have already been inserted. At this point you can
enter specific data for the program about to be executed. Also this provides
a way to check the accuracy of any argument substitutions which were
requested. If there is no need to obtain further information from you, set
ARG to "N" to avoid the review process. After answering "Y" or "N" in the ARG
field, the cursor will be moved over to the W input field.
The W input field also requires a yes or no entry. When set to "Y", the
program will wait for a keystroke before returning from the hot key execution.
This is useful for DOS commands such as CHKDSK which normally return to the
DOS command line after execution. Without the W field set to "Y", the CHKDSK
results would be immediately overwritten when returning to HOT WIRE. If there
HOT KEYS Command Mode (3 of 5)
is no need to wait before returning from a hot key execution, place an "N" in
the W input field.
After the hot key is fully entered, the program will prompt for the next hot
key to define. Press the escape key to return to the HOT KEYS command menu.
At this point, any defined hot key may tested for its correct functionality.
Argument substitution codes are used to automatically insert directory tree or
file list information directly into a hot key command before it is executed.
These codes are specified by entering the % character followed by one of the
argument code characters, and then optionally followed with a "P" or "S".
Argument Substitution Codes:
%P - This substitution code means that HOT WIRE will automatically insert a
full directory path, including the drive designator, into the hot key
command. The currently active directory path will be used by default.
If a "P" is appended to the substitution code (entered as %PP), the
program will prompt you for the full directory path to be used. If an
"S" is appended, the program will insert the full directory path from
the target (inactive) side of the SPLIT command mode display screen.
HOT KEYS Command Mode (4 of 5)
Argument Substitution Codes (continued):
%D - This substitution code means that the program will insert the drive
designator of the current tree into the hot key command (including the
colon delimiter). Append a "P" if you are to supply the drive, or an
"S" if the target split window drive is to be used.
%F - This code will cause the HOT WIRE to enter the current file name and
extension into the hot key command. If in the LIST or SPLIT command
mode, the currently highlighted file will be used. If in VIEW mode, the
currently viewed file will be used. If in a command mode where no file
list is displayed, the current directory name and extension will be
used. Append a "P" to prompt you for the file name extension, or append
an "S" to use the file name and extension of the "current" file in the
target split window (distinguished by a ■ character near the middle
column of the screen).
%N - This code is similar to %F except that only the file name will be
inserted into the hot key command. The file extension, if any, will not
be used.
HOT KEYS Command Mode (5 of 5)
Argument Substitution Codes (continued):
%E - This code is similar to %N except that only the three characters of
the file extension will be inserted into the hot key command (excluding
the period (.) delimiter). The file name will not be used.
If an argument substitution code has an "S" appended to reference the target
side of the split window, and the SPLIT command mode is not currently active,
an error message will occur and the hot key will not be executed.
Command Descriptions:
CTRL-KEYS - Select this option to make changes to the hot keys associated
with Ctrl key combinations.
ALT-KEYS - Select this option to make changes to the hot keys associated
with Alt key combinations.
WARNING: A memory-resident program (TSR) should not be loaded through a hot
key definition, as it will create a "hole" in memory when HOT WIRE is exited.
Subsequent execution of other programs may cause your system to crash.
MODEM Command Mode (1 of 5)
When attempting a connection by modem, the programs running on each machine
must first initialize their modems appropriately. The machine which is to
assume the master mode has to dial the phone number which will connect to the
machine assuming the slave mode. The slave machine must already be running
the program and have initialized its modem to automatically answer all
incoming calls.
Once a connection is made between the two machines, you must enter a password
to gain access to the slave machine's disk drives. If the password is
verified, the slave will send its directory tree to the master machine, and
program control resumes at the master machine as if the two were directly
connected.
A modem must receive a command string before it will initialize itself or dial
a phone number. Modem command strings often require special characters or
"control codes" (ASCII 0 through 31) which the modem knows how to interpret.
Since control codes are normally nondisplayable, they are represented in HOT
WIRE by the character ^ (caret -- ASCII value 94) followed by another
character with an ASCII value from 64 to 95. The control code is translated
by subtracting 64 from the value of the character following the ^. For
MODEM Command Mode (2 of 5)
example, the sequence ^@ (caret followed by ASCII value 64) is translated to a
single ASCII value 0; ^A is translated to an ASCII 1, and ^Z is translated to
an ASCII 26. The sequence ^^ is special and translates to a single ^. Note
that this special translation means that there is no sequence available for
representing ASCII 30.
The ~ (tilde) is a character with another special meaning. Each ~ encountered
in a command string causes a half-second pause before the next character is
sent to the modem. This is used in the modem hangup and auto answer commands.
Of the General Options listed below, the dialing command, outgoing phone
number, and dialing command suffix are used only by the machine which is to
assume the master mode when a connection is made. The auto answer command and
incoming password are used only by the machine which is to assume the slave
mode when a connection is made. The remaining options may be used by either
machine.
Except for the hangup command, any changes to the Modem Setup options will not
have any effect until the next time a connection is attempted. The hangup
command is used when breaking an existing connection, so any changes to it
will be valid immediately, even if you are currently connected.
MODEM Command Mode (3 of 5)
Command Descriptions:
GENERAL OPTIONS - These options define the modem command strings, the phone
number called by the master, and the password verified by the slave.
Maximum Baud Rate - This option defines the maximum baud rate at which
the modem's and machine's serial ports can communicate. Usually this
is the same as the maximum baud rate supported by the modem. Once
this option is set, there is really no need to change it. If, after
a connection is established, the modem's baud rate is different than
the defined maximum, the machine will automatically reset its baud
rate to match the modem. Unlike direct connections, changing the
maximum baud rate will have no effect when a connection has already
been established.
Initialization Command - This option specifies a series of commands
which are sent to the modem each time a remote connection is
attempted.
Dialing Command - This option specifies the modem command used to dial a
phone number.
MODEM Command Mode (4 of 5)
Command Descriptions:
GENERAL OPTIONS (continued) -
Outgoing Phone Number - This option contains the digits and codes to be
dialed when attempting a remote connection. Most modems will allow
the entry to include or omit spaces, dashes, and parentheses.
Dialing Command Suffix - This option specifies the set of characters
which tells the modem to begin executing the dialing command.
Hangup Command - This option specifies the command which tells the modem
to hang up (disconnect) the line. When hanging up, the program will
attempt first to hang up the line by dropping the DTR line. If this
fails, it will then attempt hanging up by using this hangup command.
Auto Answer Command - This option specifies the command which tells the
modem to answer all incoming calls automatically.
Incoming Password - This option specifies the password which must be
received from the master machine in order to continue operations.
MODEM Command Mode (5 of 5)
Command Descriptions:
RESULT MESSAGES - When a remote connection is attempted by modem, the modem
will indicate the result by sending a "result message" (sometimes called
a "status message" or "status code") back to the program. In order for
the program to correctly interpret the result messages, they must be
defined in the Modem Setup screen. This program supports two types of
result messages: those which occur when a connection is successful at a
particular baud rate, and those which indicate that no connection was
established.
Baud Connect - These messages specify what is sent by the modem when a
connection is established. Each message corresponds to a particular
baud rate. When the program matches a received message, it then
knows the baud rate at which the modem is communicating. If this
baud rate is different from the modem's maximum baud rate, the
program will reset the communications port to match the modem.
No Connect - These messages are sent by the modem when a connection
attempt is unsuccessful. Typically these messages will indicate a
busy signal, a lack of carrier, a voice connection, or no answer.
COLORS Command Mode (1 of 3)
The COLOR command mode allows you to change the colors used to display
information on the screen. For monochrome systems, the colors are represented
by various shades, contrasts, underlining, and blinking attributes. At
startup, the program will check the monitor type to determine the appropriate
color selections to display. Some monitor types act like color monitors
even though their display screen is monochrome. These are called composite
monitors. In order for the program to display the correct color selections,
use the /b command line switch to force the use of monochrome settings. Once
the setup information is saved to disk, the /b option will not be required
until you want to see the available monochrome selections again.
There are many more color selections available when using a color monitor.
Use the + and - keys to toggle between the two screens of available colors.
This command mode has seven menu selections, six of which display another
command mode menu. When a menu option is selected from one of these submenus,
the program will prompt you to enter a numeric value ranging from 0 through
255 which corresponds to one of the available color selections. The
monochrome selections each have their corresponding value displayed to the
left of the selection. The color selections have their values displayed in
the background and foreground colors they represent.
COLORS Command Mode (2 of 3)
In order to visualize the effects of changes to the current color selections,
a display screen template is updated each time a new color is entered. An
arrow will point to the area on the template which will be affected by the
current entry. The program's working display screen will not be updated until
you exit completely from the SETUP command mode.
Command Descriptions:
BASE - This option displays the menu options which allow changes to be made
to the default background and border colors, the colors used to prompt
you for input data, and the color of highlighted messages which occur
when the program is busy doing something.
COMMAND - This option allows you to change the colors used to display
command menus. In this command submenu, the HOT KEYS option refers to
the key which is pressed to select a menu item. These "hot keys" should
not be confused with the hot keys which run external programs.
TREE INFO - This option allows changes to the colors used to display the
current directory tree and status information.
COLORS Command Mode (3 of 3)
Command Descriptions:
FILE LIST - This option allows you to change the colors used to display
files in a directory. The HIGHLIGHT option refers to the color used to
display a tagged file.
VIEW FILE - This option allows changes to the colors used to display a
file's contents when in the VIEW command mode.
HELP TEXT - This option allows you to change the colors used to display the
on-line help text and quick help summary screen.
DEFAULT - Select this option to reset the colors to the HOT WIRE's
predefined color values. These are the same colors used when the
program is started when no setup file is available.
MACRO Command Mode (1 of 8)
Macros are defined by capturing specific keystroke combinations which group
one or more program operations. A macro file is created for each defined
macro which can then be played back at any time. This program feature
eliminates the need to reenter keystrokes for common or repeated operations.
Macros are recorded to and played back from the directory specified by the
environment variable HW. If none is specified, HOT WIRE will look in the root
directory of the disk drive you started the program from.
A macro can be invoked at program startup with the command option /fMACRO,
where MACRO is an eight character macro file name. Macros can otherwise be
invoked only from the TREE, GLOBAL, LIST, and SPLIT command modes.
Several of the function key combinations control the macro record and playback
modes and are defined as follows:
Shift-F5 - Macro record on/off toggle (record mode only)
Shift-F6 - Macro directory or file location command (record mode only)
Shift-F7 - Macro loop on/off toggle (record mode only)
Shift-F8 - Macro pause on (record mode only)/off toggle
Shift-F9 - Macro playback on/off toggle (playback mode only)
MACRO Command Mode (2 of 8)
To record a macro, make sure one of the valid command modes (TREE, GLOBAL,
LIST, or SPLIT) is currently active and then select Shift-F5. The program
will prompt for a macro name. If the macro name already exists, the program
will ask if the currently defined macro should be overwritten. Once the name
is successfully entered, a thirty character description may be entered to
explain what the macro does. If overwriting an existing macro, the
description will be retained and redisplayed for changes. When entered, the
program will place a "" to the left of the current command mode to indicate
that the program is currently recording a macro. To end the recording, press
Shift-F5 again.
One of the first things to consider is whether or not the proper operation of
the macro depends at all on the current values of the setup parameters. When
the macro is played back at a later time, these values may not be set as you
expected. For instance, if any files are to be copied or moved, the settings
of the "File Copy and Move Parameters" can determine whether a newer file can
be overwritten, or if a file's tag is removed after it is successfully copied.
The settings of the "Global Parameters" can cause a macro to operate on an
entire directory subtree, or only a single directory. In order to ensure that
the macro operates correctly, you will want to record the correct setup
information in your macro. Select the F2 function key to enter the SETUP
MACRO Command Mode (3 of 8)
command mode. Select the appropriate options, and input the correct values
for each the parameters which you require, even if the values are already set
correctly. When you return to the SETUP command mode, you can decide to SAVE
the values permanently, or just for the current session.
While recording a macro, several special macro function keys are available.
Press Shift-F6 (available only at the TREE, GLOBAL, LIST or SPLIT command
modes) to record a specific directory path or file name in the macro. When
the macro is played back, the program will seek for a matching directory path
or file name before proceeding with subsequent commands. This is useful when
a macro is designed solely for a directory or file with a specific name, and
it eliminates the need to traverse a tree or file list prior to playing back a
macro. A message will be displayed indicating that the directory or file name
was recorded.
Shift-F7 is a looping mechanism designed to operate with tagged files and the
F4 function key. Pressing it indicates that the next sequence of commands is
to be repeated until the exit condition is satisfied. This exit condition
occurs when the F4 function key finds no more tagged files. One important
point to remember is that the F4 function key should be pressed at least once
during the definition of the loop and, for most purposes, not more than once.
MACRO Command Mode (4 of 8)
If the F4 key is never entered, the macro will never loop!
While in a loop definition, the program will display a "" character to the
left of the current command mode. Pressing the Shift-F7 function key a second
time will mark the end of the current loop. Another key point is that the
loop should be terminated at the same command mode as it was initiated.
Remember that macros are just a series of keystrokes, and if a macro
re-executes its loop at a different command mode from before, the program will
most likely give a continuous error message indicating that an invalid command
was entered. In odd cases, though, the command may be valid for the current
command mode even though it was not intended for that command mode. This
could produce undesirable side effects. If during a macro playback the
program appears to be looping endlessly, press the escape key or Shift-F9
again to abort the macro. It is likely that the macro was incorrectly
recorded, and must be recorded again.
Shift-F8 is a pausing mechanism which, when entered during the macro record
mode, causes a break in the macro execution during macro playback mode.
Pauses can only be entered during record mode, but can be terminated in either
mode. When a macro is currently on pause, a "" character is displayed at the
left of the current command mode. During a pause all keystrokes are taken
MACRO Command Mode (5 of 8)
directly from the keyboard instead of the macro file. If you are recording,
no more keystrokes will be recorded in the macro file until the pause is
terminated. The pause command is useful when a macro requires data entry (not
commands) from you such as a specific drive, path, or file name, or when
traversing a tree to locate a target directory. If you do not want the macro
to use the same data each time it is played back, insert a macro pause at each
prompt which requires information specifically for the current task.
A macro pause can be terminated in a few different ways. Each way will resume
the macro record or playback operation exactly as if no pause had occurred at
all. One way to terminate a pause is to press the Shift-F8 key again.
The second way involves data entry operations. If a macro pause is invoked
during data entry such as for a path or file name, it will be terminated
automatically when the carriage return key is pressed. This will eliminate an
extra keystroke (the terminating Shift-F8) which would otherwise be entered
just before pressing the carriage return key to exit the data entry field.
If the pause is invoked when prompted for a single character drive designator,
as with the options selected from the DISK Command Mode, the pause will be
automatically terminated when a valid character is entered.
MACRO Command Mode (6 of 8)
A third way to automatically terminate a macro pause is available when
traversing a tree to select a target directory for operations such as copying
and moving files. If the pause is invoked when the program is prompting to
traverse the tree, it will be terminated automatically when the carriage
return key is pressed to select the target directory. This is useful when a
target might be different each time the macro is played back.
For the same reasons as with a macro loop, a macro pause should be terminated
at the same command mode as it was initiated.
There are several situations where the program will automatically cause a
macro pause. These occur when the program is performing an operation which
under some, but not all, circumstances requires additional information from
you such a yes or no answer.
For example, if your macro is copying a file to a target directory where a
file by the same name already exists, you may be prompted, depending on your
current setup information, to confirm overwriting the file. No prompt would
occur if the file did not already exist at the target directory. Another
example is when your macro unlogs a tree. If that tree represents a floppy
disk drive, you will be prompted whether or not to save the tree to disk. No
MACRO Command Mode (7 of 8)
prompt will occur when unlogging trees representing hard disk drives.
In either case, your answer should probably not be recorded in the macro file
unless you are sure that the same prompt and response will be required each
time you playback the macro. If so, you can terminate the automatic macro
pause by pressing Shift-F8. Your response will then be recorded in the macro
and used each time the macro is played back. In general, however, you should
let the program terminate the automatic macro pause itself.
To play back a macro, press Shift-F9 from the TREE, GLOBAL, LIST, or SPLIT
command modes. The program will display a window of available macros sorted
by originating command mode and macro name. For each macro, the program
displays the macro name, description, and command mode from which it was
recorded. The program automatically highlights the macro which was last
played back. Use the cursor control keys to move the highlighted bar over the
desired macro and then press carriage return to begin playback. Alternatively
you may type the macro name and then press carriage return.
If the selected macro originated from a command mode other than the current
command mode, the program will go automatically the appropriate command mode
before executing. If the macro was recorded from the SPLIT command mode, the
MACRO Command Mode (8 of 8)
program will require you to specify the split target directory before the
macro can be executed.
Macros can also be invoked from the command line at program startup by using
the /fMACRO option where MACRO is the macro file name (no file extension is
necessary). These macros should always be defined to operate from the TREE
Command Mode. Special consideration is needed when /f is combined with the
command line options /m or /s which initiate remote communications. When used
with the /m option, the macro will be played back after the machine has
assumed the master mode. When used with the /s option, the macro will be
played back before the machine assumes the slave mode.
A macro which is currently being played back can be aborted by pressing the
Shift-F9 key again. If currently in a macro loop, the escape key will abort
the macro as well.
ENTERING DIRECTORY PATHS (1 of 2)
Specifying a directory path is required whenever copying or moving files or
directories from the LIST or GLOBAL command modes. It's also required when
entering into the SPLIT command mode, or choosing F7 from any command mode to
change the current directory path. There are several ways to specify a
directory path.
Pressing the carriage return key immediately selects the current tree as the
target tree and then allows traversal of the tree to highlight the target
directory. Pressing carriage return again will select the highlighted
directory.
Entering a drive designator only (no colon) and pressing carriage return will
display the specified tree and then allow traversal and directory selection.
If the tree was not yet logged, the program will automatically log it.
Entering a drive designator followed by a colon will select the specified
tree's current directory as the target directory path. If the tree was not
yet logged, it will be automatically logged and the directory selected will be
equivalent to DOS's current working (origin) directory on that drive.
The program will also accept directory paths entered similarly to how they are
ENTERING DIRECTORY PATHS (2 of 2)
entered with DOS's CHDIR command. Entering only a backslash will select the
root directory. This may also be followed with a path or directory name.
Specifying only a directory name will select the child directory (of the
current directory) with that name. If the directory name is only one
character in length, precede it with a drive designator so that the directory
name itself is not confused with a drive letter.
Entering ".." will select the parent of the current directory. Entering ".."
followed by a backslash and directory name or path will select a sibling or
sibling's descendent directory. If this method is used, the ".." must be
specified first and entered once only ("..\..\dirname" or "dirname\.." are
considered invalid entries by the program).
Any of these methods may also incorporate a drive designator.
Finally, the next or previous directory in the tree can be selected by simply
pressing the + or - key. No drive designator is necessary.
If an invalid path is specified, an error message will occur and the current
operation will be aborted. Otherwise the operation will continue normally.
ENTERING OPERATION SCOPE (1 of 2)
Many program operations such as copying, moving, and deleting require you to
select the scope of the pending operation. Scope means the number or range of
files which will be affected.
When not performing global operations, whether or not you are prompted for a
scope selection will depend on the value of the "Fast Command Mode" option in
the Miscellaneous section of the General Setup screen. By setting this option
to YES, the current file becomes the default scope selection. To select
tagged files, use the Ctrl key when selecting the option. To select all
files, use the Alt key when selecting the option. The Ctrl and Alt key
combinations are always available independent of the current setting of this
option. For example, if COPY is the intended command selection, entering
Ctrl-C will copy all tagged files, entering Alt-C will copy all files, and
entering C by itself will copy the current file only.
When performing global operations, the number of files affected will also
depend on the value of the global parameter "Include All Subdirectories" in
the General Setup information screen. When set to YES, all files in the
current directory as well as all files in all its subdirectories (its
descendants) are available in the scope selection. When set to NO, only the
files in the current directory are available.
ENTERING OPERATION SCOPE (2 of 2)
Command Descriptions:
CURRENT FILE - This scope selection will limit the pending program
operation to the currently highlighted file in the file list. This
option is not available for global operations.
TAGGED FILES - This selection will cause the operation to be performed on
all tagged files in the current file list, directory, or directory
subtree. This option is available only when there are tagged files
available. This scope can be selected automatically by holding down the
Ctrl key when selecting the operation to be performed.
ALL FILES - This selection will cause the operation to be performed on all
files in the current file list, directory, or directory subtree. This
scope can be selected automatically by holding down the Alt key when
selecting the operation to be performed.
DIRECTORY STRUCTURE - This option is available only for the global copy,
move, and delete operations. Except for the move operation, this scope
selection will affect directory structures only. Moving a directory
structure, by necessity, moves the files in each directory as well.
END OF HELP