home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 158.img / HOTWIRE.ZIP / HOTWIRE.HLP < prev    next >
Text File  |  1990-01-01  |  123KB  |  2,206 lines

  1. Sorry, help is not available.
  2. TREE Command Mode (1 of 9)
  3. Welcome to HOT WIRE!  This command mode is the top-most command menu.  All
  4. other command modes are accessible by selecting options from this menu.  Basic
  5. tree functions at the TREE command mode allow changing, making, removing, and
  6. renaming directories on the displayed directory tree.
  7.  
  8. Menu options are selected by using the space bar or backspace key to move the
  9. highlight bar over the desired option.  Pressing the carriage return key will
  10. select the highlighted option.  A menu option may also be selected by pressing
  11. the "hot key" associated with that menu option.
  12.  
  13. Except when in TREE command mode, pressing the escape key from a command menu
  14. will always return to the previous command menu.  Pressing the escape key from
  15. the TREE command menu is equivalent to pressing function key F10, which allows
  16. you to exit the program and return to the DOS command line.
  17.  
  18. The displayed directory tree is a graphical representation of the directory
  19. structure on the current disk drive.  Each directory is represented by a node
  20. in the tree.  Nodes are connected in accordance with the parent-child
  21. relationships between them.  The root directory is always the top node in the
  22. tree.  The program sorts alphabetically all nodes which share a common parent
  23. node.
  24. 
  25. TREE Command Mode (2 of 9)
  26. The current directory on the tree is highlighted with a reverse video bar.
  27. Whenever a new tree is logged, the current directory is set to the same
  28. directory which is current for DOS on that disk drive.  This directory is also
  29. referred to as the origin/exit directory because it was the originating
  30. directory when the tree was logged, and it will be the current DOS directory
  31. after exiting the program.  The origin/exit directory is displayed with its
  32. own special highlight color.  By using the CHDIR command, the origin/exit
  33. directory can be changed, thus changing the directory which is current for
  34. that disk drive after exiting the program.
  35.  
  36. Traversing the directory tree will move the highlight bar between nodes in the
  37. tree.  The keys used to traverse the tree are listed and described below.
  38.  
  39. The top of the screen displays information about the currently displayed tree
  40. including the volume label, number of directories, number of files, and the
  41. total used and unused disk space.  If there are any tagged files in the tree,
  42. the total number of bytes in the tagged files is also displayed.  Note that
  43. disk space is represented in K bytes, where 1 K is equal to 1024 bytes.
  44.  
  45. Towards the bottom of the screen, the current directory status is displayed.
  46. Included here is the drive designator, complete directory path, total number
  47. 
  48. TREE Command Mode (3 of 9)
  49. of user files and bytes used, directory creation information, and directory
  50. number and level indicators (denoted as (D#,L#)).  Tagged file information for
  51. the directory is also displayed when necessary.
  52.  
  53. The current directory number indicates how many tree nodes have been traversed
  54. to arrive at the current node (or how many nodes away the current directory is
  55. from the root).  The level indicates how many node positions to the right the
  56. current directory is from the root.  This information is intended only as an
  57. aid in the navigation of very large or complex directory trees.
  58.  
  59. Directory trees are generally saved to and read from the current drive to
  60. allow quick startup of the program.  Tasks such as making and removing
  61. directories which are performed outside of this program will not be evident in
  62. the currently displayed tree until it is physically recreated by using the F8
  63. function key.  This will resolve any inconsistencies in the tree.  To recreate
  64. the tree each time the program is started, see the help text for the General
  65. Setup information screen (press F2 to access the SETUP command mode).
  66.  
  67. Getting around in the tree is controlled primarily by the cursor control keys
  68. and other typical movement keys.  These are summarized as follows.
  69. 
  70. TREE Command Mode (4 of 9)
  71. Tree Traversal Keys:
  72.  
  73.    +/-            Next/previous tree (if more than 1 is logged)
  74.    Home/End       Top/bottom node on current display screen
  75.    Ctrl Home/End  Top/bottom node in tree
  76.    /            Next/previous node at same level
  77.    ─/─          Next/previous node in tree
  78.    Ctrl ─/─     Next/previous level on tree
  79.    PgUp/PgDn      Next/previous tree node display screen
  80.    Ctrl-O         Go to the origin/exit (DOS) directory node
  81.  
  82. Using the Home key when the top node on the current display screen is already
  83. highlighted will cause a traversal to the top of the directory tree.
  84. Similarly, using the End key when bottom node is already highlighted will
  85. cause a traversal to the bottom node in the tree.
  86.  
  87. Using the Ctrl ─ key combination has another special interpretation.  It
  88. traverses directly to the parent directory of the currently highlighted
  89. directory node.  Note that using Ctrl ─ does not necessarily result in
  90. traversing to the first child of the currently highlighted directory node.
  91. 
  92. TREE Command Mode (5 of 9)
  93. Other commands such as the FIND command and the F4 and F6 function keys may
  94. also result in a tree traversal.
  95.  
  96. Command Descriptions:
  97.  
  98.    LIST - This command displays the LIST command mode menu options.  When
  99.       selected, the program displays the list of files within the currently
  100.       highlighted directory, and then allows operations to be performed on
  101.       individual files or groups of files in that directory.
  102.  
  103.    SPLIT - This command displays the SPLIT command mode menu options which are
  104.       identical to those in the LIST command mode.  This command mode is
  105.       different from LIST in that it allows simultaneous display of the files
  106.       from any two directories, and its operations affect only those two
  107.       directories.  If the program is started up in "remote" mode, this
  108.       command mode will be automatically selected after the remote connection
  109.       has been established.
  110.  
  111.    GLOBAL - This command displays the GLOBAL command mode menu options which
  112.       allow operations to be performed on the entire directory tree or a
  113.       particular directory subtree.
  114. 
  115. TREE Command Mode (6 of 9)
  116. Command Descriptions:
  117.  
  118.    DISK - This command displays the DISK command mode menu options which allow
  119.       you to control which directory trees are available (logged) and to
  120.       select which one is currently displayed.
  121.  
  122.    CHDIR - Change the origin/exit directory to the one currently highlighted
  123.       by the reverse video bar.  When exiting the program, this will become
  124.       the current DOS directory on the disk drive referenced by the current
  125.       tree.  Changing the origin/exit directory also changes the effect of the
  126.       Ctrl-O function.
  127.  
  128.    MKDIR - Make a subdirectory (child) at the currently highlighted (parent)
  129.       directory.  The program will move the highlight bar to the newly created
  130.       directory position and prompt for the directory name.  An error message
  131.       will occur if the directory can not be created.  This usually occurs
  132.       when the directory already exists in the tree or when a file with the
  133.       same name already exists in the parent directory.  If the directory
  134.       already exists on the disk drive, but was not previously displayed in
  135.       the tree, an error message will occur, and the directory will be added
  136.       to the tree (you may want to update your tree by using function key F8).
  137. 
  138. TREE Command Mode (7 of 9)
  139. Command Descriptions:
  140.  
  141.    MKDIR (continued) - After a directory is added successfully, the program
  142.       will redisplay it in its correct sorted position relative to its parent.
  143.  
  144.    RMDIR - Remove the currently highlighted directory.  Only directories which
  145.       are completely empty can be removed.  An error message will occur if the
  146.       directory contains any files or child directories.  Once successfully
  147.       removed, the new current directory will become the previous child
  148.       directory, if one exists, or the parent directory otherwise.  If the
  149.       origin/exit directory is removed, it will be reassigned automatically.
  150.  
  151.    RENAME - Change the name of the currently highlighted directory.  If
  152.       positioned at the root directory node, this command allows adding or
  153.       changing the current disk volume label which is displayed at the top
  154.       line of the screen.  Otherwise, the program will position the cursor at
  155.       the current directory name to allow changes.  An error message will
  156.       occur if the new name is the same as an existing directory which has the
  157.       same parent, or if the directory contains a file or child directory with
  158.       the same name.  If the name is successfully changed, the program will
  159.       reposition the node in the correct sorted order.
  160. 
  161. TREE Command Mode (8 of 9)
  162. Command Descriptions:
  163.  
  164.    FIND - Use this command to locate a directory or file on the disk.  To
  165.       locate directories, use Ctrl-F when selecting this command.  When
  166.       prompted, enter a directory name or file specification, including the
  167.       "*" and "?" wildcard characters as needed.  The program will begin
  168.       searching from the top of the directory tree.  If a matching directory
  169.       or file name is found, the highlight bar will be positioned at that
  170.       directory.  If it was a file that was found, the program will then
  171.       automatically enter the LIST command mode and highlight that file entry.
  172.       Use the F6 function key to search for the next occurrence of the
  173.       directory or file specification.
  174.  
  175.    F1-HELP - Use the F1 function key to access the on-line help facility.  The
  176.       Quick Help Summary is initially displayed.  Pressing F1 again will
  177.       display context-sensitive help for the current command mode.  By using
  178.       Shift-F1, you can bypass the Quick Help Summary and immediately display
  179.       the context-sensitive help.  The help file should be located in the
  180.       directory specified by your HW environment variable, or in the root
  181.       directory of the startup disk if HW is not specified.  If the file
  182.       cannot be found, only the Quick Help Summary screen will be available.
  183. 
  184. TREE Command Mode (9 of 9)
  185. The use of the "+" and "-" keys is consistent throughout the program.  For
  186. typing convenience, the "=" key can be used in place of the "+" key.
  187.  
  188. When only a directory tree is displayed, these keys will display the next or
  189. previous tree in the list of currently logged trees.  The list is circular so
  190. that when the last tree in the list is displayed, the next tree to be
  191. displayed will be the first tree in the list.
  192.  
  193. When a file list is displayed, either in LIST or SPLIT mode, these keys will
  194. display the next or previous directory's file list.  If already at the top or
  195. bottom of the tree these will have no effect.  In LIST mode, the program will
  196. skip directories which have no files to display.
  197.  
  198. When viewing the contents of a file when no file position marks have been set,
  199. these keys will bring into view the contents of the next or previous file in
  200. the current file list.  If you are viewing the last file in the file list, the
  201. "+" key will return you back to the previous command mode.  This will also
  202. occur when pressing the "-" key while viewing the first file in the list.
  203.  
  204. When marks have been set while viewing a file, these keys go to the next or
  205. previous marked file position.  The list of set marks is also circular.
  206. DISK Command Mode (1 of 4)
  207. This command mode allows you to control which directory trees are available
  208. (logged) and to select which one is currently displayed.  A tree is
  209. distinguished by the drive designator with which it was logged.  A drive
  210. designator can be any alphabetic character from "A" to "Z".
  211.  
  212. In addition, this program allows the "#" symbol to be entered as the drive
  213. designator for the currently displayed tree on the slave machine.  This
  214. non-alphabetic character is used because the master and slave machines could
  215. be referencing physically different disk drives which have identical drive
  216. designators (ie: the "A" disk drive on each machine).  The "#" symbol is used
  217. to distinguish between them.  As a result, only one tree at a time may be
  218. logged from the slave machine.  Select the SLAVE command from this menu to
  219. change which tree is currently logged from the slave machine.
  220.  
  221. A circular list of currently logged trees is maintained by the program.  By
  222. using the "+" and "-" keys, the program will display each logged tree in the
  223. list.
  224.  
  225. Note that two different drive designators could also reference the same
  226. physical disk drive.  This is occurrence on local area networks.  In
  227. this situation, the logged trees have identical directory trees except for
  228. 
  229. DISK Command Mode (2 of 4)
  230. their drive designators.  You must exercise extreme caution when performing
  231. operations between trees which reference the same physical disk drive.  Given
  232. the right circumstances, it is possible to inadvertently delete a file.  For
  233. instance, attempting to copy a file into a target directory on another tree
  234. which is actually the same (physical) directory as the source directory will
  235. cause a failure (a file cannot be copied onto itself).  The program knows that
  236. something wrong happened to the target file.  So instead of leaving an
  237. "invalid" file in the target directory, the program will delete it.  But it is
  238. physically the same file that was being copied from the source directory!  The
  239. file ends up not being copied at all, but deleted instead.
  240.  
  241. The same situation could occur between drives created with DOS's SUBST
  242. command, or directories which reference whole drives as can be accomplished
  243. with DOS's JOIN command.  You are cautioned against using these commands as
  244. they are unreliable in many situations.  In fact, many DOS reference manuals
  245. state that these commands are both unreliable and unpredictable when used
  246. together or with commands such as ASSIGN, BACKUP, CHKDSK, DISKCOMP, DISKCOPY,
  247. FDISK, FORMAT, LABEL, RECOVER, and SYS.  Even commands such as CHDIR, MKDIR,
  248. RMDIR, and PATH should be used with care when they can adversely affect a
  249. substituted disk drive.  Until such time that the SUBST and JOIN commands are
  250. more stable, you are strongly advised against their use.
  251. 
  252. DISK Command Mode (3 of 4)
  253. Command Descriptions:
  254.  
  255.    LOG TREE - This option prompts for the drive designator of the tree to be
  256.       logged from disk and displayed on screen.  Use "#" to indicate the
  257.       current tree at the slave machine.  If the tree is already logged, it
  258.       will be redisplayed.  After successful completion of this option, the
  259.       program will automatically return to the previous command menu.
  260.  
  261.    UNLOG TREE - This option will remove the specified tree from the list of
  262.       available trees.  The tree information will be saved to disk if the
  263.       setup options are set accordingly (see Setup help).  When unlogging the
  264.       currently displayed tree, the program will prompt for another tree to
  265.       display.  When unlogging the slave tree, its tree information is sent
  266.       from the master back to the slave.  This allows the slave machine to
  267.       maintain all changes which may have occurred to its tree.
  268.  
  269.    RECREATE TREE - This option rereads the disk for the specified tree and
  270.       displays the updated directory tree information.  Use this option when a
  271.       tree's information is no longer valid.  Function key F8 is equivalent to
  272.       recreating the currently displayed tree.  When successfully recreated,
  273.       the program will automatically return to the previous command menu.
  274. 
  275. DISK Command Mode (4 of 4)
  276. Command Descriptions:
  277.  
  278.    +NEXT TREE - This option will display the next tree in the list of
  279.       available trees.  If only one tree is logged, this command has no
  280.       effect.  If you are currently viewing the last tree in the list, this
  281.       command will display the first tree in the list.
  282.  
  283.    -PREV TREE - This option will display the previous tree in the list of
  284.       available trees.  If only one tree is logged, this command has no
  285.       effect.  If you are currently viewing the first tree in the list, this
  286.       command will display the last tree in the list.
  287.  
  288.    SLAVE - This option is only available when the slave tree is currently
  289.       displayed.  Use it to log another tree from the slave machine.  The
  290.       program will prompt you to enter a drive designator.  After a valid
  291.       entry, the program will unlog the current slave tree and log the new
  292.       slave tree.
  293. LIST/SPLIT Command Mode (1 of 9)
  294. These command modes display a list of files for the currently highlighted
  295. directory and allow operations to be performed on the individual files.  The
  296. same set of command line options are available for both the LIST and SPLIT
  297. command modes.  SPLIT mode differs from LIST mode in that it allows
  298. simultaneous display of any two directories, and its operations can affect
  299. only those two directories.  To enter SPLIT mode you must select a second
  300. unique directory to be listed.
  301.  
  302. SPLIT mode can be entered automatically at program startup if the "Startup
  303. Mode" is set to REMOTE in the Miscellaneous section of the General Setup
  304. screen.  In this case, a remote connection is attempted at startup, and if
  305. successful, SPLIT mode will be entered with the master's current directory
  306. file list on the left side of screen and the slave's file list on the right.
  307.  
  308. Pressing the escape key will exit LIST or SPLIT mode and return to the tree
  309. and directory which are currently active.
  310.  
  311. Menu options are selected by using the space bar or backspace key to move the
  312. highlight bar over the desired option.  Pressing the carriage return key will
  313. select the highlighted option.  A menu option may also be selected by pressing
  314. the "hot key" associated with that menu option.
  315. 
  316. LIST/SPLIT Command Mode (2 of 9)
  317. A file list is very similar to what is displayed by DOS's DIR command.  HOT
  318. WIRE, however, will display all files in the current directory including those
  319. which have the hidden file attribute set.  It will not display any child
  320. directories which may exist as these are represented in the displayed
  321. directory tree.  Files are displayed in sorted order in accordance with the
  322. criteria which have been defined in the General Setup information screen.  A
  323. file list may also be uniquely sorted regardless of the setup information.
  324.  
  325. Each file is represented by its name, extension, size, date, time, and set
  326. attributes.  If a file's size is 1,000,000 bytes or greater, its size will be
  327. displayed in kilobytes (a "K" will be appended to the displayed size value).
  328. One kilobyte is equal to 1024 bytes.  A file's attributes can be any
  329. combination of the following:  "R" for read-only, "H" for hidden, "S" for
  330. system, and "A" for archive.  The archive attribute is usually set each time a
  331. file is written to and closed.  Many backup utilities make use of this
  332. attribute when determining which files have changed since the last backup
  333. operation was performed.  Typically, these backup utilities will reset the
  334. archive attribute after the file is successfully backed up.
  335.  
  336. Towards the bottom right of the screen where the directory information is
  337. displayed, a current file number indicator (denoted as (F#)) is displayed.
  338. 
  339. LIST/SPLIT Command Mode (3 of 9)
  340. This number is assigned to each file according to its position in the current
  341. file list.  As with the current directory number and level indicators, this
  342. information is intended only as an aid in traversing the file list.
  343.  
  344. The total size and number of files in the current file list, and, if required,
  345. the total size and number of tagged files, are also displayed as part of the
  346. directory information.  In SPLIT mode, total size and file information is
  347. displayed only when there are no tagged files in the file list.  Otherwise
  348. just the tagged file information is displayed.
  349.  
  350. Getting around in the file list is controlled primarily by the cursor control
  351. and paging keys.  These are summarized as follows.
  352.  
  353. File List Traversal Keys:
  354.  
  355.    +/-            Next/previous file list
  356.    Home/End       Top/bottom of file list on display
  357.    Ctrl Home/End  Top/bottom of file list
  358.    /            Next/previous file in list
  359.    PgUp/PgDn      Next/previous file list display screen
  360.    Tab            Toggle tag on current file and move to next file
  361. 
  362. LIST/SPLIT Command Mode (4 of 9)
  363. Other commands such as the FIND command and the F4 and F6 function keys may
  364. also result in a file list traversal, and possibly a tree traversal depending
  365. upon the type of find command last issued.
  366.  
  367. When in SPLIT mode, the left and right cursor arrow keys are used to change
  368. between the left and right windows.  If the window you are changing to is a
  369. directory with no files, the program will prompt you for a new directory path
  370. for that window.  This prompt is the same that occurs when pressing the F7
  371. function key.  To return back to the other window without changing paths,
  372. press the escape key.  To perform file operations, the program requires that
  373. at least one of the split window directories has files displayed.
  374.  
  375. Many of the commands available in this command mode, as well as other command
  376. modes accessible from this one, require that you specify the scope of the
  377. pending operation.  Scope means the number or range of files to be affected.
  378. After the initial command selection, the program will present an additional
  379. set of command options from which the scope is selected.  Choices include the
  380. current file, tagged files, or all files in the file list.
  381.  
  382. In addition to the operation scope, commands such as COPY and MOVE require
  383. further information before the operation can be performed.  Each of these
  384. 
  385. LIST/SPLIT Command Mode (5 of 9)
  386. commands operates between a source and destination (target) directory.  In the
  387. SPLIT command mode, the target directory is already known because it was
  388. selected when entering SPLIT mode.  The target directory is always the
  389. inactive side of the SPLIT mode screen (the file list without a current file
  390. highlight bar).
  391.  
  392. In the LIST command mode, only the source directory is known in advance.  To
  393. copy or move files, the program will have to prompt you for the target tree
  394. and directory path before proceeding.  Help for entering paths is available
  395. when the program prompts you for this information.
  396.  
  397. To confirm the selected target before copying or moving, set the "Confirm
  398. Before Copying/Moving" switch to YES in the General Setup information screen.
  399.  
  400. Command Descriptions:
  401.  
  402.    COPY - Select this command to copy file(s) to a specified target directory.
  403.       The "File Copy and Move Parameters" in the General Setup information
  404.       screen control the conditions under which files are copied.  If a copy
  405.       operation fails for some unspecified reason (no error message), check
  406.       the setup parameters to aid in diagnosis of the failed operation.
  407. 
  408. LIST/SPLIT Command Mode (6 of 9)
  409. Command Descriptions:
  410.  
  411.    MOVE - Select this command to move file(s) to a specified target directory.
  412.       As with copying, the "File Copy and Move Parameters" control the
  413.       conditions under which files are moved.  Moving files to a target
  414.       directory on the same tree (disk drive) is quick and equivalent to
  415.       assigning a new directory path to each file.  Moving files between
  416.       different trees (across drive boundaries) is equivalent to copying the
  417.       files to the target directory and then deleting the source files.
  418.  
  419.    DELETE - Select this command to remove file(s) from the current directory
  420.       file list.  To avoid accidental deletions, make sure the "Confirm
  421.       Deletes" parameter is set to YES in the Miscellaneous section of the
  422.       General Setup screen.  When YES, the program will always prompt you for
  423.       confirmation prior to deleting any files.  If you try to delete a file
  424.       which is marked read-only or is currently in use, an error message will
  425.       occur.  If all the files in a list are deleted, the HOT WIRE will
  426.       automatically exit from LIST mode, or prompt you for a new source
  427.       directory path when in SPLIT mode (same prompt as function key F7).
  428.  
  429.    TAG - This option presents the TAG command mode menu options.  These
  430. 
  431. LIST/SPLIT Command Mode (7 of 9)
  432. Command Descriptions:
  433.  
  434.    TAG (continued) - options allow marking specific files in the current file
  435.       list for an operation which can then be performed on the tagged files.
  436.  
  437.    UNTAG - Select this option to display the UNTAG command mode menu options.
  438.       These options are the same as those available in the TAG command mode
  439.       but they undo marks on specific files rather than setting marks.
  440.  
  441.    VIEW - The VIEW command mode provides three different ways to view a file's
  442.       contents.  Included in the menu options is a FIND command which allows
  443.       quick text searches to be performed.
  444.  
  445.    ALTER - Select this option to display the ALTER command mode menu options.
  446.       These options allow changing a file's name, date, time, and attributes.
  447.       The file contents can be changed with the EDIT FILE option.  Help for
  448.       these options is available when this is the current command mode.
  449.  
  450.    SORT - This option allows you to change the order of the files in the
  451.       current file list.  The default sort is defined in the General Setup
  452.       information screen.
  453. 
  454. LIST/SPLIT Command Mode (8 of 9)
  455. Command Descriptions:
  456.  
  457.    FIND - Use this command to locate a directory or file on the disk.  When
  458.       searching for files, the FIND command searches from the top of the
  459.       current file list and continues to the end of the list.  To search for
  460.       files throughout the tree, use Alt-F when selecting this command.  To
  461.       locate directories, use Ctrl-F when selecting this command.  When
  462.       prompted, enter a directory name or file specification, including the
  463.       "*" and "?" wildcard characters as needed.  When searching in the
  464.       current file list only, a successful find will cause the highlight bar
  465.       to be repositioned on the file which was found.  When searching for
  466.       files throughout the tree, a successful find will change the current
  467.       directory, display the file list for that directory, and place the
  468.       highlight bar on the file which was found.  When searching for
  469.       directories, a successful find will change the current directory and
  470.       display the file list for the directory which was found.  In the SPLIT
  471.       command mode, the current target directory (the inactive side of the
  472.       split screen) will be skipped while searching for directories or files
  473.       throughout the tree.  An error message will occur when a search is
  474.       unsuccessful.  Use the F6 function key to continue searching for next
  475.       occurrence of the directory or file specification.
  476. 
  477. LIST/SPLIT Command Mode (9 of 9)
  478. Command Descriptions:
  479.  
  480.    PRINT - The PRINT command mode has options which allow printing a file's
  481.       contents or a directory's file list or subtree.  This information can be
  482.       sent to the display screen, a file, or a printer.
  483.  
  484.    RUN - Use this command to execute the currently highlighted file.  Only
  485.       files with extensions .BAT, .COM, and .EXE can be run.  After the
  486.       program executes the file, it will pause for a keystroke before
  487.       returning.  When running batch files, HOT WIRE will use the COMSPEC
  488.       environment variable to locate the file COMMAND.COM.  If either cannot
  489.       be found, an error message will be displayed.  Do not attempt to load a
  490.       memory-resident (TSR) program with this command.  Doing so will create a
  491.       "hole" in memory when HOT WIRE is exited.  Subsequent execution of other
  492.       programs may cause your system to crash.  This option cannot be selected
  493.       for files which exist on a slave machine.
  494. GLOBAL Command Mode (1 of 6)
  495. The GLOBAL command mode provides a set of options very similar to those
  496. available in the LIST command mode.  The fundamental difference with the
  497. global commands is that they affect operations on files at the "tree" or
  498. directory level versus the "file list" level.  In other words, global
  499. operations are performed by selecting the directories that will be affected as
  500. opposed to selecting individual files within a single directory.
  501.  
  502. The number of directories affected by a global operation depends on the
  503. settings of the "Global Parameters" in the General Setup information screen.
  504. The global commands are very powerful.  Before performing any global
  505. operation, make sure that these parameters are set as expected.  By default
  506. both parameters are set to YES.
  507.  
  508. When the "Include All Subdirectories" parameter is set to YES, the program
  509. will perform the current operation on every applicable file in the current
  510. directory as well as every applicable file in all subdirectories which are
  511. children or descendants of the current directory.  To operate on an entire
  512. tree, select the root directory as the current directory before selecting a
  513. global command option.  When set to NO, the program will perform the operation
  514. on all applicable files in the current directory only.  No subdirectories will
  515. be affected.
  516. 
  517. GLOBAL Command Mode (2 of 6)
  518. When the "Match Subdirectories at Target" parameter is set to YES, the global
  519. copy and move operations will cause directories to be created at the target
  520. tree which have the same names as those in the source tree.  In other words,
  521. the source directory subtree will be recreated at the target and all files
  522. that are copied or moved will be placed into their corresponding target
  523. directories.  If this parameter is set to NO, then all files will be placed
  524. into the same single target directory.  This setup parameter has no effect if
  525. the "Include All Subdirectories" parameter is set to NO.
  526.  
  527. Many of the commands available in this command mode, as well as other command
  528. modes accessible from this one, require that you specify the scope of the
  529. pending operation.  Scope means the number or range of files to be affected.
  530. After the initial command selection, the program will present an additional
  531. set of command options from which the scope is selected.  Choices include the
  532. tagged files, or all files in the current directory or subtree.  In the GLOBAL
  533. command mode, you may also select to copy, move, or delete directory
  534. structures.
  535.  
  536. The COPY and MOVE options, as in the LIST command mode, require that you
  537. specify a target tree and directory path before proceeding.  Help for entering
  538. paths is available when the program prompts you for this information.
  539. 
  540. GLOBAL Command Mode (3 of 6)
  541. Command Descriptions:
  542.  
  543.    COPY - Select this command to copy file(s) in the current directory or
  544.       subtree to a specified target directory.  The "File Copy and Move
  545.       Parameters" in the General Setup information screen control the
  546.       conditions under which files are copied.  If a copy operation fails for
  547.       some unspecified reason (no error message), check the setup parameters
  548.       for further diagnosis.  This command can also be selected to copy a
  549.       directory structure without copying its files.  In this case, the
  550.       selected target directory will become the parent directory of the
  551.       resulting subtree which is created.  If the source subtree begins with
  552.       the root directory, no corresponding target directory will be created
  553.       for it.
  554.  
  555.    MOVE - Select this command to move file(s) in the current directory or
  556.       subtree to a specified target directory.  As with copying, the "File
  557.       Copy and Move Parameters" control the conditions under which files are
  558.       moved.  Moving files to a target directory on the same tree (disk drive)
  559.       is quick and equivalent to assigning a new directory path to the source
  560.       files.  Moving files between different trees (across drive boundaries)
  561.       is equivalent to copying the files to the target directory and then
  562. 
  563. GLOBAL Command Mode (4 of 6)
  564. Command Descriptions:
  565.  
  566.    MOVE (continued) - deleting the source files.  Any files remaining in the
  567.       source subtree are those which could not be moved or deleted.  This
  568.       command can also be selected to move a directory structure and all its
  569.       files simultaneously.  In this case, the selected target directory will
  570.       become the parent directory of the resulting subtree which is created.
  571.       If the source subtree begins with the root directory, no corresponding
  572.       target directory will be created for it.  After moving everything, the
  573.       program will remove the source directory subtree structure providing it
  574.       has no files left.
  575.  
  576.    DELETE - Select this command to remove file(s) from the current directory
  577.       or subtree.  This command can also be selected to remove all directories
  578.       in a subtree provided that there are no files left in the subtree.  To
  579.       avoid accidental file deletions, make sure the "Confirm Deletes"
  580.       parameter is set to YES in the Miscellaneous section of the General
  581.       Setup screen.  When YES, the program will always prompt you for
  582.       confirmation prior to deleting any files.  If you try to delete a file
  583.       which is marked read-only or is currently in use, an error message will
  584.       occur.
  585. 
  586. GLOBAL Command Mode (5 of 6)
  587. Command Descriptions:
  588.  
  589.    TAG - This option presents the TAG command mode menu options.  These
  590.       options allow marking specific files in the current directory or subtree
  591.       for an operation which can then be performed on the tagged files.
  592.  
  593.    UNTAG - Select this option to display the UNTAG command mode menu options.
  594.       These options are the same as those available in the TAG command mode
  595.       but they undo marks on specific files rather than setting marks.
  596.  
  597.    ALTER - Select this option to display the ALTER command mode menu options.
  598.       These options allow changing the names, dates, times, and attributes of
  599.       files in the current directory or subtree.
  600.  
  601.    FIND - Use this command to locate a directory or file on the disk.  To
  602.       locate directories, use Ctrl-F when selecting this command.  When
  603.       prompted, enter a directory name or file specification, including the
  604.       "*" and "?" wildcard characters as needed.  The program will begin
  605.       searching from the top of the directory tree.  If a matching directory
  606.       or file name is found, the highlight bar will be positioned at that
  607.       directory.  If it was a file that was found, the program will then
  608. 
  609. GLOBAL Command Mode (6 of 6)
  610. Command Descriptions:
  611.  
  612.    FIND (continued) - automatically enter the LIST command mode and highlight
  613.       that file entry.  Use the F6 function key to search for the next
  614.       occurrence of the directory or file specification.
  615.  
  616.    PRINT - The PRINT command mode has options which allow printing a file's
  617.       contents or a directory's file list or subtree.  This information can be
  618.       sent to the display screen, a file, or a printer.
  619.  
  620.    LIST - This command displays the LIST command mode menu options which
  621.       displays the list of files within the currently highlighted directory
  622.       and allows operations to be performed on individual files or groups of
  623.       files in that directory.
  624.  
  625.    SUBTREE - This option will pop open a window and display the statistics for
  626.       the current directory subtree.  Included here is the number of
  627.       directories, files, bytes, and tagged file information in the current
  628.       subtree.  To examine statistics for the entire directory tree, traverse
  629.       to the root directory before selecting this option.  Press any key to
  630.       clear the window and return to the previous command menu.
  631. ALTER Command Mode (1 of 4)
  632. This command mode allows changes to be made to a file or group of files.
  633. These changes include the file's name, contents, date and time stamps, and
  634. attributes.  Changes can be made from GLOBAL, LIST, and SPLIT command modes.
  635. Changing a file's contents is not available from the GLOBAL command mode.
  636.  
  637. If a file list is displayed, changes to its files can affect the sort order of
  638. the files.  After every operation, the program will check the sort criteria
  639. and resort the file list if necessary.  In GLOBAL mode, the file list will be
  640. resorted the next time it is displayed.
  641.  
  642. If you are currently using function key F4 to traverse to each tagged file,
  643. keep in mind that an alteration to a file which results in an automatic resort
  644. of the file list could reposition the current file ahead or behind other
  645. tagged files which have not or have already been visited by a previous F4
  646. operation.  This means that you could inadvertently skip some of the files
  647. which you have tagged.  The automatic resort is disabled during macro loop
  648. operations to avoid this potential problem.
  649.  
  650. Command Descriptions:
  651.  
  652.    RENAME - Select this option to change the name of each file in the selected
  653. 
  654. ALTER Command Mode (2 of 4)
  655. Command Descriptions:
  656.  
  657.    RENAME (continued) - scope.  At the prompt, enter a file name
  658.       specification, including the "*" and "?" wildcard characters as needed.
  659.       Wildcards are necessary when renaming more than one file at a time.  If
  660.       renaming the current file only, the program will display the current
  661.       file name in the input field for quick changes.  When using the "?"
  662.       wildcard character, it is possible to rename a file while requesting
  663.       more characters than are available from the original file name.  For
  664.       example, suppose you use DOS's RENAME command to rename the file
  665.       "ABC.DOC" as "?????XYZ.*".  The resulting file name would be
  666.       "ABC  XYZ.DOC".  The two spaces between the C and X are extra characters
  667.       which were properly inserted, but probably unwanted as a file with such
  668.       a name cannot be recognized by DOS commands or other programs (spaces
  669.       are used by DOS to delimit arguments on a command line).  HOT WIRE,
  670.       however, avoids the pitfall of such a situation by replacing any blanks
  671.       inserted into the middle of a file name with underscore characters.  In
  672.       this example, the resulting file name would be "ABC__XYZ.DOC".
  673.  
  674.    EDIT FILE - Select this option to change the contents of the current file.
  675.       The program will execute the editor program specified in the General
  676. 
  677. ALTER Command Mode (3 of 4)
  678. Command Descriptions:
  679.  
  680.    EDIT FILE (continued) - Setup information screen, passing to it the name of
  681.       the file to be edited.  After returning from the editor, the program
  682.       will update the file list to show any changes to the file's size, date,
  683.       and time.  Read-only files generally cannot be edited, so a warning
  684.       message will be displayed if this is attempted.  An error message will
  685.       occur if you have not specified an editor in the General Setup
  686.       information screen.  This option is not available in GLOBAL mode.
  687.  
  688.    DATE STAMP - This option will allow you to change the date stamp for each
  689.       file in the selected scope.  The program will prompt for a new date
  690.       value.  The minimum date which can be entered is 01/01/80.  If 01/01/01
  691.       is entered, the program will assume that the year is 2001.  To quickly
  692.       retrieve the current system date, just press the carriage return key.
  693.       Date stamps will not be changed on files which are marked as read-only.
  694.  
  695.    TIME STAMP - This option will allow you to change the time stamp for each
  696.       file in the selected scope.  The program will prompt for a new time
  697.       value (hours and minutes) between 00:00 and 23:59.  To quickly retrieve
  698.       the current system time, just press the carriage return key.  Time
  699. 
  700. ALTER Command Mode (4 of 4)
  701. Command Descriptions:
  702.  
  703.    TIME STAMP (continued) - stamps will not be changed on files which are
  704.       marked as read-only.
  705.  
  706.    SET ATTRIB - Select this option to set certain attributes for each file in
  707.       the selected scope.  The program will prompt you for the list of
  708.       attributes to set.  Help on entering attributes is available after
  709.       selecting this option.
  710.  
  711.    UNSET ATTRIB - Select this option to unset certain attributes for each file
  712.       in the selected scope.  The program will prompt you for the list of
  713.       attributes to unset.  Help on entering attributes is available after
  714.       selecting this option.
  715. ENTERING ATTRIBUTES (1 of 2)
  716. File attributes are used by DOS to record certain properties of a file.  A
  717. file can have any combination of these attributes or none at all.  This
  718. program makes use of four different DOS file attributes.  Each attribute is
  719. specified by the first letter of its description.
  720.  
  721.    R - This letter indicates a read-only file.  This attribute protects a file
  722.       from being changed or deleted.
  723.  
  724.    H - This letter indicates a hidden file.  Hidden files will not appear in a
  725.       directory listing when using the DOS DIR command.
  726.  
  727.    S - This letter indicates a system file.  System files are generally used
  728.       by DOS during boot operations.  They also will not appear when using the
  729.       DIR command.
  730.  
  731.    A - This letter indicates an archive file.  DOS will set this attribute on
  732.       whenever a file is created or changed.  This information is often used
  733.       by backup utilities to determine which files have changed since the last
  734.       backup operation was performed.  These utilities will usually set the
  735.       archive attribute off after a file is backed up.
  736. 
  737. ENTERING ATTRIBUTES (2 of 2)
  738. The program will prompt you to enter attributes whenever the ATTRIBUTE option
  739. is selected from the TAG/UNTAG command mode or the SET/UNSET ATTRIB option is
  740. selected from the ALTER command mode.  Each attribute is entered by pressing
  741. the first letter of its description.  Use the Clear option to erase the
  742. current input and home the cursor position.  Press the carriage return key to
  743. accept the current input, or the escape key to abort the operation.
  744.  
  745. When tagging files by attribute, the program will tag any file found which has
  746. at least one of the attributes specified.  For example, if the attributes H
  747. and A were entered, the program will tag all files which have either an H or
  748. an A attribute set.  If the same attributes were specified for an untag
  749. operation, the program will untag all files which have an H or A attribute.
  750. If you do not specify attributes, the program will tag or untag all files
  751. which have no attributes set (a special case).
  752.  
  753. When setting or unsetting attributes, the program will set or unset all
  754. specified attributes for the current scope of files.  For example, if the
  755. attributes R and H were specified for a SET ATTRIB operation on a file which
  756. has only an A attribute set, the result would be a file with the R, H, and A
  757. attributes set.  If you do not specify attributes, the program will ignore the
  758. current operation.
  759. TAG/UNTAG Command Mode (1 of 4)
  760. This command mode allows you to select groups of files through the use of file
  761. tagging functions.  These functions are available from the GLOBAL, LIST, and
  762. SPLIT command modes.  Once files are selected, you can choose an operation to
  763. be performed on all the tagged files rather than just one file at a time.
  764.  
  765. The directory tree information at the top of the screen will indicate the
  766. number and total size in Kbytes of tagged files in the tree.  Similar
  767. information is displayed for the current directory in the directory status
  768. information area near the bottom of the screen.  The SUBTREE option in the
  769. GLOBAL command mode can be used to display the tagged file totals in a
  770. directory subtree.  After a tag/untag operation has completed, the tree and
  771. current directory information will be updated and redisplayed.  A message will
  772. be displayed if the operation resulted in no change in tag information.
  773.  
  774. Files will remain tagged in a logged directory tree until explicitly untagged
  775. by you or by a program operation such as DELETE or MOVE.  The F5 function key
  776. can be used to quickly untag all files in a directory tree or file list.  The
  777. F8 function key, which is used to recreate a directory tree or file list, will
  778. also untag all tagged files in a tree or list.  Unlogging or recreating a tree
  779. from the DISK command mode will have a similar effect.  A General Setup option
  780. can also be set so that tagged files will be automatically untagged after they
  781. 
  782. TAG/UNTAG Command Mode (2 of 4)
  783. are successfully copied.
  784.  
  785. The TAB key invokes a special tagging function that can be used any time a
  786. file list is displayed.  It will toggle the tag status on the current file; an
  787. untagged file will become tagged, and a tagged file will become untagged.  The
  788. current file highlight bar will then be moved to the next file in the list.
  789.  
  790. The F4 function key can be used from many command modes to locate and traverse
  791. to the next tagged file in the directory tree.  If you were not viewing a file
  792. list before pressing F4, the program will move the directory highlight bar to
  793. the directory which contains the tagged file, and then will go directly into
  794. the LIST command mode.  The tagged file will be displayed at the top of the
  795. file list.  When in the SPLIT command mode with the source and target
  796. directories both selected from the same tree, F4 will skip tagged files in the
  797. target directory of the split screen while searching for the next tagged file
  798. in the tree.
  799.  
  800. Command Descriptions:
  801.  
  802.    CURRENT - This option will tag/untag the current file in the displayed file
  803.       list and then move the highlight bar down to the next file in the list.
  804. 
  805. TAG/UNTAG Command Mode (3 of 4)
  806. Command Descriptions:
  807.  
  808.    WILDCARD - This option allows you to specify a wildcard file specification
  809.       using the characters * and ?. Once entered, the program will tag/untag
  810.       all files matching the file specification.  For example, to tag all
  811.       files with a .DOC extension, enter *.DOC in the input field and then
  812.       press carriage return.
  813.  
  814.    ALL FILES - This option will tag or untag all files in the current
  815.       directory or directory subtree.  When the operation has completed, the
  816.       program will automatically return to the previous command mode.
  817.  
  818.    DATES - This option allows you to select a range of file dates to be tagged
  819.       or untagged.  The program will prompt for a "FROM" value and a "THRU"
  820.       value, and then will tag/untag all files which have dates which fall
  821.       within the range entered (inclusive).  The minimum date which can be
  822.       entered is 01/01/80.  If 01/01/01 is entered, the program will assume
  823.       that the year is 2001.  To quickly retrieve the current system date,
  824.       just press the carriage return key.
  825.  
  826.    SIZES - This option allows you to select a range of file sizes to be
  827. 
  828. TAG/UNTAG Command Mode (4 of 4)
  829. Command Descriptions:
  830.  
  831.    SIZES (continued) - tagged or untagged.  The program will prompt for a
  832.       "FROM" value and a "THRU" value, and then will tag/untag all files which
  833.       have sizes which fall within the range of values entered (inclusive).
  834.  
  835.    ATTRIBUTE - When this option is selected, the program will prompt for up to
  836.       four attributes to be examined.  The program will then tag/untag all
  837.       files which have at least one of the specified attributes.
  838.  
  839.    INVERT - This option will toggle the tag status on all files in the current
  840.       directory or directory subtree.  All tagged files will become untagged,
  841.       and all untagged files will become tagged.  For example, to tag all
  842.       files which do not fall within a particular range of date stamps, first
  843.       use the DATES option to tag all files within the range, and then select
  844.       the INVERT option to toggle all the tags (note:  there are other ways to
  845.       achieve the same results).
  846.  
  847.    TAG/UNTAG - This option will toggle or reverse the function of the options
  848.       in the current command mode.
  849. VIEW Command Mode (1 of 7)
  850. This command mode allows viewing a file's contents in any of three different
  851. display modes.  Each display mode is useful for different types of files.
  852. Options available in the VIEW mode allow for fast text searches, marking
  853. certain locations in the file, and jumping directly to any file offset.
  854.  
  855. The status information at the top of the screen displays the name of the file
  856. which is being viewed, the current display mode, the 8th-bit character mask
  857. status, and the range file offsets which are represented by the current
  858. display lines.  A file offset should be thought of as the number of characters
  859. past the start of the file.  The start of a file is its first character, so
  860. the offset of the first character is 0. When the last character of a file is
  861. displayed, an end-of-file indicator, <EOF>, will appear next to the range of
  862. offsets.
  863.  
  864. In the unformatted and hexadecimal display modes, all characters in the file
  865. are displayed on the screen.  In the normal text display mode, the characters
  866. which represent carriage return, linefeed, and tab will be interpreted as text
  867. formatting characters and will not be displayed.  In the range of ASCII
  868. characters, ASCII values 0 and 255 have no displayable symbol.  For these
  869. characters only, the period symbol (.) will be substituted and displayed so
  870. that they can be easily distinguished from space characters.
  871. 
  872. VIEW Command Mode (2 of 7)
  873. When switching between display modes, the current starting file offset will be
  874. preserved.  Because of this, switching to the text display mode may cause the
  875. first line of the display to appear as if it chopped off the first part of the
  876. text line.  To see the entire text line as it would normally appear, press the
  877. cursor down key follow by the cursor up key.  The same situation could result
  878. when jumping to a particular file offset.
  879.  
  880. Traversing through a file's contents is controlled with the cursor movement
  881. and paging keys.
  882.  
  883. File Traversal Keys:
  884.  
  885.    +/-            View next/previous file in file list, or traverse between
  886.                   file marks when any have been set
  887.    Home/End       First/last screen of file contents
  888.    /            Next/previous display line
  889.    ─/─          Move display text left/right 1 column (TEXT mode only)
  890.    Ctrl ─/─     Move display text left/right 40 columns (TEXT mode only)
  891.    PgUp/PgDn      Next/previous screen of file contents
  892.    Tab            Toggle tag on current file and move to next file
  893. 
  894. VIEW Command Mode (3 of 7)
  895. Command Descriptions:
  896.  
  897.    TEXT - This option selects the regular ASCII text display mode. 19 lines of
  898.       text can be displayed at a time, and each line may be up to 257
  899.       characters in length.  An end-of-line condition is defined by a single
  900.       carriage return or linefeed character, or by the sequence of carriage
  901.       return followed by linefeed, or by the 257th character read, whichever
  902.       occurs first.  In this display mode, a tab character in a text line will
  903.       cause the next character to be displayed at the next eight-character
  904.       boundary to the right of the tab character (DOS's default tab stop).
  905.       Each text line is displayed 80 characters at a time.  If a text line
  906.       extends further to the right, use the right arrow key to shift the text
  907.       display to the right.  When text is shifted, a small arrow () will
  908.       occur at the far left of the status line indicating that there is text
  909.       to the left of the current display screen.  Use the left arrow key to
  910.       text display area back to the left.  The Ctrl key can be used with the
  911.       left and right arrow keys to shift text 40 characters at a time instead.
  912.  
  913.    UNFRMT - This option selects the unformatted ASCII display mode.  In this
  914.       mode each of the 19 display lines are 80 characters in length, and each
  915.       screen of information consists of 1520 total characters.  There is no
  916. 
  917. VIEW Command Mode (4 of 7)
  918. Command Descriptions:
  919.  
  920.    UNFRMT (continued) - text formatting performed, and there is no left or
  921.       right scrolling capability.  Carriage return, linefeed, and tab
  922.       characters are displayable with the UNFRMT option and treated just like
  923.       any other character.  This mode is useful for viewing the contents of
  924.       non-standard text files and binary (.EXE and .COM) files.
  925.  
  926.    HEX - This option selects the hexadecimal display mode.  In this mode each
  927.       of the 16 display lines represent 16 characters from the file.  The
  928.       display is divided into three sections.  On the left is the hexadecimal
  929.       file offset of the line.  In the center is the hexadecimal
  930.       representation of each character in the line.  On the right is the ASCII
  931.       representation of each character in the line.  Each screen of
  932.       information consists of 256 total characters from the file.  This
  933.       display mode is similar to the unformatted display mode in that no text
  934.       formatting is performed and there is no left/right scrolling.  HEX mode
  935.       is useful for viewing binary files.
  936.  
  937.    FIND - This option allows you to specify text to searched for in the file.
  938.       Normally the FIND function is case-insensitive.  To perform a
  939. 
  940. VIEW Command Mode (5 of 7)
  941. Command Descriptions:
  942.  
  943.    FIND (continued) - case-sensitive search, enter a ~ character as the first
  944.       character in the input field.  Press carriage return to begin the
  945.       search.  Searching always begins from the top of the file.  If a match
  946.       is found, the display will be updated and the text will be highlighted
  947.       on the first display line.  Use the F6 function key to continue
  948.       searching for the next occurrence of the text.  An error message will
  949.       occur when the search fails.  Searches for text which contains spaces
  950.       due to a tab formatting character will be unsuccessful.  A search in
  951.       progress can be aborted by pressing the escape key.
  952.  
  953.    MASK - This option will toggle the status of the 8th-bit character mask.
  954.       The current mask setting is displayed in the status line at the top of
  955.       the screen.  When set OFF, the full range of 256 ASCII values is
  956.       represented on the screen.  When set ON, the 8th-bit of each character
  957.       will be ignored, causing only the first 128 ASCII values to be
  958.       represented.  The mask may improve the readability of files which were
  959.       created with certain text editors which use special codes to format the
  960.       file contents.
  961. 
  962. VIEW Command Mode (6 of 7)
  963. Command Descriptions:
  964.  
  965.    JUMP - Select this option to go directly to a particular file offset.  The
  966.       program will prompt you for the target offset.  Entering H as the first
  967.       character in the input field will specify the entry as a hexadecimal
  968.       number.  Entering a + or - at the end of the input will specify that the
  969.       number entered is to be added or subtracted from the current starting
  970.       offset (jump relative).  Otherwise the number entered will become the
  971.       new starting offset (jump absolute).  If the offset is greater than the
  972.       file size, an error message will occur.  Otherwise, the display will be
  973.       updated at the new starting file offset.
  974.  
  975.    SET MARK - Select this option to record a mark at the current file offset.
  976.       The program will display a message indicating which mark was set.  Marks
  977.       are convenient for quickly traversing to specific locations in a file.
  978.       The program will retain the 10 most recently set marks for the currently
  979.       viewed file.
  980.  
  981.    GOTO MARK - This option will display a window listing each set file mark
  982.       and the file offset which it references.  The program will wait for you
  983.       to input a mark number.  Once entered, the window will be cleared, and
  984. 
  985. VIEW Command Mode (7 of 7)
  986. Command Descriptions:
  987.  
  988.    GOTO MARK (continued) - the display will be updated to the mark's file
  989.       offset.  If no marks have been set, an error message will occur.
  990.  
  991.    RESET - Select this option to reset all set file marks.  The program will
  992.       prompt for confirmation.  Once reset, the + and - keys will traverse
  993.       between files instead of file marks.  If no marks have been set, this
  994.       option will have no effect.
  995.  
  996.    +/-[F/M] - Pressing the + and - keys can have two different effects in the
  997.       VIEW command mode.  An F is displayed between the square brackets when
  998.       no file marks have been set.  In this case, pressing + or - will display
  999.       the contents of the next or previous file in the current file list.  If
  1000.       there is no next or previous file available, the program will return to
  1001.       the LIST command mode.  Once a file mark has been set, an M will be
  1002.       displayed between the square brackets.  Now pressing + or - will
  1003.       traverse between the next or previous set file marks.  Marks must be
  1004.       reset to be able to traverse between files again.
  1005. ENTERING SORT CRITERIA (1 of 4)
  1006. A file list can be sorted by any combination of the criteria used to display a
  1007. file list entry.  Sorting a file list organizes the displayed data and can
  1008. help you locate a particular file or group of files more quickly.  The program
  1009. will also use the sort criteria when performing operations such as copying,
  1010. moving, and printing.  When no sort criteria are specified, the order in which
  1011. files are displayed will correspond exactly to how they displayed when using
  1012. the DOS DIR command (sorted by physical location on disk).
  1013.  
  1014. The default sort criteria can be specified in the General Setup information
  1015. screen so that any file list will initially be displayed in a particular
  1016. sorted order.
  1017.  
  1018. The order of a displayed file list can be specified individually as well.
  1019. However, an individual sort will be used only while the file list is displayed
  1020. or is retained in memory because of existing file tags.  If the file list has
  1021. no tagged files, the default file list sort will be used the next time that
  1022. list is displayed.
  1023.  
  1024. After changing the default sort criteria, it will automatically be applied to
  1025. all existing file lists whose current sort was the same as the previously
  1026. defined default sort.
  1027. 
  1028. ENTERING SORT CRITERIA (2 of 4)
  1029. After selecting the SORT option, the program will display the current sort
  1030. criteria along with the command descriptions.  Pressing carriage return at any
  1031. point will accept the current sort criteria and return to the previous
  1032. command menu.  To return without making any changes, press the escape key.
  1033.  
  1034. Sort commands are entered by pressing the first letter of the command
  1035. description.  The order in which sort criteria are entered determines the
  1036. precedence of each of each entry.  For example, if the criteria were entered
  1037. as "NS    +", the program will display files in ascending order sorted first
  1038. by name and then by size among any duplicate names.
  1039.  
  1040. To simply reverse the order in which files are currently displayed, press "I"
  1041. to invert the sort and then press carriage return.  If the first command
  1042. entered is anything other than "I", the program will clear the current sort
  1043. criteria, display the selected letter, and position the cursor for the next
  1044. entry.
  1045.  
  1046. Command Descriptions:
  1047.  
  1048.    Name - Sorts by the names of the files (excluding extensions).
  1049. 
  1050. ENTERING SORT CRITERIA (3 of 4)
  1051. Command Descriptions:
  1052.  
  1053.    Ext - Sort by the extensions of the files.
  1054.  
  1055.    Size - Sorts by the sizes of the files.
  1056.  
  1057.    Date - Sorts by the dates the files were created or last modified.  The
  1058.       earliest date a file can have is 01/01/80.  The date 01/01/79 is assumed
  1059.       to be the year 2079 (01/01/00 is the year 2000).
  1060.  
  1061.    Time - Sorts by the times the files were created or last modified.  Time
  1062.       stamps are recorded down to thirtieths of second, but are displayed only
  1063.       down to minutes.  Files are sorted by their recorded time stamps.
  1064.  
  1065.    Attr - Sorts by the attributes assigned to the files.  There are four
  1066.       different attributes which a file can have.  Each attribute has a
  1067.       different precedence which affects the order in which files are sorted.
  1068.       This precedence is:  none < R < H < S < A. For example, if a file list
  1069.       is sorted in ascending order by attribute, all files which have no
  1070.       attributes will occur first (least precedence), followed by those which
  1071.       have just a read-only attribute, and so forth.
  1072. 
  1073. ENTERING SORT CRITERIA (4 of 4)
  1074. Command Descriptions:
  1075.  
  1076.    Invert - Toggles sort order between ascending (+) and descending (-).
  1077.  
  1078.    Clear - Removes the current sort criteria and repositions the cursor at the
  1079.       beginning of the input field.
  1080. PRINT Command Mode (1 of 5)
  1081. The PRINT Command Mode has options which allow printing a file's contents or a
  1082. directory's file list or subtree.  This information can be sent to a printer,
  1083. the display screen, or a file.  This command mode is accessible from the
  1084. GLOBAL, LIST, and SPLIT command mode menus.
  1085.  
  1086. After selecting an option from the PRINT command mode, you will be prompted to
  1087. select the scope of the operation.  When printing file contents or a list of
  1088. files, scope refers to the selections CURRENT FILE, TAGGED FILES, and ALL
  1089. FILES.  When printing a directory tree, the scope is determined by the global
  1090. "Include All Subdirectories" parameter in the General Setup information
  1091. screen.
  1092.  
  1093. Command Descriptions:
  1094.  
  1095.    FILE CONTENTS - Select this option to print the contents of each file
  1096.       within the specified scope.  Each printed line can be up to 236
  1097.       characters in length.  Printers which don't support this length may
  1098.       either wrap the text around to the next line, or truncate the text at
  1099.       the maximum supported length.  An automatic formfeed will be issued
  1100.       between each printed file.
  1101. 
  1102. PRINT Command Mode (2 of 5)
  1103. Command Descriptions:
  1104.  
  1105.    LIST OF FILES - This option prints the same information which the program
  1106.       displays for each file in a file list.  This includes the file name,
  1107.       extension, size, date and time stamps, and set attributes.  A separate
  1108.       directory header is printed for each directory processed.  This includes
  1109.       the directory path, number of files and bytes, and creation information.
  1110.       The top of the output has volume and tree information, and the bottom of
  1111.       the output has a summary of the printed information which includes the
  1112.       number of directories and files printed and the total size of all files.
  1113.  
  1114.    DIRECTORY TREE - This option will print directory information for a single
  1115.       directory or directory subtree.  The scope of directories printed
  1116.       depends on the current position in the directory tree and the value of
  1117.       the global "Include All Subdirectories" parameter.  If this parameter is
  1118.       set to YES, the scope will include the current directory as well as all
  1119.       directories which are descendants of the current directory.  If the
  1120.       parameter is set to NO, only the current directory information will be
  1121.       printed.  To print the entire directory tree, make sure the root
  1122.       directory is current and the global parameter is set to YES.  Each
  1123.       directory printed includes its name, creation date, and the number of
  1124. 
  1125. PRINT Command Mode (3 of 5)
  1126. Command Descriptions:
  1127.  
  1128.    DIRECTORY TREE (continued) - files and bytes within the directory.  Each
  1129.       entry is indented in accordance with its relationship to its ancestor
  1130.       directories.  The top of the output has volume and tree information, and
  1131.       the bottom of the output has a summary of printed information with
  1132.       respect to the volume information.
  1133.  
  1134. After a print option is selected and the scope is determined, the program will
  1135. display another set of menu options and prompt you to select a destination for
  1136. the generated output.  After printing has started, the escape key can be
  1137. pressed to abort the operation.
  1138.  
  1139. Command Descriptions:
  1140.  
  1141.    DISPLAY SCREEN - Select this option to send all output to the display
  1142.       screen.  The program will ask you if an automatic pause should occur
  1143.       between each screen of information.  If you answer YES, the program will
  1144.       wait for a key to be pressed after each pause.  If you answer NO, you
  1145.       can initiate a pause at any time by pressing a key.  The pause will be
  1146.       automatically terminated after the next key press.  You can also control
  1147. 
  1148. PRINT Command Mode (4 of 5)
  1149. Command Descriptions:
  1150.  
  1151.    DISPLAY SCREEN (continued) - the rate at which each line of output is
  1152.       displayed.  Use the numeric keys 1 to 9 to increase or decrease the
  1153.       delay between each printed line (1 is the shortest delay between lines
  1154.       and therefore produces the fastest output).
  1155.  
  1156.    FILE - Select this option to place all output into a file.  The program
  1157.       will prompt you for the path and file name to use.  The default
  1158.       selection is defined in the General Setup information screen.  If no
  1159.       path is specified, the file will be created or updated in the active
  1160.       directory.  If the file already exists, the program will ask you if it
  1161.       should be overwritten.  If you answer YES, the resultant file will
  1162.       contain only the new data.  If you answer NO, the output will be
  1163.       appended to the file.  Press the escape key to abort any modification to
  1164.       the existing file.  When the output is being generated, text formatting
  1165.       is included.  This means that the current form length is observed, and
  1166.       formfeeds are inserted into the file where necessary.  When the file
  1167.       containing the output is to be sent to a printer, you should answer NO
  1168.       at the prompt after selecting the PRINTER command.  This will suppress
  1169.       additional formfeeds which would otherwise be issued while printing.
  1170. 
  1171. PRINT Command Mode (5 of 5)
  1172. Command Descriptions:
  1173.  
  1174.    PRINTER - Select this option to send the output to the printer which is
  1175.       specified in the General Setup information screen.  You should make sure
  1176.       the printer is ready before selecting this option.  The program will ask
  1177.       you if you want to issue formfeeds while printing.  Answering YES means
  1178.       that the program will issue formfeeds in accordance with the Form Length
  1179.       parameter specified in the General Setup information screen.  Answering
  1180.       NO will suppress these formfeeds, and should be selected when printing
  1181.       the contents of a file which contains previously generated output.
  1182. SETUP Command Mode (1 of 3)
  1183. Through this command mode you can define the operating characteristics of the
  1184. program and tailor the system to suit your own personal preferences, or to
  1185. meet the requirements of special situations.
  1186.  
  1187. Setup is divided into four different command modes.  Each command mode
  1188. displays a particular screen of setup information and allows changes to be
  1189. made.  Setup values may be accessed and changed from any place in the program
  1190. except from the VIEW command mode.  The COLORS command mode is available only
  1191. when the SETUP command mode is accessed from the TREE command mode.
  1192.  
  1193. The program has predefined default values for all setup information.  These
  1194. values are used whenever an external setup file is not available.
  1195.  
  1196. If changes are made to the current setup information, the changes may be saved
  1197. to a file stored on disk.  If saved, the program will place the setup
  1198. information file in the directory specified by the environment variable HW or
  1199. in the root directory of the disk drive you started the program from if no
  1200. environment variable has been specified.  If you press the escape key at this
  1201. menu after having made changes, the program will prompt you whether or not to
  1202. save the changed information.
  1203. 
  1204. SETUP Command Mode (2 of 3)
  1205. Command Descriptions:
  1206.  
  1207.    SAVE - Select this option to save the current setup information to disk and
  1208.       return to the previous command mode.  If the setup file does not exist
  1209.       it will be created; otherwise it will be overwritten.
  1210.  
  1211.    QUIT - Select this option to return to the previous command mode without
  1212.       saving changes to disk.  This means that any changes you made will only
  1213.       be in effect until you exit the program.
  1214.  
  1215.    GENERAL - This option displays the General Setup information screen which
  1216.       contains most of the available setup choices.
  1217.  
  1218.    HOT KEYS - This option displays a setup screen which allows function keys
  1219.       to be mapped to the names of external programs.  By using hot keys,
  1220.       arguments such as path and file names can be automatically passed to the
  1221.       external program for immediate processing.
  1222.  
  1223.    MODEM - Select this option to display or change the setup information
  1224.       pertaining to remote connections via modem.
  1225. 
  1226. SETUP Command Mode (3 of 3)
  1227. Command Descriptions:
  1228.  
  1229.    COLORS - This option allows changes to be made to the colors or screen
  1230.       attributes used by HOT WIRE.  This option is available only when the
  1231.       SETUP command mode is accessed from the TREE command mode.
  1232. GENERAL Command Mode (1 of 19)
  1233. This screen displays many different categories of information.  The
  1234. information in each category can be changed by selecting a category option
  1235. from the command menu.  The program will expect input for each item of
  1236. information in a given category.  Pressing carriage return for any input item
  1237. will keep the current item's data and move the cursor to the next item.
  1238. Pressing the escape key before traversing all the items in a category will
  1239. abort all changes which were made in that category and redisplay the previous
  1240. values.
  1241.  
  1242. Command Descriptions:
  1243.  
  1244.    FILE - This category identifies the criteria which control how file copy
  1245.       and move operations behave.
  1246.  
  1247.       Confirm Before Copying/Moving - When set to YES, this option enables a
  1248.          system prompt which displays the status of a pending copy or move
  1249.          operation and then asks you for final confirmation.  The status
  1250.          information includes the number of files to be copied or moved, the
  1251.          total number of bytes involved, and the target directory path.  The
  1252.          operation can be cancelled by pressing the escape key or answering
  1253.          "no" at the prompt.
  1254. 
  1255. GENERAL Command Mode (2 of 19)
  1256. Command Descriptions:
  1257.  
  1258.    FILE (continued) -
  1259.  
  1260.       Rename Files at Target Directory - If set to YES, this option will
  1261.          prompt you for the file specification used in naming the target files
  1262.          as they are copied or moved.  When copying or moving multiple files,
  1263.          a wildcard specification must be used.
  1264.  
  1265.       Confirm Before Overwriting - When set to YES, the program will prompt
  1266.          you before each copy or move operation that would result in
  1267.          overwriting an existing target file.  This allows you to selectively
  1268.          control which files are overwritten at the target.
  1269.  
  1270.       Overwrite Newer Files at Target - When set to NO, this option causes the
  1271.          program to check the date and time of a file about to be overwritten
  1272.          by a copy or move operation.  Only when the source file is newer than
  1273.          the target file will the copy or move operation take place.  If the
  1274.          "confirm overwrites" option is set to YES, the program will only
  1275.          prompt you before overwriting target files which are older than the
  1276.          source file.
  1277. 
  1278. GENERAL Command Mode (3 of 19)
  1279. Command Descriptions:
  1280.  
  1281.    FILE (continued) -
  1282.  
  1283.       Include Hidden and System Files - If set to YES, this option will
  1284.          include files marked with a hidden or system attribute during an "all
  1285.          files" copy or move operation.  During a "tagged files" or "current
  1286.          file" operation, tagged or current hidden and system files are copied
  1287.          without regard to the current setting of this option.
  1288.  
  1289.       Pause for Unsuccessful Copy/Move - When set to YES, the program will
  1290.          pause for every unsuccessful copy or move operation and prompt you to
  1291.          continue or abort the current operation.  Continuing allows the
  1292.          program to proceed with the remaining copy or move operations.  When
  1293.          set to NO, the program continues automatically with the next copy or
  1294.          move operation after an unsuccessful one.  In addition, when copying
  1295.          or moving files to a remote machine, transmission errors will be
  1296.          retried until the information is correctly transferred, or until you
  1297.          abort the operation by pressing the escape key.  Critical errors,
  1298.          however, such as those associated with hardware failures, will always
  1299.          require a response from you, regardless of how this option is set.
  1300. 
  1301. GENERAL Command Mode (4 of 19)
  1302. Command Descriptions:
  1303.  
  1304.    FILE (continued) -
  1305.  
  1306.       Remove Tag After Successful Copy - If set to YES during a "tagged files"
  1307.          copy operation, this option causes the program to remove the tag
  1308.          identifier from each file successfully copied.  This allows the
  1309.          progress of a copy operation to be monitored more closely because the
  1310.          tag information is updated as each file is copied.  The number of
  1311.          files and bytes not yet copied is displayed for the current directory
  1312.          as well as the entire directory tree.  Also, when the copy operation
  1313.          has completed, any files that are still tagged are those which were
  1314.          not successfully copied.  Tags are not removed for "current file" or
  1315.          "all files" copy operations.  Note that during move operations, file
  1316.          tags are always removed.
  1317.  
  1318.       Verify Disk Write Operations - This option sets the DOS environment
  1319.          variable (VERIFY=) on or off to enable or disable disk write
  1320.          verifications.  When set on, file copy and move operations will take
  1321.          a bit longer due to the verification function performed by DOS.  For
  1322.          file copy and move operations between the master and slave machines,
  1323. 
  1324. GENERAL Command Mode (5 of 19)
  1325. Command Descriptions:
  1326.  
  1327.    FILE (continued) -
  1328.  
  1329.       Verify (continued) - make sure the "I/O Pause" flag is set to YES when
  1330.          the receiving machine has its verify flag set to YES.
  1331.  
  1332.    GLOBAL - These parameters control the scope of directories affected by a
  1333.       global operation.  The global commands are very powerful.  Before
  1334.       performing any global operation, make sure that you understand what
  1335.       these parameters mean and how they affect the operation.
  1336.  
  1337.       Include All Subdirectories - When set to YES, this parameter causes
  1338.          the program to perform the current global operation on every
  1339.          applicable file in the current directory as well as every applicable
  1340.          file in all subdirectories which are children or descendants of the
  1341.          current directory (affects an entire directory subtree).  To operate
  1342.          on an entire tree, select the root directory as the current directory
  1343.          before selecting a global command.  When set to NO, the program
  1344.          will perform the global operation on all applicable files in the
  1345.          current directory only.  No subdirectories will be affected.
  1346. 
  1347. GENERAL Command Mode (6 of 19)
  1348. Command Descriptions:
  1349.  
  1350.    GLOBAL (continued) -
  1351.  
  1352.       Match Subdirectories at Target - This parameter only affects the global
  1353.          copy and move file operations, and only when the Include All
  1354.          Subdirectories parameter is set to YES.  If this option is set to
  1355.          YES, then for each subdirectory processed at the source a
  1356.          subdirectory with the same name will be created at the target.  In
  1357.          other words, the source directory subtree will be recreated at the
  1358.          target and all files that are copied or moved will be placed into the
  1359.          corresponding target directory.  If this option is set to NO, then
  1360.          all files will be placed into the same single target directory.
  1361.  
  1362.    COM - This category defines the communications parameters for establishing
  1363.       a connection between the master and slave machines.  The master machine
  1364.       controls which baud rate and block size are used, and if I/O pause is
  1365.       enabled or disabled.  Once a connection has been established, only the
  1366.       block size, I/O buffer size, and I/O pause can be changed.  These
  1367.       parameters are used only during file transfers.  It is also possible to
  1368.       change the baud rate, but only with DIRECT connections.
  1369. 
  1370. GENERAL Command Mode (7 of 19)
  1371. Command Descriptions:
  1372.  
  1373.    COM (continued) -
  1374.  
  1375.       COM Port - Assigns which serial port is used by this machine to
  1376.          communicate with the remote machine.  The program supports COM1
  1377.          through COM8.  Once selected, the program will display the default
  1378.          base address and IRQ line for that serial port.  The default values
  1379.          assigned to COM3 through COM8 are for IBM PS/2 machines.  To use COM3
  1380.          or COM4 on an IBM PC machine, change the default values for base
  1381.          address and IRQ line to 3E8/IRQ4 for COM3 or to 2E8/IRQ3 for COM4
  1382.          (these values are somewhat standard, but depending on the hardware
  1383.          may be reversed as COM3=2E8/IRQ3 and COM4=3E8/IRQ4).  If the port
  1384.          assignment is invalid for the machine, an error message will occur
  1385.          when a remote connection is attempted.
  1386.  
  1387.       Base Address - This value is the hexadecimal base address for the
  1388.          current serial port.
  1389.  
  1390.       IRQ Line - This value is the IRQ line number supported by the serial
  1391.          port.  The program supports IRQ values 0 through 7.
  1392. 
  1393. GENERAL Command Mode (8 of 19)
  1394. Command Descriptions:
  1395.  
  1396.    COM (continued) -
  1397.  
  1398.       Connection - The connection type can be assigned to DIRECT or MODEM.
  1399.          DIRECT connections use a null-modem serial cable connected between
  1400.          the two machines, whereas MODEM connections use modems and telephone
  1401.          lines to make the connection.  Use the space bar to toggle the
  1402.          current selection.  If MODEM is selected, the baud rate displayed
  1403.          below is the modem's maximum baud rate which is defined in the modem
  1404.          information screen (select option MODEM from the SETUP command mode).
  1405.          The modem baud rate can only be changed at the modem information
  1406.          screen.
  1407.  
  1408.       Baud Rate - If the connection type is DIRECT, the baud rate can be
  1409.          changed by using the space bar to display each of the six available
  1410.          selections.  Use the AUTO baud selection to let the program
  1411.          automatically select a suitable baud rate between the master and
  1412.          slave machines.  If numerous block errors occur during remote
  1413.          operations, try reducing the baud rate to correct the problem.
  1414. 
  1415. GENERAL Command Mode (9 of 19)
  1416. Command Descriptions:
  1417.  
  1418.    COM (continued) -
  1419.  
  1420.       Block Size - This parameter sets the size of blocks sent between the
  1421.          master and slave machines during file transfers.  Each block sent is
  1422.          checked for 100% accuracy at the receiving machine.  When "noise" is
  1423.          introduced into a transmission a block error will occur, and the
  1424.          program will send the block again.  Larger block sizes require less
  1425.          overhead in verification of the transferred data, but require more
  1426.          time to retransmit after an error has occurred.  Use the space bar to
  1427.          display each of the seven available block sizes.  A large block size
  1428.          is recommended when the machines are directly connected.  A smaller
  1429.          block size is recommended for modem connections where noise is more
  1430.          common, so that retransmissions are less costly.  Also, a smaller
  1431.          block size can help you monitor transfer progress more closely
  1432.          because the displayed progress bar is updated more frequently.
  1433.  
  1434.       I/O Buffer - This parameter determines the amount of information which
  1435.          is sent or received before the next disk read or write operation
  1436.          occurs.  A larger buffer size means that the program will have to
  1437. 
  1438. GENERAL Command Mode (10 of 19)
  1439. Command Descriptions:
  1440.  
  1441.    COM (continued) -
  1442.  
  1443.       I/O Buffer (continued) - perform disk reads and writes less frequently
  1444.          than with a smaller buffer size.  Use the space bar to toggle between
  1445.          the available selections.  The buffer size ranges from 8K bytes (8192
  1446.          bytes) up to a maximum of 32K bytes in increments of 8K.  The maximum
  1447.          size may be less than 32K if the amount of RAM available was small
  1448.          when the program was started.  However, it will always be at least
  1449.          8K.  When two machines are connected, the maximum buffer size
  1450.          available will be the lesser of each machine's maximum size.  The
  1451.          size of the buffer used may affect overall file transfer speeds.
  1452.          When used in conjunction with the I/O Pause parameter (described
  1453.          below) set to YES, a larger I/O buffer size is recommended.  When I/O
  1454.          pause is set to NO, a smaller buffer size may be more efficient.
  1455.  
  1456.       I/O Pause - When this flag is set to YES, the master and slave machines
  1457.          will pause between disk write operations before sending the next
  1458.          block of information.  This may be necessary when the "Verify Disk
  1459.          Write Operations" flag is set to YES on the receiving machine, or
  1460. 
  1461. GENERAL Command Mode (11 of 19)
  1462. Command Descriptions:
  1463.  
  1464.    COM (continued) -
  1465.  
  1466.       I/O Pause (continued) - when using high baud rates and working with
  1467.          machines which have significantly different CPU or disk access speeds
  1468.          or disk caches.  If a transmission is regularly failing with short
  1469.          blocks, set this option to YES.  Otherwise you may leave it set to NO
  1470.          for faster overall transfers.
  1471.  
  1472.    SORT - This option determines the default sort used when displaying file
  1473.       lists.  When selected, the program will display the current sort
  1474.       criteria and prompt you to enter changes.  Except for the invert option,
  1475.       once a keystroke is entered the current sort criteria are cleared and
  1476.       the new criteria can be entered.  Press the carriage return key to
  1477.       accept the changes or the escape key to abort from any changes.
  1478.  
  1479.    EDITOR - This option allows you to enter the name of the file editor which
  1480.       will be used when the EDIT FILE option is selected from the ALTER
  1481.       command mode.  If no path name is specified, your DOS PATH will be
  1482.       searched for the program.  An error message will occur if you select the
  1483. 
  1484. GENERAL Command Mode (12 of 19)
  1485. Command Descriptions:
  1486.  
  1487.    EDITOR (continued) - EDIT FILE option when no editor has been specified.
  1488.  
  1489.    MISC - This option allows changes to be entered for several miscellaneous
  1490.       operating characteristics of the program.
  1491.  
  1492.       Save Trees to Disk - Set this option to YES if you want directory tree
  1493.          information to be saved to disk whenever unlogging a tree or exiting
  1494.          the program.  By doing so, the program can read that information at
  1495.          other times and quickly log the specified tree.  Trees are written to
  1496.          the root directory of the current disk unless otherwise specified
  1497.          (set the ALT DIR menu option).  If the directory tree information has
  1498.          changed outside of the program, the tree can be recreated using the
  1499.          F8 function key so that the tree information is updated the next time
  1500.          it is saved to disk.  If this option is set to NO, the program will
  1501.          have to scan the disk each time the tree for that disk is logged,
  1502.          which can be a time-consuming process.
  1503. 
  1504. GENERAL Command Mode (13 of 19)
  1505. Command Descriptions:
  1506.  
  1507.    MISC (continued) -
  1508.  
  1509.       Remove Screen Snow - When set to NO, this option tells the program that
  1510.          it can write directly to the screen's video buffer without causing
  1511.          interference ("snow") or flickering to appear on the display screen.
  1512.          If set to YES, the program will wait for the video hardware to reset
  1513.          before writing any information to the video buffer.  This slows
  1514.          screen updates dramatically.  Snow removal generally is required only
  1515.          for older style CGA cards.
  1516.  
  1517.       Use Sound Effects - When set to YES, the program will produce sounds
  1518.          when opening or closing windows or when displaying messages.  Set
  1519.          this option to NO to disable all sound effects except for those
  1520.          associated with error messages.
  1521.  
  1522.       Fast Command Mode - Operations such as copying, moving, and deleting
  1523.          normally require you to select the scope of files on which the
  1524.          operation is to be performed.  The choices available are the current
  1525.          file, tagged files, or all files.  To avoid this scope selection
  1526. 
  1527. GENERAL Command Mode (14 of 19)
  1528. Command Descriptions:
  1529.  
  1530.    MISC (continued) -
  1531.  
  1532.       Fast Command (continued) - process, set Fast Command Mode to YES.  Doing
  1533.          so will make the current file the default scope selection.  To select
  1534.          tagged files, use the Ctrl key when selecting the option.  To select
  1535.          all files, use the Alt key when selecting the option.  The Ctrl and
  1536.          Alt key combinations are always available independent of the current
  1537.          setting of this option.  Global operations requiring a scope
  1538.          selection will not be affected by this setup option as "current file"
  1539.          is not a valid selection in the GLOBAL command mode.
  1540.  
  1541.       Use Aux File Tags - Set this option to YES to use an auxiliary file tag
  1542.          indicator () when viewing a directory file list.  This is helpful
  1543.          for monochrome display screens where contrast is weak or difficult to
  1544.          detect.  The file tag indicator will appear between the file's
  1545.          extension and size.
  1546.  
  1547.       Confirm Deletes - When this option is set to YES, the program will
  1548.          prompt you before performing any file delete operations to help avoid
  1549. 
  1550. GENERAL Command Mode (15 of 19)
  1551. Command Descriptions:
  1552.  
  1553.    MISC (continued) -
  1554.  
  1555.       Confirm Deletes (continued) - accidental deletions.  When set to NO, the
  1556.          program will not prompt you before performing a delete operation.
  1557.  
  1558.       Keyboard Speedup - Set this option to YES to speed up the typematic rate
  1559.          on an enhanced keyboard.  This can dramatically speed up tree and
  1560.          list traversal operations.  After the typematic rate is increased, it
  1561.          cannot be decreased until the machine is rebooted.
  1562.  
  1563.       Startup Mode - Use the space bar to toggle between the two available
  1564.          selections: REMOTE and LOCAL.  This option determines what the
  1565.          program does when it is first executed from the DOS command line.  If
  1566.          the option is set to REMOTE, the program will log and display the
  1567.          disk's tree and then attempt to connect to the remote machine.  If no
  1568.          command line switch was used, the first machine which loads and
  1569.          executes the program will attempt to connect as the master machine.
  1570.          When the program is run on the other machine, it will automatically
  1571.          connect as the slave.  A command line switch can be used to force a
  1572. 
  1573. GENERAL Command Mode (16 of 19)
  1574. Command Descriptions:
  1575.  
  1576.    MISC (continued) -
  1577.  
  1578.       Startup Mode (continued) - machine to assume the master or slave role.
  1579.          This lets you avoid always having to start the master machine first.
  1580.          Use /m for master or /s for slave on the DOS command line.  If one of
  1581.          these switches is used, the startup mode defaults to REMOTE.  When
  1582.          the two machines establish a connection, the master machine will
  1583.          automatically enter the SPLIT command mode with its current directory
  1584.          file list displayed on the left side of the split window and the
  1585.          slave's current file list displayed on the right.  Entry into the
  1586.          SPLIT command mode occurs only when the program is first started.  If
  1587.          the program was started up in LOCAL mode, any remote connection which
  1588.          is made will not result in an entry into the SPLIT command mode.
  1589.          When the startup mode is set to LOCAL, the machine will log its tree
  1590.          and remain in the TREE command mode.  No remote connection will be
  1591.          attempted.  A command line switch /l may be used to force a LOCAL
  1592.          startup.
  1593.  
  1594.    PRINTER - These parameters allow you to define the printer and output
  1595. 
  1596. GENERAL Command Mode (17 of 19)
  1597. Command Descriptions:
  1598.  
  1599.    PRINTER (continued) - formats used by the program.
  1600.  
  1601.       Device - This parameter determines where the output of a printed file or
  1602.          report is directed.  Enter the device name of the parallel or serial
  1603.          port which is connected to the printer.  DOS has several reserved
  1604.          device names which are generally used for this parameter.  PRN or
  1605.          LPT1 can be entered to reference the first parallel printer attached
  1606.          to the machine.  Other device names which are commonly used include
  1607.          LPT2, LPT3, AUX, COM1, and COM2.
  1608.  
  1609.       Init Code Sequence - This parameter defines a printer initialization
  1610.          sequence which is sent to the printer each time a file or report is
  1611.          printed.  This can be used to cause a printer to reset itself, or set
  1612.          a particular line spacing, or suppress automatic form feeds, or any
  1613.          of many other typical printer setup options.  These printer commands,
  1614.          often called escape sequences, are sets of special characters or
  1615.          values which the printer recognizes as commands rather than data to
  1616.          be printed.  Often the values required in an escape sequence are not
  1617.          part of the displayable ASCII character set.  To allow input of these
  1618. 
  1619. GENERAL Command Mode (18 of 19)
  1620. Command Descriptions:
  1621.  
  1622.    PRINTER (continued) -
  1623.  
  1624.       Init Code (continued) - values, the program recognizes a backslash ("\")
  1625.          followed by a sequence of three digits which correspond to the ASCII
  1626.          value to be sent to the printer.  For example, the Esc character can
  1627.          be sent by entering "\027" into the input field for this option.  The
  1628.          sequence Esc followed by the ASCII value 19 would be entered as
  1629.          "\027\019".
  1630.  
  1631.       Form length - This parameter's value defines when the program generates
  1632.          printer form feeds while printing files or reports.  Form length is
  1633.          measured in lines per page, and can have any value from 1 to 255.
  1634.  
  1635.       Default Print File - This parameter allows you to specify a path and
  1636.          file name to be used when redirecting output to a file rather than
  1637.          the printer.  If no drive or path is entered, the file will be
  1638.          created or updated in the currently active directory.  When choosing
  1639.          to print to a file, the program will prompt you whether to use the
  1640.          default print file or some other file.
  1641. 
  1642. GENERAL Command Mode (19 of 19)
  1643. Command Descriptions:
  1644.  
  1645.    ALT DIR - Select this option to specify an alternate directory path to use
  1646.       when reading or writing the tree information for a particular drive.  If
  1647.       no path is specified, the default is the root directory of that drive.
  1648.       This is useful for disk organization as well as for drives where write
  1649.       access to the root directory is not allowed, as is common with networks.
  1650.       A tree can actually be saved to a different drive if necessary.
  1651. HOT KEYS Command Mode (1 of 5)
  1652. Hot keys are function keys which are assigned to external programs or DOS
  1653. commands.  They allow running up to twenty-four different programs at the
  1654. touch of a key from any place within the program.  Arguments such as paths or
  1655. file names can be passed automatically to the external program.  You can also
  1656. specify that the program prompt you for arguments.
  1657.  
  1658. The hot keys are assigned to function keys F1 through F12 when pressed in
  1659. conjunction with the Ctrl or Alt keys.  For example, to run a program mapped
  1660. to the key combination Ctrl-F1, first press down the Ctrl key, and then while
  1661. holding it down, press the F1 function key.  The F11 and F12 key combinations
  1662. are only available on machines which support an extended keyboard.
  1663.  
  1664. To enter a hot key definition, select one of the two available menu options.
  1665. The program will prompt you for a value from 1 to 12 which corresponds to the
  1666. Ctrl or Alt function key F1 through F12.  Once entered, the program will place
  1667. the cursor at the appropriate entry on the display screen.
  1668.  
  1669. First, enter the name of the external program or command.  Use a full path
  1670. name if the program is not already accessible through the PATH environment
  1671. variable.  You don't need to include the .BAT, .COM, or .EXE extension.  Next
  1672. consider if the program will require some kind of input.  The argument
  1673. 
  1674. HOT KEYS Command Mode (2 of 5)
  1675. substitution codes (described below) may be used to retrieve information
  1676. directly from a directory tree or file list, or from you after you press the
  1677. hot key.  When all the information for running the program is entered, press
  1678. the carriage return key.
  1679.  
  1680. The cursor is now in the ARG field for the current hot key.  This input field
  1681. requires a yes or no entry.  Placing a "Y" in the ARG field means that the
  1682. program will display the entire hot key command line for reviewing or changing
  1683. before it gets sent to the DOS command processor.  When displayed, all
  1684. argument substitutions will have already been inserted.  At this point you can
  1685. enter specific data for the program about to be executed.  Also this provides
  1686. a way to check the accuracy of any argument substitutions which were
  1687. requested.  If there is no need to obtain further information from you, set
  1688. ARG to "N" to avoid the review process.  After answering "Y" or "N" in the ARG
  1689. field, the cursor will be moved over to the W input field.
  1690.  
  1691. The W input field also requires a yes or no entry.  When set to "Y", the
  1692. program will wait for a keystroke before returning from the hot key execution.
  1693. This is useful for DOS commands such as CHKDSK which normally return to the
  1694. DOS command line after execution.  Without the W field set to "Y", the CHKDSK
  1695. results would be immediately overwritten when returning to HOT WIRE.  If there
  1696. 
  1697. HOT KEYS Command Mode (3 of 5)
  1698. is no need to wait before returning from a hot key execution, place an "N" in
  1699. the W input field.
  1700.  
  1701. After the hot key is fully entered, the program will prompt for the next hot
  1702. key to define.  Press the escape key to return to the HOT KEYS command menu.
  1703. At this point, any defined hot key may tested for its correct functionality.
  1704.  
  1705. Argument substitution codes are used to automatically insert directory tree or
  1706. file list information directly into a hot key command before it is executed.
  1707. These codes are specified by entering the % character followed by one of the
  1708. argument code characters, and then optionally followed with a "P" or "S".
  1709.  
  1710. Argument Substitution Codes:
  1711.  
  1712.    %P - This substitution code means that HOT WIRE will automatically insert a
  1713.       full directory path, including the drive designator, into the hot key
  1714.       command.  The currently active directory path will be used by default.
  1715.       If a "P" is appended to the substitution code (entered as %PP), the
  1716.       program will prompt you for the full directory path to be used.  If an
  1717.       "S" is appended, the program will insert the full directory path from
  1718.       the target (inactive) side of the SPLIT command mode display screen.
  1719. 
  1720. HOT KEYS Command Mode (4 of 5)
  1721. Argument Substitution Codes (continued):
  1722.  
  1723.    %D - This substitution code means that the program will insert the drive
  1724.       designator of the current tree into the hot key command (including the
  1725.       colon delimiter).  Append a "P" if you are to supply the drive, or an
  1726.       "S" if the target split window drive is to be used.
  1727.  
  1728.    %F - This code will cause the HOT WIRE to enter the current file name and
  1729.       extension into the hot key command.  If in the LIST or SPLIT command
  1730.       mode, the currently highlighted file will be used.  If in VIEW mode, the
  1731.       currently viewed file will be used.  If in a command mode where no file
  1732.       list is displayed, the current directory name and extension will be
  1733.       used.  Append a "P" to prompt you for the file name extension, or append
  1734.       an "S" to use the file name and extension of the "current" file in the
  1735.       target split window (distinguished by a ■ character near the middle
  1736.       column of the screen).
  1737.  
  1738.    %N - This code is similar to %F except that only the file name will be
  1739.       inserted into the hot key command.  The file extension, if any, will not
  1740.       be used.
  1741. 
  1742. HOT KEYS Command Mode (5 of 5)
  1743. Argument Substitution Codes (continued):
  1744.  
  1745.    %E - This code is similar to %N except that only the three characters of
  1746.       the file extension will be inserted into the hot key command (excluding
  1747.       the period (.) delimiter).  The file name will not be used.
  1748.  
  1749. If an argument substitution code has an "S" appended to reference the target
  1750. side of the split window, and the SPLIT command mode is not currently active,
  1751. an error message will occur and the hot key will not be executed.
  1752.  
  1753. Command Descriptions:
  1754.  
  1755.    CTRL-KEYS - Select this option to make changes to the hot keys associated
  1756.       with Ctrl key combinations.
  1757.  
  1758.    ALT-KEYS - Select this option to make changes to the hot keys associated
  1759.       with Alt key combinations.
  1760.  
  1761. WARNING:  A memory-resident program (TSR) should not be loaded through a hot
  1762. key definition, as it will create a "hole" in memory when HOT WIRE is exited.
  1763. Subsequent execution of other programs may cause your system to crash.
  1764. MODEM Command Mode (1 of 5)
  1765. When attempting a connection by modem, the programs running on each machine
  1766. must first initialize their modems appropriately.  The machine which is to
  1767. assume the master mode has to dial the phone number which will connect to the
  1768. machine assuming the slave mode.  The slave machine must already be running
  1769. the program and have initialized its modem to automatically answer all
  1770. incoming calls.
  1771.  
  1772. Once a connection is made between the two machines, you must enter a password
  1773. to gain access to the slave machine's disk drives.  If the password is
  1774. verified, the slave will send its directory tree to the master machine, and
  1775. program control resumes at the master machine as if the two were directly
  1776. connected.
  1777.  
  1778. A modem must receive a command string before it will initialize itself or dial
  1779. a phone number.  Modem command strings often require special characters or
  1780. "control codes" (ASCII 0 through 31) which the modem knows how to interpret.
  1781.  
  1782. Since control codes are normally nondisplayable, they are represented in HOT
  1783. WIRE by the character ^ (caret -- ASCII value 94) followed by another
  1784. character with an ASCII value from 64 to 95.  The control code is translated
  1785. by subtracting 64 from the value of the character following the ^.  For
  1786. 
  1787. MODEM Command Mode (2 of 5)
  1788. example, the sequence ^@ (caret followed by ASCII value 64) is translated to a
  1789. single ASCII value 0; ^A is translated to an ASCII 1, and ^Z is translated to
  1790. an ASCII 26.  The sequence ^^ is special and translates to a single ^. Note
  1791. that this special translation means that there is no sequence available for
  1792. representing ASCII 30.
  1793.  
  1794. The ~ (tilde) is a character with another special meaning.  Each ~ encountered
  1795. in a command string causes a half-second pause before the next character is
  1796. sent to the modem.  This is used in the modem hangup and auto answer commands.
  1797.  
  1798. Of the General Options listed below, the dialing command, outgoing phone
  1799. number, and dialing command suffix are used only by the machine which is to
  1800. assume the master mode when a connection is made.  The auto answer command and
  1801. incoming password are used only by the machine which is to assume the slave
  1802. mode when a connection is made.  The remaining options may be used by either
  1803. machine.
  1804.  
  1805. Except for the hangup command, any changes to the Modem Setup options will not
  1806. have any effect until the next time a connection is attempted.  The hangup
  1807. command is used when breaking an existing connection, so any changes to it
  1808. will be valid immediately, even if you are currently connected.
  1809. 
  1810. MODEM Command Mode (3 of 5)
  1811. Command Descriptions:
  1812.  
  1813.    GENERAL OPTIONS - These options define the modem command strings, the phone
  1814.       number called by the master, and the password verified by the slave.
  1815.  
  1816.       Maximum Baud Rate - This option defines the maximum baud rate at which
  1817.          the modem's and machine's serial ports can communicate.  Usually this
  1818.          is the same as the maximum baud rate supported by the modem.  Once
  1819.          this option is set, there is really no need to change it.  If, after
  1820.          a connection is established, the modem's baud rate is different than
  1821.          the defined maximum, the machine will automatically reset its baud
  1822.          rate to match the modem.  Unlike direct connections, changing the
  1823.          maximum baud rate will have no effect when a connection has already
  1824.          been established.
  1825.  
  1826.       Initialization Command - This option specifies a series of commands
  1827.          which are sent to the modem each time a remote connection is
  1828.          attempted.
  1829.  
  1830.       Dialing Command - This option specifies the modem command used to dial a
  1831.          phone number.
  1832. 
  1833. MODEM Command Mode (4 of 5)
  1834. Command Descriptions:
  1835.  
  1836.    GENERAL OPTIONS (continued) -
  1837.  
  1838.       Outgoing Phone Number - This option contains the digits and codes to be
  1839.          dialed when attempting a remote connection.  Most modems will allow
  1840.          the entry to include or omit spaces, dashes, and parentheses.
  1841.  
  1842.       Dialing Command Suffix - This option specifies the set of characters
  1843.          which tells the modem to begin executing the dialing command.
  1844.  
  1845.       Hangup Command - This option specifies the command which tells the modem
  1846.          to hang up (disconnect) the line.  When hanging up, the program will
  1847.          attempt first to hang up the line by dropping the DTR line.  If this
  1848.          fails, it will then attempt hanging up by using this hangup command.
  1849.  
  1850.       Auto Answer Command - This option specifies the command which tells the
  1851.          modem to answer all incoming calls automatically.
  1852.  
  1853.       Incoming Password - This option specifies the password which must be
  1854.          received from the master machine in order to continue operations.
  1855. 
  1856. MODEM Command Mode (5 of 5)
  1857. Command Descriptions:
  1858.  
  1859.    RESULT MESSAGES - When a remote connection is attempted by modem, the modem
  1860.       will indicate the result by sending a "result message" (sometimes called
  1861.       a "status message" or "status code") back to the program.  In order for
  1862.       the program to correctly interpret the result messages, they must be
  1863.       defined in the Modem Setup screen.  This program supports two types of
  1864.       result messages: those which occur when a connection is successful at a
  1865.       particular baud rate, and those which indicate that no connection was
  1866.       established.
  1867.  
  1868.       Baud Connect - These messages specify what is sent by the modem when a
  1869.          connection is established.  Each message corresponds to a particular
  1870.          baud rate.  When the program matches a received message, it then
  1871.          knows the baud rate at which the modem is communicating.  If this
  1872.          baud rate is different from the modem's maximum baud rate, the
  1873.          program will reset the communications port to match the modem.
  1874.  
  1875.       No Connect - These messages are sent by the modem when a connection
  1876.          attempt is unsuccessful.  Typically these messages will indicate a
  1877.          busy signal, a lack of carrier, a voice connection, or no answer.
  1878. COLORS Command Mode (1 of 3)
  1879. The COLOR command mode allows you to change the colors used to display
  1880. information on the screen.  For monochrome systems, the colors are represented
  1881. by various shades, contrasts, underlining, and blinking attributes.  At
  1882. startup, the program will check the monitor type to determine the appropriate
  1883. color selections to display.  Some monitor types act like color monitors
  1884. even though their display screen is monochrome.  These are called composite
  1885. monitors.  In order for the program to display the correct color selections,
  1886. use the /b command line switch to force the use of monochrome settings.  Once
  1887. the setup information is saved to disk, the /b option will not be required
  1888. until you want to see the available monochrome selections again.
  1889.  
  1890. There are many more color selections available when using a color monitor.
  1891. Use the + and - keys to toggle between the two screens of available colors.
  1892.  
  1893. This command mode has seven menu selections, six of which display another
  1894. command mode menu.  When a menu option is selected from one of these submenus,
  1895. the program will prompt you to enter a numeric value ranging from 0 through
  1896. 255 which corresponds to one of the available color selections.  The
  1897. monochrome selections each have their corresponding value displayed to the
  1898. left of the selection.  The color selections have their values displayed in
  1899. the background and foreground colors they represent.
  1900. 
  1901. COLORS Command Mode (2 of 3)
  1902. In order to visualize the effects of changes to the current color selections,
  1903. a display screen template is updated each time a new color is entered.  An
  1904. arrow will point to the area on the template which will be affected by the
  1905. current entry.  The program's working display screen will not be updated until
  1906. you exit completely from the SETUP command mode.
  1907.  
  1908. Command Descriptions:
  1909.  
  1910.    BASE - This option displays the menu options which allow changes to be made
  1911.       to the default background and border colors, the colors used to prompt
  1912.       you for input data, and the color of highlighted messages which occur
  1913.       when the program is busy doing something.
  1914.  
  1915.    COMMAND - This option allows you to change the colors used to display
  1916.       command menus.  In this command submenu, the HOT KEYS option refers to
  1917.       the key which is pressed to select a menu item.  These "hot keys" should
  1918.       not be confused with the hot keys which run external programs.
  1919.  
  1920.    TREE INFO - This option allows changes to the colors used to display the
  1921.       current directory tree and status information.
  1922. 
  1923. COLORS Command Mode (3 of 3)
  1924. Command Descriptions:
  1925.  
  1926.    FILE LIST - This option allows you to change the colors used to display
  1927.       files in a directory.  The HIGHLIGHT option refers to the color used to
  1928.       display a tagged file.
  1929.  
  1930.    VIEW FILE - This option allows changes to the colors used to display a
  1931.       file's contents when in the VIEW command mode.
  1932.  
  1933.    HELP TEXT - This option allows you to change the colors used to display the
  1934.       on-line help text and quick help summary screen.
  1935.  
  1936.    DEFAULT - Select this option to reset the colors to the HOT WIRE's
  1937.       predefined color values.  These are the same colors used when the
  1938.       program is started when no setup file is available.
  1939. MACRO Command Mode (1 of 8)
  1940. Macros are defined by capturing specific keystroke combinations which group
  1941. one or more program operations.  A macro file is created for each defined
  1942. macro which can then be played back at any time.  This program feature
  1943. eliminates the need to reenter keystrokes for common or repeated operations.
  1944. Macros are recorded to and played back from the directory specified by the
  1945. environment variable HW.  If none is specified, HOT WIRE will look in the root
  1946. directory of the disk drive you started the program from.
  1947.  
  1948. A macro can be invoked at program startup with the command option /fMACRO,
  1949. where MACRO is an eight character macro file name.  Macros can otherwise be
  1950. invoked only from the TREE, GLOBAL, LIST, and SPLIT command modes.
  1951.  
  1952. Several of the function key combinations control the macro record and playback
  1953. modes and are defined as follows:
  1954.  
  1955.    Shift-F5 - Macro record on/off toggle (record mode only)
  1956.    Shift-F6 - Macro directory or file location command (record mode only)
  1957.    Shift-F7 - Macro loop on/off toggle (record mode only)
  1958.    Shift-F8 - Macro pause on (record mode only)/off toggle
  1959.    Shift-F9 - Macro playback on/off toggle (playback mode only)
  1960. 
  1961. MACRO Command Mode (2 of 8)
  1962. To record a macro, make sure one of the valid command modes (TREE, GLOBAL,
  1963. LIST, or SPLIT) is currently active and then select Shift-F5.  The program
  1964. will prompt for a macro name.  If the macro name already exists, the program
  1965. will ask if the currently defined macro should be overwritten.  Once the name
  1966. is successfully entered, a thirty character description may be entered to
  1967. explain what the macro does.  If overwriting an existing macro, the
  1968. description will be retained and redisplayed for changes.  When entered, the
  1969. program will place a "" to the left of the current command mode to indicate
  1970. that the program is currently recording a macro.  To end the recording, press
  1971. Shift-F5 again.
  1972.  
  1973. One of the first things to consider is whether or not the proper operation of
  1974. the macro depends at all on the current values of the setup parameters.  When
  1975. the macro is played back at a later time, these values may not be set as you
  1976. expected.  For instance, if any files are to be copied or moved, the settings
  1977. of the "File Copy and Move Parameters" can determine whether a newer file can
  1978. be overwritten, or if a file's tag is removed after it is successfully copied.
  1979. The settings of the "Global Parameters" can cause a macro to operate on an
  1980. entire directory subtree, or only a single directory.  In order to ensure that
  1981. the macro operates correctly, you will want to record the correct setup
  1982. information in your macro.  Select the F2 function key to enter the SETUP
  1983. 
  1984. MACRO Command Mode (3 of 8)
  1985. command mode.  Select the appropriate options, and input the correct values
  1986. for each the parameters which you require, even if the values are already set
  1987. correctly.  When you return to the SETUP command mode, you can decide to SAVE
  1988. the values permanently, or just for the current session.
  1989.  
  1990. While recording a macro, several special macro function keys are available.
  1991. Press Shift-F6 (available only at the TREE, GLOBAL, LIST or SPLIT command
  1992. modes) to record a specific directory path or file name in the macro.  When
  1993. the macro is played back, the program will seek for a matching directory path
  1994. or file name before proceeding with subsequent commands.  This is useful when
  1995. a macro is designed solely for a directory or file with a specific name, and
  1996. it eliminates the need to traverse a tree or file list prior to playing back a
  1997. macro.  A message will be displayed indicating that the directory or file name
  1998. was recorded.
  1999.  
  2000. Shift-F7 is a looping mechanism designed to operate with tagged files and the
  2001. F4 function key.  Pressing it indicates that the next sequence of commands is
  2002. to be repeated until the exit condition is satisfied.  This exit condition
  2003. occurs when the F4 function key finds no more tagged files.  One important
  2004. point to remember is that the F4 function key should be pressed at least once
  2005. during the definition of the loop and, for most purposes, not more than once.
  2006. 
  2007. MACRO Command Mode (4 of 8)
  2008. If the F4 key is never entered, the macro will never loop!
  2009.  
  2010. While in a loop definition, the program will display a "" character to the
  2011. left of the current command mode.  Pressing the Shift-F7 function key a second
  2012. time will mark the end of the current loop.  Another key point is that the
  2013. loop should be terminated at the same command mode as it was initiated.
  2014. Remember that macros are just a series of keystrokes, and if a macro
  2015. re-executes its loop at a different command mode from before, the program will
  2016. most likely give a continuous error message indicating that an invalid command
  2017. was entered.  In odd cases, though, the command may be valid for the current
  2018. command mode even though it was not intended for that command mode.  This
  2019. could produce undesirable side effects.  If during a macro playback the
  2020. program appears to be looping endlessly, press the escape key or Shift-F9
  2021. again to abort the macro.  It is likely that the macro was incorrectly
  2022. recorded, and must be recorded again.
  2023.  
  2024. Shift-F8 is a pausing mechanism which, when entered during the macro record
  2025. mode, causes a break in the macro execution during macro playback mode.
  2026. Pauses can only be entered during record mode, but can be terminated in either
  2027. mode.  When a macro is currently on pause, a "" character is displayed at the
  2028. left of the current command mode.  During a pause all keystrokes are taken
  2029. 
  2030. MACRO Command Mode (5 of 8)
  2031. directly from the keyboard instead of the macro file.  If you are recording,
  2032. no more keystrokes will be recorded in the macro file until the pause is
  2033. terminated.  The pause command is useful when a macro requires data entry (not
  2034. commands) from you such as a specific drive, path, or file name, or when
  2035. traversing a tree to locate a target directory.  If you do not want the macro
  2036. to use the same data each time it is played back, insert a macro pause at each
  2037. prompt which requires information specifically for the current task.
  2038.  
  2039. A macro pause can be terminated in a few different ways.  Each way will resume
  2040. the macro record or playback operation exactly as if no pause had occurred at
  2041. all.  One way to terminate a pause is to press the Shift-F8 key again.
  2042.  
  2043. The second way involves data entry operations.  If a macro pause is invoked
  2044. during data entry such as for a path or file name, it will be terminated
  2045. automatically when the carriage return key is pressed.  This will eliminate an
  2046. extra keystroke (the terminating Shift-F8) which would otherwise be entered
  2047. just before pressing the carriage return key to exit the data entry field.
  2048.  
  2049. If the pause is invoked when prompted for a single character drive designator,
  2050. as with the options selected from the DISK Command Mode, the pause will be
  2051. automatically terminated when a valid character is entered.
  2052. 
  2053. MACRO Command Mode (6 of 8)
  2054. A third way to automatically terminate a macro pause is available when
  2055. traversing a tree to select a target directory for operations such as copying
  2056. and moving files.  If the pause is invoked when the program is prompting to
  2057. traverse the tree, it will be terminated automatically when the carriage
  2058. return key is pressed to select the target directory.  This is useful when a
  2059. target might be different each time the macro is played back.
  2060.  
  2061. For the same reasons as with a macro loop, a macro pause should be terminated
  2062. at the same command mode as it was initiated.
  2063.  
  2064. There are several situations where the program will automatically cause a
  2065. macro pause.  These occur when the program is performing an operation which
  2066. under some, but not all, circumstances requires additional information from
  2067. you such a yes or no answer.
  2068.  
  2069. For example, if your macro is copying a file to a target directory where a
  2070. file by the same name already exists, you may be prompted, depending on your
  2071. current setup information, to confirm overwriting the file.  No prompt would
  2072. occur if the file did not already exist at the target directory.  Another
  2073. example is when your macro unlogs a tree.  If that tree represents a floppy
  2074. disk drive, you will be prompted whether or not to save the tree to disk.  No
  2075. 
  2076. MACRO Command Mode (7 of 8)
  2077. prompt will occur when unlogging trees representing hard disk drives.
  2078.  
  2079. In either case, your answer should probably not be recorded in the macro file
  2080. unless you are sure that the same prompt and response will be required each
  2081. time you playback the macro.  If so, you can terminate the automatic macro
  2082. pause by pressing Shift-F8.  Your response will then be recorded in the macro
  2083. and used each time the macro is played back.  In general, however, you should
  2084. let the program terminate the automatic macro pause itself.
  2085.  
  2086. To play back a macro, press Shift-F9 from the TREE, GLOBAL, LIST, or SPLIT
  2087. command modes.  The program will display a window of available macros sorted
  2088. by originating command mode and macro name.  For each macro, the program
  2089. displays the macro name, description, and command mode from which it was
  2090. recorded.  The program automatically highlights the macro which was last
  2091. played back.  Use the cursor control keys to move the highlighted bar over the
  2092. desired macro and then press carriage return to begin playback.  Alternatively
  2093. you may type the macro name and then press carriage return.
  2094.  
  2095. If the selected macro originated from a command mode other than the current
  2096. command mode, the program will go automatically the appropriate command mode
  2097. before executing.  If the macro was recorded from the SPLIT command mode, the
  2098. 
  2099. MACRO Command Mode (8 of 8)
  2100. program will require you to specify the split target directory before the
  2101. macro can be executed.
  2102.  
  2103. Macros can also be invoked from the command line at program startup by using
  2104. the /fMACRO option where MACRO is the macro file name (no file extension is
  2105. necessary).  These macros should always be defined to operate from the TREE
  2106. Command Mode.  Special consideration is needed when /f is combined with the
  2107. command line options /m or /s which initiate remote communications.  When used
  2108. with the /m option, the macro will be played back after the machine has
  2109. assumed the master mode.  When used with the /s option, the macro will be
  2110. played back before the machine assumes the slave mode.
  2111.  
  2112. A macro which is currently being played back can be aborted by pressing the
  2113. Shift-F9 key again.  If currently in a macro loop, the escape key will abort
  2114. the macro as well.
  2115. ENTERING DIRECTORY PATHS (1 of 2)
  2116. Specifying a directory path is required whenever copying or moving files or
  2117. directories from the LIST or GLOBAL command modes.  It's also required when
  2118. entering into the SPLIT command mode, or choosing F7 from any command mode to
  2119. change the current directory path.  There are several ways to specify a
  2120. directory path.
  2121.  
  2122. Pressing the carriage return key immediately selects the current tree as the
  2123. target tree and then allows traversal of the tree to highlight the target
  2124. directory.  Pressing carriage return again will select the highlighted
  2125. directory.
  2126.  
  2127. Entering a drive designator only (no colon) and pressing carriage return will
  2128. display the specified tree and then allow traversal and directory selection.
  2129. If the tree was not yet logged, the program will automatically log it.
  2130.  
  2131. Entering a drive designator followed by a colon will select the specified
  2132. tree's current directory as the target directory path.  If the tree was not
  2133. yet logged, it will be automatically logged and the directory selected will be
  2134. equivalent to DOS's current working (origin) directory on that drive.
  2135.  
  2136. The program will also accept directory paths entered similarly to how they are
  2137. 
  2138. ENTERING DIRECTORY PATHS (2 of 2)
  2139. entered with DOS's CHDIR command.  Entering only a backslash will select the
  2140. root directory.  This may also be followed with a path or directory name.
  2141.  
  2142. Specifying only a directory name will select the child directory (of the
  2143. current directory) with that name.  If the directory name is only one
  2144. character in length, precede it with a drive designator so that the directory
  2145. name itself is not confused with a drive letter.
  2146.  
  2147. Entering ".." will select the parent of the current directory.  Entering ".."
  2148. followed by a backslash and directory name or path will select a sibling or
  2149. sibling's descendent directory.  If this method is used, the ".." must be
  2150. specified first and entered once only ("..\..\dirname" or "dirname\.." are
  2151. considered invalid entries by the program).
  2152.  
  2153. Any of these methods may also incorporate a drive designator.
  2154.  
  2155. Finally, the next or previous directory in the tree can be selected by simply
  2156. pressing the + or - key.  No drive designator is necessary.
  2157.  
  2158. If an invalid path is specified, an error message will occur and the current
  2159. operation will be aborted.  Otherwise the operation will continue normally.
  2160. ENTERING OPERATION SCOPE (1 of 2)
  2161. Many program operations such as copying, moving, and deleting require you to
  2162. select the scope of the pending operation.  Scope means the number or range of
  2163. files which will be affected.
  2164.  
  2165. When not performing global operations, whether or not you are prompted for a
  2166. scope selection will depend on the value of the "Fast Command Mode" option in
  2167. the Miscellaneous section of the General Setup screen.  By setting this option
  2168. to YES, the current file becomes the default scope selection.  To select
  2169. tagged files, use the Ctrl key when selecting the option.  To select all
  2170. files, use the Alt key when selecting the option.  The Ctrl and Alt key
  2171. combinations are always available independent of the current setting of this
  2172. option.  For example, if COPY is the intended command selection, entering
  2173. Ctrl-C will copy all tagged files, entering Alt-C will copy all files, and
  2174. entering C by itself will copy the current file only.
  2175.  
  2176. When performing global operations, the number of files affected will also
  2177. depend on the value of the global parameter "Include All Subdirectories" in
  2178. the General Setup information screen.  When set to YES, all files in the
  2179. current directory as well as all files in all its subdirectories (its
  2180. descendants) are available in the scope selection.  When set to NO, only the
  2181. files in the current directory are available.
  2182. 
  2183. ENTERING OPERATION SCOPE (2 of 2)
  2184. Command Descriptions:
  2185.  
  2186.    CURRENT FILE - This scope selection will limit the pending program
  2187.       operation to the currently highlighted file in the file list.  This
  2188.       option is not available for global operations.
  2189.  
  2190.    TAGGED FILES - This selection will cause the operation to be performed on
  2191.       all tagged files in the current file list, directory, or directory
  2192.       subtree.  This option is available only when there are tagged files
  2193.       available.  This scope can be selected automatically by holding down the
  2194.       Ctrl key when selecting the operation to be performed.
  2195.  
  2196.    ALL FILES - This selection will cause the operation to be performed on all
  2197.       files in the current file list, directory, or directory subtree.  This
  2198.       scope can be selected automatically by holding down the Alt key when
  2199.       selecting the operation to be performed.
  2200.  
  2201.    DIRECTORY STRUCTURE - This option is available only for the global copy,
  2202.       move, and delete operations.  Except for the move operation, this scope
  2203.       selection will affect directory structures only.  Moving a directory
  2204.       structure, by necessity, moves the files in each directory as well.
  2205. END OF HELP
  2206.