OS/2 Professional

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / btp_eebe / bt_ref.doc < prev next >

Wrap

Text File | 1992-09-12 | 140.9 KB | 2,923 lines

**** * * * ******* TM * * * * * * * * * ** * * * *** * * * *** * ** *** ** **** * ** * * * * * * * * * * * ** * * * * * * * * *** * **** * * * **** * * * * * * * * * * * * * * * * * * * * * **** * * * * * * **** **** * **** * * * * E X T E N D E D E * D I T I O N * Version 2.50 EE - Reference Guide *** September 12, 1992 ******************************************************* * THIS VERSION IS A HACK! * * IT DOES NOT OROGINATE FROM BIT BUCKET SOFTWARE * * AND THERE IS NO OFFICIAL SUPPORT. * * * * PLEASE READ BTEE_MOD.DOC CAREFULLY! * * USE THIS VERSION ON YOUR OWN RISK! * ******************************************************* A Freely Available FidoNet Compatible Electronic Mail Interface and Dumb Terminal Package Software Written by Vince Perriello and Bob Hartman Enhancements Written by Michael Buenter, Holger Schurig and Tobias Burchardt. Documentation Written by Alan D. Applegate Copyright (C) 1988, 1989 Bit Bucket Software, Co. A Delaware Corporation Enhancements (C) 1991, 1992 Michael Buenter All Rights Reserved Terms and Conditions Contained Separately Bit Bucket Software, Co. 427-3 Amherst St., Suite 232 Nashua, NH 03063 "BinkleyTerm" and "Freely Available" are trademarks of Bit Bucket Software, Co. TABLE OF CONTENTS Section 1 - General Information How to Use This Manual Section 2 - Configuring BinkleyTerm Configuration File Scheduling Events Section 3 - General Reference Information Command Line Parameters Dial Translation Response File Template Scripts Terminal Mode Keystrokes Unattended Mode Keystrokes VT-100 Keystrokes +-------------+ | +---------+ | | | Section | | BinkleyTerm Reference Guide | | 1 | | GENERAL INFORMATION | +---------+ | +-------------+ HOW TO USE THIS MANUAL The documentation for BinkleyTerm is supplied in two parts. The User's Guide (named BT_USER.DOC) explains how to install BinkleyTerm. It also describes basic operational procedures. New users may find some concepts or terminology unfamiliar; a glossary is provided toward the end of the User's Guide. Concepts and terminology that may be of interest to experienced users and new users alike are covered in the Reference Guide (named BT_REF.DOC) an alphabetica┴ëM╪┴Θ≤Ñï╚ïEαâß≤ñïM▄ï}╪ï≤ìZ≈ëuαï∙ï╨ë]▄╕ï≤+r<ç}▄+╬ïuαΣ≥«ì t3 ïM▄ï┬ï╫ àV ëu∞ë]≡ïU≡ï]∞ï≥ï√ïE+P<ïE+┬ï╨ï╩┴Θ≤Ñï╩âß≤ñ+]├â─(_^[╔├Uï∞SVWü∞êëEëM╔t└u╥uâ╚ ü─ê_^[╔├╥uâ}u╟─l â╚ ü─ê_^[╔├ïEëEÉ└u╟E╠L«ëUöδ=ï┌╕≡Φ≡╪ ï╙ëE£└u╟─l ╟Eα Θ ⁿëUö╟Eá╟E╠L»╟Eαâ}ö└êEªï}┤ïMï╫ï┘ï√3└â╔ ≥«≈╤+∙╕%≥«ì t3 ï╦ç╫ëU└╥ä&j j+╙RSìUÉR░ U╠ï╦â─â°·u≈]αΘì@ï┘ïM└ïEα┴+├ëEαA╟E╪╗3÷ï└ï╤A3└èâΦ â°çë $à°Ñï└Tªxªxª`ªxªxªxªxªxªxªxªHªxª<ªxªxªlªï╞é╚ï≡δ6ì@ï╞é╚ï≡δ*ì@ï╞é╚ï≡δì@ï╞é╚ï≡δì@ï╞é╚ï≡δì@3█I█àY ï╓ëU╪é9*u#ïEìXë]ïëE╘└}é╩ï≥ëu╪≈╪ëE╘Aδ4ⁿ╟E╘ïdb 3÷ⁿ3╥èfïSâαtï╞ï≥âε0└ìÇ≡AδΓï└ëu╘é9.t╟E▄ ΘSï±Aé9*uï╬ïEìXë]ïëE▄â┴δ6ì@╟E▄ïdb 3÷ⁿ3╥èfïSâαtï╞ï≥âε0└ìÇ≡AδΓï└ëu▄è<ht<lt<LuèêEºAδì@╞Eº 3└èâ°%äπâΦEâ°3ç $àäºD⌐D⌐D⌐£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡∞⌐£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡t¿∞⌐D⌐D⌐D⌐£¡∞⌐£¡£¡£¡£¡|¼∞⌐∞⌐£¡£¡┤¼£¡∞⌐£¡£¡∞⌐ï┘j jjSìEÉP░ U╠ï╦â─ëEΦΘ1ⁿé}ºlàvï┘ïEìPëUfïìE¬Φ°üï╦ëEΦâ° u╟EΦΘ·ï└ïE╘+EΦëE╨└╟E╨δï└÷E╪t≈]╨ï┘j u╨ïEΦPìE¬PìEÉP░ U╠ï╦â─ëEΦΘ▓ï└ïEìXë]ïêE¬ïE╘HëE╨└}╟E╨δï└÷E╪t≈]╨ï┘j u╨jìE¬PìEÉP░ U╠ï╦â─ëEΦΘ`é9Fué}ªt╟EΦIΘHèêE½ïE╠ëEÿèEºêE¬é}¬Lu%ï]ìCëEïëàt ïCëàx ïCëà| δï]ìCëEïëE∞ïCëE≡é}ºLu ìàt δï└ìE∞ï┘ uìU¬R u▄ u╘ïM╪ìUÉâ∞Φx» ï╦â─ëEΦΘ╗ì@é}ºhué9ptïEìXë]┐ëEΣδïEìXë]ïëEΣâ}▄}╟E▄δì@â}▄uâ}Σu╟EΦΘdée╪∩é9pu╞E¬l╞E½XδⁿèEºêE¬èêE½ì}Åë}¼é}½ou ╟E╕δèE½<xt<Xu ╟E╕δ╟E╕ ╟E╚èE½<dt<ià@ïEΣ└}╞E¿-╟E╚≈╪ëEΣδ'ï└÷E╪t╞E¿+╟E╚δⁿ÷E╪t╞E¿ ╟E╚é}½Xu ╕¼Q δï└╕└Q ëE░é}¬hufï]Σüπ ë]ΣïuΣ÷t&ïU░ï]╕ëMⁿOï╞ï≥3╥≈≤ç≥è2êï≡└uΩëuΣïMì]Å+▀ë]╝ïE▄+├ëEΣ└~δï└3└ëE─÷E╪ä9â}╝v3é}½ouï╪â√s&╟E─δⁿèE½<xt<Xu╞E¿0èE½êE⌐╟E╚ïE╘+E╝+E╚+E─ëEΣ└~%÷E╪t≈╪ëEΣδ÷E╪tïEΣE─╟EΣδ ì@╟EΣïEΣ└~δ3└ï┘j P u╚ìU¿RìUÉR░ïu╠ ╓ï╦ï╓â─ëEΦâ°·tj0ïE─P u╝WìEÉP░ ╥ï╦â─ëEΦâ}Φ·t(ïEΣ└}δì@3└ï┘j PjjìUÉR░ U╠ï╦â─ëEΦâ}Φ·äFïEΣÖ3┬+┬ï]─]╝]╚╪ë]ΦΘ+ì@é}ºhuïEìXë]ïï]αfëδì@ïEìXë]ïï]αë╟EΦΘ≡ïEìXë]ïëE└└u*╟EΦ· â}áä═ï┘ìEÉP░Φï╦â─Θ╢ï└é}ºlu.ï┘ïE╠ëEÿ u▄ u╘ u╪ìEÉP u└░Φºï╦â─ëEΦΘéï└ï≈ï┘ï}└3└â╔ ≥«ç┘ï■≈╙Kë]Φâ}▄}ë]▄δⁿïEΦ;E▄}δï└ïE▄ëEΦïE╘+EΦëE╨└} ╟E╨δ ÷E╪t≈]╨ï┘j u╨ïEΦP u└ìEÉP░ U╠ï╦â─ëEΦδ ï└╟EΦIâ}Φ·u≈]αδⁿAïEΦEαΘ¼≈ ë}┤ëMï]α█îcïUï·3└â╔ ≥«≈╤IëMΦj jQRìUÉR░ U╠â─â°·u ≈█ë]αδ3ì@ïEΦEαâ}uïEö╞δâ}átìMÉQ░Φ╧â─â°·u≈]αâ}tïE£ΦB╝ ïEαü─ê_^[╔├Uï∞SVWïu÷~.3└èEèαï╚┴ß┴ïUïzï▐ï╦┴Θ≤½ï╦âß≤¬ï╬ïB┴ëBïU╥v!ïEïxïuï┌ï╦┴Θ≤Ñï╦âß≤ñïX┌ëXïu÷}1≈▐ëu3└èEèαï╪┴π├ï]ï{ï╓ï╩┴Θ≤½ï╩âß≤¬ïS╓ëSïEE_^[╔├ï└Uï∞â∞ïEâ8uïHïPï@Φ0jâ° u&╕· â─╔├ïMïQïAΦO⌐└t ╕· â─╔├ïM╟A3└â─╔├Uï∞â∞SVW╟Eⁿïuï^≈█ü├≡ë]°ï} Ä«ë}ⁿèUï└;√î`ë}≡╢┬ëU⌠èαï╚┴ß┴ï~ïNëu∞∙ï╙ï≥ï╬┴Θ≤½ï╬ïu∞âß≤¬ï}≡VV░Φ, ïU⌠â─â°·u ╟Eⁿ· δ+√╗≡δ¢ì@êUë}ë]°3└èEèαï╚┴ß┴ïuï~ïN∙ïUï┌ï╦┴Θ≤½ï╦âß≤¬Vïu)u°ïU╥å╕ïEⁿâ°·ä¼┬ëEⁿï}ïu°ï]ⁿï╞;┬ç^ëu∞ï╧ëU≡ï{ïS·ï±ëM⌠ï╨ï╩┴Θ≤Ñï╩ïU∞âß≤ñï}⌠ï≥CS░Φf■ ïU≡â─â°·u╟Eⁿ· δï└ï╞+╨■╛≡δ¢ì@ëUë}ëu°ïEïxïX√ïuï]ï╙ï╩┴Θ≤Ñï╩âß≤ñXïE°+├ëE°ï} ì╜ïEⁿâ°·ä▒≈▀ë}╟ëEⁿèUï]°ïuⁿ;√î`ë}≡╢┬ëU∞èαï╚┴ß┴ï~ïNëu⌠∙ï╙ï≥ï╬┴Θ≤½ï╬ïu⌠âß≤¬ï}≡VV░Φÿ² ïU∞â─â°·u ╟Eⁿ· δ+√╗≡δ¢ì@êUë}3└èEèαï╚┴ß┴ïuï~ïN∙ïUï┌ï╦┴Θ≤½ï╦âß≤¬VïEⁿ_^[╔├ì@Uï∞SVWâ∞ â}ì7ïMëMΦfâ9tⁿâ┴fâ9u≈ëMΦïEΦ+EÖâΓ┬╤°ëEïMâßu╤αëEâ}u ïMïQj uj uQ░ ╥â─ëE≡Θ:÷EäûïE╤αΦ╨╦ ëE∞└u╟E≡· ╟─l Θ╣ì@ï]∞ë]αïuëuΦï} ä=fâ>t7ïM≡fïï├Φxï╚â° u╣· δ┘Oâ╞ tfâ>u╪ëM≡ë}ë]αëuΦâ}≡·äXïEα+E∞ëE≡ΘJïEΦ<╦ ëE∞└u╟E≡· ╟─l δ(ï└ï]ï├Φ╦ ï╦ëE∞ïUΦvëE≡â° u╟E≡· ï]≡â√·ä<ïE+├ëEΣ└} ╟EΣδ ⁿ÷Et≈]ΣïMïqj uΣïU≡R u∞Q░ ╓â─ëE≡ïE∞Φ╖ ïE≡â─ _^[╔├Uï∞â∞║í╪F â└$Φtφ └à╩ï╪F ÷A$à║Φ╟í╨F ΦÖƒ í╘F ΦÅƒ ï╘F ïI<╔tQ░Φâ─ï╠F ïI<╔tQ░Φâ─ï╨F ïI<╔tQ░Φâ─3╥í╠F ΦÅf3╥íion "Scheduling Events" for details. See also 'Packer' and 'Cleanup' for related information. Aka <net>/<node> NOTE: This statement is supported for backward compatibility only. If you wish to specify a/k/a addresses, please use the newer 'Address' statement described previously. Allows nodes with more than one FidoNet address to specify their alternate addresses. This would normally be used by network, region or zone coordinators, and other 'special' nodes. Multiple 'Aka' statements can be used. Answer <modem_string> When this statement is used, BinkleyTerm assumes that the modem has been set NOT to answer the phone automatically (by the modem initialization string, or the modem's DIP switches). When BinkleyTerm receives a response string of "RING" from the modem, it sends the <modem_string> command to the modem to answer the phone. The advantage is that BinkleyTerm must be "alive and well" before the modem will answer a call. If for some reason BinkleyTerm is not available, yet the modem still has power, no calls will be answered. NOTE! Some modems DO NOT like commands to be sent while they're sending response strings...in testing, this feature DOES NOT work on all modems. Only by trying it will you be able to determine if it works with your modem. AnswerBack <text> In Terminal Mode, when an ENQ (ASCII decimal 5, hex 5) is received, <text> will be sent in response. Normal BinkleyTerm character translations are available. Many BBS packages send this character immediately prior to requesting a user name. Application <app_name> [<parm> <parm> ... ] Allows addition of application dependent data to the configuration file. Any 'Application' statement is ignored by BinkleyTerm entirely. <app_name> is the name of or reference to a specific application, such as a message editor or outbound maintenance utility that uses the BinkleyTerm configuration file. Zero or more application specific parameters, shown as <parm> in the example, may follow <app_name>. Autobaud In Unattended Mode, this forces BinkleyTerm to call out at the baud rate specified by the 'Baud' statement, regardless of the baud rate associated with a given nodelist entry. This assures connects at the highest possible baud rate. Avail <filespec> This designates the name of the file to be sent to a remote system that file requests "FILES" from your system. The <filespec> identifies the file, and may contain an optional drive and path designation. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. Banner <string> The line designated by <string> is sent to callers immediately following the BinkleyTerm identification line, and before the line, "Press <Escape> to enter BBS." Generally, this is the name of your BBS or something else of interest to callers. Baud <max_baud_rate> This parameter tells BinkleyTerm your maximum baud rate. Valid <max_baud_rate> settings are 300, 1200, 2400, 4800, 9600, 19,200 and 38,400. In Terminal Mode, you may change this setting. BBS <exit_option> This designates the method to be used to access your BBS software when a human caller dials your system. Valid options for <exit_option> are 'Batch,' 'Exit' and 'Spawn.' Refer to the User's Guide section "BBS Interface" for more information on the options, and how to use them. BBSNote <string> After a human caller presses Escape to access the BBS program, or after the number of seconds designated by the 'Timeout' statement, BinkleyTerm will display the <string> to the caller. Generally, this is a notification that the BBS software is loading. BlankWait <number> Sets the number of seconds Binkley will wait before blanking the screen when the "ScreenBlank" config verb is uncommented. Boss <net>/<node> NOTE: This statement is supported for backward compatibility only. It is not needed when the 'Address' statement is used, as described previously. This specifies a FidoNet node address. For regular FidoNet nodes, place your assigned address here. For Point systems, place the address of your Boss node here. BossPhone <phone_number> This parameter, used in Point installations, contains the telephone number of your Boss node for use with the Alt-Y command in Terminal Mode. This statement is optional in all cases except Point installations that do not wish to use a nodelist. BossPwd <password> Used for Point installations, this parameter designates the password to be used for session-level passwording with your Boss node. Refer to the User's Guide section "Security - Session Passwording" for additional information. The Boss node must also have session passwording implemented, using this password. When this parameter AND 'BossPhone' are BOTH implemented, a nodelist is NOT required for a Point system. BoxType <number> When full-screen mode is used (default), this tells BinkleyTerm what type of boxes to use for the various on- screen windows. Legal values are from 0 to 4. They produce the following results (apologies given to people with printers that do not support the extended IBM character set): 0 1 2 3 4 0 = Hatches (Non-IBM) +-+ ┌─┐ ╔═╗ ╓─╖ ╒═╕ 1 = Single Rule | | │ │ ║ ║ ║ ║ │ │ 2 = Double Rule +-+ └─┘ ╚═╝ ╙─╜ ╘═╛ 3 = Single Top, Double Sides 4 = Double Top, Single Sides Busy <modem_string> While BinkleyTerm performs certain functions, and when you exit the program from Unattended Mode, BinkleyTerm sends the <modem_string> to the modem. Normally, this is a short set of modem commands, as shown in the sample configuration file, to take the phone off-hook to prevent incoming calls. Callers will hear a busy signal. You may desire to lower DTR instead using a lower-case letter "v." This would cause callers to hear ringing, but with no answer. CaptureFile <filename> If used, this statement tells BinkleyTerm the name of a file to use for session capturing in terminal mode. The Alt-L command toggles session capture on and off. If this statement is not used, then BinkleyTerm will prompt for a name each time Alt-L is pressed. When activated, all communications session I/O will be echoed to this file. The <filename> may optionally include a drive and path designation as well. Carrier <hex_carrier_mask> This tells BinkleyTerm which FOSSIL status bit it should use to determine whether or not carrier is present. A value of 80 (hexadecimal) is nearly always correct. Some modems do not support CD (carrier detect) and other signal lines may be used. NOTE: This value is in HEXADECIMAL (base 16). Other systems, such as Opus-CBCS, ask for this value in DECIMAL (base 10). Normal setting is 80 hex, which equals 128 decimal. CheckInit BT watches now the modem reponse after issuing the init string. If there's no "OK" coming, BT tries again. After two unsuccesfull tries, BT exits with errorlevel 2. I recommend to comment out "PreInit" when using this feature. Cleanup <command_line> If used, BinkleyTerm will execute <command_line> at the beginning of each event, but prior to the 'Packer' statement's command line (if used). This might be used to unpack any previously packed outbound mail for later repacking, or to perform minor outbound area maintenance, etc. It is suggested that <command_line> designate a batch file that would contain the command line(s) for the program(s) actually used to unpack mail and/or perform maintenance. See also 'AfterMail' and 'Packer' for related information. Colors <n1> <n2> <n3> <n4> <n5> <n6> <n7> <n8> <n9> <n10> <n1> top and bottom text displays (Nodenumber, Systemname, Version and help key). <n2> "Current-Settings"-window <n3> "Today at a Glance"-window <n4> "Pending Outbound Mail"-window <n5> "Recent-Activity"-window <n6> "Transfer Status"-window <n7> actual called node in the "Pending Outbound Mail"-window <n8> color of pop-up windows <n9> header of all windows <n10> border of all windows Only applies if a Video FOSSIL (VFOSSIL) is detected at start- up. This statement allows setting of color attributes for the full-screen windowed display. The default colors are all 7, black background with white foreground. The following chart may assist you in determining your desired color attribute values. The numbers listed under "Foreground" will yield the given color on a black background. By adding the value shown under "Background Value" to the foreground value will yield a background of the selected color. For example, to get yellow characters on a blue background, add the foreground color for yellow, 14, to the background value for blue, 16 - use a color attribute of 30. Note that gray, bright colors and yellow cannot be used for the background. Color Foreground Background Value -------------- -------------- ---------------- Black 0 0 Blue 1 16 Green 2 32 Cyan 3 48 Red 4 64 Magenta 5 80 Brown 6 96 White 7 112 Gray 8 N/A Bright Blue 9 N/A Bright Green 10 N/A Bright Cyan 11 N/A Bright Red 12 N/A Bright Magenta 13 N/A Yellow 14 N/A Bright White 15 N/A On IBM-compatible monochrome displays and using a black background, colors 9 through 15 yield high intensity characters, 1 through 7 normal intensity characters. 0 and 8 yield invisible characters. 1 and 9 will yield underscored characters. CursorCol <column> For use with multi-tasking systems, this tells BinkleyTerm the column number to place the cursor after screen writes. For DESQview, <column> should be set to 1. The default value is 80. CursorRow <row> For use with multi-tasking systems, this tells BinkleyTerm the row number to place the cursor after screen writes. For DESQview, <row> should be set to 1. The default value is 23. CostLog <file> It needs CostLog definitions from parselst.cfg and works only with the German and Swiss phone billing scheme. If "CostLog" isn't defined, then everything works the standard way. If CostLog is defined you will have to change the cost settings of your nodelist compiler. BT EE needs the cost in tenth of seconds for one cost unit in the compiled nodelist. The costlog has two formats: One "big" if abs(LogLevel) is 5 and one "small". CostUnit <unit> Define the cost unit. If you leave it out, Binkley uses 23 (for Germany every unit costs 23 Pfg, length of unit differs with the distance of your call). If you live in Switzerland you will probably define "CostLog 10" for 10 Rappen. Dial <match_string> <new_prefix>/[<new_suffix>] This option allows for real-time telephone number translation. BinkleyTerm will look at the telephone number it is to send to the modem. If the prefix of the telephone number matches that shown in <match_string>, then the prefix will be changed to <new_prefix>, and <new_suffix> (optional) will be added to the end. In most cases, this will be used to strip-off "1-" and/or area codes for systems in a local exchange, such as: DIAL 1-603-888 888/ A number in the nodelist as 1-603-888-8179 would be changed to simply 888-8179 and dialed. DIAL 1-303-555 555/&M0 A number in the nodelist as 1-303-555-1234 would be changed to 555-1234&M0 and dialed. There is a maximum of 20 characters each for <match_string>, <new_prefix> and <new_suffix>. Another use for this feature would be for dialing scripts: DIAL 1-404 "GA_PCP.SCR"404/ This line could be used to invoke a PC Pursuit script, for example, for the state of Georgia. The script would be used for all outgoing calls to area code 404. For permanent translations it is probably more efficient to perform these translations with your nodelist processing program (i.e., XlatList, ParseLst, XlaxNode). Refer to your nodelist processing software documentation for more information. DoingMail <string> If used, this statement will cause BinkleyTerm to send <string> to a caller when an event without a 'B' flag is active, indicating that BBS access is NOT allowed. This replaces the default string "Processing Mail. Please hang up." See the section "Scheduling Events" for more information on event flags. Domain <designator> <abbreviation> [<nodelist> [<start_z> <end_z>]] For Domain-Support refer to the User's Guide Section "Description an Operation of Domain Addressing". BT uses start_z and end_z for a simple domain matching. If BT receives any nodedumber without domain and you set up domains, it'l try to add the domain with comparing them to all <start_z> <end_z> entries. Example: Domain fidonet fidonet nodex 1 6 Domain signet signet sigex 24 29 Domain virnet virnet virex 9 9 If BT receives 27:1341/103 ther will be added @signet automatically. Downloads <path> This tells BinkleyTerm where to place files downloaded while in Terminal Mode. The <path> is a complete drive and path designation. This path has no effect on mail transfers made in Unattended Mode. DTRHigh If used, BinkleyTerm will leave the DTR (data terminal ready) line to the modem "high" whenever it is exiting. By default, BinkleyTerm takes the DTR line "low" when exiting. The use of 'DTRHigh' has no effect when doing an Alt-J shell escape which will leave DTR low. 'DTRHigh' should be used with modems that go back on-hook when DTR is lowered. EnterBBS <string> If used, this statement will cause BinkleyTerm to send <string> to a caller when the BBS is available, during events with a 'B' flag, indicating that BBS access is allowed. This replaces the default string "Press <Escape> to enter BBS." Note that <string> must not exceed one line. See the section "Scheduling Events" for more information on event flags. Event <event_flags...> NOTE! Normally the 'Event' statement is used only in the event file, BINKLEY.EVT. Events should NOT be scheduled in the configuration file. This statement begins an event line. Due to the depth of this topic, it is covered in the section "Scheduling Events." ExitBaud [<errorlevel>] <Connect> This is a feature for people who have to react on different connect messages (e.g. Fax modems). If BT encounters the given <Connect> messages reported by the modem it takes the following action: - errorlevel > 0: * forces Binkley to exit with the specified errorlevel (or 99 if not defined) * it generates a batchfile called BAUDBAT.BAT that contains the line "EXITBAUD <locked Baudrate> <Baudrate> <Port/Handle> <Time_to_next_event> <Connect>" - errorlevel < 0: * forces Binkley to shell to call "EXITBAUD <locked Baudrate> <Baudrate> <Port/Handle> <Time_to_next_event> <Connect>" E.g. if you have a Fax-Modem that reports 'CONNECT FAX' and you want to call your fax-software as fast as possible, you may include ExitBaud 199 FAX into your CFG. You see that this statements works like ExtrnMail... In OS/2 you'll have to use the shell! ExtrnMail [<errorlevel>] <string> This is used in conjunction with BinkleyTerm's external mail program feature. If while waiting for a YooHoo or TSYNC (the beginning of a FidoNet mail session) BinkleyTerm receives <string>, it will write to the disk a file named MAILBAT.BAT, and will then exit with an errorlevel of 99. Refer to the User's Guide section "External Mail Programs" for information. Note that if the [<errorlevel>] parameter is used, BinkleyTerm will exit with an errorlevel of the value given, rather than the default value of 99. When used for an external mail program, <string> should be relatively long, without too many repeating characters, to assure accuracy. When used with multiple BBS functionality, <string> may be only one letter. Up to 16 "ExtrnMail" statements that each use [<errorlevel>] may be used. FaxIn <fax_inbound_path> This keyword tells Binkley where to store received Class 2 faxes. See the User's Guide for more information about Class 2 fax receive. FileSec <n> See MaxAreas Flags <dir> The directory name specified is used by BinkleyTerm to create task identification files. The filename is TASK.# where # is the task number. These files can be used to determine if any given Binkley task is currently running. The file is created whenever Binkley has carrier present and a mail session is in progress. FTS-0001 When used, this statement will force BinkleyTerm to use only base FidoNet protocol (FTS-0001), effectively enabling the equivalent of the following statements: NoWaZOO, NoResync, NoSLO and NoSEAlink. Used mostly for debugging and testing of FidoNet policy compliance; not for regular use. Gong Using this statement causes BinkleyTerm to sound an alarm when it successfully connects with a system it's attempting dial, or after a download has been completed. 'Gong' is only applicable in Terminal Mode. Note that 'Gong' also works when doing a manual mail poll operation in Terminal Mode (Alt-M). Hold <path> This specifies the complete drive and path designation for the directory that will be used as your outbound mail holding area. oMMM and/or other mail processing software places outbound mail in this area for BinkleyTerm to send to or hold for other FidoNet systems. It should be mentioned that this area should NOT contain any other files of any kind, and that the contents of the directory should NOT be manipulated by you unless you know EXACTLY what you're doing. For all practical purposes, BinkleyTerm maintains this directory for you. Include <filename> If used, this tells BinkleyTerm the name of a file to include while reading the configuration file. The include file must contain additional configuration file statements in the same format as expected for the primary configuration file. When end-of-file is reached, BinkleyTerm will continue reading the main configuration file at the line immediately following the "Include" statement that initially caused BinkleyTerm to branch. The <filename> may optionally include a drive and path designation. Example: C:\BT\INCL_2.CFG Init <modem_string> BinkleyTerm sends the <modem_string> to the modem to initialize it, and make it ready for communication. The string is sent to the modem verbatim, with the exception of special dial translation characters. These characters are shown in the section "Dial Translations." Refer to your modem instruction manual for help in finding a correct init string for your particular modem and configuration. JanusBaud JanusOK Controls whether Janus bi-directional protocol will be used during WaZOO sessions. Please refer to the complete Janus explanation in the User's Guide. KnownAbout <filespec> This tells BinkleyTerm the name of the ABOUT file, a special file used with incoming file requests. <filespec> is a complete drive, path and filename designation. This ABOUT file applies only to file requests that are received from "known" systems. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. KnownAvail <filespec> This designates the name of the file to be sent to a "known" remote system which file requests "FILES" from you. The <filespec> identifies the file, and may contain an optional drive and path designation. Refer to the User's Guide sections "File Requests" and "Security -Controlling File Requests" for more information. KnownInbound <path> Used with secured inbound areas, this statement designates the path to the inbound file area used for mail received from "known" systems. Refer to the User's Guide section "Security - Secured Inbound File Areas" for more information. KnownMaxBytes See 'MaxBytes' for information. KnownMaxTime <number> See MaxTime. KnownMinBaud <baud> See MinBaud. KnownReqLim <quantity> This tells BinkleyTerm the maximum number of files that will be sent in response to incoming file requests during any one mail session. Regardless of whether the incoming requests has wildcards, or whether multiple file requests are sent in one mail session, the maximum number of files that will be sent in response to an incoming file request will be no greater than <quantity>. This statement applies only to "known" systems. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. KnownReqList <filespec> This designates the name of the OKFILE, a special used with incoming file requests. The <filespec> is a complete drive, path and filename designation. This OKFILE applies only to file requests received from "known" systems. For more information, refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests." KnownReqTpl <filespec> This designates the name of the response file template used for request response file construction. The <filespec> is a complete drive, path and filename designation. This template applies only for response files generated for "known" systems. For more information, refer to the User's Guide sections "Request Response Files" and "Security - Response File Templates." KnownSec <n> See MaxAreas LazyAkaChk Standard behaviour on EMSI Sessions is to hang up if the remote password does not match our passwords. If you enable "LazyAkaChk" in BINKLEY.CFG, all Akas with bad passwords are deleted (no mail is sent to those akas) but BT does NOT hang up. If you want to protect _your_ akas, e.g. tell BT to hang up if a remote system calls you with one of your akas in his aka list, install a password for your own akas! Lockbaud <string> LockBaud [<lock_rate>] The <lock_rate> parameter tells BinkleyTerm what baud rate at which locking should occur. This is useful for modems that allow a floating baud rate to a certain speed, then are locked at higher connect rates. Most ROM revisions of the USRobotics Courier HST 14.4k model and the USRobotics Courier HST Dual Standard allow this type of operation by setting the modem for &B0 which floats the baud rate at 2400 bps or lower. Bit 7 (and perhaps Bit 6) of the S27 register also need to be set appropriately. TO LOCK AT 19200 AND FLOAT AT SLOW SPEEDS: Use the 'Baud 19200' and 'LockBaud 4800' statements in your configuration file, and set the modem for &B0 and S27=128. Jeff Nonken's Lockbaud ARQ idea has been implemented. The <string> should be that part of the connect string from the modem that identifies an error-free connection. The FOSSIL should NOT be locked if this option is used. See the User's Guide for more information. If you have a modem with more than one response code which indicates an error-free connection, you can use multiple "LockBaud" lines (up to 16). LogLevel <log_level_number> This tells BinkleyTerm how verbose to make the status log. Acceptable values for <log_level_number> are from 1 to 5, 1 indicating minimal information, 5 maximum information. See the 'Statuslog' option for additional information. If you define a negative Log level, Binkley will only write to the logfile if a carrier is currently detected. This reduces the logfile dramatically, but with "LogLevel -5" you still have the complete information of your sessions available. Note that this can cause problems with logfile-analyzers. Each log entry is preceded by a character or a blank, indicating the importance of the entry. LogLevel Characters That Precede Included Entries 1 ! * 2 ! * + 3 ! * + : 4 ! * + : # 5 ! * + : # and blank (no character) Macro <number> <macro_string> This allows the sending of predefined macros from within Terminal Mode. Macros are typically used to send your name, user ID, or passwords while on-line. The <number> parameter is a digit between 1 and 9, which corresponds to the F1 through F9 keys. While in Terminal Mode, you send a macro by pressing Alt-Fx, x indicating the macro number you desire to send. The <macro_string> is sent verbatim. A carriage return is indicated by the pipe symbol (|). No other translations take place. MailNote <string> Used in conjunction with BinkleyTerm's external mail program feature. When the string designated by the 'ExtrnMail' statement is received, <string> is sent to the caller as notification that the external mail program is being loaded. Refer to the User's Guide section "External Mail Programs" for information. MakeDir If "TaskNumber" is set and if BT has to create flag files, not available directories (PNT, zones) are now created on the fly. Empty PNT directories are deleted after use. MaxBytes Together with the 'ProtMaxBytes' and 'KnownMaxBytes' statements, you can control file requests by number of bytes sent. These three statements work in the same manner as the other file request limiting statements detailed in the documentation. NOTE: There is a response file "Type 6" response now, which indicates that the caller has exceeded the byte limits. MaxAreas <area.dat> Adding MaxAreas with the path to your Maximus AREA.DAT files database let's BT seek files in this base when processing file requests. All you have to do is: * add "MaxFiles D:\Max\AREA.DAT" to BINKLEY.CFG * add "*D:\Max\MAXFILES.IDX" to you OKFILE You will have to add following keywords to your BINKLEY.CFG: FileSec <n> KnownSec <n> (optional) ProtSec <n> (optional) Where n is the following security level: 0=Disgrace, 1=Limited, 2=Normal, 3=Worthy, 4=Privil, 5=Favored, 6=Extra, 7=Clerk, 8=Asstsysop, 10=Sysop, 11=Hidden, -2=Twit (not supported) Each caller will be assigned a "user level" (security) depending on their caller level (default, known, prot). This security will be compared to the access rights in the Maximus file area. If the security is too low, the caller will get a password error. Access to 5000-8000 files is very fast: it takes about _one_ second on my setup! This won't be very much longer on slower systems because the file access time will stay about the same. MaxPort <quantity> BinkleyTerm is capable of supporting up to 32 communications ports. This is, however, far more than any current FOSSIL driver is capable of supporting. Normally the <quantity> will be 1 or 2, depending on your FOSSIL. Refer to the documentation for your FOSSIL for information about the number of ports it is capable of supporting. For Unattended Mode, the port number in use is set by the 'Port' statement. In terminal mode, you may change the port in use, dependent on this statement, the number of ports your FOSSIL can support, and the hardware you have available. MaxReq <quantity> This tells BinkleyTerm the maximum number of files that will be sent in response to incoming file requests during any one mail session. Regardless of whether the incoming requests has wildcards, or whether multiple file requests are sent in one mail session, the maximum number of files that will be sent in response to an incoming file request will be no greater than <quantity>. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. MaxTime <number> Specifies the maximum cumulative time allowed for file request sessions in minutes. This verb can be used in combination with the file request size limiters (MaxBytes, KnownMaxBytes, ProtMaxBytes) as well as the file request quantity limiters (MaxReq, KnownMaxReq, ProtMaxReq). MinBaud <baud> This keyword defines the lowest baudrate at which frequesting is allowed. If the caller is at a lower baudrate he'll get the right response-message. Have a look into SAMPLE.TPL for the new 'status 8'! ModemTrans <number> <prefix>/[<suffix>] This statement allows BinkleyTerm to dynamically select the modem prefix and suffix strings based on the modem type field found in a Version 6 or compatible nodelist, or in a NODELIST.EXT file (see the section "Nodelist" in the User's Guide). The <prefix>/[<suffix>] have the same purpose and usage as they do in conjunction with the 'Dial' statement described previously. Refer to 'Dial' above for more information. The value of <number> corresponds to a given modem type. If this type is matched, then the given <prefix>/[<suffix>] values are used. MultiLink This tells BinkleyTerm that the MultiLink multi-tasker is installed, and to release time-slice to the multi-tasker during certain non-processor-intensive operations. This increases system efficiency for MultiLink-using systems. MyListFlags <list_flags> Your nodelist-flags (EMSI) MyLocation <location> Location of your system (EMSI) MyMaxBaud <maxbaud> The max. baudrate supported by your modem (300-9600) MyPhone <phone> Your phonenumber (data) (EMSI) NetFile <path> This specifies the complete drive and path of the directory that will hold files being sent to your system via FidoNet. Incoming mail is stored here prior to processing. This path is also used by BTCTL to create a MAIL.SYS file. If secured inbound areas are being used (see 'ProtInbound' and 'KnownInbound' in this Reference Guide, or the section "Security - Secured Inbound File Areas" in the User's Guide), then this statement designated the inbound file path for mail received from systems not in the nodelist and not password protected. NetMail <path> This specifies the complete drive and path of the directory that contains a Fido compatible message base. This Path is used for the "Unread Netmail Pending" display. NiceOutbound <sorted> NiceOutbound switches on the nice outbound. If you use "NiceOutbound S", it will be sorted in zone/net/node/point order. The "Flags" field. It carries the information spread about half the window in the standard version. Depending on the files in the outbound directory the characters C/H/D/N and/or R are displayed (for crash, hold, direct, normal and requests). The old "S" field (status) has been removed. Instead, a human readable text is displayed if an error occurs: Unknwn for nodes that have no entry in the nodelist NoConn when the maximum values in BINKLEY.EVT ("T=n,m") are exceeded. Tried If a session took place, but some mail or requests for the node still remains. The "Files" field displays how many files are pending for the node. All *.?UT, *.?EQ, *.?LO and all files in flow-file(s) are counted. The "Age" field displays how old the oldest of all the files to be sent is. Nice for people with points not picking up their mail regularily. The date of the files inside of the *.?LOs flow-files are not considered, because you can send very old files from your system via file-attach. ┌ Pending Outbound Mail ─────────────────┐ │Node Files Size Age Status│ │1:135/202@fidonet 1 267b 0 C│ <- a crashmail │2:243/1@fidonet 1 7.1k 0 NR│ <- normal mail/req │2:242/29@fidonet 2 127k 1 H-│ <- 2 files since │ │ yesterday on hold └────────────────────────────────────────┘ NoArq <arqstr> You can define here up to five extended connect strings which should'nt passed to the bbs. If none of these strings matches, BT displays "ARQ Connect" in the "Current Settings" window and handles ZModem block sizes more "ARQ-friendly". My setting for a HST-DS: NoArq /None NoArq /V32/None NoCollide By default, BinkleyTerm will make an attempt to detect an incoming call while preparing to make an outgoing call, and abort the outgoing call process. This feature is called "call collision detection," and may not work on all modems. Using 'NoCollide' disables this feature entirely. Nodelist <path> This specifies the complete drive and path where processed, compiled nodelist files can be found. Refer to the User's Guide section "Nodelist" for more information. NoEMSI <user_flag> Set NoEmsi to disable the EMSI handshake. NoEMSI without <user_flag>: - disable EMSI-support for callers and outdials NoEMSI with <user_flag>: - <user_flag> can be "A" trough "F" - If a dialed system has the same user flag set in the nodelist, BT won't use EMSI in this session! NoFullScreen By default, BinkleyTerm uses a full-screen interface when in Unattended Mode. When this statement is used, BinkleyTerm will use the line-by-line screen write mode employed by BinkleyTerm Version 1.10 and earlier. This statement has no effect in Terminal Mode. NoMNPFilter This statement disables the MNP-filter and causes session handshakes to start faster. Us this with new modems which support MNP/V.42b; they suppress mnp/v42 garbage well enough. NoRequests This statement tells BinkleyTerm to universally refuse incoming file requests at all times. NoResync When used, this statement will tell BinkleyTerm not to allow SEAlink Resync (an ability to restart failed SEAlink mail sessions). Used mostly for debugging purposes; not for regular use. NoSEAlink When used, this statement will tell BinkleyTerm not to allow SEAlink mail sessions at all, including SEAlink extensions to base FidoNet protocol (FTS-0007) and WaZOO/DietIFNA sessions. NoSharing Disables file sharing calls in networked environments. NoSize Disables Bink's calculation and display of queued file sizes for the pending outbound window display. If you see a big performance problem associated with this feature, try uncommenting this verb. When in force, the "Q=nnn" schedule flag is also disabled. NoSLO This tells BinkleyTerm NOT to employ SEAlink "Overdrive" (an ACK-less variety of the SEAlink protocol) for any SEAlink network mail transfers. NoWaZOO Forces BinkleyTerm to be strictly an FSC-0001 mailer by disabling WaZOO functionality. This is primarily of interest to coordinators who wish to verify that their nodes are meeting FidoNet compatibility requirements. There is no benefit to the average user from using this statement. In fact, performance with other WaZOO-capable mailers (BinkleyTerm, Opus, D'Bridge, FrontDoor, etc.) will be adversely affected. NoWildCards If you define "NoWildCards", wildcards are not allowed in the filename part of a request. NoZedZap When used, this statement will tell BinkleyTerm not to allow ZedZap (Zmodem) transfers during a WaZOO session. It is primarily intended to force BinkleyTerm to use DietIFNA mode (SEAlink) during WaZOO sessions. Used mostly for debugging purposes; not for regular use. NoZones Tells BinkleyTerm to handle zones in the same manner as version 1.50 and previous versions. This essentially means that multi-zone support is turned off. Refer to the User's Guide section "Zone Support" for additional information. Okfile <filespec> This designates the name of the OKFILE, a special file used with incoming file requests. <filespec> is a complete drive, path and filename designation. For more information, refer to the User's Guide sections "File Requests" and "Controlling File Requests." Overwrite When receiving a file in Unattended Mode, or when downloading a file in Terminal Mode, BinkleyTerm by default will NOT allow overwriting of an existing file if you're receiving a file with the same name. Instead, BinkleyTerm will slightly alter the name of the file being received to differentiate it from the existing file. By using the 'Overwrite' statement, BinkleyTerm WILL ALLOW overwriting of existing files should you be receiving one by the same name. Use this option carefully. Packer <command_line> If used, BinkleyTerm will execute <command_line> at the beginning of each event, but after the "Cleanup" statement's command line (if used). This might be used to pack any pending outbound mail for sending. It is suggested that <command_line> designate a batch file that would contain the command line(s) for the program(s) actually used to scan and/or pack mail. See also 'AfterMail' and 'Cleanup' for related information. PickUpAll When connected via EMSI, pickup mail for ALL akas. If not specified, you'll only get mail for your primary aka (beware of BT's automatic aka-matching!). PktRsp PktRsp tells BT to send an answer in PKT style instead of a RSP file. PktRsr only works when a FlagDir is defined, because it creates the PKTs in this directory. The PKTs will be deleted at beginning of the next session. They are coded with the task number, so that no crashes will occur! Point <net>/<node> NOTE: This statement is supported for backward compatibility only. To specify a system address, use the 'Address' statement described previously. This parameter specifies a FidoNet node address. For regular FidoNet nodes, this is your assigned node address. For Point systems, this address is the one assigned to you by your Boss node Sysop. PollTries <number> This controls how many call attempts BinkleyTerm will make under the following circumstances: - Alt-D keypress in Terminal Mode - Alt-M keypress in Terminal or Unattended Mode - BT POLL command line invocation of BinkleyTerm BinkleyTerm will make <number> attempts, then stop. Port <port_number> This informs BinkleyTerm which communications port your modem is connected to or configured as. The <port_number> corresponds to the COM port number, 1 for COM1, 2 for COM2, etc. Most FOSSIL drivers support up to 2 COM ports, COM1 and COM2, some support more. Refer to your FOSSIL documentation for information on port support and installation information. Note that in Terminal Mode, it is possible to override this setting. PreDial <modem_string> The <modem_string> designates a string, which will have standard modem translations performed upon it, that is to be sent to the modem BEFORE the dial string (designated by the 'Prefix' statement) is sent. BinkleyTerm has a default 'PreDial' string of: v``^````` Some modems give responses when DTR is lowered, and others require an extended period of time to resync. By using 'PreDial,' you can override the default to provide an outward dialing situation better suited to your modem. In testing, a single backquote (`) has been used with the USR HST high speed modem to provide extremely fast outward dialing responsiveness. Prefix <modem_string> The <modem_string> is a modem command to cause the modem to dial. To dial a system, BinkleyTerm sends the <modem_string>, followed by the telephone number, to the modem. Normally, for touch-tone systems, "ATDT," is used, for rotary-dial lines, "ATDP," would be used. Refer to your modem manual for more information on control options. PreInit <modem_string> The <modem_string> designates a string, which will have standard modem translations performed upon it, that is to be sent to the modem BEFORE the modem initialization string (designated by the 'Init' statement) is sent. BinkleyTerm has a default 'PreInit' string of: |v~^````` |````` The default string is optimized to be suitable for a wide variety of modems. However, many modems may be able to work with a shorter string, which would yield faster modem initialization sequences. In testing, this 'PreInit' string has proven effective: |v``^`` Using this string, the initialization sequence is very fast. Note that 1/2 second is still added at the end of the 'PreInit' string for timing purposes, and therefore, 1/2 second is the fastest initialization that could be realized by using your own 'PreInit' setting. PrivateNet <fakenet> This tells BinkleyTerm the net number of a private network for which you serve as a gateway, if any. This statement is also used on Point systems to designate their private net number. If this line is commented out, BinkleyTerm 2.50 offers full 5-D addressing for points. For example, if you are point 5 off my system, your address would be "1:106/2000.5@fidonet.org", expressed in 5-D notation. In other words, the five dimensions are: "zone:net/node.point@domain". ProtAbout <filespec> This tells BinkleyTerm the name of the ABOUT file, a special file used with incoming file requests. The <filespec> is a complete drive, path and filename designation. This ABOUT file applies only to file requests that are received from "protected" systems. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. ProtAvail <filespec> This designates the name of the file to be sent to a "protected" remote system which file requests "FILES" from you. The <filespec> identifies the file, and may contain an optional drive and path designation. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. ProtInbound <path> Used with secured inbound areas, this statement designates the path to the inbound file area used for mail received from "protected" systems. Refer to the User's Guide section "Security - Secured Inbound File Area" for more information. ProtMaxBytes See 'MaxBytes' for information. ProtMaxTime <number> See MaxTime. ProtMinBaud <baud> See MinBaud. Protocol <filespec> This tells BinkleyTerm that it can use the listed external file transfer protocol within Terminal Mode. The <filespec> is a complete drive, path and filename that points to an Opus- CBCS compatible external file transfer protocol program. Refer to the User's Guide section "External Protocols" for more information. Note that the first letter of <filespec> will be the letter used to access the protocol from the upload and download menus in Terminal Mode. Because the first letter of the filename may conflict with another external protocol, or with a hard- coded protocol, you may need to rename the executable file for the external protocol to begin with a letter that is not currently in use. Note also that external protocols are available in Terminal Mode ONLY - they cannot be used for mail session in Unattended Mode! ProtReqLim <quantity> This tells BinkleyTerm the maximum number of files that will be sent in response to incoming file requests during any one mail session. Regardless of whether the incoming requests has wildcards, or whether multiple file requests are sent in one mail session, the maximum number of files that will be sent in response to an incoming file request will be no greater than <quantity>. This statement applies only to file requests that are received from "protected" systems. Refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests" for more information. ProtReqList <filespec> This designates the name of the OKFILE, a special used with incoming file requests. <filespec> is a complete drive, path and filename designation. This OKFILE applies only to file requests received from "protected" systems. For more information, refer to the User's Guide sections "File Requests" and "Security - Controlling File Requests." ProtReqTpl <filespec> This designates the name of the response file template used for request response file construction. The <filespec> is a complete drive, path and filename designation. This template applies only for response files generated for "protected" systems. For more information, refer to the User's Guide sections "Request Response Files" and "Security - Response File Templates." ProtSec <n> See MaxAreas Reader <command_line> Using the Alt-E command in Unattended Mode causes BinkleyTerm to send <command_line> to COMMAND.COM for execution as a child process. This is typically used to invoke your local console message base reader/editor. ReadHoldTime <minutes> This statement causes Binkley to read the hold directory every <minutes> minutes. Standard is 10 minutes. , independently from the state of "Pending Outbound Mail". ReinitTime <minutes> If you configure "ReInitTime 40", your modem will be initialized every 40 minutes. Note that this is the same time binkley waits until blanking the screen, if you enabled screenblank. ReqOnUs When this statement is used, incoming file requests will be filled, even if your system initiated the call. Otherwise, incoming requests "on your dime" will be refused. ReqTemplate <filespec> This designates the name of the response file template used for request response file construction. The <filespec> is a complete drive, path and filename designation. For more information, refer to the User's Guide sections "Request Response Files" and "Security - Response File Templates." RingTries <number> Limits the <number> of unanswered rings Bink detects before it hangs up on an outbound call. Your modem must be able to identify and report "RINGING" for this feature to work. Bink defaults to 4 where this parameter is not otherwise set. (Thanks to Henry Clark and Ron Bemis for this idea). SameRing By default, and unless the 'NoCollide' option is used, BinkleyTerm will attempt to abort its dialing process if an incoming call is detected. This feature is called "call collision detection." 'SameRing' is used when your modem reports "RING" on BOTH incoming and outgoing calls (most modems reports "RING" on incoming and "RINGING" on outgoing), and partially disables this feature. ScreenBlank [<method>] If 'ScreenBlank' is used, and 10 minutes pass without any activity (incoming call, outgoing call), then the screen will be blanked. The <method> parameter may be "Key" or "Call" and tells BinkleyTerm which method to use to "unblank" the display. "Key" tells it to unblank upon a keypress (and is the default); "Call" tells it to unblank when a call comes in or is placed. 'ScreenBlank' works only if a Video FOSSIL (VFOSSIL) is installed. ScriptPath <path> If given, this statement tells BinkleyTerm where to look for outward dialing scripts (refer to the section "Scripts" for more information). <path> is a standard DOS path line, with optional drive designation. Serial <number> Bink now defaults to "UNREGISTERED" operation. To disable it now and forever, uncomment the verb "Serial" followed by a <number> of your choice. Vince intends to ALWAYS run the UNREGISTERED version -- proudly. Shell <number> <command_line> This allows you configure up to 9 keystroke accessible DOS shells to run programs while BinkleyTerm stays memory resident. Shells work only in Unattended Mode. While in Terminal Mode, the same keystrokes work as macros keys (see the 'Macro' statement description for information). The <number> parameter is a digit between 1 and 9, which corresponds to the F1 through F9 keys. While in Unattended Mode, you invoke a shell by pressing Alt-Fx, x indicating the shell number you wish to invoke. The <command_line> is sent to COMMAND.COM verbatim for execution. If the program you're invoking uses command line parameters, include them in <command_line> as you would at the DOS prompt. SlowModem Using 'SlowModem' causes BinkleyTerm to insert a 1/10th second delay between each character sent to the modem while in command mode. This is for use with modems that may have a hard time keeping up with BinkleyTerm's modem commands otherwise. SmallWindow During mail transfers that use the SEAlink protocol, BinkleyTerm uses a default run ahead, in blocks, of the baud rate divided by 400. Using this statement tells BinkleyTerm to run ahead no more than 6 blocks. This option is used primarily with high speed modems. StartBlkLen <number> Allows adjustment of the starting Zmodem session block size from a value of 64 bytes to 1024 bytes. Communications on noisy lines often benefit from use of a smaller initial block size. If this verb is commented out, behavior is identical to 2.40. Statuslog <filespec> This tells BinkleyTerm where to log information about its operation and mail sessions. This log is completely compatible with the log file used by Opus-CBCS. The <filespec> is a complete drive, path and filename designation. Various information is placed in the log. See also the configuration file statement 'LogLevel.' SuckerLimit <user_flag> <minutes> Mark all file suckers in the nodelist with one of the unused user flag bits. After <minutes> minutes of file requests by the sucker, the session will be ended. Suffix <modem_string> BinkleyTerm will send the 'Prefix' string, followed by the phone number, followed by a carriage return to the modem for the purpose of dialing a number. If for some reason you need to put characters immediately after the phone number BUT PRIOR TO THE RETURN CODE use the 'Suffix' field. NOTE: Unlike some communications packages such as Telix, normally you DO NOT need a 'Suffix' with BinkleyTerm. Use the 'Suffix' field ONLY for adding characters to the end of the phone number, if needed. SwapDir <path_name> By using this statement, BinkleyTerm will enable "memory swapping." The <path_name> designated will be used by BinkleyTerm for storage of its swapfile when spawning subtasks, such as jumping to DOS, invoking a packer, and so on. BinkleyTerm will swap itself out of memory except for about 5k to 8k of code. If <path_name> points to a RAM disk (you will need about 150k of space available), BinkleyTerm exits and reloads very quickly. The <path_name> parameter may designated a directory path, or a combination of drive designator and directory path. Sysop <sysop_name> The WaZOO method of mail transfer (originally designed by Wynn Wagner for Opus-CBCS, and supported by BinkleyTerm) sends a variety of information during session negotiation. Among the information is the Sysop name, normally your name. This information is not passed during FTS-0001 mail session, and has no effect in Terminal Mode. System <system_name> The WaZOO method of mail transfer sends a variety of information during session negotiation. Among the information is the system name, normally whatever name you have given to your BBS or Point system. This information is not passed during FTS-0001 mail sessions, and has no effect in Terminal Mode. TaskNumber <number> This statement performs two functions for persons operating in multi-processing or multi-line environments (through a LAN or multi-tasker). First, it designates a task number for the BinkleyTerm that uses the configuration file that this statement appears inside of. The <number> parameter must be greater than zero (0). Second, it tells BinkleyTerm to operate in "multi-processor smart mode." If BinkleyTerm is transacting with a particular system, it will create a "xxxxyyyy.BSY" file for that node, named in the conventional packet form (xxxx = net number in hex, yyyy = node number in hex). This file can serve as a flag to other BinkleyTerm tasks, or to compatible mail processing packages so that other tasks or processors will not handle any mail for the particular node until the ".BSY" file is gone. Additionally, BinkleyTerm will not send files to any node for which there is a ".BSY" file. TaskView This statement tells BinkleyTerm that the TaskView multi- tasker is installed, and to give up processor time-slice when the system is idle and while certain functions are being performed. This increases system efficiency. TermInit <modem_string> Identical in structure to the 'Init' statement, this statement provides a modem initialization string that BinkleyTerm will use in Terminal Mode. The string will be sent to the modem if BinkleyTerm is initialized in Terminal Mode, or when switched to Terminal Mode from Unattended Mode. The string will also be sent when an Alt-I command is issued in Terminal Mode. NOTE: The 'PreInit' statement, if designated, will NOT be used in conjunction with this initialization string. Timeout <seconds> This sets the number of seconds that BinkleyTerm will wait for a caller to press Escape or for a mail session to begin before assuming that the incoming call is human. The default value is 20 seconds. Note that <seconds> cannot be set lower than 20. TopView This statement tells BinkleyTerm that the TopView multi-tasker is installed, and to give up processor time-slice when the system is idle and while certain functions are being performed. This increases system efficiency. Unattended By default, BinkleyTerm is in Terminal Mode when invoked. When this statement is used, BinkleyTerm will be in Unattended Mode when invoked from DOS. This option should be used on systems where BinkleyTerm's primary purpose is as a FidoNet mail interface. Version6 This statement tells BinkleyTerm that it is to use a "New Opus Style" Version 6 nodelist. The files NODELIST.IDX and NODELIST.DAT will be expected, and must be compiled and ready for use by BinkleyTerm. Refer to the User's Guide section "Nodelist" for more information. Version7 Enables support for the new Version 7 compiled nodelist format developed by Doug Boone for Opus 1.70. This format offers a 40% savings in file size compared to Version 6. XlaxNode 2.52, QNode and FastLst can be used to generate Version 7 nodelist files. Refer to the User's Guide section "Nodelist" for more information. The "sysop name lookup" feature with Version7 uses the "SYSOP.NDX" file, not the Version6 "FIDOUSER.LST" file. Be sure to use Version7 compiler keywords "Userlist" or "Interlist" if you want this feature supported. WinSlice Uses Windows' timeslice rather than the MSDOS (int 28) timeslice. Use of a Windows-specific FOSSIL is required to prevent loss of characters, however. Zone <zone_number> NOTE: This statement is supported for backward compatibility only. Please use the 'Address' statement discussed previously to designate a zone. This is part of the FidoNet node address for your BinkleyTerm system, and refers to the part of the globe you live in. Current FidoNet zones are 1 for the Americas, 2 for Europe, 3 for the South Pacific and 4 for South America. SCHEDULING EVENTS As mentioned elsewhere in this manual, one of the driving forces behind BinkleyTerm mail handling is cost. Rigid scheduling, although taking a back seat, still retains some importance. In order for BinkleyTerm to know when it's time to send mail that requires a toll call, and in order for it to know when it can send to systems that do not accept Continuous Mail, event schedules are used. Several other features are controlled by events as well. Although events may be placed in the configuration file, they should be contained in a special file named BINKLEY.EVT. In this way, small changes to the configuration file will not cause BinkleyTerm to re-run the current event; this will only happen if the BINKLEY.EVT file is edited. By storing event schedules in a flat text file, events can be easily edited at any time with a standard ASCII text editor. No special utilities are required. Note that each time an edit is made to BINKLEY.EVT (or to the configuration file if events are listed there), BinkleyTerm will re-build its binary schedule file, which will in turn cause BinkleyTerm to re-run the current event when the system is brought on-line. This is normal operation, and is necessary to allow BinkleyTerm to properly register the schedule changes. Each event is on a separate line in the BINKLEY.EVT or configuration file. Here is a sample of such a line: Event All 03:00 04:00 L=10 N B E1=10 E2=20 E3=30 The syntax for the entries is: Event <day> <start> [<stop>] [<string>] <flags/options> <day> This tells BinkleyTerm which days this event line applies to. Options are: All . . . . Every day of the week Week . . . Weekdays, Monday through Friday only WkEnd . . . Weekends, Saturday and Sunday only Sun . . . . Sunday only Mon . . . . Monday only Tue . . . . Tuesday only Wed . . . . Wednesday only Thu . . . . Thursday only Fri . . . . Friday only Sat . . . . Saturday only The parameters can be linked with the pipe character (|) to indicate more than one option. For example, "Mon|Wed|Fri" would that the event applies to Monday, Wednesday and Friday only. No spaces may be used between the parameters. The <day> parameter is REQUIRED. <start> This tells BinkleyTerm what time to start the event, in 24 hour "military" time, in the format hh:mm, where hh is the hour and mm is the minute. Note that <start> must NOT be greater than <stop>, i.e., events may NOT stretch through the midnight hour. The <start> parameter is REQUIRED. The <start> parameter may optionally take date information as well. Allowable additional information is the month in numeric form (1 for January, 2 for February and so on, ending with 12 for December) and a day of the month. This additional information is used IN ADDITION to the <day> parameter previously described. A field that includes date information would be in the format: hh:mm,month,day Where hh is the hour, mm is the minute, month is the numeric month, and day is the day of the month. You may also leave out the day parameter, like this: hh:mm,month If you wish to leave out a month parameter, simply place a zero into that field, indicating that the event is to take place on all months, like this: hh:mm,0,day Using the date options with the <start> parameter offers significant scheduling power. For example, if you wanted something to occur on the second Friday of each month, you can do so without a lot of manipulation by creating seven events with the same errorlevel, each corresponding the possible date values for the second Friday of each month, like this: Fri 23:00,0,8 23:00 F E1=131 Fri 23:00,0,9 23:00 F E1=131 Fri 23:00,0,10 23:00 F E1=131 Fri 23:00,0,11 23:00 F E1=131 Fri 23:00,0,12 23:00 F E1=131 Fri 23:00,0,13 23:00 F E1=131 Fri 23:00,0,14 23:00 F E1=131 In any given month, the event required on the second Friday of the month would cause an errorlevel 131 exit (which has been previously associated in your batch file with the function you wish to occur). In you wanted something to happen every leap year, you could create an event like this: All 23:15,2,29 23:15 F E1=132 Which would cause an errorlevel 132 exit on February 29. Note that if you want a specific exit on a specific date regardless of the day-of-the-week, you should use "All" for the <day> parameter for that event. You can specify negative 'errorlevels' between -1 and -9 that correspond to the ALT-F1 through ALT-F9 keys you can define with "Shell <n> <command>" in your configuration file. [<stop>] This tells BinkleyTerm what time to stop the event. This parameter is OPTIONAL, and defaults to 60 minutes after the start time should the parameter be omitted. This is given in the same format the <start> parameter, as military time, hh:mm where hh is the hour and mm is the minute. [<string>] This parameter is OPTIONAL. If used, <string> designates a string of characters to be added to the command line of the configuration file parameters 'Packer,' 'AfterMail' and 'CleanUp.' The string should be enclosed in quotation marks. For example: Event All 00:00 01:00 "-sA -c" The <string> is appended to the command lines given for these options in the configuration file, and should be ignored by those that do not need it. It is suggested that batch files be used with the above mentioned configuration file options, and that the batch file(s) filter out unneeded information given in <string> before calling a program that might "cough" because the command line is wrong. Up to 32 extra characters can be added with the <string> parameter. <flags/options> This set of parameters tells BinkleyTerm about the event. The various flags and options should be separated by a space. C The 'C' flag tells BinkleyTerm that during this event, only mail marked as Continuous Mail will cause a call to be made. L= The 'L=' flag is the 'less than or equal to cost' flag. For example, 'L=10' would mean that during this event, only mail with a cost EQUAL TO OR LESS THAN 10 cents will be sent (as designated by the nodelist cost field for a particular entry. Using 'L' alone, without a cost, means that a value of '0' is used, and only mail with no cost may be sent. This is also called the 'local only' flag when used with no cost parameter, since local calls in most areas are free. L< The 'L<' flag works just like the 'L=' flag, except that it means 'less than cost.' For example, 'L<10' would indicate that during the designated event, only mail with a cost field of LESS THAN 10 cents will be sent. L> The 'L>' flag works just like the 'L=' flag, except that it means 'greater than cost.' For example, 'L>10' would indicate that during the designated event, only mail with a cost field of GREATER THAN 10 cents will be sent. M NOTE! This flag should ONLY be used when the 'NewNodelist,' 'QuickNodelist' or 'TBBSList' configuration file options are used! The 'M' flag indicates that the event is a 'mail' event, and that it is okay to send mail to anyone in the nodelist, regardless of their #CM designation. This flag is normally used during local mail schedules, and during National Mail Hour. N This flag tells BinkleyTerm not to accept inbound file requests during this event. R This flag tells BinkleyTerm that the event is 'Receive Only.' BinkleyTerm will not dial out to send mail, however, it will send mail if polled for it. B This flag tells BinkleyTerm that BBS operation is allowed during this event. If this flag is NOT present, callers will be greeted with the message "Processing mail...please hang up." Use this option at all times (if you run a BBS) except during mail schedules, such as National Mail Hour. F This flag tells BinkleyTerm that the event should be 'forced' and will occur at the first possible moment. USUALLY YOU DO NOT NEED TO USE THIS FLAG. BinkleyTerm will execute the current event anyway if for some reason the start time is bypassed (but before the stop time passes). If you do use this option, use it only on zero- length events; those events for which the <start_time> and <stop_time> are the same. D This flag tells BinkleyTerm that the event is dynamic. Dynamic events continue until there is no longer any mail of the specified type to be sent. For example, if the dynamic event specifies that local Continuous Mail is to be sent, the event will continue until there is no more local Continuous Mail to be sent, or until the event ends, whichever happens first. When the dynamic event ends, the non-dynamic event scheduled for the same time slot will take over. If no such event exits, the system will accept mail, but will dial out to no one. Note that dynamic events must be started before or at the same time as non-dynamic events, if the dynamic event is to overlap a non-dynamic one. E1= The 'E1=' option tells BinkleyTerm what errorlevel to exit with at the beginning of the event. 'E1=10' would tell BinkleyTerm to exit to its start-up batch file with errorlevel 10 when the event begins. This is a good method of executing functions once daily, for example, message base maintenance software, and so on. Once the E1= exit has been made, it will not occur again until the next time the event is scheduled. Negative errorlevels correspond to the shells defined with "Shell" in BINKLEY.CFG. E2= The 'E2=' option tells BinkleyTerm what errorlevel to exit with after mail is received. The E2= exit is only executed if the incoming mail does not meet the criteria for an E3= exit, or if an E3= exit does not exist. Using your batch file, the errorlevel set for the E2= option should invoke mail unpacking software to merge the incoming mail with your message base. E3= The 'E3=' option tells BinkleyTerm what errorlevel to exit with after compressed mail is received. If mail is received during the event, and compressed mail is not a part of the mail received, then an E2= exit is performed. If compressed mail was received (even in conjunction with other mail or files) then the E3= exit is performed. Using your batch file, the errorlevel you set for this option should invoke mail unpacking software that can handle compressed mail and merge it with your message base. E4= Event exits E4-E9 can be followed by a three character v string. If that string is matched in the file extension of E9= a received file, then the designated errorlevel exit will be taken. For example: E4=100,TIC (Received .TIC Files Cause Exit 100) E5=100,FLE (Received .FLE Files Cause Exit 100) E6=110,REQ (Received .REQ Files Cause Exit 110) E7=120,MO? (Received .MO? Files Cause Exit 120) The order of exit precedence is as follows: E3, E4-E9, E2, AfterMail When more than one E4-E9 exit applies, the first one is the one taken. A= This allows you to control the amount of time that BinkleyTerm will sit idle between attempting an outgoing call. The format is "A=x" where x is the number of seconds desired, which can be a number between 0 and 1800 (1800 seconds = 30 minutes). The average wait between calls is based on +/- 50% of the number specified, i.e., A=60 would yield a wait time in the range of 30 to 90 seconds, 60 being the average. Should the A= parameter not be used, the default value is 120, for an average wait time of between 60 and 180 seconds. K This option tells BinkleyTerm not to send to any nodes marked in the nodelist as #CM (accepts Continuous Mail). Note that this option is only valid when an Opus Version 6, QuickBBS or TBBS nodelist is in use. T= This option allows you to control the maximum number of call attempts and failed connects that will be acceptable to BinkleyTerm. The T= option accepts two parameters, and is used in the format "T=x,y" where x is the maximum number of failed connects (carrier established, session fails - a chargeable call in toll situations), and y is the maximum number of call attempts (no answer, no session - generally NOT a chargeable call in toll situations). Generally, the x parameter should be very low, so as not to rack up charges on your phone bill should the call be long distance or another toll call. The y parameter is generally set rather high, since these calls are usually not charged for. The default x parameter is 3, the default y parameter has not been explicitly specified, but is quite high. X By default, BinkleyTerm will treat outgoing file requests (.REQ files) in the same manner as Normal packets and attaches. This would include forcing a dial attempt during events that would allow Normal mail to be sent. Sometimes this is undesirable operation, such as during National Mail Hour when destination systems typically do not accept file requests. Using the 'X' flag for an event tells BinkleyTerm not to force a call for a file request. Please note that other types of mail, such as packets and attaches, may cause BinkleyTerm to dial a system for which an outbound file request is pending. S "S" designates an event which is "send only" meaning that BinkleyTerm will continue to send normally, but will not answer the phone (or if the modem is in auto-answer mode, BinkleyTerm will not respond). H "High-Priority Crash" - Binkley will send Crash flavored mail IMMEDIATELY, no matter what the cost. All other mail flavors are sent according to cost or other constraints imposed by the current event. This behavior mirrors that of Crashmail under Opus 1.1x+ with one exception - Crashmail call(s) are made at normal intervals during an H event, rather than forcing a repetitive poll as with Alt-M. Q= Q=nnn nhibits Bink from calling out with less than nnn bytes of data for a node (?LO + ?UT sizes). You should probably have at least one event with Q=0 (the default if none is specified) in order to get the mail out. (Henry Clark gets credit for this idea) P This flag tells BinkleyTerm that during mail sessions, it should only deliver mail, and refuse to pickup any mail that may be waiting for your system. Many of the above options can be used with one another, and in fact usually are. Constructing a working event schedule can be a time consuming process requiring a certain amount of trial and error. Since the event schedule plays a very important roll on when mail will be sent, it should be manipulated VERY carefully to avoid having BinkleyTerm make toll calls during high rate periods. A sample event schedule is shown in BINKLEY.EVT, contained in the distribution package. Print out the file if desired, but in any case, study it carefully and make sure you understand the various options before going ahead. +-------------+ | +---------+ | | | Section | | BinkleyTerm Reference Guide | | 3 | | GENERAL REFERENCE INFORMATION | +---------+ | +-------------+ COMMAND LINE PARAMETERS BinkleyTerm offers a selection of command line parameters which each have a unique function. The words that are descibed below are simply placed on the DOS command line - no hyphens or slashes are necessary. For example: BT NoForce Unattended Share Config C:\BT\SYS1.CFG Here is a list of the command line parameter options: NoForce Don't force events that have already passed. Mail For Point system use, this causes BinkleyTerm to attempt connection to the boss upon start-up. Share Leaves the FOSSIL driver "hot" (does not de-initialize the driver upon exit) for use with other FOSSIL-based systems. Dynam Restart the current dynamic event, if any, even if it may have already executed. Unattended Run in Unattended Mode, regardless of whether the 'Unattended' configuration file statement is used. Config Allows specification of a configuration file other than the default (BINKLEY.CFG). This parameter must be followed by a single space, and then the name of the configuration file, including drive and path if applicable, for example: "BT Config C:\BT\MYCONFIG.CFG" Poll Instructs BinkleyTerm to immediately poll a given node. Upon completion of the poll, BinkleyTerm will exit. For example: "BT Poll 1:132/101" DIAL TRANSLATION When BinkleyTerm is in modem command mode, several dial translations take place automatically. ASCII Char. Name Action ------ ------- ------------------- ------------------------ 045 - Hyphen Stripped 046 . Period Translated to a Comma 094 ^ Carat Raise DTR Line 096 ` Accent Mark 1/20th Second Delay 118 v Lower Case V Lower DTR Line 124 | Pipe, Split Bar Carriage Return Sent 126 ~ Tilde 1 Second Delay RESPONSE FILE TEMPLATE Response files are explained in the User's Guide section "Request Response Files." Response files are generated according to a template file which designates exactly what is to be placed in the finished response file. Most options perform simple macro substitution; others allow conditional inclusion of text, or instruct BinkleyTerm what to do with the response file. Response files will be generated according to the template under any one of the following cases, called reason codes: 1 - File Not Found 2 - No Update Necessary 3 - Password Missing or Wrong 4 - Request Limit Exceeded 5 - Start of No-Requests-Honored Event 9 - Successful Request By default, when a template is designated in the configuration file, BinkleyTerm will always generate a response file for all of the above reasons. It is possible, however, to control or limit what the response file says based on a particular reason code, or to not have a response file generated at all for a particular reason code. BinkleyTerm uses the template file serially, and copies everything found in the template directly to the response file, performing substitution or conditional copies as directed by template file verbs. When the end of the template is reached the response file is closed and sent to the calling system (unless an %exit verb is used before the end of the file). All the allowed verbs in the template begin with a percent sign (%), a character which should not be used for any other purpose within the file. Allowed verbs are as follows: %; When placed in column 1 (far left), designates a comment line. When in any other column, designates that remainder of line should be ignored. %abort Don't send response file. %abort <number> When <number> matches the reason code, don't send response file. %exit Close the response file and send as-is. %exit <number> When <number> matches the reason code, close the response file and send as-is. %text <number> <text> When %status is given later in the template, <text> is copied into the response file if <number> matches the reason code. The <text> should be no longer than 255 characters in length, and may contain other template verbs such as %system, %date, and so on. %line <number> <text> If <number> matches the reason code, <text> is copied into the response directly. The <text> should not exceed 255 characters in length, and may contain other template file verbs such as %system, %date, and so on. %date Copies the current date into the response file. %time Copies the current time into the response file. %bink Copies the program name and version into the response file. For example: BinkleyTerm 2.30 %mynode Copies your node address into the response file. %system Copies your system name, as given in the BinkleyTerm configuration file, to the response file. %sysop Copies your Sysop name, as given in the BinkleyTerm configuration file, to the response file. %yrnode Copies the node address of the calling system into the response file. %request Copies into the response file the actual line from the incoming request that prompted the creation of the response file. Normally this is the name of the file that caused the response file to be generated. %status Copies text previously defined for the current reason code with the %text verb into the response file. A complete sample template file is included with the BinkleyTerm distribution package. Use the file as a base to design your own unique file. SCRIPTS A script is a series of instructions used when dialing a particular system. They allow the system to "look" for particular information coming across the line, and act according when the desired information is received within a set time limit. Scripts are essentially a mini programming language, and as such, take study and practice to use effectively. Scripts are stored in a flat ASCII text file, and edited using any standard text editor (such as DOS' own EDLIN). Once written, scripts are associated with a particular nodelist entry for use each time the given node is dialed. Possible applications for scripts include accessing packet switch networks, such as GTE/Telenet's PC Pursuit service, that require multiple sets of operations to reach the desired destination. The use of a script is triggered by the appearance of a file name, inside double quotes, in the phone number field of a nodelist entry. For example, instead of seeing 1-303-555-6789 in the nodelist data file, you might see "MYSCRIPT.SCR"303-555-6789. Notice that the name of the script file is IMMEDIATELY (without spaces) followed by the area code and phone number. The field must appear in the format shown, including hyphens. The area code portion of the number can be up to 10 characters long (for use with certain long distance carriers). Script references can also be placed in your configuration file by way of the 'Dial' statement. See "Configuration File" for details. Refer to the documentation for your nodelist processor for information on inserting information into the phone number field of a nodelist entry. The following restrictions apply when using scripts: - Any line beginning with anything other than a letter or a colon (:) is ignored as a comment. - All lines must begin flush left...at the left margin. - All keywords that take arguments must be followed by exactly ONE space between the keyword and the argument. - There should be NO extra characters at the ends of lines. This includes space characters. All characters on a line are significant, including any extra spaces that you may have inadvertently included. - Script commands and script labels are NOT case sensitive. Please note that spaces can cause hard-to-track-down problems. Spaces are significant characters, meaning they are NOT ignored in patterns, etc. Do not use a space unless you intend to, and do not leave any at the ends of lines unless you want them there. Here are the script statements available to you: :<label> The colon (:) starts a label. Labels can be up to 20 characters long. Control can be passed to the location in the script identified by a label using the 'If' and 'Goto' script statements. Up to 50 labels per script are allowed. Abort [<start_time> <stop_time>] Allows conditional aborting of script execution based on time of day. If used without arguments, it causes unconditional aborting of execution. If arguments are used, script execution will abort if the current time is between the hours given with <start_time> and <stop_time>. For example, "Abort 8:00 22:00" would make the script abort between the hours of 8:00am and 10:00pm. The hours CAN wrap through midnight, "Abort 22:00 3:00" would be an example of this. Areacode Transmits the areacode portion of the phone number to the modem, as shown in the given nodelist entry. Baud [<baud_rate>] This statement sets the baud rate for the call to the value given. If no <baud_rate> is given, the baud rate as listed in the nodelist for this node is used. Break [<duration>] This causes a "break" signal to be sent, as needed with some types of host systems. <duration> designates the number of hundredths of a second for the break signal to last. If the <duration> parameter is not given, the default duration value of 100 (1 second) will be used. Carrier Continue the script if there is carrier, abort if there is not. Comm <settings> Allows setting of the communications parameters. <settings> is a three-character string, consisting of the number of data bits, parity and number of stop bits. For example, a <settings> string of "8N1" would cause the parameters to be set to 8 data bits, No parity, and 1 stop bit. "7E1" would cause 7 data bits, Even parity, and 1 stop bit. "7O2" would cause 7 data bits, Odd parity, and 2 stop bits. Possible values are 7 or 8 for data bits, E (even), O (odd) or N (none) for the parity, and 1 or 2 for stop bits. NOTE! The string is NOT checked for accuracy. The user is responsible for making sure that it is correct! Dial Dial the entire telephone number, and wait for a valid response. Continue if there is carrier, abort if there is not. DOS <command_line> Causes the <command_line> to be sent to DOS for execution. Upon completion, script execution continues. Sufficient memory must exist for any application executed by this command. Goto <label> This statement causes the script processor to jump to the location in the script pointed to by <label>. A colon (:) must have previously been used in the script to identify the <label>. If the label does not exist, the script aborts. If <pattern_number> <label> If a match for <pattern_number> was found at the last 'Wait' statement, transfer control to the point in the script identified by <label>. If a match was not found, control continues to the next statement in the script. 'If' can be used at any time prior to the next 'Wait' statement. NoWaZOO Forces BinkleyTerm to be strictly an FSC-0001 mailer by disabling WaZOO functionality for the current outgoing session only. This is primarily of interest to coordinators who wish to verify that their nodes are meeting FidoNet compatibility requirements. There is no benefit to the average user from using this statement. In fact, performance with other WaZOO-capable mailers (BinkleyTerm, Opus, D'Bridge, FrontDoor, etc.) will be adversely affected. NoEMSI Forces BinkleyTerm not to use the EMSI handshake. Pattern <pattern_number> <string> This statement establishes a pattern for the script handler to look for during the next 'Wait' statement. <string> IS case sensitive. The script handler will look an EXACT match for the series of characters in <string> during the next 'Wait' statement. Up to 8 patterns can be used, and they can be reused or reset at will. Up to 20 characters can be used in a pattern. The purpose is to wait for a given string from the host, or a particular modem response string, and to act accordingly. Phone Transmits the local portion of the phone number to the modem, as shown in the given nodelist entry. Hyphens are stripped automatically. Rawxmit <string> This works in the same manner as the 'Xmit' statement, except that dial translation is NOT performed. Session This should be used at the end of a script which has been successful. It tells BinkleyTerm to begin a NetMail session with the remote system. Speed Causes BinkleyTerm to send the baud rate divided by 100 as a string. The baud rate used it the rate specified for the node in the nodelist, or the rate specified by a prior call to the 'Baud' statement. For example, if the current connect rate was 2400 baud, the string "24" would be sent when this statement is encountered. Timer <seconds> Sets a master countdown timer to <seconds>. If the timer expires, the script will abort. This allows you to set timeouts on any portion of, or the entire script. You may reset the timer by using another 'Timer' statement. Wait [<seconds>] [<label>] Wait for a maximum of <seconds> for one of the previously set patterns to be matched. If a pattern is matched, the script continues, otherwise it aborts. If <label> is provided, the script will resume operation at the label specified upon timeout. Note that the default value is 40 seconds. Both <seconds> and <label> are optional. A <label> may be specified without specifying <seconds>. For example: Wait 40 foo is the same as: Wait foo Xmit <string> Transmits <string> to the modem. Normal BinkleyTerm translations are valid (refer to the section "Dial Translation" for information). In addition to the statements above, the following logical variables are also available: BPSxxxx Allows branching or actions based on baud rate. For example, the statement IF BPS2400 DO2400 would cause script execution to jump to the previously defined label "DO2400" is the current connection was at 2400 bps (baud). Other examples might be "BPS9600" for 9600 bps connections, "BPS1200" for a 1200 bps connection, etc. TERMINAL MODE KEYSTROKES While in Terminal Mode, several keystrokes are available that allow uploading and downloading of files, changing of communications parameters, and so on. Alt-F1 through Alt-F9 These keystrokes allow you to send user-defined macros. Please refer to the section "Configuration File" for information on Terminal Mode macros. Alt-F10 This provides a brief help screen, listing the key-presses available to you in Terminal Mode. Alt-B This allows you to step the baud rate up to the next higher value. BinkleyTerm supports baud rates of 300, 1200, 2400, 4800, 9600, 19,200 and 38,400. 38,400 baud wraps to 300 baud. Alt-C This allows you to set various communications parameters, including number of data bits, parity, and number of stop bits. You are prompted for the information. Note that when 8 bits are set, BinkleyTerm defaults to no parity, and you are not prompted for the setting. Alt-D Allows you to dial out. When prompted, you may enter one of three items: a telephone number, a FidoNet node address in the form [<zone>:]<net>/<node>, or a FidoNet Sysop name. Entering a FidoNet address requires the presence of a compiled nodelist, properly referenced in the BinkleyTerm configuration file. Entering a Sysop name requires that your nodelist processing software, e.g., ParseLst, has created a compatible list named FIDOUSER.LST. Refer to your nodelist processing software documentation for more information about creating FIDOUSER.LST. Alt-E Erases the display screen. Alt-H Hang-up. This command toggles the modem's DTR (data terminal ready) line, thereby disconnecting any call in progress. The modem init string is sent to the modem after DTR is toggled. Alt-I Re-initializes the modem. Alt-J Jump to DOS. Invokes COMMAND.COM to allow for "quick and dirty" DOS commands on the fly. Enter "EXIT" at the DOS prompt to return to BinkleyTerm. BinkleyTerm will automatically return to the directory it was run from when returning from DOS. Alt-L Toggle session logging on and off. The session logging function allows you to designate a file or printer, and have the entire terminal mode session echoed to the selected file or device. When first invoked, this command will prompt you for a file name. Type in the desired name of the log file, including drive and path designation if desired. You may also enter a printer device name, e.g., PRN, LPT1, LPT2, etc. for printer echoing. Invoke the command again to end logging to the file or device. Alt-M Poll a node in the nodelist, by node address. This command requires that mail handling be implemented as described in the User's Guide section, "Unattended Mode Overview". You are prompted for a FidoNet node address. Once entered, BinkleyTerm will dial the system (if its exists in the nodelist) and attempt to exchange mail with the system. If there is outgoing mail to the system, or if mail is waiting for you on the remote system, it will be sent during the mail session. Alt-P This command allows you to change the communications port in use. Invoking the command shifts the port number to the next higher port. The number of ports supported is determined by your hardware, and by the 'Maxport' statement in the configuration file. Alt-R This allows you to dial out with a "scan list." Empty elements are designated by 'Null.' Using the function keys (or equivalently numbered numeric keys) you can select the scan list element you wish to enter. Enter a telephone number, node address or Sysop name, just as you would with the Alt-D command. Press 'Enter' to "store" your entry for that element. When you have stored all the desired elements, press 'Enter' to begin the dialing process. Each number will be dialed in sequence, until a connection is made. After the session is completed, a 'Null' will be stored for that element. Invoke Alt-R again, and press 'Enter' to dial the remaining elements. Press 'Escape' at any time to abort the dialing process. Note that unless saved, the dialing list is volatile. Once you exit the Terminal Mode, your dialing list will be erased. It is possible to save to and retrieve from the disk media up to 10 separate lists of entries. To save a list, press Shift- Fn, where 'n' is the number of the list to save. For example, Shift-F3 would save the current list of 10 entries to list number 3. To retrieve a previously saved list, press Alt-Fn, where 'n' is the number of the list to retrieve. For example, Alt-F5 would retrieve the 10 entries previous saved as list number 5. Alt-S Invoking this command sends a "break" signal via the modem to the remote host. This command requires that a FOSSIL of revision 5 or later be installed. Alt-U This command is used in Point and BBS installations to shift to Unattended Mode. BinkleyTerm is put into the mailer mode, ready to accept calls from remote systems. In order to operate, the mailer functions must be implemented as described in the User's Guide section, "Unattended Mode Overview". Alt-X Allows you to exit the program and return to DOS. If BinkleyTerm was invoked with a batch file, this command will cause BinkleyTerm to exit to the batch file with and errorlevel of 1. The batch file must trap this errorlevel, and exit accordingly. Note that this function DOES leave the DTR (data terminal ready) line on the modem 'high.' Alt-Y Used primarily for Point operations, this function initiates a mail session with the host. This is designed ONLY to work with the system listed as your Boss node in the configuration file. Issuing this keystroke invokes a temporary mailer mode, and BinkleyTerm attempts to dial the Boss system to exchange mail. Mail handling must be set-up as described in the User's Guide section, "Unattended Mode Overview". If mail is waiting to be sent to the Boss, or if mail is waiting on the Boss system for pickup, it will be sent during the mail session. Alt-= "Doorway" mode is now supported in Bink's Terminal package. When in this mode, all keystrokes are sent out the modem as entered (exceptfor the command used to toggle the mode on & off). If a function key is used, a zero followed by the scan code is sent. The default command to toggle "Doorway" mode on and off is "Alt =" (it can be remapped the same as other Binkley functions). PgDn This allows you to download a file from the host with which you are connected. You are prompted for the desired protocol to use, and for the required file information, if needed (protocol dependent). If you have the 'Download' statement properly implemented in the configuration file, the downloaded files will be placed in the directory specified. Otherwise, the file will be saved to the current directory. PgUp This allows you to send a file to the remote host. You are prompted for the desired protocol to use for the transfer, as well as the file information. You may specify a complete drive, path and filename using standard DOS conventions, e.g., C:\PATH\FILENAME.ARC. When a batch protocol is used (SEAlink, Telink, or Zmodem), wildcards are allowed in the filename. UNATTENDED MODE KEYSTROKES While in Unattended Mode, several keystrokes are available that perform various functions, such as manual polling, call forcing, DOS shells, and so on. F1 through F10 These keys cause BinkleyTerm to exit with an errorlevel of 10 times the function key number pressed. In other words, F1 causes an errorlevel 10 exit, F7 would cause an errorlevel 70 exit. Your batch file is used to capture and process these errorlevels. Alt-F1 through Alt-F9 These keystrokes invoke user-defined DOS shells, to execute programs or utilities as desired. Refer to the section "Configuration File" for additional information. Alt-F10 This key causes BinkleyTerm to display a brief help screen, listing the various keystrokes available to you in the current operating mode. Alt-A Send answer string to the modem. Alt-B Forces a screen blank to occur. Any system activity or a press of the space bar will reactivate the screen display. Alt-C This forces BinkleyTerm to look at the outbound holding area and determine whether anything should be sent right away. If there is something that would not ordinarily be sent during the current event, this command will not cause it to be sent. Use a manual poll for immediate sending to any system under any circumstances. Note that BinkleyTerm automatically checks the outbound area approximately once every 10 minutes; the automated equivalent of this command. Alt-E This invokes your message editor/reader, as designated by the configuration file parameter 'Reader.' Refer to the section "Configuration File" for more information. Alt-F Toggles between few informations (fast) and many infos in the outbound window. Alt-G Allows the generation of an outbound file request. When executed, this command will pop-up a window on the screen where you will be prompted to provide information appropriate to creating a file request. See 'Colors' in "Configuration File" for related information. Alt-I Re-initializes the modem but does not rescan the outbound. Alt-J This causes BinkleyTerm to exit to DOS and stay resident (DOS shell). This is probably the most efficient method to perform a quick DOS command "on the fly." Enter "EXIT" at the DOS prompt to return to BinkleyTerm. BinkleyTerm will automatically return to the directory it was run from when returning from DOS. Alt-K Allows you to kill all mail for a particular node. When executed, you will be prompted for the appropriate information. Alt-M This keystroke allows you to perform a manual mail polling operation. You will be prompted for a FidoNet node address in the form <net>/<node>. You may also enter a Sysop name if a FIDOUSER.LST is available to BinkleyTerm in the nodelist directory. Refer to the User's Guide section "Nodelist" for more information on FIDOUSER.LST. BinkleyTerm will then dial the system, without regard to event schedules, and attempt to transact mail with the remote system. Alt-N Toggle NoPickup flag. ATTENTION: If you toggle this flag it is are saved PERMANENTLY in BINKLEY.SCD! So if the same event reappears one day later, it'l have the same status as the day before! Alt-O Press ALT-O if you want to rescan the hold directory. Useful for multiline systems. Alt-P Causes information in the Unattended Mode "Today at a Glance" window to be "zeroed" out. Alt-Q This tells BinkleyTerm to quit the current event, and start the next event that covers the current time period. If there is no such event, Event 0 (the default non-event) will be started. For all practical purposes, nothing happens during event 0, however, BinkleyTerm will still accept incoming mail. The events can be restarted by the Alt-R command. Alt-R This forces BinkleyTerm to restart the first event that should execute at the current time, not including forced events. Alt-S Allows the generation of an outbound file attach. When executed, this command will pop-up a window on the screen where you will be prompted to provide information appropriate to creating a file attach. See 'Colors' in "Configuration File" for related information. Alt-T This is used to shift to Terminal Mode on the fly. By using the Alt-U command of the Terminal Mode, you can flip back and forth between Terminal Mode and Unattended Mode. Alt-U Toggle "Send only" flag. ATTENTION: If you toggle this flag it is are saved PERMANENTLY in BINKLEY.SCD! So if the same event reappears one day later, it'l have the same status as the day before! Alt-W This command causes the screen to be redrawn with current information. This is handy for situations such as multi- tasking that may have caused the BinkleyTerm screen to become "trashed." Alt-X This allows you to exit BinkleyTerm with errorlevel 1. If you are using a batch file, it must capture and act upon the errorlevel properly by terminating the batch file. Refer to the User's Guide section "Control" for additional information. Alt-Y Polls the boss node (same as Alt-Y in Terminal Mode). Alt-Z Opens the Zoom Window with the enhanced outbound manager. Followin keys are active in the Zoom Window: ALT-F10 Help screen with Zoom functions A Readdress Mail G Get (request) Files I Reset Dial Tries P Poll any System (Create CLO File) C/D/H/N Change to Mail to Crash/Direct/Normal/Hold R Delete Requests S Send Files T Stop Calls Esc Cancel operation during session startup and elsewhere. Space This key may be used to abort polls and to un-blank the screen (when the 'ScreenBlank' option is used). This key is ignored when pressed during BinkleyTerm idle time (waiting for calls). VT-100 KEYSTROKES As described in the User's Guide, BinkleyTerm can optionally provide complete VT-100 terminal emulation. Part of this support is keystroke mapping of the VT-100 keypad. Shown below is an illustration of the VT-100 keypad, and the keystrokes that are required in order to emulate the respective key. The keypad layout and functionality should be familiar to VT-100 users. +--------+--------+--------+--------+ | | | Shift- | Shift- | | F1 | F2 | F1 | F2 | | | | | | +--------+--------+--------+--------+ | | | Shift- | Shift- | | F3 | F4 | F3 | F4 | | | | | | +--------+--------+--------+--------+ | | | Shift- | Shift- | | F5 | F6 | F5 | F6 | | | | | | +--------+--------+--------+--------+ | | | Shift- | | | F7 | F8 | F7 | | | | | | Shift- | +--------+--------+--------+ F10 | | | Shift- | | | F10 | F9 | | | | | | +-----------------+--------+--------+ Note that BinkleyTerm also allows the use of the arrow cursor control keys on the keyboard. When used with a host that supports VT-100 or ANSI, the arrow keys are functional for cursor positioning. One of the more common non-VT-100 applications for these keys is with Opus-CBCS' "OPed" full-screen on-line message editor, and many of the full-screen external on-line editors used with QuickBBS.