------------------------------------------------------------------------------
-  JB LEARN HELP FILE - VERSION 2.12 - FOR {COMMO} VERSION 6.5 - 08/12/95    -
-  COPYRIGHT (C) 1995, JEFF BISHOP - ALL RIGHTS RESERVED.                    -
------------------------------------------------------------------------------

[MAIN HELP]
This menu allows you to get help on the main menu options. Simply select a
choice and you will receive help on it. When you are doing viewing help
topics, simply press <ESCAPE>. This will return you to the JB Learn main
menu.
[END TOPIC]

[CONTINUE LEARNING]
This option allows you to continue learning. The capture file is erased and a
new prompt is searched for. This should be used once activities in the JB
Learn menu are done. This option is selected by pressing C or <ENTER>.
[END TOPIC]

[AUTO RESPONSE]
This controls whether or not the user should be asked to confirm responses
found in the data file or not. If you answer 'N' the user will have to confirm
each match. This is how you will achieve best results. If you are daring 
answer 'Y' and the learn will assume what it finds is correct. You may or may
not get a macro that works answering 'Y'.
[END TOPIC]

[ADD DIALING DIRECTORY]
This allows you to add a dialing directory entry to your current dialing
directory. The advantage this has is that the macro just created will
automatically be linked to this dialing directory entry. You are also guided
through the process of creating the dialing directory entry. This prevents
errors in the syntax and layout of the dialing directory entry. You will be
allowed to define the system name, password, dialing parameters, and terminal
type.
[END TOPIC]

[KILL SEND LIST]
During the uploading processes in JB Learn, we use a file called {send}.lst.
This file contains a listing of files to send to upload. During the startup
code of JB Learn we found this file already here. Do you wish to delete the
file, or leave it here for your use?
[END TOPIC]

[ADD MACRO LINK]
JB Learn uses a macro link in your dialing directory to start executing the
program when logging onto a BBS. This option adds code to your COMMO.MAC to
make this entry of the macro link easier. If you do this you can simply add a
macro named 'LEARN' instead of specifying 'JB-LEARN,JB-LEARN.MAC'.
[END TOPIC]

[AUTOMATIC STRING DETECT]
This small menu will appear if a prompt that has been seen before is now here
again. You are given the option to have the learn engine write the code for
you for this prompt, or handle it differently.
[END TOPIC]

[EDIT BBS PROMPT]
This menu choice allows you to edit the existing BBS prompt. This might be
required in certain circumstances. The INPUT window is opened to allow you to
edit the prompt.
[END TOPIC]

[SEND ENTER]
This menu option simply sends a <CR> character in response to the current BBS
prompt.  This is useful for prompts like 'PRESS ANY KEY TO CONTINUE ...'.
[END TOPIC]

[SCROLLBACK]
This menu option allows you to enter COMMO's scrollback feature to review
previously seen text that scrolled off of the screen. This might be useful
for getting useful information that you missed while learning.
[END TOPIC]

[HOTKEY]
This menu option allows you to send a hotkey response to the BBS for the
current BBS prompt. A hotkey is a single letter response with no <CR>
appended to it. Many BBS types use this method of selection for their menus.
[END TOPIC]

[INSERT COMMENTS]
This option allows you to write a line to the macro file. This could be a
comment or even additional commands. This option simply takes what you
enter and writes it to the macro. Be very careful with this one.
[END TOPIC]

[JUMP AND SHELL]
You can jump to DOS for one user-defined command while learning. The
{COMMO} {EXECUTE} function is used with the "-n1" option only. This means
that the command interpreter will be invoked for your command. This will
allow you to run batch files and other internal DOS commands. Before the
command is executed, you are given the opportunity to write this logic
to your macro file. Be very careful with this command. If no command is
entered, then you will be shelled to DOS. The shell to DOS logic is NOT
written to the macro file. Expert mode must be on for this option to be
available.
[END TOPIC]

[DEFINE SSLOOK]
This menu option allows you to create SSLOOK strings and place them
into your macros. Consult the COMMO documentation on what a SSLOOK
command will do. Basically, the SSLOOK should be used when nagging
prompts that appear often during a login session. The SSLOOK will
send the response you tell it when it sees the target. You may have up to 15
SSLOOKS active at one time. When the menu appears, it will show you the
current number of active SSLOOKS. SSLOOKS can not normally be brought
forward. This means that after a {LOOKFOR} is executed, your previously
defined SSLOOKS are reset to active status. Answer 'Y' when asked if
you want this SSLOOK brought forward. Consult the COMMO documentation
(macro.doc) for more information on this capability. This feature is only
available in expert mode.
[END TOPIC]

[TREAT LIKE PASSWORD]
This option will send your password to the host and write macro code to do
it in your macro. The routine will check to see if you defined a password
in the dialing directory. If you have, it simply uses it. If you did not,
you will be asked for the password.
[END TOPIC]

[QUIT]
This option terminates JB-Learn. When this happens, final code is written to
the macro file. You are asked which keyboard definition that should be used.
You can choose VT100, VT220, Pine, DOORWAY, or none of the above. You are also
asked if you want to create a new dialing directory entry in your dialing
directory file. If you answer yes you will be prompted for the system name
(a default is provided if known), and the phone number will be asked for.
You are also asked for stop bits, data bits, and parity options. The password
and terminal type is also asked for. The routine will place the new entry just
after the one already defined in the dialing directory. The string '(WITH
LEARN)' is appended to the system name. If no entry matching the system name
is seen, the entry will be placed at the end of your dialing directory. The
linked macro will automatically be defined for you based upon the input
entered earlier. A backup of your original dialing directory file is made
prior to any modifications. The name of this dialing directory file is defined
with the variable FON_FILE. Once this is done, the variables are cleared out
of memory and the JB-Learn processor will be terminated.
[END TOPIC]

[SEND STANDARD]
This menu option allows you to enter a string to send to the host in
response to the BBS prompt. A <CR> (decimal 13) will be appended to the
response string. This is none to JB Learn as a STANDARD RESPONSE.
[END TOPIC]

[TRANSFER MENU]
This menu selection allows you to either upload or download files with a
variety of transfer protocols. Simply answer the questions as shown once a
protocol choice is made. You are able to write this transfer logic t o your
learned macro as you perform the transfer. For all transfer protocols you are
given the option to write the sending of the current filename to the macro or
you can write code that will prompt you for the filename each time in the
macro. This is up to you.
[END TOPIC]

[LOOKFOR TIMER]
This option allows you to maintain the WAITTIME variable. This variable
defines the length of time after all modem activity stops before the learn
process starts interacting with the user. Change the definition if you would
like. Be careful though to keep it long enough. Making it too short
will have disastrous affects in the learn engine. If this variable is
set as NULL, then this auto learn type feature is turned off. Expert
mode must be on in order for this feature to work.
[END TOPIC]

[TARGET RESPONSE MENU]
This menu allows you to review the current BBS prompt and the response for
this prompt. You can edit both of them with options provided in the bottom
portion of the menu.
[END TOPIC]

[DIALING PARAMETERS]
This menu allows you to select the parity, stop bits, and data bits for this
dialing entry. The baud rate is determined automatically based upon the
current speed of the modem. The options available here are: 7 = 7 databits,
even parity, and 1 stop bit, 8 = 8 data bits no parity and 1 stop bit, and
C = current dialing parameters.
[END TOPIC]

[DEFINE LOOKFOR/SEND PAIR OR SSLOOK]
You now have an option to define the response to the current BBS prompt as a
LOOKFOR/SEND pair or as a SSLOOK. Use a LOOKFOR/SEND pair if the current
prompt is one that should not be seen very often. If this prompt is one that
is seen often, use the SSLOOK option. You may define up to 15 SSLOOKS. After
this point, a forced LOOKFOR will be done.
[END TOPIC]
