HF-HF-HF-A 2CBHF-HF- - GE-A 2HF GE- Programme Terminal PacKet v1.82HF GE- HF-A 2 - 24 October 1994 - F1EBN , Gerard Regnard - Mocquesouris - 77220 Tournan en Brie - France - Terminal PacKet TPK v1.82 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-PREFACEGE-HE-HF- -Thanks: -The original french documentation was improved by GE-Claude F5CDC.HF- -To GE-Ivor GI4WRI HF- and GE-George GI1VAZ HF- for the english translation. -To all the OMs who have translated the TPK files. -To GE- Alan G3KFN HF- and GE-Chris KC6IKO HF- sysops of GB7PLY. -A special thanks to GE-Andy G1DIL HF- who has coordinated all the job ! -To GE-Chris F1RZN HF-for the english translation of version 1.82 -documetation. -Comment(s) or suggestion(s) : F1EBN @ F6ABJ.FRPA.FRA.EU -H HE- -H HE- Preface ii HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-CONTENTSGE-HE-HF- -G 1.0 General presentation of TPK. . . . . . . . . . . . . . . 1H - 1.1 Objectives of TPK. . . . . . . . . . . . . . . . . . . . 1 - 1.2 Conventions of command writing. . . . . . . . . . . . . . 1 - 1.3 Main functions of TPK. . . . . . . . . . . . . . . . . . 2 - 1.3.1 HELP. . . . . . . . . . . . . . . . . . . . . . . . . 2 - 1.3.2 LOG. . . . . . . . . . . . . . . . . . . . . . . . . 2 - 1.3.3 BACKSCROLL. . . . . . . . . . . . . . . . . . . . . . 3 - 1.3.4 CAPTURE. . . . . . . . . . . . . . . . . . . . . . . 3 - 1.3.5 REMOTE Commands. . . . . . . . . . . . . . . . . . . 3 - 1.3.6 FILES TRANSFER. . . . . . . . . . . . . . . . . . . . 3 - 1.3.7 PROGRAMMING. . . . . . . . . . . . . . . . . . . . . 4 - 1.3.8 The "BROADCAST" function. . . . . . . . . . . . . . . 4 - 1.3.9 Other functions. . . . . . . . . . . . . . . . . . . 5 - 1.4 Briefly, how starting up ? . . . . . . . . . . . . . . . 7 - 1.5 Description of the main screen windows. . . . . . . . . . 8 -G 2.0 Description and use of TPK functions. . . . . . . . . . 10H - 2.1 On-line help . . . . . . . . . . . . . . . . . . 10 - 2.1.1 General points. . . . . . . . . . . . . . . . . . . 10 - 2.1.2 Choice of a command. . . . . . . . . . . . . . . . . 10 - 2.1.2.1 With the keyboard. . . . . . . . . . . . . . . . 10 - 2.1.2.2 With the mouse. . . . . . . . . . . . . . . . . 10 - 2.1.3 Movements in the text displayed. . . . . . . . . . . 11 - 2.1.3.1 With the keyboard. . . . . . . . . . . . . . . . 11 - 2.1.3.2 With the mouse. . . . . . . . . . . . . . . . . 11 - 2.1.4 Changing the help file. . . . . . . . . . . . . . . 12 - 2.2 LOG type functions. . . . . . . . . . . . . . . . . . . 12 - 2.2.1 MHEARD. . . . . . . . . . . . . . . . . . . . . . . 12 - 2.2.2 LOGBOOK. . . . . . . . . . . . . . . . . . . . . . . 12 - 2.3 BACKSCROLL. . . . . . . . . . . . . . . . . . . . . . . 13 - 2.4 CAPTURE mode. . . . . . . . . . . . . . . . . . . . . . 14 - 2.5 Remote commands. . . . . . . . . . . . . . . . . . . . . 14 - 2.5.1 Internal commands. . . . . . . . . . . . . . . . . . 14 - 2.5.2 Commented directory. . . . . . . . . . . . . . . . . 16 - 2.5.3 External commands. . . . . . . . . . . . . . . . . . 17 - 2.5.3.1 General points. . . . . . . . . . . . . . . . . 17 - 2.5.3.2 Structure of EXECAUTO.TPK . . . . . . . . . . . . 17 - 2.6 File transfers. . . . . . . . . . . . . . . . . . . . . 19 - 2.6.1 General points. . . . . . . . . . . . . . . . . . . 19 - 2.6.2 Transfer of text (ASCII). . . . . . . . . . . . . . 21 - 2.6.2.1 You send an ASCII file to your correspondent. . 21 - 2.6.2.2 You ask for an ASCII file. . . . . . . . . . . . 22 - 2.6.2.3 Correspondent send you an ASCII file. . . . . . 22 - 2.6.2.4 Correspondent asks for an ASCII file. . . . . . 22 - 2.6.2.5 Summary of ASCII transfers. . . . . . . . . . . 23 - 2.6.3 BINARY transfer (Datas). . . . . . . . . . . . . . . 23 - 2.6.3.1 You send a BINARY file to your correspondent. . 23 - 2.6.3.2 You want to receive a BINARY file. . . . . . . . 24 - 2.6.3.3 Correspondent sends you a binary file. . . . . . 24 - 2.6.3.4 Correspodent asks for a BINARY file. . . . . . . 24 - 2.6.3.5 Summary of BINARY transfers. . . . . . . . . . . 25 - 2.6.4 Recovery of an abandonned transfer. . . . . . . . . 25 -H HE- -H HE- Contents iii HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - 2.6.5 Menus for transferring files. . . . . . . . . . . . 26 - 2.6.5.1 Aim. . . . . . . . . . . . . . . . . . . . . . . 26 - 2.6.5.2 File(s) reception menus . . . . . . . . . 26 - 2.6.5.3 File(s) transmission menus . . . . . . . 27 - 2.6.5.4 Menu of file(s) choice in a list. . . . . . . . 28 - 2.7 Programming function. . . . . . . . . . . . . . . . . . 29 - 2.7.1 General points. . . . . . . . . . . . . . . . . . . 29 - 2.7.2 Programming of function keys. . . . . . . . . . . . 30 - 2.7.3 Macro-commands. . . . . . . . . . . . . . . . . . . 32 - 2.7.3.1 Creating a macro-command. . . . . . . . . . . . 32 - 2.7.3.2 Carrying out a macro-command. . . . . . . . . . 33 - 2.7.3.3 Managing macro-commands. . . . . . . . . . . . . 33 - 2.7.4 Programme files. . . . . . . . . . . . . . . . . . . 33 - 2.7.4.1 Creation of a programme-file. . . . . . . . . . 33 - 2.7.4.2 Carrying out a programme-file. . . . . . . . . . 34 - 2.7.4.3 Example of a programme-file. . . . . . . . . . . 34 - 2.7.5 Other commands useful in programming. . . . . . . . 35 - 2.7.5.1 Capture of the date and time. . . . . . . . . . 35 - 2.7.5.2 Variable PATH. . . . . . . . . . . . . . . . . . 36 - 2.7.5.3 Programming a waiting period. . . . . . . . . . 37 - 2.7.5.4 Password management. . . . . . . . . . . . . . . 38 - 2.7.5.5 Programming an event. . . . . . . . . . . . . . 39 - 2.7.5.6 Creation of a cycle. . . . . . . . . . . . . . . 39 - 2.7.5.7 Management of events. . . . . . . . . . . . . . 40 - 2.8 The BROADCAST function. . . . . . . . . . . . . . . . . 40 - 2.8.1 Installation of the BROADCAST manager. . . . . . . . 40 - 2.8.2 List of the BROADCAST function commands . . . . . . . 41 - 2.8.3 Message transfers between TPK and the BBS. . . . . . 45 - 2.8.4 Configuration examples of the "BROADCAST" functions. 46 - 2.9 The LOGBOOK function. . . . . . . . . . . . . . . . . . 48 - 2.9.1 Contents of the LOGBBOK. . . . . . . . . . . . . . . 48 - 2.9.2 Management commands of the LOGBOOK. . . . . . . . . 49 - 2.10 Other functions. . . . . . . . . . . . . . . . . . . . 50 - 2.10.1 Access to DOS function. . . . . . . . . . . . . . . 50 - 2.10.2 Keyboard management. . . . . . . . . . . . . . . . 51 - 2.10.3 Reconnection function. . . . . . . . . . . . . . . 51 - 2.10.4 QSO messages function. . . . . . . . . . . . . . . 52 - 2.10.5 Printing function. . . . . . . . . . . . . . . . . 52 - 2.10.6 Miscellaneous. . . . . . . . . . . . . . . . . . . 52 - 2.10.6.1 Warning bells. . . . . . . . . . . . . . . . . 52 - 2.10.6.2 Serial port management. . . . . . . . . . . . . 53 - 2.10.6.3 Use of external drivers. . . . . . . . . . . . 54 - 2.10.6.4 Passage into direct terminal mode. . . . . . . 54 -G 3.0 TPK function keys. . . . . . . . . . . . . . . . . . . . 55H - 3.1 Function keys to . . . . . . . . . . . . . . . 55 - 3.2 to keys. . . . . . . . . . . . . . . . . 56 -G 4.0 Syntax of TPK commands. . . . . . . . . . . . . . . . . 59H - 4.1 Local commands. . . . . . . . . . . . . . . . . . . . . 59 - 4.2 Remote commands. . . . . . . . . . . . . . . . . . . . . 67 -G 5.0 Configurations and setting up of TPK. . . . . . . . . . 70H - 5.1 The serial port. . . . . . . . . . . . . . . . . . . . . 70 - 5.1.1 Connection between TNC and PC. . . . . . . . . . . . 70 -H HE- -H HE- Contents iv HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - 5.1.2 Configuration of the serial port. . . . . . . . . . 71 - 5.1.3 Configuration for IBM serial cards. . . . . . . . . 72 - 5.1.4 Use of an external driver. . . . . . . . . . . . . . 73 - 5.2 Setting up TPK. . . . . . . . . . . . . . . . . . . . . 73 - 5.2.1 Decompression. . . . . . . . . . . . . . . . . . . . 73 - 5.2.2 List of TPK files. . . . . . . . . . . . . . . . . . 74 - 5.2.3 Starting. . . . . . . . . . . . . . . . . . . . . . 76 - 5.2.3.1 First attempts. . . . . . . . . . . . . . . . . 76 - 5.2.3.2 First time starting. . . . . . . . . . . . . . . 76 - 5.2.3.3 Error messages. . . . . . . . . . . . . . . . . 77 - 5.2.3.4 Setting up commands. . . . . . . . . . . . . . . 78 - 5.2.4 Use of TPK with a KAM. . . . . . . . . . . . . . . . 78 - 5.2.4.1 Setting up. . . . . . . . . . . . . . . . . . . 78 - 5.2.4.2 Specific commands for the KAM. . . . . . . . . . 79 - 5.2.5 Use of TPK with a PK232. . . . . . . . . . . . . . . 79 - 5.3 The different screens. . . . . . . . . . . . . . . . . . 80 - 5.3.1 Description of screens. . . . . . . . . . . . . . . 80 - 5.3.1.1 On-line help. . . . . . . . . . . . . . . . . . 81 - 5.3.1.2 The ALT keys help. . . . . . . . . . . . . . . . 81 - 5.3.1.3 The main screen. . . . . . . . . . . . . . . . . 81 - 5.3.1.4 The MHEARD screen. . . . . . . . . . . . . . . . 84 - 5.3.1.5 The BACKSCROLL screen. . . . . . . . . . . . . . 84 - 5.3.1.6 The DOS screen. . . . . . . . . . . . . . . . . 85 - 5.3.1.7 The message listing screen. . . . . . . . . . . 85 - 5.3.1.8 The message editor screen. . . . . . . . . . . . 86 - 5.3.1.9 The LOGBOOK screen. . . . . . . . . . . . . . . 88 - 5.3.2 Configuration of a colour screen. . . . . . . . . . 88 - 5.3.3 Configuration of a monochrome screen. . . . . . . . 89 -G 6.0 TPK files. . . . . . . . . . . . . . . . . . . . . . . . 90H - 6.1 The TPK.CFG file. . . . . . . . . . . . . . . . . . . . 90 - 6.2 The CONFIG.TPK files. . . . . . . . . . . . . . . . . . 90 - 6.3 The DIRC.TPK file. . . . . . . . . . . . . . . . . . . . 91 - 6.4 The EXECAUTO.TPK file. . . . . . . . . . . . . . . . . . 93 - 6.5 The on-line help files. . . . . . . . . . . . . . . . . 93 -G 7.0 TPK version 1.82 . . . . . . . . . . . . . . . . . . . . 95H - 7.1 Macro Commands . . . . . . . . . . . . . . . . . . . . . 95 - 7.1.1 Editing macro commands . . . . . . . . . . . . . . . 95 - 7.1.2 Specific macro commands . . . . . . . . . . . . . . . 95 - 7.1.3 Parameters for macro commands . . . . . . . . . . . . 96 - 7.2 Function keys . . . . . . . . . . . . . . . . . . . . . . 97 - 7.3 SO command (Bell/Chimes) . . . . . . . . . . . . . . . . 97 - 7.3.1 How to modify bells/chimes . . . . . . . . . . . . . 97 - 7.3.2 Enabling/disabling Bells . . . . . . . . . . . . . . 98 - 7.3.3 Testing bells . . . . . . . . . . . . . . . . . . . . 99 - 7.4 The built in screen saver . . . . . . . . . . . . . . . . 99 - 7.5 Messages lists . . . . . . . . . . . . . . . . . . . . . 100 - 7.5.1 Selecting messages . . . . . . . . . . . . . . . . . 100 - 7.5.2 Sending messages . . . . . . . . . . . . . . . . . . 101 - 7.5.3 Wait delay when forwarding with a BBS . . . . . . . 101 - 7.6 7PLUS . . . . . . . . . . . . . . . . . . . . . . . . . 102 - 7.6.1 Receiving 7PLUS messages . . . . . . . . . . . . . . 102 - 7.6.2 Sending 7PLUS encoded files . . . . . . . . . . . . 102 - 7.7 Servers . . . . . . . . . . . . . . . . . . . . . . . . 104 -H HE- -H HE- Contents v HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - 7.7.1 Servers: how they interact with TPK . . . . . . . . 104 - 7.7.2 How TPK runs these servers . . . . . . . . . . . . . 104 - 7.7.3 Files in which are stored messages . . . . . . . . . 105 - 7.7.4 Programing servers . . . . . . . . . . . . . . . . . 105 - 7.8 Miscellaneous Modifications . . . . . . . . . . . . . . 105 - 7.8.1 Handling Timezone . . . . . . . . . . . . . . . . . 106 - 7.8.2 Callsign used . . . . . . . . . . . . . . . . . . . 106 - 7.8.3 LOG file . . . . . . . . . . . . . . . . . . . . . . 106 - 7.8.4 Running DOS commands . . . . . . . . . . . . . . . . 107 - 7.8.5 Working mode for the TNC when connected . . . . . . 107 - 7.8.6 Messages Import file . . . . . . . . . . . . . . . . 107 - 7.9 Using the PK900 with TPK . . . . . . . . . . . . . . . . 108 - 7.9.1 Initialising your PK900 . . . . . . . . . . . . . . 108 - 7.9.2 Handling of 2 ports by TPK . . . . . . . . . . . . . 110 - 7.9.3 INITCNX and INITDCNX macro commands. . . . . . . . 112 - 7.10 Using TPK with BAYCOM modem . . . . . . . . . . . . . . 112 -G 8.0 Appendix : Extensions to the Yapp protocol . . . . . . . 114H - 8.1 HEADER extension. . . . . . . . . . . . . . . . . . . . 114 - 8.2 Data Packets extension. . . . . . . . . . . . . . . . . 114 - 8.3 Crash Recovery. . . . . . . . . . . . . . . . . . . . . 114 -H HE- -H HE- Contents vi HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-1.0 GENERAL PRESENTATION OF TPK.GE-HE-HF- E--GE-1.1 OBJECTIVES OF TPK.GE-HE-HF- -TPK is a software conceived for a TNC2 (or a clone). It works with -a PC or compatible under MSDOS. -It uses the power of the PC to facilitate the use of the TNC and -considerably increase the fields of use of the packet radio. -TPK has the characteristic of beiing largely configurable. The -configurations files and equally many TPK commands can easily be -programmed by the user. -TPK accepts both KAM and PK232 TNCs. E--GE-1.2 CONVENTIONS OF COMMAND WRITING.GE-HE-HF- -The commands as an example in this documentation will always be -surrounded by " to differentiate them from the text. -Here is an example of what you will come across: -To send a text file, use the command: -þ "/SEND [x:]FILENAME.EXT A" -Of course, in the real use of the command, the " will not be typed. -The capital letters of TPK commands in this document are the -essential letters to give the command validity. -On the other hand, a command can be written in small or capital -letters. -þ Macro, M, macro, or mAcRo are identical and valid. -þ SEND has no shortening but can be written send, Send etc. -The parameters between hooks are optional. -þ "/SEND [x:]FILENAME.EXT" - In that case the disc where the file can be found is optional. -The pressing of a key on the keyboard is represented by . -þ for the escape key. -Commands are usually validated by the key (carriage return) or - or . In this document validation is often left out -as it is obvious, otherwise it is represented by . -H HE- -H HE- General presentation of TPK. 1 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Parameters of commands must be separated by spaces. Useless -parameters, or excess ones, are ignored. E--GE-1.3 MAIN FUNCTIONS OF TPK.GE-HE-HF- -The TNC mainly directs the transfer of packets according to the -AX25 protocol. TPK adds several new functions of wich i have hereby -made a brief summary. Paragraph 2 gives details and directions for -use. E--GE-1.3.1 HELP.GE-HE-HF- -The use of TPK is simple....as long as you know its possibilities, -from where the importance of the documentation. -TPK offers 3 types of help: -þ The TPK.DOC file that you are currently reading: it's the most - complete document. It should be read at least once to find out - what it contains and to find out how to get at it in case you - get stuck -þ A main "online" help which is accessible at any time through the - key . It is to be used systematically and is the most - practical help available. -þ A table focussing on the list of keys accessible with the - function key . E--GE-1.3.2 LOG.GE-HE-HF- -þ MHEARD: List and path of stations heard, list of the last 8 - connections or remote commands. It is activated by the function - key . - (Details paragraph "2.2.1 MHEARD." on page 12) -þ Logbook: summarise connections in a file you can consult at any - time with the command "LOG". - (Details paragraph "2.2.2 LOGBOOK." on page 12 ) -þ Another file, LOGDIST.TPK summarise connections, deconnections, - remote commands received. It is an ASCII file, readable with any - text viewer or editor. -H HE- -H HE- General presentation of TPK. 2 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-1.3.3 BACKSCROLL.GE-HE-HF- -A circular buffer memorise everything which is written in the -traffic and monitoring window in the connected and disconnected -mode. This buffer can be consulted, erased or saved on disc at any -time. -Keys ,,,HOME,END,PGUP,PGDN are used for the -backscroll functions. -(Details paragraph "2.3 BACKSCROLL." on page 13) -You can control the lenght of this buffer by the command "BUFFER". -(Details paragraph "4.1 Local commands." on page 59) E--GE-1.3.4 CAPTURE.GE-HE-HF- -A command very simply allows you to capture on disc the text being -received, for example to recover a message from a BBS. The name of -the file created is parametrable. -This function is activated by the key . -(Details paragraph "2.4 CAPTURE mode." on page 14) E--GE-1.3.5 REMOTE Commands.GE-HE-HF- -Your correspondent can also carry out TPK commands: to gain access -to your discs in order to find the directory (/DIR), the number of -free bytes (/FREE), to change the implicit disc (/DISK), etc.... -These commands are attainable by the station to which you are -connected.. In order to be accepted as a command by TPK , the -latter must be preceded by "/". -All "/" received at the beginning of a line is considered by TPK as -preceding a command. This command must be found in the EXECAUTO.TPK -file, then carried out according to the contents of this file, or -ignored if it has not been authorised. E--GE-1.3.6 FILES TRANSFER.GE-HE-HF- -TPK allow the transfer of ASCII or BINARY files. -The protocol used for binary transfers is the excellent Yapp by -WA7MBL with some extensions (Crash recovery / Checksum). Your -correspondent must also be equipped with the Yapp protocol or also -be using TPK. But with TPK unlike with Yapp, these binary transfers -can be carried out without any intervention from the correspondent. -Thus it is possible to carry out the transfer in his absence. -H HE- -H HE- General presentation of TPK. 3 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -TPK's Yapp protocol is capable of retrieving an interrupted -transfer (interrupted for example by an untimely DISCONNECT !) with -another TPK user or a BBS F6FBB (but in this case only on a -download). -(Details paragraph "2.6 File transfers." on page 19) E--GE-1.3.7 PROGRAMMING.GE-HE-HF- -It is possible to carry out a sequence of defined commands in a -file (command "EXecute"). These commands can be programmed to be -carried out at a given time (command "At"). -The 10 function keys, as well as the , and keys -can be programmed just as well by you, thus enabling you to -personalise TPK. -So, Macro-commands (the sequence of commands sent out by a given -word key) can easily written, bringing power and flexibility to the -use of TPK. -In all cases, writing these programms requires the setting up and -use of an editor. Remember that in packet, you will avoid annoying -your correspondents with non standard characters as those are -banished from the keyboard (the accented e's, control characters -etc). -(Details paragraph "2.7 Programming function." on page 29) E--GE-1.3.8 The "BROADCAST" function.GE-HE-HF- -At the present time, to get a list of the available messages at -your local BBS, you are required to connect to it, and type L. -With TPK and FBB v5.14 and above, you can receive this list direct -to your PC, automatically, by simply running TPK with no manual -intervention. The only requirement is that you check first with -your SysOp and have the facility enabled at the BBS. -You can then view this list of message headers (without connecting -to your BBS), select the particular messages that you would like to -read (using either the keyboard, or mouse) and TPK will arrange for -these to be collected using the FBB compressed forwarding and -stored directly onto your disk ready for you to attend to them. -The built-in text editor in TPK allows you to enter any new -messages, edit messages, or send replies to any of the previously -received messages. Once complete your outgoing mail is sent to your -local FBB BBS again in compressed format. -The BROADCAST command in TPK allows you to configure all of these -features. -H HE- -H HE- General presentation of TPK. 4 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -The headers are sent by the FBB BBS in beacon mode (this is why -this function has been named BROADCAST). Their format is identical -to that seen when you type the L command when using the FBB BBS. -Example: -HF-F6ABJ-1>FBB -200000 P 432 F6FBB @F6FBB FC1EBN 920709 5.14d Installed. No problems ! HF- -These beacon frames are stored in selected files within TPK and you -can consult the files/list at any time. A simple protocol is used -to maintain the listing to be sure that it is up-to-date. TPK MUST -receive all of the message headers in numerical order, if one is -received out of sequence then a request to resynchronise is sent by -TPK to the FBB BBS. This frame can be sent manually using the BR -SYNCHRO command. E--GE-1.3.9 Other functions.GE-HE-HF- -Access to DOS: command "SHell" to launch a programm from TPK or key - to simply pass under DOS. Return from DOS through "EXIT". -(Details paragraph "2.10.1 Access to DOS function." on page 50) -Management of the keyboard: TPK analyses what have been entered -after you have validated it by pressing . If it recognises a -command, it will carry it out, if not everything is sent towards -the TNC. -(Details paragraph "2.10.2 Keyboard management." on page 51) -Edition: the keyboard is printed in the lower part of the screen. -This text can then be corrected (it is possible to delete, add to, -edit and justify the text). -The lines entered are kept in the memory (20 lines) and can be -examined with keys and . -(Details paragraph "2.10.2 Keyboard management." on page 51) -Connection to a station: the call of the last connection is -memorised and you can request the connection again by hitting . -(Details paragraph "2.10.3 Reconnection function." on page 51) -QSO Messages: you can prepare up to 10 messages which can be sent -to the correspondent by hitting keys (n from 1 to 0). -(Details paragraph "2.10.4 QSO messages function." on page 52) -Personal mailer: your correspondent can leave a message to you -(command "/MSG"). The message is incorporated a the end of your -personal mail list. -H HE- -H HE- General presentation of TPK. 5 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -(Details par "2.8 The BROADCAST function." on page 40) -Printing: a printer can be brought into service by the keys -or . -(Details paragraph "2.10.5 Printing function." on page 52) -Let us note the following possibilities described in paragraph -"2.10.6 Miscellaneous." on page 52 -þ It is possible to operate in systems other than packet by using - the key to put TPK transparent and send everything typed - on the keyboard to the TNC. -þ There are several sounding warning. They are managed by commands - "ALArme", "BELL", "SOnnerie" and key . - (Details paragraph "2.10.6.1 Warning bells." on page 52) -þ Management of the serial interface: choices and adjustement of - addresses and IRQs of the serial ports, use of internal or - external drivers like COMBIOS, MBBIOS, ESS, G8BPQ. - (Details paragraph "5.1 The serial port." on page 70) -H HE- -H HE- General presentation of TPK. 6 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-1.4 BRIEFLY, HOW STARTING UP ?GE-HE-HF- -The setup of the serial port is as follow: -þ Serial port: fixed in TPK.CFG -þ Speed: fixed in TPK.CFG -þ Parity: NONE fixed in TPK -þ Bits: 8 fixed in TPK -þ Stop: 1 fixed in TPK -The installation is done by the programm TPKINST.EXE. -Put the TPK disc in drive A: for example and type: -þ A: -þ TPKINST GB -Set all the parameters (the serial port and speed, etc), and after -validation TPKINST will create the directories if needed, -decompress the zipped files, and install TPK.CFG with your -parameters. -Connect your TNC on the serial port connector, go in the TPK -directory and run TPK.EXE. When TPK is ready (you must not get an -error message !), if you see nothing coming from the TNC, the -parity and bits number are certainly bads. There is the command -TNCINI to set them correctly. -Enter the command: -þ TNCINI -You will see the tries in a small window. When TPK has received the -cmd: from the TNC, the parity and bit number are corrects. You can -now configure your TNC. -According to the type of your TNC, use the file *.SET -correspondent. For instance for a TNC2 with eprom 1.1.8a use the -file TNC2118A.SET. You can send the contents of the file to the TNC -with the /SEND command: -þ "/SEND TNC2118A.SET E" -When all the commands are sent the TNC is configured and you can -trie the first connection ! -H HE- -H HE- General presentation of TPK. 7 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-1.5 DESCRIPTION OF THE MAIN SCREEN WINDOWS.GE-HE-HF- -The TPK screen can manifest itself in some different ways, -according to the functions in progress (the name of the screens and -windows in capital letters will be used systematically in this -document, in a way which will avoid mistakes in interpretation). -þ The ON-LINE HELP screen. (access by ) -þ The KEYS HELP screen. (access by ) -þ The MAIN screen of reception and transmission. -þ The MHEARD screen. (access by ) - The MHEARD screen is split in 2: - - The stations heard. - - The connections made and remote commands received. -þ The BACKSCROLL screen. (access by , , , ) -þ The DOS screen. (access by ) -þ The LISTINGS screen. (access by or BRoadcast List) -þ The LOGBOOK screen. (access by command "LOG") -Paragraph "5.3 The different screens." on page 80 describes these -screens in detail. -Here is a summarised description of the main screen, ie the packet -screen concerning reception and transmission, which consist of at -least two windows: -þ At the top of the screen, the traffic window. -þ At the bottom of the screen, the keyboard window. -However the reception window differs according to whether it is in -the disconnected or connected mode: in the disconnected mode, one -receives the traffic in progress, according to the state of the TNC -command "Monitor". In the connected mode, only the QSO in progress -is displayed (what is sent out and what is received). -In every case the keyboard window will let in TNC and TPK commands. -It is possible to open a third window called monitor window which -will be located at the top of the screen (to the detriment of the -traffic window which will consequently be reduced in size). -In the disconnect mode, it will be possible to receive for example -the only traffic of a given call in the monitor window. -H HE- -H HE- General presentation of TPK. 8 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -In the connected mode, on the TNC2 ONLY, under certain conditions, -you can receive the traffic in progress, except for your QSO which -will be displayed in the traffic window. -The windows are separated, according to the number of opened -windows, by 2 or 3 bands of a line. They indicate the state of the -system and the fucntion of various keys. -For more details see paragraph "5.3 The different screens." on page -80 which describe the functions of all the screens. -Now, to fully make use of TPK, you will have to read carefully the -following paragraphs. -H HE- -H HE- General presentation of TPK. 9 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.0 DESCRIPTION AND USE OF TPK FUNCTIONS.GE-HE-HF- E--GE-2.1 ON-LINE HELP .GE-HE-HF- E--GE-2.1.1 General points.GE-HE-HF- -The key gives you access to the TPK on-line help -screen.This screen gives the the syntax of TPK commands by a menu -in which you choose the command of interest to you. -This help is not however limited to TPK commands and can contain -all the informations you want, because everything displayed in this -screen is contained in the file TPK.HLP. This file is a text file, -whose structure is simple and which can easily be modified with an -editor. Furthermore, you can change the help file by choosing it -in a menu. E--GE-2.1.2 Choice of a command.GE-HE-HF- E--GE-2.1.2.1 With the keyboard.GE-HE-HF- -You can move the selection line onto the desired command with the -arrows and . Then validate this with or -by pressing the key which correspond to the button. -To cancel this, press or which corresponds to the - button. You will return to the MAIN TPK screen. - takes the selection line to the top of the menu. - takes the selection line to the bottom of the menu. - moves on the next page in the list (a height of one window). - moves back to the last page in the sequence. E--GE-2.1.2.2 With the mouse.GE-HE-HF- -The mouse can be activated, if present, in the file TPK.CFG with -TPKINST.EXE. -Position the cursor with your mouse onto the command you wish to -select and validate this by pressing the left button. -If the selection line is on the desired command, you can also -validate it by positioning the cursor with the mouse on the - button. - When you have made your choice, validate it by key - corresponding to the button. -H HE- -H HE- Description and use of TPK functions. 28 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - To cancel, press the key or which corresponds to the - button. - takes the selection bar to the top of the menu. - takes the selection bar to the bottom of the menu. - goes down on page in the list (one window height). - goes back one page in the list (one window height). -þ With the mouse: - Position the cursor with your mouse on the file you are choosing - and validate it by pressing the left button of the mouse. When - you have made your choice, validate it by positioning cursor on - the button and by pressing the left button. - To cancel a selection press the right button of the mouse or - position the cursor on the button and validate with the - left button. - The up and down arrows on the right side of the menu window act - in the same way as the corresponding keys on the keyboard. - Position the cusror upwards and validate with the left button. E--GE-2.7 PROGRAMMING FUNCTION.GE-HE-HF- E--GE-2.7.1 General points.GE-HE-HF- -TPK offers several methods allowing the creation of new commands. -The ability to create its own personal commands means TPK can adapt -to its own need, and furthermore, it's a great fun ! -These commands can be called by using a combination of one of the -three special keys , and plus any of the ten -function keys to . You therefore have at your disposal -some 30 programmable commands. -Furtheremore, you can mix these commands with TPK or TNC commands: -these commands, made up of several commands are called -"macro-commands". The name of each macro-command will be chosen by -you. -Programmable commands and macro-commands can be integrated into one -text file (you get to baptize it !), thus enabling the creation of -quite complex programmes: these are programme-files. -Even possible combination must conform to a syntax which will be -explained in the following paragraphs. -H HE- -H HE- Description and use of TPK functions. 29 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.7.2 Programming of function keys.GE-HE-HF- -The to , to and -to keys are programmed by the "Touche" command -(Touche=Key) with the following syntax: -þ "Touche An Text_of_the_key" (A for ALT, n for key number) -þ "Touche Cn Text_of_the_key" (C ofr CTRL, n for key number) -þ "Touche Sn Text_of_the_key" (S for SHIFT, n for key number) -For example, to programme the key in order to connect -the F6ABJ-1 BBS, you write: -þ "T S1 ^6c f6abj-1^M" followed by -As this example shows, the "Text_of_the_key" can contain special -characters which enable simulation of control keys. The -carriage-return on your keyboard is nothing more than a key -containing and (capital M, lower case m correspond to -another code !). Type and on your keyboard and the -result will be a carraige-return. the control key corresponds to -the character "^" in the above example, the "M" corresponds to -which you must send after the BBS code, whilst the following -is manual; it validates and records the programmation. -The "^6" preceding the TNC connection command, simulates pressing -the key, which, on TPK, forces passage of the TNC into command -mode by sending a "break" on the serial link. -Now try: type and , TPK must call up F6ABJ-1. -These explanations will have to suffice in the comprehension of -this example of programming. -Secial characters such as "^" are not always available from the -keyboard. Having the complete ASCII table at your disposal, it is -still possible to get these characters on the screen in the -following way: -Find the ASCII code expressed in DECIMAL (94 for "^"). Keep the - key prssed while typing "94" on the number block. Release the - key: the character "^" is displayed on the screen. -This is a general method and can be used outside of TPK as in TPK -to write any character, specific or otherwise. -In the case of function key programming, macro-commands or -programme files, TPK has a special writing which is used to -simulate a specific character via the "@" character. -The syntax is: @nnn@ -H HE- -H HE- Description and use of TPK functions. 30 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Where "nnn" is the ASCII decimal code. -Eg, @27@ simulate the key. -You can also simulate function key or key codes with two characters -by the special syntax: @0@nnn@ -Eg: "@0@75@ will equal the left arrow or "@0@59@" will equal the - key. -HE-Note: HF-This is ONLY to be used in programming ! TPK ONLY interprets -them in this case. -The programmable keys not only need the "^" in order to simulate -the key, but also the character "@" (code ASCII 64) to -simulate the key: -Eg: "@C" will simulate the key which erase the screen. -It is therefore possible to enter several commands on the same key -thanks to the "^M" which, working like the , can line up the -commands in single file. -Eg: programming the key as follow: -þ "T C3 sh copy a:*.* c:\tmp^M/dir c:\tmp\*.*^M" - Is equivalent to: -þ "sh copy a:*.* c:\tmp" -þ "/dir c:\tmp\*.*" - Typed on the keyboard. -The contents of a key must not exceed 255 characters (same rule for -the macro-commands described below). -The "Touche" command allow management of programmable keys: -þ When the "Text_of_the_key" is absent, TPK lists the contents of - the key. -þ If the n (key number) is also absent, TPK lists the contents of - all the keys in the category. -Examples: -þ "T S1" lists contents of -þ "T S" lists contents of to keys -þ lists contents of all the function keys -H HE- -H HE- Description and use of TPK functions. 31 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -The contents of the keys are saved in the TPK.KEY file at each -key's modification. -Some additional examples could prove useful: -þ "T S1 /DIR C:\TPK\*.*^M" - Affects the DIR command to the key and lists the - files in the TPK directory. -þ "T S2 ^7/SEND" - In the connected mode, preparation of a "/SEND" command: the - "^7" equivalent to key put TPK in the waiting for a command - mode (displaying "TPK>") and after hitting , you only - have to enter the filename. -þ "T S3 ^6MH^MK^M" - will put the TNC back in the command mode if it is - not there already , it will list the MHEARD and put the TNC in - the CONVERS mode (to be used in the connected mode). -þ "T S4 ^6@CMH^M" - Same thing but after the screen has been erased (by . E--GE-2.7.3 Macro-commands.GE-HE-HF- -A macro-command is a series of commands which can be triggered on -by a key word. -HE-Note: HF-The key word is CASE sensitve, so "bbs" is different from -"BBS". -Macro-commands are not limited in number. -Macro-commands are programmed in exactly the same way as function -keys (see paragraph "2.7 Programming function." on page 29). The -only difference is that carrying them out is not triggered on by -function keys but by a word key that you have chosen. -A macro-command can be a sequence of TPK or/and TNC commands. E--GE-2.7.3.1 Creating a macro-command.GE-HE-HF- -The TPK command enabling creation of a macro-command and memorising -it on disc is "MEMorise": -þ "MEMorise Key Text" validated by a -H HE- -H HE- Description and use of TPK functions. 32 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - With "Key" the name you have chosen and "Text" the programming - text. -Eg: "MEM bbs c f6abj-1^M" memorises the "bbs" macro-command which -requests a connection to F6ABJ-1. E--GE-2.7.3.2 Carrying out a macro-command.GE-HE-HF- -Two ways: -þ The TPK "Macro" command followed by the key word. - Eg: "M bbs" carries out the "bbs" macro-command. -þ The key followed by the key word. - Eg: "bbs" E--GE-2.7.3.3 Managing macro-commands.GE-HE-HF- -It is realised by two TPK commands: -þ "EMacro Key" edits the macro-command "Key". The content of the - macro-command is crossed back into the keyboard buffer, which - allow edition and modifications (see paragraph "2.10.2 Keyboard - management." on page 51). - Eg: "EM bbs" edits the macro-command "bbs" -The key displays the macro-commands list. -HE-Note: HF-You can stockpile macro-command calls, function keys and -programmes up to a maximum level of 20. E--GE-2.7.4 Programme files.GE-HE-HF- -TPK commands and macro-commands (paragraph "2.7.3 Macro-commands." -on page 32) can be reassembled in text files which then becomes -programme-files. -The programme-files must be placed in the TPK directory. E--GE-2.7.4.1 Creation of a programme-file.GE-HE-HF- -Each line of a programme-file can contain one or several commands -according to the same principle as macro-commands. -A line which begins with a sharp (#) is considered as commentary -and is ignored by TPK. -H HE- -H HE- Description and use of TPK functions. 33 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -The "ECHOTPK Text" command enables inclusion of commentaries in the -programme-files. When you are executing the file, "Text" will be -displayed in the traffic window. E--GE-2.7.4.2 Carrying out a programme-file.GE-HE-HF- -The "EXecute" command launches the interpretation of commands -placed in the file whose name is passed into the parameter. -To interrupt a programme-file in progress, type the key. E--GE-2.7.4.3 Example of a programme-file.GE-HE-HF- -The command "EX lbbs" starts execution of the programme-file LBBS -whose listing is given below for analysis: -HF-c fe6cnb-1 -att 180 cnx -^7att 180 > -@S^H^H^H^H1 -rm -^7att 600 > -b HF- -Some explanation will not go amiss: -þ Line 1 : "c fe6cnb-1" - Connection onto the BBS. The request is sent to the TNC by TPK. -þ Line 2 : "att 180 cnx" - Wait 180 seconds for connection. If at the end of this time, - connection has not been established, the programme is - abandonned. (See command "ATTente" paragraph "2.7.5 Other - commands useful in programming." on page 35) -þ Line 3 : "^7att 180 >" - Wait for the BBS prompt ">" during 180 seconds. If the prompt - arrives eg. within 15 seconds, the following command is dealt - with without further delay, but if the prompt doesn't arrive in - 180 seconds, the programme is interrupted. - You must not forget the "^7" which simulates the key for - passing into the command mode of TPK when you are connected, if - not, the command will be sent to the BBS ! - The awaited text is everything located after the space to the - right of the duration (180) and the end of line . -þ Line 4 : "@S^H^H^H^H1" -H HE- -H HE- Description and use of TPK functions. 34 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - followed by 4 and an 1. Brought into service of - the CAPTURE on disc (See paragraph "2.4 CAPTURE mode." on page - 14). The 4 erase the ".TPK" extension of the CAPTURE - filename TEMP.TPK. Therefore TEMP remains to which you can add a - 1 to give new name TEMP1 -þ Line 5 : "rm" - "rm" is sent to the BBS for reading personal messages. If there - are messages, they will be saved in TEMP1 -þ Line 6 : "^7att 600 >" - Wait for the BBS prompt for 600 seconds. don't forget the "^7", - it's easy to forget ! -þ Line 7 : "b" - The disconnection command "b" (for bye) is sent to the BBS. - CAPTURE will be automatically closed in disconnection. Of - course, it is possible to do it with an : to put an "@S" - in the file is enough. E--GE-2.7.5 Other commands useful in programming.GE-HE-HF- -TPK has at its disposal 3 predefined variables which are ONLY -usable in the programming of function keys, macro-commands and -programme-files. E--GE-2.7.5.1 Capture of the date and time.GE-HE-HF- -þ "%DATE%" or "%DATE % - Makes it possible to incorporate the present date in the key or - the macro-command. - Usable formats for the date: - - dd or d for the day with or without leading zeros. - - mm or m for the month with or without leading zeros. - - yy or yyyy for the year with 2 or 4 characters. -þ "%TIME%" or "%TIME %" - Makes it possible to incorporate the time. - Usable formats for the time: - - hh or h for the hours with or without leading zeros. -H HE- -H HE- Description and use of TPK functions. 35 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - - mm or m for the minutes with or without leading zeros. - - ss or s for the seconds with or without leading zeros. - - To display time with the 12H00 AM/PM format add AM/PM or - am/pm or A/P or a/p in the format string. - - To display UT time add a Z in the time format string and in - the date format string. - TPK uses the environment string TZ to set difference between - local and universal time. - Examples: - - %DATE d/mm/yy% = 1/12/92 - - %DATE dd/mm/yyyy% = 01/12/92 - - %DATE mm-dd-yy% = 12-01-92 - - %TIME h:mm:ss% = 9:12:34 - - %TIME hh:mm% = 09:12 - - %TIME h:mm AM/PM% = 9:12 AM - - %DATE d-mm-yyy h:mm% = 1-12-92 9:12 - HE-Note: HF-DATE and TIME can be mixed but be careful no other - texts in the middle of the format string. - - %TIME h:mmz% = 8:12 for TZ=FRA-1 - - Creation of a macro-command for sinding DAYTIME to the TNC - with universal time. - DAYTIME %DATE yymmddhhmmssz%^M - You must enter this macro-command with the "MEMorise" command - (see paragraph "4.1 Local commands." on page 59) E--GE-2.7.5.2 Variable PATH.GE-HE-HF- -TPK directory can be found with variable PATH. It can be used to -build a path from the TPK directory. -Eg: "T S5 @W^Y%PATH%capture.tpk^M" -Will write the TPK buffer into the TPK directory instead of the -BUFFER directory, with the name "CAPTURE.TPK" -H HE- -H HE- Description and use of TPK functions. 36 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.7.5.3 Programming a waiting period.GE-HE-HF- -Command "ATTente" (See also paragraph "4.1 Local commands." on page -59) whose syntax is: -þ "ATTente Duration [Event]" - With: - - "Duration" : a waiting time expressed in seconds. - - "Event" : several types of event are possible. - -- CNX : waiting for the connection. - -- DCNX : waiting for the disconnection. - -- Text : waiting for the receipt of the string Text at the - END of a line. - -- "Text" : waiting for the receipt of the string Text - ANYWHERE in a line. - HE-Note: HF-You cannot wait for a text in the disconnected mode. - -- PASSWORD : waiting for a password question. - (See paragraph "2.7.5.4 Password management." on page 38) -Examples: -þ "ATT 180 cnx" - Waits for a connection for 180 seconds. If the connection does - not take place before this time has elapsed, it is abandoned. -þ "ATT 60 >" - Waits for a BBS FBB prompt for 60 seconds. This text has to be - terminated by a . -þ "ATT 10" - Simply waits for for 10 seconds (pause). - HE-Note: HF-TPK functionning is not interrupted during this waiting - period. - Remember : a programme in progress can be cancelled at any time - by typing . -H HE- -H HE- Description and use of TPK functions. 37 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.7.5.4 Password management.GE-HE-HF- -TPK can automatically send a reply to a password question from a -BBS or any other system. -The "ATTente" command is used with the following syntax: -þ ATTente PASSWORD - Where: - - Text_To_Wait : the text sent with the password numbers list. - - WordKey : a word key to find the password string in a TPK - file called PASSWD.TPK and which must be located in the TPK - directory. -When TPK receives the Text_To_Wait it looks for the word key in -PASSWD.TPK and if found, read the following line containing the -password string. Then with the numbers sent with the password -question takes the corresponding letters in the password string and -send them as reply. -Format of the PASSWD.TPK file: -þ One line for the word key. -þ One line for the password string. -You can put as many passwords as you want in this file. Just put -the two necessary lines for each password. -Example of PASSWD.TPK file: -HF-Line 1 : EBNPASSWD -Line 2 : THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG HF- -Example of command "ATTente" in this case: -þ "ATT 180 PASSWORD Password? EBNPASSWD" - TPK receives for example: - Password? 11 5 7 15 23 - Its reply will be: - BQINM -This function can be used for the C_FILTER of VE2BLY or the SYS -command for F6FBB BBS for example. -H HE- -H HE- Description and use of TPK functions. 38 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.7.5.5 Programming an event.GE-HE-HF- -Command "At Time [Command]" (Do not confuse with "ATTente" !). -(See also paragraph "4.1 Local commands." on page 59). -Parameters: -þ Time : the time of command launch. The time parameter can be the - %TIME% variable and you can make an addition to it. - Eg: "a %TIME%+15 command" -þ Command : can be a macro-command or ANY TPK function. The - execution of this is ONLY valid in the disconnected mode, - otherwise commands are stockpiled and will be carried out after - disconnection. -Programming is carried out at the said time THEN IS ERASED. Waiting -time before the programme is carried out cannot exceed 24 hours. -You can programme a maximum of 10 different programmes which will -be erased in the space of 24 hours unless you programme more as -soon as the first ones are carried out. -Some examples: -þ "A 1000 bbs" - Memorises a programme at 10 o'clock. When the TPK clock gets to - 10 o'clock the "bbs" macro-command will be carried out. -þ "A 100 EX bbs1" - Programmes execution of "bbs1" at 1 o'clock. -þ "A 2355 EX bbs1" - Programmes execution of "bbs1" at 23H55. E--GE-2.7.5.6 Creation of a cycle.GE-HE-HF- -Example: the macro-command BEACON. -"K^MBEACON TPK^M^6a %TIME%+15 macro BEACON^M -The first command launch (by typing "MACRO BEACON" or -"BEACON") will write the "BEACON TPK" text then reprogramme -itself at the present time plus 15 minutes, creating thus a -continuous cycle. -HE-Note: HF-This ONLY works in macro-commands or function keys, because -the %TIME% variable is only known in these modes. -H HE- -H HE- Description and use of TPK functions. 39 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.7.5.7 Management of events.GE-HE-HF- -þ "A" without parameters lists the programmed events. -þ "A 1000" lists the events programmed at 10 o'clock. -þ EFAt 1000" erases the 10 o'clock event if it exists. E--GE-2.8 THE BROADCAST FUNCTION.GE-HE-HF- E--GE-2.8.1 Installation of the BROADCAST manager.GE-HE-HF- -Three commands are necessary for the correct operation of BROADCAST -mode. -Examples: -þ MYCALL FD1CDC - Advises both TPK and your TNC of your own callsign. Your - callsign MUST be initialized before using the BRoadcast - commands. -þ BR F6FBB-1 U F6FBB-1 - Advises TPK the path used for the UNPROTO reply to F6FBB-1 (your - local BBS) -þ BR F6FBB-1 C F6FBB-1 - Advises TPK the path used for connections to the local FBB BBS, - F6FBB-1 -The following command enables automatic reception of your personal -mail: -þ BR RXMSG PRIV - Advises TPK to search for your personal mail. -All of these commands must be included in the file CONFIG.TPK -HE-Note: HF-You MUST call your local SysOp BEFORE validating these -functions as he must authorize you to use the BROADCAST option -prior to use. If you don't do this, TPK will send a beacon every -time it receives a message header frame from the BBS. This beacon -will be ignored by the BBS -When you have run TPKINST a directory will be created into which -will be placed two files after receiving the first BROADCAST from -your local BBS (that is provided this has been validated using the -H HE- -H HE- Description and use of TPK functions. 40 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -above commands). The names of these files will be the CALLSIGN of -the BBS and the extensions will be .NUM and .LST HF- - Examples: FC1EBN-1 uses the files FC1EBN-1.NUM and FC1EBN-1.LST - FC1EBN-12 uses the files FC1EBN12.NUM and FC1EBN12.LST - F6FBB-1 uses the files F6FBB-1.NUM and F6FBB-1.LST - F6FBB uses the files F6FBB.NUM and F6FBB.LST HF- -These files .NUM and .LST contain very important -information so be sure that you DO NOT DELETE OR MODIFY them ! E--GE-2.8.2 List of the BROADCAST function commandsGE-HE-HF- -All of these commands can be configured as macro-commands or -function keys. -For each command, you will find: -þ The syntax of the command. -þ A description of the command. -þ An example. -Command list: -þ BRoadcast Connection - Establish the packet path for automatic connection to - Ex: BR F6FBB-1 C F6FBB-1 V FD1CDC-5 -þ BRoadcast Unproto |AUTO - Specify the return path for the reply to the BROADCASTs of - . This is the UNPROTO mode of the TNC. This is the command - which validates the BROADCAST receipt from this BBS. - Ex: BRoadcast F6FBB-1 U F6FBB-1 V FD1CDC-5 -þ BRoadcast RXMSG Acceptpriv - Allows private messages to be included in the lists. You can't - read these messages if you are not a SysOp at the BBS. This - command is for co-sysops ! - Ex: BRoadcast RXMSG Acceptpriv -þ BRoadcast List - Use this command to directly access the message list of a BBS. - You can also use which will open a menu with the BBS - list. The first character on each line is the message status - for TPK: -H HE- -H HE- Description and use of TPK functions. 41 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H HF- - R : Message received - P : Private message received (in MSG_PRIV) - Y : Message read - * : Message ready to forward (in MSG_PRIV) - F : Message forwarded (in MSG_PRIV) - K : Message killed - + : Message 7Plus (the 7plus files which have been extracted and/or - decoded are stored in the CAPTURE directory) HF- - You MUST send the "BR RXMSG PRIV" command to TPK to request - automatic collection of your Personal mail. - In the BBS lists, if the message status is blank then the - message has not been received: if you select it with or - click-on with the mouse it will be marked to for collection. - When all selections are complete, confirm your request with - (Delayed Reception) or with (Immediate Reception) or by - clicking-on or with the mouse. - Incoming messages are received into sub-directories: the name of - the directory is the callsign of the BBS, the same as for the - .NUM and .LST files. - A typical directory tree for a user close to F6FBB-1 would look - like:- HF- - C:\ÄÄTPKÄÄÂÄÄUPLOAD - ³ - ÃÄÄPRIV_UP - ³ - ÃÄÄDOWNLOAD - ³ - ÃÄÄHELP - ³ - ÃÄÄCAPTURE - ³ - ÃÄÄBUFFER - ³ - ÃÄÄDOC - ³ - ÀÄÄLISTSÄÄÄÂÄÄF6FBB-1 Directory of the F6FBB-1 messages - ³ - ÀÄÄMSG_PRIV Directory of your private mail HF- - The directories F6FBB-1 and MSG_PRIV are created automatically - by TPK. The message names are the actual number of the - messages. For instance if you have a file with the name 123456, - then this will be message number 123456 at your local BBS. - To list messages from F6FBB-1 use: BR F6FBB-1 L - To list your own private mail use: BR MSG_PRIV L -þ BRoadcast SYnchro -H HE- -H HE- Description and use of TPK functions. 42 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Send a beacon to which contains the number of the last - message header TPK received. The beacon path is the one - configured in the BR U command. These messages are - sent every time TPK receives a header where the number is not - the one expected. If the TNC can't send the packets (on a busy - channel for instance) then it will respond with "too many - packets outstanding". That is not a problem, as the beacon will - be sent as and when the channel is clear. - Ex: BR F6FBB-1 SY -þ BRoadcast Delete|Supprime - Delete the BBS from the list. TPK will ignore any - BROADCASTs and will not FORWARD with this BBS. - Ex: BR F6FBB-1 DEL -þ BRoadcast Erase|Efface nnn - Delete any old messages from the listing. nnn is the amount of - messages to keep in the list. Messages with status Y (read but - not killed) remain in the list. You MUST kill them before - erasing. You can't erase part of the list if some messages have - been selected but have not yet been received. - Ex: BR F6FBB-1 E 1500 - To keep a total of 1500 messages in the list. -þ BRoadcast Erase|Efface K - Delete all killed messages from the list. - Ex: BR F6FBB-1 E K -þ BRoadcast Erase|Efface P - Delete your private messages from the list. (Don't attempt to - delete the actual files from the MSG_PRIV directory, you must - kill them from the listing of your personal mail !!!) - Ex: BR F6FBB-1 E P -þ BRoadcast Erase|Efface Date - Delete all messages older than - Ex: BR F6FBB-1 E DATE 920714 -þ BRoadcast Erase|Efface Days|Jours
- Delete all messages older than
days -H HE- -H HE- Description and use of TPK functions. 43 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Ex: BR F6FBB-1 E Days 7 -þ BRoadcast - Send management information from TPK. - Ex: BR F6FBB-1 -þ BRoadcast - List the known BBSs. TPK can work with several BBSs. Enter the - command "BR U " and "BR C " for each - one. - Ex: BR - HE-Note: HF-Be careful: if you enter several BBSs, you will get your - personal mail from each, and the bulletins will be the same from - all of the BBSs ! Don't forget that you will also upset the - White Pages Database too. So the best choice is to enter ONLY - ONE BBS and all will be OK... - The following commands allow automatic reception of pre-selected - messages. -þ BRoadcast RXMSG PRIV - Requests receipt of your personnal mail from ALL BBSs declared. - You MUST have already entered your callsign to TPK using the - MYCALL command. - Ex: BR RXMSG PRIV -þ BRoadcast RXMSG TO - Requests receipt of messages addressed TO - Ex: BR RXMSG TO FBB -þ BRoadcast RXMSG BBS <@BBS> - Request receipt of messages routed to <@BBS> - Ex: BR RXMSG BBS GBR -þ BRoadcast RXMSG FROM - Request receipt of messages sent by - Ex: BR RXMSG FROM FC1EBN -þ BRoadcast RXMSG STRING - Request receipt of messages where TPK can find in the - subject field. Only ONE text_string can be searched for at any -H HE- -H HE- Description and use of TPK functions. 44 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - one time. - Ex: BR RXMSG STRING TPK -þ BRoadcast RXMSG 7PLUS [DECODE] - Every incoming message is scanned for 7PLUS content. If it is a - 7+ file, then the 7+ text is extracted and a file is created in - the CAPTURE directory. If you add the DECODE parameter to every - 7+ message received TPK will execute the 7+ program and attempt - to decode the file. For correct operation the route to - 7PLUS.EXE must be declared in your PATH statement or the file - must actually reside in the CAPTURE directory. You must ensure - that you have sufficient free memory available for 7PLUS to - execute whilst running TPK; a good test to check if this is - possible is to SHELL through to DOS (using the key) and - then run MEM.EXE from DOS5. It needs to report approx 100Kb of - free memory. (Also see BUFFER command.) Any 7+ reports - generated during execution are redirected to a file called - 7PRESU. If you encounter problems then check this file to see - what happened during the last execution. - Ex: BR RXMSG 7PLUS - BR RXMSG 7PLUS DECODE -þ BRoadcast RXMSG BUffer - List those messages which are held in memory but have not yet - been saved to a file because there is a hole in the list. - Ex: BR RXMSG BU E--GE-2.8.3 Message transfers between TPK and the BBS.GE-HE-HF- -þ FORward Timer|Intervalle - Set the amount of time between each forwarding cycle (Default is - 15 mins) in the range of 5 to 55 minutes. Once set then the - automatic exchange of messages will commence after each period - of n minutes. - Ex: FOR T 25 - To set period to 25 min - FOR T - Shows the forwarding period and the value of the counter. -þ FORward Execute -H HE- -H HE- Description and use of TPK functions. 45 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Begin execution of reception and transmission of messages - to/from your local BBS. - Ex: FOR E -þ FORward List|Liste RX|TX - Lists those messages waiting to be received (RX) or transmitted - (TX) - Ex: FOR L RX - FOR L TX E--GE-2.8.4 Configuration examples of the "BROADCAST" functions.GE-HE-HF- -Reception of the message headers from the local BBS F6ABJ-1 -þ MYCALL (Ex: MYCALL FC1EBN) -þ BR F6ABJ-1 U F6ABJ-1 -þ BR F6ABJ-1 C F6ABJ-1 - If you want to receive your personal mail you must add: -þ BR RXMSG PRIV -Declaration of FF6PTT-1 BBS where you want to send messages using -forwarding, but without receiving message lists (in this case you -must NOT use the BR U command) -þ BR FF6PTT-1 C FF6PTT-1 V F6PRA-4 - If, for instance F2KL wants to receive a listing from the BBS - F6ABJ-1, receive his personal mail from this BBS, and also - forward his outgoing mail to both F6ABJ-1 and to FF6PTT-1; but - does not want to receive the message listing from FF6PTT-1, then - he would use the following commands (these can be entered into - the set-up file CONFIG.TPK): -þ MYCALL F2KL -þ BR F6ABJ-1 U F6ABJ-1 -þ BR F6ABJ-1 C F6ABJ-1 -þ BR RXMSG PRIV -þ BR FF6PTT-1 C FF6PTT-1 -In this case FC1MVP is using his PMS to receive his mail and so -doesn't want TPK to undertake automatic reception from his local -H HE- -H HE- Description and use of TPK functions. 46 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -BBS FC1GHV-1. The only commands used will be: -þ MYCALL FC1MVP -þ BR FC1GHV-1 U FC1GHV-1 -þ BR FC1GHV-1 C FC1GHV-1 - The command BR FC1GHV-1 C FC1GHV-1 allows him to use TPK for - writing his messages and forwarding them on to FC1GHV-1. -Connection to the BBS via a Thenet: -In fact the connection path is treated by the macro-commands -manager. It is possible to put several commands in this path, -macro-commands or programmes. -Example: connection to F6ABJ-1 via FF6KBS-5 -þ BR F6ABJ-1 C FF6KBS-5^MATT 180 CNX^MC F6ABJ-1 -Example: connection via several nodes. -þ BR F1AA C F6XYZ^MATT 180 CNX^MC F6ABC^MATT 180 ABC^MC F1AA - Simply add the waiting for the connection prompt for each node. -Connection to a BBS with a password. -First create a macro-command for sending the password: - "MEM PASSWD ATT 180 PASSWORD Password? PASSABJ" -HE-Note: HF-Be careful : the macro-command keyword MUST be in capital -because the BRoadcast command convert the connection path into -uppercase. -The connection path for the BRoadcast command will be: - "BR F6ABJ-1 C F6ABJ-1^MPASSWD" -(See paragraph "2.7.5.4 Password management." on page 38) -Examples of programmed keys for simplified operation of the -BROADCAST commands. -þ Go to my personal mailbox: - T C1 BR MSG_PRIV L^M -þ List the messages from my local BBS: - T C2 BR F6ABJ-1 L^M -þ Send a resynchronization beacon to my local BBS: -H HE- -H HE- Description and use of TPK functions. 47 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - T C3 BR F6ABJ-1 SY^M E--GE-2.9 THE LOGBOOK FUNCTION.GE-HE-HF- E--GE-2.9.1 Contents of the LOGBBOK.GE-HE-HF- -The LOGBOOK generated at every connection contain the following -informations, each field is a string in that order : -þ Current date at the moment of the connection : 8 characters. - Implicit format is dd-mm-yy - Modification of the date format with command "LOG Date" -þ Frequency of the QSO : 6 characters. - Implicit value : 144675 - The command "FRE" modify this value. -þ Traffic mode : 4 characters. - Implicit value : PK - Modification with command "LOG Mode" -þ Power used : 4 characters. - Implicit value : 25W - Modification with command "LOG POWER" -þ QSO beginning time : 4 characters. - Implicit format : hhmm - Modification of the format with command "LOG Time" -þ Callsign of the station connected : 8 characters. -þ Report sent : 3 characters. -þ Report received : 3 characters. - Implicit value : 59 - Modificaton with command "LOG Rst" -þ QSO end time : 4 characters. -H HE- -H HE- Description and use of TPK functions. 48 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Same format as the beginning time. -þ Commentaries : 40 characters. E--GE-2.9.2 Management commands of the LOGBOOK.GE-HE-HF- -The "LOG" command associated to the "FRE" command allow the -management of the LOGBOOK. -Command "FREquence" see paragraph "4.1 Local commands." on page 59 -and paragraph "5.2.4 Use of TPK with a KAM." on page 78 -þ LOG - Display and edition of the LOGBOOK. The last QSOs are displayed - and you can move into the file, search calls, print it, etc. - See paragraph "5.3.1.9 The LOGBOOK screen." on page 88 -þ LOG Date - Modification of the display format of the date in the LOGBOOK. - The format is the same as the %DATE% variable. - See paragraph "2.7.5.1 Capture of the date and time." on page 35 - Example : "LOG DATE mm/dd/yy" -þ LOG Mode - Modification of the implicit traffic mode in the LOGBOOK. - Example : "LOG MODE Pack" -þ LOG Power - Modification of the value of the power used. - Example : "LOG POWER 100W" -þ LOG Time - Modification of the display format of the time in the LOGBOOK. - The format is the same as the %TIME% variable. - See paragraph "2.7.5.1 Capture of the date and time." on page 35 - Example : "LOG TIME hhmm am/pm" -þ LOG Rst - Modification of the implicit report written in the LOGBOOK. This - value is used for the report sent and the report received. -H HE- -H HE- Description and use of TPK functions. 49 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Example : "LOG RST 55" -þ LOG Prn @xxx@yyy@zzz@ - Modification of the printer initialisation string. This string - is sent at every printing of the LOGBOOK request. The printer - must print 124 characters on a line. So you must programme it to - do this. - The values must be given in decimal and separated by the "@" - character. - Example to set an EPSON printer in 15 cpi: - "LOG PRN @27@64@27@103@" -þ LOG ? - Displays the implicit values used for the LOGBOOK. - Example : "LOG ?" E--GE-2.10 OTHER FUNCTIONS.GE-HE-HF- E--GE-2.10.1 Access to DOS function.GE-HE-HF- -Access to DOS by remaining in TPK is possible. -þ Either by : it jumps to the DOS screen and to return back - to TPK type "EXIT" -þ Or by the "SHell" command : in this case, a DOS command and its - parameters can be passed. - Eg: "SH dir b:*.*" - Return to TPK occurs after execution of this command. -The receive buffer is offen a big memory consumer: it can be -temporarily saved on disc or in XMS/EMS memory before starting up a -programme which has no probleme using the now free memory. -(See command "BUFFER" paragraph "4.1 Local commands." on page 59) -HE-Note: HF-The "SHell" command without parameter is equal to the -key. -H HE- -H HE- Description and use of TPK functions. 50 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.10.2 Keyboard management.GE-HE-HF- -The keyboard management principle is very simple: TPK analyses what -has been entered after the validation. If it recognises a -command, it will carry out it, otherwise everything is sent to the -TNC.Certain commands are interpreted by TPK before being sent to -the TNC, eg: the "Connect" and "MYcall" commands. You will get the -reply from TPK and from the TNC ! -The characters that you enter with the keyboard are displayed in -the "keyboard-entry" window at the bottom of the screen. -The line can then be edited and dealt with in several ways. -A circular buffer keeps the last 20 commands entered on TPK in -memory (including remote commands). This buffer is edited by the - which leeds back to the preceding command and by the - which moves on the following command in the buffer. -The keyboard-entry can then be corrected by using the classic -deletion, insertion keys. The presentation can be improved through -use of the text justification ("Justifie" command and key) -and the word wrapping ("COUpure" command). -The "COUpure NbCol" command limits the current lenght to NbCol -maximum columns. The text is cut at the last space before this -column and the word in the process of being entered is sent on to -the following line. This mean a message can be entered on a BBS -without worrying about line returns. (NbCol=40 to 79) -The "Justifie NbCol" command justifies the text entered on NbCol -columns. When the text entered with the keyboard reaches the NbCol -column, the word currently being entered is sent to the following -line and the line in progress is centered on the NbCol columns. Its -use is the same as the "Coupure" command. (NbCol=40 to 79) -The key is a command which autorises justification of the -text or not.(flip-flop) E--GE-2.10.3 Reconnection function.GE-HE-HF- -A connection request is of course transmitted to the TNC, but is -also managed by TPK: the callsigns passed into the TNC are -memorised and if this connection does not result, it is possible to -relaunch it by typing . -However, when a station is connected to you, and a premature -disconnection takes place, you can simply hit to relaunch a -new connection. -H HE- -H HE- Description and use of TPK functions. 51 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-2.10.4 QSO messages function.GE-HE-HF- -You can prepare 10 "MESSAGEn.TPK" files which will be used during a -packet QSO. These files will be sent to your correspondent by the - key where "n" is the number appearing in the message name -( to ). -These files can be a welcome message or they will eg. describe the -station or any other text in current use. They can be created with -any text editor. E--GE-2.10.5 Printing function.GE-HE-HF- -Printing can be put into service by the or keys. -The receive buffer can be written on the printer by pressing the - key. Be careful the buffer, if full, can be very long to -print. Hit to stop ! E--GE-2.10.6 Miscellaneous.GE-HE-HF- E--GE-2.10.6.1 Warning bells.GE-HE-HF- -þ "SOnnerie ON|OFF" - Ring on connection (telephone type bell !) -þ "ALArme F6XYZ" or "ALArme F6XYZ-n" - Bip-Bip each time the F6XYZ or F6XYZ-n (n is the SSID from 1 to - 15) appears in the traffic window in the disconnected mode. -þ "ALArme F6XYZ-*" - Bip-Bip on the F6XYZ callsign whatever the SSID (F6XYZ, F6XYZ-1, - F6XYZ-2, etc). -þ "BELL ON|OFF" or key. - Deletion or authorisation of the bip sent out by - inserted in the message text you receive on the screen. When the - command is active ("BELL ON"), the bells are replaced by the - ASCII character number 14 (musical note). This deos not concern - the connection bell, which is operated by the command - "SOnnerie". The key does the same function in a - flip-flop mode. It's status is displayed a the bottom of the - screen (Bell led). -þ "/OPE" -H HE- -H HE- Description and use of TPK functions. 52 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - This remote command is to be used by your correspondent during a - QSO to call you: a bell is triggered off on your PC to attract - your attention. An execution report is sent to your - correspondent. E--GE-2.10.6.2 Serial port management.GE-HE-HF- -Here are the TPK commands which enable serial port configuration. -þ "FLux 0|1|2" - Flow control between the computer and the TNC by: - - 0 : DSR - - 1 : CTS - - 2 : DSR + CTS - HE-Note: HF-Identical to the parameter of TPK.CFG -þ "Vitesse 1200|4800|9600|19200|38400|57600|115200" - Modification of the serial port speed with the TNC. -þ "PORT n[?|address IRQ] - Change of serial port or addresses and IRQs of the serial - interface. - (See paragraph "5.1.2 Configuration of the serial port." on page - 71) -þ - Displays a little window (in the main screen only) giving the - status of the RS232 line (in the connected or disconnected - mode). - (See paragraph "5.1.1 Connection between TNC and PC." on page - 70) -þ "TNCINI" - Unbalances a TNC in 8 bits without parity. TPK sends a in - every possible combination of bit numbers and parity, until the - "cmd:" prompt of the TNC is obtained. This command allows - putting back a TNC, whose configuration of the serial interface - is unknown, in a state of dialogue with TPK. -HE-Note: HF-The TNC command "XFLOW" must be "OFF" in order that the -hardware flow control will be used between the the computer and the -TNC. -H HE- -H HE- Description and use of TPK functions. 53 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -(See paragraph "5.1.2 Configuration of the serial port." on page -71) E--GE-2.10.6.3 Use of external drivers.GE-HE-HF- -þ "G8BPQ ON|OFF" - Validates the use of the G8BPQ driver. The serial port number in - TPK.CFG must correspond to the one you wish to use in the - driver. - (See paragraph "5.1.4 Use of an external driver." on page 73) -þ "INT14 ON|OFF" - Validates the use of an external bios INT14H driver like COMBIOS - of WA7MBL, MBBIOS of AA4RE or ESS (version 1.10 or higher) from - FC1EBN ! - (See paragraph "5.1.4 Use of an external driver." on page 73) E--GE-2.10.6.4 Passage into direct terminal mode.GE-HE-HF- - key allow passage into a mode where TPK is almost -transparent. Everything typed on the keyboard is sent directly to -the TNC, including the programmable function keys and -macro-commands. This command enables trafficking in other modes -than packet, eg. in RTTY, AMTOR, etc, for the TNCs which -incorporate this possibility like the PK232 or the KAM. -Be careful using this possibility which can be interpreted in an -unforeseen way by TPK ! -H HE- -H HE- Description and use of TPK functions. 54 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-3.0 TPK FUNCTION KEYS.GE-HE-HF- E--GE-3.1 FUNCTION KEYS TO GE-HE-HF- -þ : help for ALT keys. - (See paragraph "5.3.1.2 The ALT keys help." on page 81 and - paragraph "3.2 to keys." on page 56) -þ : lists the stations heard and the last connections. Return - by typing any key or automatically after 30 seconds. - (See paragraph "2.2.1 MHEARD." on page 12) -þ : access to DOS while remaining in TPK. Return to the - programme by typing "EXIT" - (See paragraph "2.10.1 Access to DOS function." on page 50) -þ : starts or stops printing traffic. It's equivalent to - . - (See paragraph "2.10.5 Printing function." on page 52) -þ : command allowing or not your correspondent access to your - disc (remote commands). - (See paragraph "2.5 Remote commands." on page 14 and paragraph - "6.1 The TPK.CFG file." on page 90) -þ : forces the TNC into the command mode by sending a "break" - onto the serial line. The "cmd:" prompt of TNC is displayed. you - can then pass a command to the TNC, which will be interpreted as - such and not as text to be sent. (To be used in connected mode) - (See paragraph "2.7.2 Programming of function keys." on page 30 - example of the SHIFT-F3 key programming) - HE-Note: HF-Don't mix this up with the key. -þ : in the main screen and in the connected mode, allows - passage of a TPK command which will be interpreted as a command - and not a text to be sent. Eg. the TPK command "/SEND" can be - used to send a file. - The key displays the "TPK>" prompt in the keyboard-entry - window. - Don't mix this up with the key. -þ : the sending of a connection request with the preceding - connection parameters, memorised by TPK. -H HE- -H HE- TPK function keys. 55 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - (See also paragraph "2.10.3 Reconnection function." on page 51) -þ : sending a disconnection request. -þ : the key send the contents of the keyboard-buffer - without the . E--GE-3.2 TO KEYS.GE-HE-HF- -þ : allows using other modes than packet. - (See paragraph "2.10.6.4 Passage into direct terminal mode." on - page 54) -þ : deletion/authorisation of bells brought about by - inserted into the text received on screen. This is a - flip-flop command and is equivalent to the "BELL" command. - (See paragraphs "2.10.6.1 Warning bells." on page 52 and "4.1 - Local commands." on page 59) -þ : erases the traffic window from the main screen in - connected or disconnected mode. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ : sends the TNC command "DAytime" to the TNC. This - function is automatically carried out by TPK at the launch of - the programme. - (See also paragraph "2.7.5.1 Capture of the date and time." on - page 35 for an example of DAytime macro-command) -þ : file(s) transmission menu. - (See paragraph "2.6.5.3 File(s) transmission menus " on - page 27) -þ : erases the monitor window on the main screen in - connected and disconnected mode. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ : set the display in 8 or 7 bits. -þ : TPK on-line help. - (See also , paragraph "3.1 Function keys to " on - page 55) -þ : start/stop the printer. Identical to key . -H HE- -H HE- TPK function keys. 56 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - (See paragraph "2.10.5 Printing function." on page 52) -þ : activation/de-activation of the text justification. - Linked commands: "Justifie", "COUpure" - (See paragraph "2.10.2 Keyboard management." on page 51) -þ : access to the messages listings. - (See paragraph "5.3.1.7 The message listing screen." on page 85) -þ : enables quitting the KISS mode if it was active. -þ : displays list of macro-commands. - (See paragraph "2.7.3 Macro-commands." on page 32) -þ : print the receive buffer. - Associated keys: and - (See paragraphs "2.3 BACKSCROLL." on page 13 and "2.10.5 - Printing function." on page 52) -þ : file(s) receiving menu. - (See paragraph "2.6.5.2 File(s) reception menus " on page - 26) -þ : opening or closing the CAPTURE mode. - (See paragraph "2.4 CAPTURE mode." on page 14) -þ : displays the list of programmable function keys. - (See paragraph "2.7.2 Programming of function keys." on page 30) -þ : displays the status of the RS232 line in a small - window. - (See paragraph "5.1.1 Connection between TNC and PC." on page - 70) -þ : writing of the receive buffer in a file. - Associated keys: and - (See paragraph "2.3 BACKSCROLL." on page 13) -þ : to leave the TPK programme and return to DOS. -þ : erase the receive buffer. -H HE- -H HE- TPK function keys. 57 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Associated commands: and - (See paragraph "2.3 BACKSCROLL." on page 13) -þ to : send into the QSO the contents of the - messages of current useage. These files are called - "MESSAGEn.TPK" (n from 0 to 9) and are sent by pressing the - key. - (See paragraph "2.10.4 QSO messages function." on page 52) -H HE- -H HE- TPK function keys. 58 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-4.0 SYNTAX OF TPK COMMANDS.GE-HE-HF- E--GE-4.1 LOCAL COMMANDS.GE-HE-HF- -þ ALA F6XYZ[-n]|F6XYZ-*|F6XYZ - A bell sounds each time F6XYZ-n is received. - (See paragraph "2.10.6.1 Warning bells." on page 52) -þ At Time Command - Programmation of a command at a determined time. format of the - time is: hour and minutes placed side by side (eg: 1215=12H15). - Command is a command of TPK or a macro-command, etc. -þ At Time - This lists the programming at the stated time if it exists. -þ At - Lists all the programmings. - (See paragraph "2.7.5 Other commands useful in programming." on - page 35) -þ ATTente Duration Event - Awaits an event for a maximum of seconds "Duration". The command - ends as soon as "Event" happens. - "Event" can be: - - CNX for a connection. - - DCNX for a disconnection. - - A string ending a line of text received (Syntax: ATT Text). - - A string anywhere in a line of text received (Syntax: ATT - "Text"). - - PASSWORD for a password question. - (See paragraph "2.7.5.4 Password management." on page 38) - If the time period runs out and the awaited event has not taken - place, the execution of the macro-command or the programme-file - is abandonned. -þ ATTente Duration -H HE- -H HE- Syntax of TPK commands. 59 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Pause for "Duration" seconds. - (See paragraph "2.7.5.3 Programming a waiting period." on page - 37) -þ BELL ON|OFF - Deletion/Authorisation of the bip sent out by a - inserted in the text received. The key can be used for - the same function). - (See paragraph "2.10.6.1 Warning bells." on page 52) -þ BUFFER [nnnn] - Receive buffer size. - You can change the number of lines in the receive buffer with - the command BUFFER. - nnnn is the number of lines you want. - TPK keeps a minimum of 50kb free to allow a SHELL to DOS. With - this value you can only execute DOS internal commands. To free - more memory you must reduce the number of lines or swap the - buffer to disk ..See command "SWAP". - Ex: BUFFER 1000 -þ CHat NbLines - On the main screen, Nblines is the number of lines in the - traffic window measured from the top of the screen.NbLines mini - is the greatest value between FE and FC+3. NbLines maxi is the - number of lines on the screen minus 4. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ COMmente [x:\path\]FileName.Ext - Adds to the DIRC.TPK file a commentary about the file given in - the parameter. TPK asking you the commentary in a window. - (See paragraph "2.5.2 Commented directory." on page 16) -þ COUpure NbCol - Break in text entered with the keyboard from the number column - NbCol.Associated commands: and Justifie - (See paragraph "2.10.2 Keyboard management." on page 51) -þ ECHOTpk Text -H HE- -H HE- Syntax of TPK commands. 60 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - When a programme-file is being carried out, the Text is - displayed in the traffic window as a commentary. - (See paragraph "2.7.4 Programme files." on page 33) -þ EDITOR x:\path\editor.exe - Initialises the editor which can be called from the message - editor. You must give the full path to this programme, TPK will - test its presence. - Ex: EDITOR C:\UTIL\Q.EXE - (See paragraph "5.3.1.8 The message editor screen." on page 86) -þ EFAt Time - Cancellation of a programming. Associated command: At. - (See paragraph "2.7.5 Other commands useful in programming." on - page 35) -þ EFLogrx - Erases the list of stations heard. - (See paragraph "2.2.1 MHEARD." on page 12) -þ EFMacro Macro-Command-WordKey - Erases the macro-command WordKey. Associated commands: "EMacro", - "Macro", "MEMorise", "WordKey" - (See paragraph "2.7.3 Macro-commands." on page 32) -þ EMacro Macro-Command-WordKey - Edition of a macro-command. Associated commands: "MEMorise", - "EFMacro", "Macro", "WordKey" - (See paragraph "2.7.3 Macro-commands." on page 32) -þ EXecute Filename - Launches the execution of a programme-file. - (See paragraph "2.7.4 Programme files." on page 33) -þ EXIT - To leave the DOS window and return to TPK. - (See paragraph "2.10.1 Access to DOS function." on page 50) -þ FChat NbLines -H HE- -H HE- Syntax of TPK commands. 61 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Initialises the height of the monitoring window in the connected - mode if "RXblock" and "MCon" are ON. NbLines mini is 3 and - NbLines maxi is value of CHat minus 3. - HE-Note: HF-This mode is ONLY available with the TNC2. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ FEnetre F6XYZ-n - In the disconnected mode, sends all the F6XYZ-n packets in the - monitor window of the main screen (FENETRE=WINDOW). - (See paragraph "5.3.1.3 The main screen." on page 81) -þ FEnetre NbLines - Establishes the height of the main screen monitor window in the - disconnected mode. NbLines mini is 3 and NbLines maxi is the - value of CHat minus 3. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ FEnetre "Text" - In disconnected mode, this send all the packets whose the - callsign headers contain Text, into the monitor window. Text is - made visible in the division bar under this window. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ FEnetre - FEnetre without parameter disable the monitor window in - disconnected mode. -þ FIN - Return to DOS (end of programe) the same as key - (FIN=END). -þ FLux 0|1|2 - Flow control between the computer and the TNC: - - 0 : DSR - - 1 : CTS - - 2 : DSR + CTS - Values are the same as the corresponding parameter of TPK.CFG - (See paragraph "2.10.6.2 Serial port management." on page 53 and - paragraph "5.1.1 Connection between TNC and PC." on page 70) -H HE- -H HE- Syntax of TPK commands. 62 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ FREquence xxxxxx - This modifies the frequency indicated in the LOGBOOK and on the - main screen bar under the traffic window. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ FREquence 1|2 xxxxxx - With a KAM or another KANTRONICS TNC, equipped with several - radio ports, there is validation of the use of 2 frequencys - balanced by the "STREAM SWITCH" - (See paragraph "5.2.4 Use of TPK with a KAM." on page 78) -þ G8BPQ ON|OFF - This validates the use of the G8BPQ driver. The serial port - number in TPK.CFG must correspond to the one you wish to use in - the driver. - (See paragraph "5.2.3 Starting." on page 76) -þ Init - Initialise TPK from the parameters of the CONFIG.TPK file. This - is also done at the launch of TPK. -þ Init n - Initialise TPK from the parameters of the file CONFIG-n.TPK - n between 0 and 9. - (See paragraph "5.2.3 Starting." on page 76) -þ Init Filename - Launches the execution of the contents of the file Filename. - (See paragraph "5.2.3 Starting." on page 76) -þ INT14 ON|OFF - Validates the use of an external serial driver like COMBIOS by - WA7MBL, MBBIOS by AA4RE or ESS by FC1EBN. - (See paragraph "5.1.4 Use of an external driver." on page 73) -þ Justifie NbCol - This provides justification of the text on NbCol columns. When - the text entered on the keybord reaches the column, the word in - the process of being entered is carried to the following line - and the line is centered on the columns (NbCol between 40 and -H HE- -H HE- Syntax of TPK commands. 63 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - 79). - Associated commands: , COUpure - (See paragraph "2.10.2 Keyboard management." on page 51) -þ LANGuage [LANGUAGE] - Language change. - The command LANGuage allows you to change the language used by - TPK, where LANGUAGE is the name without extension of a .LNG - file. - You will find ENGLISH.LNG and FRANCAIS.LNG already included with - TPK. - Eg: LANG ENGLISH -þ LOG ON|OFF - Validation of the LOGBOOK. - (See paragraph "2.2.2 LOGBOOK." on page 12) -þ Macro WordKey - Launches the macro-command picked out by its WordKey. The - combination of WordKey is equivalent to the Macro command. - Associated commands: "EMacro", "EFMacro", "MEMorise", - "WordKey" - (See paragraph "2.7.3 Macro-commands." on page 32) -þ MCon ON|OFF - Activates or disactivates the main screen monitor window in the - connected mode. RXblock MUST also be ON. - HE-Note: HF-This mode is ONLY available with the TNC2. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ MEMorise WordKey Command - Stores in memory and on disc the macro-command WordKey with the - command which will be assiciated to it. Associated commands: - "EMacro", "Macro", "EFMacro", "WordKey" - (See paragraph "2.7.3 Macro-commands." on page 32) -þ MODEDIR [1|2|3|4] - Display mode of the /DIR command. -H HE- -H HE- Syntax of TPK commands. 64 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H HF- - ÚÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ - ³ Parameter ³ /DIR Local ³ /DIR Remote ³ - ÃÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄ´ - ³ 1 ³ 1 column ³ 1 column ³ - ³ 2 ³ 2 columns ³ 2 columns ³ - ³ 3 ³ 1 column ³ /DIRC ³ - ³ 4 ³ 2 columns ³ /DIRC ³ - ÀÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÙ HF- -þ PATH - Gives the TPK directory. -þ PORT n [?|ADDRESS IRQ] - Change of serial port or addresses and IRQs of serial - interfaces. Associated commands: "Vitesse", "FLux" - (See paragraph "5.1.2 Configuration of the serial port." on page - 71) -þ REPrise ON|OFF - Authorisation or deletion of the crash recovery of BINARY - transfers (ON by defalut). - (See paragraph "2.6.4 Recovery of an abandonned transfer." on - page 25) -þ RXblock ON|OFF - Validates the block mode of the TNC2. Allows the monitoring - window in the connected mode. Works ONLY with the TNC2. - Associated command: "MCon" - (See paragraph "5.3.1.3 The main screen." on page 81) -þ SHell [Command [Parameters]] - Access to DOS screen. return to TPK at the end of the command. - If there is no command this function is equivalent to the - key. - (See paragraph "2.10.1 Access to DOS function." on page 50) -þ SOnnerie ON|OFF - Validate the telephone type bell at each connection. - (See paragraph "2.10.6.1 Warning bells." on page 52) -þ SUpcr ON|OFF - In the main screen and in the disconnected mode, there is either - deletion or no deletion of a possible sent systematically -H HE- -H HE- Syntax of TPK commands. 65 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - at the end of each information packet by the TNC2. This allow - correct display in the monitoring window. - (See paragraph "5.3.1.3 The main screen." on page 81) -þ SWap [ [|XMS|EMS]] - Swapping the receive buffer during a DOS SHELL. - Get more memory during a SHELL by swapping the receiving buffer - to disk or to extended/expanded memory. - Examples: - - SW ON E:\TMP - To swap the buffer into the TMP directory of disc E: - - SW ON XMS - To swap the buffer into extended memory. - - SW ON EMS - To swap the buffer into expanded memory. - - SW OFF - To disable swaping. -þ Touche Sn|Cn|An [Text_Of_The_Key] - Function keys (from 1 to 10) either associated with the - key, the key or the key. These 30 keys are - programmable. - Complete description paragraph "2.7.2 Programming of function - keys." on page 30 -þ TNCIni - Put TNC in 8 bits mode without parity. - (See paragraph "2.10.6.2 Serial port management." on page 53) w -þ Vitesse [1200|4800|9600|19200|38400|57600|115200] - Modification of the serial port speed. Associated commands: - "PORT", "FLux" - (See paragraph "2.10.6.2 Serial port management." on page 53 et - paragraph "5.1.2 Configuration of the serial port." on page 71) -H HE- -H HE- Syntax of TPK commands. 66 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-4.2 REMOTE COMMANDS.GE-HE-HF- -When a correspondent is connected to you and is using one of these -commands, he RECEIVE in return some information or CARRIES OUT a -command. -(See paragraph "2.5 Remote commands." on page 14) -þ /BYE - Disconnect: TPK sends a disconnect request to the TNC which is - equivalent to the key in local. -þ /AIDE - Sends contents of the file AIDE (AIDE=HELP) which gives the - syntax of the remote commands. This file is a small text which - you can personalise as you wish, but TPK must find it in the TPK - directory at its launch, otherwise you will have an error - message. -þ /CHDIR or /CD - Change the current directory. If the system is closed, you - cannot get up into the tree above the directory for sending - files and your correspondent is limited to this directory or its - subdirectories. Associated command: - (See paragraph "3.1 Function keys to " on page 55) -þ /DIR [x:[\PATH\[FileName.Ext]]] - Lists the contents of a directory. If teh system is closed he - receives the contents of the directory where you are locked - into. - (See paragraph "2.5 Remote commands." on page 14) - The presentation of the directory list can be changed with the - "MODEDIR" command. - (Details paragraph "4.1 Local commands." on page 59) -þ /DIRC [Criterion] - Commented lists of files available on you discs. The criterion - lets you choose a field of interest. This command sends the - contents of the DIRC.TPK file. - (See paragraph "2.5.2 Commented directory." on page 16) -þ /DISK - He receives the name of the current disc. -H HE- -H HE- Syntax of TPK commands. 67 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ /DISK x: - He changes the current disc of your computer unless the system - is closed in which case this command has no effect. -þ /EX - Enables closure of a message (equivalent to ). -þ /FREE - He receives the the number of free bytes on your disc. -þ /FREE x: - He receives the number of free bytes on your disc x: unless the - system is closed. -þ /HELP - The remote caller receives a help text reminding them of the - list of commands. -þ /LOG - He receives your list of stations heard. -þ /MSG - Allows your correspondent to leave a message. - (See paragraph "2.8 The BROADCAST function." on page 40) -þ /OPE - A bell is triggered off on your computer by your correspondent - in an attempt to lift you out of you lethargy ! - (See paragraph "2.10.6.1 Warning bells." on page 52) -þ /SEND [x:]FileName[.Ext] [Y|A|T|E] - ASCII file or BINARY file transfer. - - Y : YAPP - - A : ASCII with the TNC in CONVERS mode - - T : ASCII with the TNC in TRANS mode - - E : ASCII without echo in the TPK traffic window. - - TE : ASCII without echo and with the TNC in TRANS mode. -H HE- -H HE- Syntax of TPK commands. 68 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - In local, "/SEND" allows the sending of an ASCII file to the - TNC, eg. to configurate it. Eg: "/SEND TNC2.SET" - (See paragraphs "2.5 Remote commands." on page 14 and "2.6 File - transfers." on page 19) -The following commands can just as easily be carried out in local -(you can type them on your keyboard): -HF-/DIR /DIRC /OPE /DISK /FREE /LOG /HELP /SEND /CHDIR /CD HF- -H HE- -H HE- Syntax of TPK commands. 69 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-5.0 CONFIGURATIONS AND SETTING UP OF TPK.GE-HE-HF- E--GE-5.1 THE SERIAL PORT.GE-HE-HF- E--GE-5.1.1 Connection between TNC and PC.GE-HE-HF- -The RS232 connection must be pin to pin in the case of a TNC -equiped with a 25 pin plug. This wiring is valid for the TNC2 and -the PK232. In general, you can get away with using the wiring shown -as "complete wiring" in the TNC documentation and which is -recommended for the BBS type WA7MBL, etc. HF- - PC TNC PC Tiny-2 -GND 1 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1 1 and 7 ÄÄÄÄÄÄÄÄÄÄ 5 -TXD 2 Ä>ÄÄÄÄÄÄÄÄÄÄÄÄÄ>Ä 2 2 Ä>ÄÄÄÄÄÄÄÄÄÄÄÄ>Ä 3 -RXD 3 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 3 3 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 2 -RTS 4 Ä>ÄÄÄÄÄÄÄÄÄÄÄÄÄ>Ä 4 4 Ä>ÄÄÄÄÄÄÄÄÄÄÄÄ>Ä 7 -CTS 5 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 5 5 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 8 -DSR 6 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 6 6 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 6 -GND 7 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 7 -DCD 8 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 8 8 Ä<ÄÄÄÄÄÄÄÄÄÄÄÄ<Ä 1 -DTR 20 Ä>ÄÄÄÄÄÄÄÄÄÄÄÄ>Ä 20 HF- -In the case of the TNC2, the DTR signal (pin 20) is used by the TNC -for the flow control with the computer, but generally, it is the -RTS signal which plays this role. TPK uses both signal: when its -reception buffers are full, or when it is out of time in dealing -with the received signals (in the case of SHell to DOS for -example), it puts these two lines to the zero logic level and the -TNC stops sending characters onto the RS232 line, if it is -correctly parametered, eg. by "Xflow OFF" -One of the TPK.CFG parameters is also concerned with the flow -control, but it concerns another sense of the RS232 link. CTS is -the signal used by the TNC to tell the computer to stop sending -datas on the line. TPK reads their value before sending characters -to the TNC. You can tell it also to keep an eye on the DSR signal: -that is the aim of the parameter in TPK.CFG. -In the main screen, by typing , you can make these signals -visible so that they can be seen by TPK via the serial interface -UART registers. -The DCD signal of pin 8 is the one which will undoubletedly have -caused most difficulties to many OMs in starting up TPK. Indeed -this signal has been ignored on certain TNCs like the TINY-2. -H HE- -H HE- Configurations and setting up of TPK. 70 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -However DCD is VERY important because it is this signal which -indicates whether the TNC is connected or not, from the AX25 point -of view, in the TNC2s equipped with the TAPR software or commercial -TNCs, just for TPK. According to the TNC, this signal is either -quite simply "empty", or pulled at the +5V through a resistance, or -is directly cabled together on the SIO of the TNC, ie. at a TTL -level instead of the RS232 level. -Generally, the DCD at the TTL level works perfectly well if your -serial card accpets this kind of level as opposed to RS232. This is -the case with cards of Asian origin ! Conversely, it doesn't work -with IBM cards, because they must have the right levels. -In the case where the DCD is not connected or linked up to +5V, you -can at first link it up directly to pin 25 of the SIO. This -modification will take you the same level as the TNC whose signal -is at the TTL level and will work in many cases. -The best thing to do is to make the substitution properly, so that -it will require mounting of a simple transistor on the TNC card, as -recommended by Paccomm for his TINY-2. This will result in proper -interfunctionning of TPK/TNC. You will find the diagram in the -CONNECT.TXT file. - also gives the state of this DCD line. It must be at zero -when the TNC is not connected into AX25. This line reflects the -state of the CON LED, it is connected to the same place. -For a TNC2, programme either DSR+CTS or CTS with the help of the -FLux command or in TPK.CFG. For KANTRONICS TNCs use CTS. -TPK, from the moment it starts up, warns you through a message if -these signals are not valued and moves into the functionning mode -without access to the serial interface. The key in the main -screen allows you to check the state of these signals thanks to the -UART register. E--GE-5.1.2 Configuration of the serial port.GE-HE-HF- -The TNC can be linked up to the choice of COM1 to COM8 -TPK implicit speed is fixed in TPK.CFG. The "Vitesse" command -allows you to change that speed from 1200 to 115200 bauds. -To get optimum file transfer functionning you must maintain a speed -higher than that of the radio link between the TNC and the -computer. A PC XT with a 4.77MHZ clock works weel at 9600 bauds -with TPK. -To change the serial port towards the TNC, type "PORT n" with n -from 1 to 8. -The serial port parameters begin by having the standard MSDOS -values, ie: -H HE- -H HE- Configurations and setting up of TPK. 71 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ COM1 (and COM5) address=3F8 IRQ=4 -þ COM2 (and COM6) address=2F8 IRQ=3 -þ COM3 (and COM7) address=3E8 IRQ=4 -þ COM4 (and COM8) address=2E8 IRQ=3 -You can modify all these parameters with an editor in the TPK.CFG -file or in TPK with the "PORT" command: -þ PORT - Gives the port used by TPK. -þ PORT n - Allocates the n port in TPK. -þ PORT n ? - Gives the address and IRQ of n port: - Eg: "port 1 ?" must give "Address:3F8 IRQ4" (if it has not been - previously modified !!) -þ PORT n adr irq - Modifies the address and the IRQ on the n port (adr is in - hexadecimal and irq between 2 and 5) - HE-Note: HF-This command with these parameters does not modify the - port used by TPK, but ONLY its address and IRQ. - Eg: "PORT 4 370 4" moves the hexadecimal address 370 to port 4 - and selects IRQ 4. E--GE-5.1.3 Configuration for IBM serial cards.GE-HE-HF- -Parameters to use for TPK with an IBM serial card, equipped with -additional ports COM3 to COM8: -þ COM3 address 12832 (decimal) | -þ COM4 address 12840 (decimal) | -þ COM5 address 16928 (decimal) | COM3 to COM8 IRQ3 -þ COM6 address 16936 (decimal) | -þ COM7 address 21024 (decimal) | -þ COM8 address 21032 (decimal) | -H HE- -H HE- Configurations and setting up of TPK. 72 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Information given by JEAN-CLAUDE FC1RZA. E--GE-5.1.4 Use of an external driver.GE-HE-HF- -Two kinds of external drivers can be used in TPK: COMBIOS by WA7MBL -(COM1BIOS or COM2BIOS), MBBIOS by AA4RE, ESS by FC1EBN (TPK command -INT14) or the G8BPQ driver (TPK command G8BPQ). -Putting the INT14 or G8BPQ command in the TPK.CFG file is enough to -validate the chosen external driver. -Certain commands become ineffectual in the case of these drivers, -as for example the modification of addresses, serial port IRQs or -the speed in the case of the G8BPQ driver. -(See paragraph "2.10.6.3 Use of external drivers." on page 54) -The functionning must be correct with COMBIOS or MBBIOS but the -G8BPQ support is only in the test stage and many TPK functions -don't work with it. E--GE-5.2 SETTING UP TPK.GE-HE-HF- E--GE-5.2.1 Decompression.GE-HE-HF- -Originally, the TPK software is provided in compressed from: this -is a guarantee of receiving all the files, and not "bits and -pieces" ! -You must have (nnn: version number): -þ TPKnnn-1.ZIP containing TPK.EXE and all configuration files. -þ TPKnnn-2.ZIP containing the french documentation files. -þ TPKnnn-3.ZIP containing the french on-line help files. -þ TPKnnn-4.ZIP containing the english documentation files. -þ TPKnnn-5.ZIP containing the english on-line help files. -þ TPKINST.EXE the installation and configuration programm. -þ TPKCRC List of the .ZIP files with CRC. -To decompress the files you must run TPKINST which will create all -the directories needed and modify the TPK.CFG file with the -informations you have given. -H HE- -H HE- Configurations and setting up of TPK. 73 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-5.2.2 List of TPK files.GE-HE-HF- -Here is the list of TPK files after decompression. -Contents of TPKnnn-1.ZIP: -þ AIDE File sent in response to /AIDE -þ CONFIG.TPK Commands to be carried out at the beginning of TPK. -þ CONFIG-1.TPK Other configurations which can be used -þ CONFIG-2.TPK with the "Init n" command. -þ CONFIG-X.TPK Commands to be carried out a the end of TPK. -þ DIRC.TPK Commented directory. -þ EXECAUTO.TPK Authorised DOS remote commands. -þ MESSAGE1.TPK Message to be sent with -þ MESSAGE2.TPK Message to be sent with -þ FRANCAIS.LNG The french texts. -þ ENGLISH.LNG The english texts. -þ TPK.CFG TPK configuration file. -þ TPK.DIR The macro-commands. -þ TPK.KEY The function keys. -þ TPK.EXE The programme itself. -þ TPK_COMP.EXE The (de)compression programme for FBB forward. -þ CVTDOC.COM The conversion programme for TPKDOC.IBM -þ LBBS Example of programme file (list of messages). -þ RBBS Example of programme file (read messages). -þ TNC2.SET Reference config for TNC2 with eprom 1.1.6 -þ TNC2PMS.SET Reference config for TNC2 with eprom 1.1.6 with - PMS. -þ TNC2-117.SET Reference config for TNC2 with eprom 1.1.7b -þ TNC2118A.SET Reference config for TNC2 with eprom 1.1.8a -þ KAM.ZIP Configuration for KAM. -H HE- -H HE- Configurations and setting up of TPK. 74 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ PK232.ZIP Configuration for PK232 -þ PK232SP.ZIP Configuration for PK232 without batteries. -þ FV142.ZIP Compressed file verbose programme. -Contents of TPKnnn-2.ZIP: -þ COULEURS Type "COULEURS" to display the range of colours. -þ CONNECT.TXT DCD modification for TINY-2 by Paccomm (english) -þ TPKDOC.IBM The french documentation format IBM Graphics. -þ CVTDOC.COM The ESC characters conversion programme for - TPKDOC.IBM -þ CVTDOCTY.COM The IBM specific characters conversion programme. -þ TPKDCD.DOC Use of the DCD signal by TPK (french). -Contents of TPKnnn-3.ZIP: -þ TPK.HLP The on-line help (french). -þ FBB.HLP BBS F6FBB on-line help (french). -þ TNC2117.HLP TNC2 v 1.1.7 on-line help translated by F6BXM - (french). -þ CLUSTER.HLP The packet cluster on-line help (french). -Contents of TPKnnn-4.ZIP: -þ CONNECT.TXT DCD modification for TINY-2 by Paccomm (english) -þ TPKDOC.IBM The englich documentation format IBM Graphics. -þ CVTDOC.COM The ESC characters conversion programme for - TPKDOC.IBM -þ CVTDOCTY.COM The IBM specific characters conversion programme. -þ TPKDCD.DOC Use of the DCD signal by TPK (english). -Contents of TPKnnn-5.ZIP: -þ TPK.HLP The on-line help (english). -þ FBB.HLP BBS F6FBB on-line help (english). -þ TNC2117.HLP TNC2 v 1.1.7 on-line help (english). -þ CLUSTER.HLP The packet cluster on-line help (english). -H HE- -H HE- Configurations and setting up of TPK. 75 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-5.2.3 Starting.GE-HE-HF- E--GE-5.2.3.1 First attempts.GE-HE-HF- -You can make your first attempt with TPK without the TNC, and even -without the serial interface. -Type TPK : you must first of all get a welcome screen while TPK -introduces all its parameters and reads its files, then an error -message informing you that it has not found the serial port or the -TNC. It's normal if the TNC is not on-line. As requested, type a -key to continue. If you don't type any key, the programme sequence -will continue after a temporisation of some seconds. -The error message which has been generated by the DSR and CTS -signals test corresponds to the flow control parameter of TPK.CFG. -You can now try to mess about with the commands and keys in such a -way a to see if everything is going as it should with your computer -and that there is no incompatibility (display, keyboard, etc). E--GE-5.2.3.2 First time starting.GE-HE-HF- -Some advice: to get off to a good start, do not hesitate to go back -to a total erasure of the RAm of your TNC. To do this, cut off the -TNC supply, remove the RAM and put it on a piece of conducting moss -or on a piece of aluminium paper for a few minutes. Then put it -back in place. -It's amazing that this little trick can save you so much time. Also -think about it if your TNC musteriously lacks in later. -You must now check the TNC configuration which must be conducted -according to the instructions in paragraph "5.1.2 Configuration of -the serial port." on page 71 -Rememeber: the programme startup is carried out from what is -located in TPK.CFG and CONFIG.TPK. Nevertheless, certain commands -such as "PORT", "INT14", "G8BPQ", "Vitesse" authorise a change on -the serial port without leaving TPK. -Eg: it is possible to pass from one TNC in the kiss mode associated -with G8BPQ to another TNC connected to another port without using -an external driver. -After these first attempts, the RS232 line having been established, -the right port having been specified and the TNC having been -supplied with power, get out of TPK (with ) and relaunch it. -If everything goes OK, you will once again find the main screen -with a text display which can be more or less coherent: you don't -have to have an error message ! Otherwise however you must find the -H HE- -H HE- Configurations and setting up of TPK. 76 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -mistake, correct it and relaunch TPK. -There are two classic errors: -þ Error message concerning the serial line: see paragraph "5.2.3.3 - Error messages." -þ Error message concerning a configuration error: check TPK.CFG or - CONFIG.TPK. Don't forget that you must not add or delete lines - to TPK.CFG ! -When all problems have been solved, relaunch TPK and type the -command: -"TNCINI" -This command will send "AW 8", "PAR 0", and "RESTART" to the TNC to -set the correct number of bits and parity, after the cmd: prompt -has been received. -If you did not receive the copyright message from the TNC, retry -this command till you get it. E--GE-5.2.3.3 Error messages.GE-HE-HF- -1.Error access TNC (missing DSR CTS) - This message is given out at the initialisation of the serial - port after the CTS and DSR signal tests and following the flow - control value given in TPK.CFG. - The signals used must be at the logic 1 level. This value can be - checked thanks to the key. - Potential errors are: - þ You have forgotten to put the flow control parameter into - TPK.CFG or you have not chosen the right one. - þ The TNC is not powered. - þ The serial cable is not connected to the computer or to the - TNC. - þ The TNC is not connected onto the right serial port. - þ Your RS232 cable is not correct. -2.Error access UART serial port - A reading/writing test in the UART registers of the serial - interface is carried out at the set-up of the serial driver and - if this test is negative, the port is declared unavailable. -H HE- -H HE- Configurations and setting up of TPK. 77 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - Potential mistakes are: - þ Adrressing the serial port according to the documentation of - your interface card. - þ You have used the command "PORT" with incorrect parameters. -3.ERROR DCD=1 logic (RS232) and TNC is not in the Connected status - ! - The DCD signal from the RS232 line is at the logic 1 level and - TPK has detected that the TNC wasn't connected at the AX25 level. - You can control this state thanks to the key. - (See paragraph "5.1.1 Connection between TNC and PC." on page 70) E--GE-5.2.3.4 Setting up commands.GE-HE-HF- -The "Init" command sets up TPK from the configuration file -CONFIG.TPK parameters. It relaunches TPK set up programme from a -configuration file, as at the beginning of the programme. -The "Init n" command starts up TPK with one of the CONFIG-n.TPK -files (with n between 0 and 9). -The "Init FileName" command starts up the execution of the FileName -contents. Eg. to initialise the TNC with the parameters contained -in the TNC2.SET file (this is a reference file for configuration of -the TNC) type: -þ "I TNC2.SET" -Unlike "EXecute", where the characters are entered in the keyboard -buffer, the commands are directly sent to the TPK interpreter. E--GE-5.2.4 Use of TPK with a KAM.GE-HE-HF- E--GE-5.2.4.1 Setting up.GE-HE-HF- -The KAM.ZIP file contains some configuration files which can be -used with this TNC. To set them up, you only have to decompress -this file in your TPK directory: -Type: "PKUNZIP -O KAM" -You will get the following files: -þ CONFIG.TPK configuration file with commands specific to the KAM. -þ CONFIG-X.TPK configuration file sent at the end of TPK. -H HE- -H HE- Configurations and setting up of TPK. 78 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ KAM.SET a configuration reference, which can be used for example - by comparing its contents with the state of your TNC through a - "DISPLAY" command, or it can be used to initialise your TNC - through the command: "/SEND KAM.SET" E--GE-5.2.4.2 Specific commands for the KAM.GE-HE-HF- -The "FREquence 1|2 xxxxxx" command validate the use of two -frequencies with automatic change by the "STREAM SWITCH" which must -consequently be modified. This command is constructed for the KAM -or for other KANTRONICS type TNCs equipped with several radio -ports. -The following commands are found in the CONFIG.TPK file: -þ STR $F1/$F2 -þ STREAMEV ON -þ FRE 1 14Mhz -þ FRE 2 144675 -Furthermore, each "FRE" command change the TNC onto the -corresponding port. Validation of the "STREAM SWITCH" enables TPK -to change radio port and takes into account a connection arriving -on the port on which it is not at this time. -Eg. if you are on VHF and someone gets connected to you on HF, TPK -will switch the TNC onto HF, validate the connection and change the -frequency for the LOGBOOK. This possibility is only validated when -two frequencies exist and only works, of course, with a TNC -equipped with two radio ports. NOT TO BE USED WITH A TNC2 ! E--GE-5.2.5 Use of TPK with a PK232.GE-HE-HF- -The PK232.ZIP file contains configuration files. Just decompress it -by using the command: "PKUNZIP -O PK232" -You will get the following files: -þ CONFIG.TPK configuration file using commands specific to the - PK232. -þ CONFIG-X.TPK configuration file sent at the end of TPK. -þ PK232SP.ZIP compressed file of the "no batteries" version. - In the case of a "no battery" functionning, decompress this last - file by entering: "PKUNZIP -O PK232SP" -H HE- -H HE- Configurations and setting up of TPK. 79 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - You get will new files: -þ CONFIG.TPK configuration file, in particular containing the - "/SEND PK232.SET" command to initialise the PK232 at each - launch. -þ PK232.SET which contains the total PK232 configuration commands. - It is used for reference, eg. by comparing its contents with the - state of your TNC with the "DISPLAY Z" command, or it can be - used to initialise your TNC by the "/SEND PK232.SET" command. - You can use TPK with a PK232 WITH or WITHOUT batteries. When the - latter is equipped with batteries, its use is the same as a - standard TNC: there are only a few parameters to initialise - again. - If your PK232 has no batteries, it loses its parameters at every - power out and you must restore the lot. The speed having been - lost, you must reinitialise it via the PK232 by sending the "*" - character. When it has been done, TPK immediately sends the - command "DCDCONN ON" to get a correct functionning of the DCD - signal. You then have to send all the PK232 configuration - commands. This is done by launching "CONFIG.TPK" which contains - the appropriate "/SEND PK232.SET" command. - To initialise a PK232 with no batteries, you must use the - special PK232 parameter of the TPK command: - - "TPK PK232" E--GE-5.3 THE DIFFERENT SCREENS.GE-HE-HF- -This paragraph introduces the screens used by TPK: HF- - The on-line help. - The ALT keys help. - The main screen. - The MHEARD screen. - The BACKSCROLL screen. - The DOS screen. - The message lists screen. - The message editor. - The LOGBOOK screen. HF- E--GE-5.3.1 Description of screens.GE-HE-HF- -H HE- -H HE- Configurations and setting up of TPK. 80 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-5.3.1.1 On-line help.GE-HE-HF- -These on line help screens are shown by using the key: the -contents of the TPK.HLP file are displayed. You choose the command -by moving the menu bar onto the heading which interest you and by -validating with or or by clicking your mouse on the - button. - or or clicked by the mouse leaves the chosen -heading or on-line help. - or button offers you the list of help files -available (files *.HLP). -The list of these files is given in the description of the contents -of the TPK compressed files paragraph "5.2.2 List of TPK files." on -page 74. -TPK can also read the help files provided by VK2DHU with its -excellent PAKET programme. -Return to TPK is automatic one minute after the keyboard has been -used, or immediately by . -These help files are ASCII text files that you can modify with your -favorite editor (see details paragraph "6.5 The on-line help -files." on page 93). E--GE-5.3.1.2 The ALT keys help.GE-HE-HF- -This on-line help screen is displayed by the key and gives you -the actions of the ALT keys. -Return to the main screen by hitting any key. Otherwise, return is -automatic one minute after the last keyboard use. E--GE-5.3.1.3 The main screen.GE-HE-HF- -The main reception and transmission screen is the one which appears -at the end of the initialisation when TPK is launched. -It is made up of at least two windows, one dedicated to your -command or text entries (this is the keyboard-entry window which is -found at the bottom of the screen), and the other is dedicated to -the packet traffic. This traffic window is located in the upper -part of the screen. Indeed, the traffic window changes a little -according to whether or not you are in the connected or -disconnected mode. -In the disconnected mode, the traffic window receives: -þ The packet traffic if the TNC command "MOnitor" is ON. -H HE- -H HE- Configurations and setting up of TPK. 81 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ The replies to the TPK or TNC commands. -In the connected mode, only the QSO packets are displayed, what is -going out and the stuff being received, just like the echo of you -have typed on the keyboard. -In both case, the keyboard-entry window enables the TNC or TPK -commands to be entered. -It is possible to open a third window which is optional and which -will install it at the top of the screen (to the detriment of the -traffic window which the number of lines will be reduced) and which -is called the MONITORING window. The traffic window will be -consequently at the middle of the screen, between the keyboard -entry window and the monitoring window. -The windows are separated by two or three lines according to the -number of active windows. They inform you of the state of the -system and of some function keys. -The monitoring window has two differents functions according to the -mode, connected or disconnected: -þ In the disconnected mode, you can receive the traffic of a - station in this window (See "FEnetre" command paragraph "4.1 - Local commands." on page 59). The traffic will be reproducted - correctly in the case of the TNC2 as you can receive it if you - were connected, unless the repetitions that you will receive - each time. The packet path will be displayed on the line - underneath this window. - If you give a string instead of a callsign all the packets - containing this string in the path will be displayed in this - window and the line underneath will display the filter. -þ In the connected mode, the monitoring window receive the - traffic, except your packets. This window don't work in the Yapp - transfer mode because the TNC2 is in the TRANSPARENT mode. This - possibility is ONLY for the TNC2. Don't try it on other TNCs !! -Commands for the main screen management: -þ Command "CHat NbLines" defines the height of the traffic window - in connected or disconnected mode, measured from the top of the - screen. - NbLines mini = 4 - NbLines maxi depends of the value of "FChat" and "FEnetre" -þ Command "FChat NbLines" defines the height of the monitoring - window in the connected mode, measured from the top of the - screen. -H HE- -H HE- Configurations and setting up of TPK. 82 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - This mode is activated by: - - "RXblock ON" validation of the block mode of the TNC2 - - "MCon ON" validation of the monitoring in the connected mode - for the TNC2. - If these two commands are activated the traffic will be - displayed in the monitoring window. - REMEMBER : this is ONLY valid for the TNC2 ! -þ Command "FEnetre" has different functions: - - "FEnetre NbLines" defines the height of the monitoring window - in the disconnected mode. - NbLines between 3 and the number of lines on the screen minus - 4. - - "FEnetre F6XYZ-n" sends all the packet coming from F6XYZ-n in - the monitoring window in the disconnected mode. - - "FEnetre "Text"" sends all the packets from which the - callsign path contains Text. - Example : with a KAM, "FE "/H"" sends all the HF traffic in - the monitoring window. -þ Command "SUpcr ON|OFF" allow supression of a added by the - TNC2 to each information packet in the disconnected mode. With - "SU ON", displaying in the monitoring window will be correct. - Put "SU OFF" on other TNCs (put it in your CONFIG.TPK file) -Summary of the main screen management: -H HE- -H HE- Configurations and setting up of TPK. 83 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H HF- - Top of the screen - ÚÄÄÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÄÄ¿ - ³ ³ Disconnected mode ³ Connected mode ³ ³ - ³ ³ ³ ³ ³ -FEnetreÄÄ´ ³ "Fenetre" ³ "FChat" ³ ³ - or ³ ³ command ³ command ³ ³ - FChat ³ ³ ³ ³ ³ - value ³ ³ ³ ³ ³ - ÀÄÄÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ÃÄÄ CHat - ³ ³ ³ value - ³ Traffic window ³ ³ - ³ ³ ³ - ³ "CHat" command ³ ³ - ³ ³ ³ - ³ ³ ³ - ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ÄÄÙ - ³ Keyboard window ³ - ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ - Bottom of the screen HF- -Keys used in the main screen windows: -þ will clear the traffic window. -þ will clear the monitoring window. E--GE-5.3.1.4 The MHEARD screen.GE-HE-HF- -The MHEARD screen is called by the key. -It is divided into two windows: -þ The upper window lists the stations heard. - (Details paragraph "2.2.1 MHEARD." on page 12) -þ The lower window lists the connections, disconnections and - remote commands received. -Return to the main screen by hitting any key. Return is automatic -after 30 seconds of keyboard inactivity. E--GE-5.3.1.5 The BACKSCROLL screen.GE-HE-HF- -The BACKSCROLL screen is called by the keys: - , , , -After which, you can explore the buffer with the arrow keys and the -/ keys. -H HE- -H HE- Configurations and setting up of TPK. 84 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Return to the main screen with the key or the key. -(Details paragraph "2.3 BACKSCROLL." on page 13) E--GE-5.3.1.6 The DOS screen.GE-HE-HF- -The DOS screen is obtained by the key. Return to the main -screen by the EXIT command, followed by any other key when TPK ask -it. -(See paragraph "2.10.1 Access to DOS function." on page 50) E--GE-5.3.1.7 The message listing screen.GE-HE-HF- G--HE-5.3.1.7.1 Message listing window presentation.:HE-GF-HF- -Key to display a list of the known BBS. -þ You can select the BBS you want to consult. If there is no BBS - known, then TPK displays your personal mailbox (MSG_PRIV). -þ When you have selected the BBS, TPK displays the message list - from that BBS. -þ Remember, you can directly access the listings with the - BRoadcast command (BR L) G--HE-5.3.1.7.2 Keys and MOUSE buttons used in the list window.:HE-GF-HF- -þ (or or ): returns you to the terminal mode of - TPK. The Last Listed message counter is NOT updated. You must - quit with or to update it. -þ : (or ) returns you to the terminal mode of TPK, and - IMMEDIATELY executes the reception of previously selected - messages. -þ : (or ) returns you to the terminal mode of TPK, and - the reception of previously selected messages will commence in - the next forward cycle. (RX delayed) -þ : (or ) changes the BBS list. -þ : (or ) allows you to enter a message using the TPK - editor. -þ : (or ) reply to a message using the TPK editor. The - callsign fields are filled in by TPK and the text of the - original message is placed at the start of your reply, with each - line displayed beginning with a ">". -H HE- -H HE- Configurations and setting up of TPK. 85 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ : (or ) edits a message with the TPK editor. The - callsign fields and the text is copied from the original message - into a new one which will be appended to your personal mail. The - original message still exists and must be killed otherwise it - will be forwarded. -þ : (or ) deletes a message. It will be marked as status - K and the file will be deleted from the disk. It cannot then be - recovered! -þ : (or

) copies a message to the printer. -þ : (or ) command which toggles the listing of either - bulletins only, or both bulletins and private messages. -þ : (or ) appends the message text to a file. The default - directory is the CAPTURE directory. -þ : (or ) messages selection. You can select messages in - the list by the TO field and the FROM field and the @BBS field, - by a text in the subject or a text in ALL the header line, by a - DATE. -On the line below the mouse buttons you have: -þ The callsign of the BBS. -þ Last Received: the number of the last message header received - from this BBS -þ Last Listed: the number of the last message header consulted. -þ NbMes: the total number of message headers in the list. E--GE-5.3.1.8 The message editor screen.GE-HE-HF- -Whilst in the Listing Window, any of the following 3 functions -automatically calls the TPK editor. -þ -þ -þ -Four fields at the top of the screen show details of some of the -message parameters: -þ BBS: the local BBS where your message will be forwarded to. - The list of known BBSs is displayed in a menu. You MUST have at - least ONE BBS defined (by the BRoadcast command) or else an - error message will be displayed and the editor abandonned ! -H HE- -H HE- Configurations and setting up of TPK. 86 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ For: destination packet address - Ex: FD1CDC@F6FBB.FMLR.FRA.EU -þ Type: the type of the message, P for private, B for bulletins, T - for NTS. -þ Subject: the title of the message. If this is a reply the - original title is copied and preceeded by RE: -To modify any of these fields whilst you are in the text window, -position the cursor on the first line of text and hit the UP key. -Using editor keys. -þ : abandons the current message and returns to the - (personal!) list. ALL text typed is lost! -þ : terminates the message. (like /EX on a BBS !!) -þ : deletes a line. The deleted line is buffered and can - be restored using . This key also deletes text in all - the windows used for entering a filename in - terminal mode, in the editor, in the BBS listing. -þ : restores a line previously deleted with -þ : call your editor which must have been previously - initialised with the "EDITOR" command. The current text is - written in the temporary file TEMPMSG.TPK and the editor is - called with this filename as parameter. - (See command "EDITOR" paragraph "4.1 Local commands." on page - 59) -þ : toggles justification ON/OFF -þ : toggles word wrap ON/OFF (Justification and word - wrapping are exclusive) -þ : import (read) a file into the message. Text is appended - at the cursor position. -þ : save the current text in the TEMPEDIT.TPK file. You can - quit the editor and find again your text later with the key - . -þ : load the TEMPEDIT.TPK file in the editor window. This - function overwrite the current text. To append the text use - . -H HE- -H HE- Configurations and setting up of TPK. 87 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-5.3.1.9 The LOGBOOK screen.GE-HE-HF- -Exploitation of the LOGBBOK screen. -When the LOGBOOK is displayed, you can edit it very simply by -moving the curseur into the field you want to modify, with the -keyboard arrows or by moving the mouse cursor into that field and -validating with the left button. -Functions of the keyboard: -þ : displays an help screen. -þ : enters the current date with the format defined by the - "LOG DATE" command into the field where the cursor is located. -þ : enters the current time with the format defined by the - "LOG TIME" command into the field where the cursor is located. -þ : change the LOGBOOK file. The list of all existing .LOG - files in the TPK directory is displayed if there is more than - one such file. -þ : search a callsign in the LOGBOOK file. Searching begin at - the beginning of the file. -þ : repeat callsign search from the cursor current position. -þ : LOGBOOK printing. It's possible to print one page, - several pages or all the LOGBOOK. Printing can take place in a - file or directly on the printer: To print give the name of the - printer for the filename : PRN or LPT1 or LPT2 or LPT3 according - to your printer configuration. -þ : add an element to the file. The implicit values are used. - You can after that enter a callsign, the times etc. You can use - this for manual use of the LOGBOOK. -þ : quit the LOGBOOK and return to the main screen. -þ : go to next field. -þ : go to the preceding field. -þ : cancel the current modifications in the field where the - cursor is. E--GE-5.3.2 Configuration of a colour screen.GE-HE-HF- -TPK supports CGA, EGA or VGA screens. The number of display lines -on the screen is specified in the following table: -þ CGA card : 25 -H HE- -H HE- Configurations and setting up of TPK. 88 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ EGA card : 25 or 43 -þ VGA card : 25 or 43 or 50 -The colours of the TPK screens are parametrable in the TPK.CFG -file. HF- - Reminder of colour codes: - 0 Black 8 Dark grey - 1 Blue 9 Light blue - 2 Green 10 Light green - 3 Cyan 11 Light cyan - 4 Red 12 Light red - 5 Magenta 13 Light magenta - 6 Brown 14 Yellow - 7 Light grey 15 White HF- -The colour parameters can be checked in the file COULEURS. The -command is "TYPE COULEURS". Make sure beforehand that the following -line exist in CONFIG.SYS: "DEVICE=[C:\PATH\]ANSI.SYS" E--GE-5.3.3 Configuration of a monochrome screen.GE-HE-HF- -Monochrome modes (Hercule, MDA, etc) in principle are carried, but -have not been fully tried out. You must simply set the correct mode -with TPKINST. If they are not as you want, modify the parameters in -TPK.CFG, always with the COULEURS file. -H HE- -H HE- Configurations and setting up of TPK. 89 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-6.0 TPK FILES.GE-HE-HF- -These files must be situated in the TPK directory indicated in -TPK.CFG otherwise there will be a error message and abandonment of -the command. -HE-Note: HF- if this path is not specified in the configuration file, it -is the implicit disc and directory at the launch of the programme -which will be used by TPK. It is setted up by TPKINST. E--GE-6.1 THE TPK.CFG FILE.GE-HE-HF- -The parameters in TPK.CFG are modified with TPKINST.EXE safe the -serial ports addresses and the colours. -This file is an ASCII text file and the parameters are commented. -The principle of the UPLOAD directory is explained in the paragraph -"2.5 Remote commands." on page 14 and its use can be modified by -. The DONWLOAD directory enables you to lock access to -reception into this sinlge directory, so you avoid writing files -anywhere. -You can modify and add commentaries but do not delete some -parameters. Furthermore, TPK loads its parameters in file order: -you must not modify this order ! E--GE-6.2 THE CONFIG.TPK FILES.GE-HE-HF- -The CONFIG.TPK files can be introduced as shown below: HF- - FE 5 - FE F6XYZ-1 - ALARM F6ABC-1 - MON ON - CONOK ON - CPACTIME ON - etc... HF- -Certain command of TNC origin are therfore also managed by TPK and -take part of its functionning. "CPACTIME" command is an important -parameter allowing characters to be sent without , eg. in the -case of the TPK prompt ([TPK] >) -þ "RXblock" is used to validate the block mode in TPK. -þ "MCon" is used to validate the monitor window in the connect - mode. So that the window is active in the connected mode, you - must pass these commands to the TNC at each use of TPK, this - happens automatically by incorporating these two commands into - the CONFIG.TPK file carried out at the start of the programme. - HE-Note: HF-This mode is ONLY for the TNC2. Don't try to use it with -H HE- -H HE- TPK files. 90 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - other TNCs ! -þ "MYcall" is used by TPK for the personal mailer and for the - LOGBOOK. -For these commands you will get a reply from TPK AND from the TNC. -The "MOnitor" command in TPK must be abreviated as "MO" and not "M" -which stands for "Macro" ! E--GE-6.3 THE DIRC.TPK FILE.GE-HE-HF- -H HE- -H HE- TPK files. 91 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -HF-Structure of the DIRC.TPK file, commented directory. -&x:\path\ Criterion-1 Criterion-2 Criterion-N -FILENAME.EXT xxxxxx JJ/MM/AAAA HH:MM Commentaries (39 char maximum) -ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Extra Commentaries ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Extra Commentaries ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Extra Commentaries ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Extra Commentaries ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ -&x:\path\ Criterion-1 Criterion-2 Criterion-N -FILENAME.EXT xxxxxx JJ/MM/AAAA HH:MM Commentaries (39 char maximum) -& Recognition character Ä¿ -x:\chemin\ Access path to the file ³ -FILENAME.EXT Name of the file ³ -xxxxxx Lenght of the file ÃÄÄ Created by the command -JJ/MM/AAAA Date of the file ³ COMmente -HH:MM Time of the file. ³ -Commentaries Description of the file ÄÙ -Criterion-1...Criterion-N Ä¿ - Selection of a range of ³ - interest or a specific ³ - kind of file ÃÄÄ To be added and modified -Extra commentaries ³ with a text editor - If 39 characters are not ³ - enough ÄÙ -Example: -&C:\TPK\ENVOI\ PACKET TPK IBM -TPK165.ZIP 234567 10/09/1991 01:65 Programme TPK version 1.65 - : New commands "/DIRC" "COMmente" - : "TNCIni" to swap a TNC in 8 bits without parity - : Menus for files transfers - : On-line help ..... etc ..... -&C:\TPK\ENVOI\ TPK -TPKHELP.ZIP 87654 10/09/1991 01:00 TPK programme of outside help - : This is the help taken from TPK which can be used - : as on-line help in Desqview for example. -&C:\TPK\ENVOI\ SATELLITES -TRKSAT300.ZIP 321098 25/12/1991 03:00 TRAKSAT satellites pursuit. -In this example: -- /DIRC PACKET lists TPK165.ZIP -- /DIRC TPK lists TPK165.ZIP and TPKHELP.ZIP -- /DIRC SATELLITES lists TRKSAT300.ZIP -- /DIRC SAT also lists TRAKSAT300.ZIP HF- -(See paragraph "2.5 Remote commands." on page 14 and "4.2 Remote -commands." on page 67) -H HE- -H HE- TPK files. 92 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-6.4 THE EXECAUTO.TPK FILE.GE-HE-HF- -File of authorised external remote commands. -If it does not exist, NOTHING is allowed. -Structure of the file for EACH authorised command: -þ Line 1 : Command -þ Line 2 : Exchange of the reception buffer on disc (Ok/No) -þ Line 3 : Number of parameters maximum (up to 18) -þ Line 4 : Authorisations for the 1st parameter -þ Line 5 : Interdictions for the 1st parameter -þ Line 6 : Authorisations for the 2nd parameter -þ Line 7 : Interdictions for the 2nd parameter -þ and so on up to the maximum number of parameters for this - command. -(See paragraphs "2.5 Remote commands." on page 14 and "4.2 Remote -commands." on page 67) E--GE-6.5 THE ON-LINE HELP FILES.GE-HE-HF- -These files are ASCII text files and are therefore easily modified -with an editor. Just take into account the base structure enabling -the functionning of the on-line help. -The first line of the file contains the title of the screen -displayed at the bottom. - Eg: TPK.HLP : =[TPK commands]= -The second line contains the description of the heading of the -different sections. The heading has no particular format, except -its lenght which is limited to 74 characters. This description -enables therefore specification of it for the user. - Eg: TPK.HLP : = Command argument ==== Default ==== Description == -Then come the different sections. Each section must begin with the -character "@" at the beginning of the line. TPK understands each -line beginning with this charcter to be a section. That which must -be displayed for the section is situated between two lines -beginning with the "@" character. - Eg. TPK.HLP: -H HE- -H HE- TPK files. 93 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -HF-@ALArme OFF/Call OFF ...Description -Parameters: - OFF Deletion of the alarm - Call Starts the alarm and TPK wil send out a beep on - receiving this call as the origin of a packet -@At [Time [Command]] .....2nd section. HF- -The end of a section is therefore either the beginning of the -following one (line beginning with a "@"), or the end of the file. -(See paragraph "2.1 On-line help ." on page 10) -H HE- -H HE- TPK files. 94 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-7.0 TPK VERSION 1.82GE-HE-HF- E--GE-7.1 MACRO COMMANDSGE-HE-HF- E--GE-7.1.1 Editing macro commandsGE-HE-HF- -A window which can be accessed with allows you to edit -macro commands. Commands to handle macro commands like in previous -versions are still available but are less user handy. -This window can be called up from the main (monitoring) screen,from -within messages lists and while using the built in message -editor.This will allow automation of some functions especially -while you're in a message list: such macro commands can be called -with keys from 0 to 9. -In the built in editor it allows you,for example,to include a few -signing lines taken from a specific file at the end of messages. E--GE-7.1.2 Specific macro commandsGE-HE-HF- -þ MSGLST0 to MSGLST9 (Upper case ONLY) - These macro commands are called using keys from 0 to 9 (that's - 10 macro commands altogether) from within messages list - (MSG_PRIV or BBS list). The text shown in the selection sidebar - matching these commands is in language files (.LNG) - In order to modify the function allocated to a key you must: - - Modify its presentation text in language files - - Modify the matching macro command - MSGLST1 will be called by hitting the key <1>,MSGLST2 will be - called by using the key <2> ...And so on...until MSGLST0 - which will be called when you'll hit <0>. -þ INITCNX and INITDCNX (Upper case ONLY as macro commands are case - sensitive) - Those to macro commands will be run each time a connection is - made (INITCNX) and each time a disconnection occurs - (INITDCNX).There were created for using with PK900 tncs in order - to disable/enable monitoring during/after connections. -H HE- -H HE- TPK version 1.82 95 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-7.1.3 Parameters for macro commandsGE-HE-HF- -Parameters can be used with macro commands.They are represented by -9 variables (like in MS-DOS batch files) which are %1% to %9%,while -%0% is the name of the macro command itself. -Example of a macro command called READ. -It will appear like this in the macro command's list : -þ READ SHELL LIST %1%^M - This macro command will shell to DOS,then call the program named - LIST.COM (a popular shareware) followed by the argument you - specified when running the macro command (the file name).LIST - will display the content of the file you entered as a parameter - (=argument).The name of the file must be specified when you run - the macro command a bit like an option in a DOS command line. -þ Here is how you would use this macro command named READ: - - READ CONFIG.TPK - Here CONFIG.TPK is the first parameter (also refered to as - "argument") and in the macro command,the sign %1% will be - replaced by this first parameter.Some programs allow several - file names or sometimes option to be entered as arguments in - the command line (after the file name when you run these - programs);For such programs you can use parameters %2%,%3% - and so on... -Here is an example of a macro command to run such a program: -þ VIEWZIP SHELL PKUNZIP %1% %2%^M - This macro command is called VIEWZIP and will shell to DOS and - run PKUNZIP followed by the 2 arguments you have entered after - the name of the macro command when you ran it. -If you type: -þ MACRO VIEWZIP -V FILE.ZIP - The macro command will shell to DOS (that's the SHELL command in - the macro command )then run the following command: -þ PKUNZIP -V FILE.ZIP - (Which will view the content of the file named FILE.ZIP) -Here is another example of a macro command named KMES : -þ KMES C F1EBN-1^MATT 180 CNX^M^7ATT 180 >^MK %1%^MB^M -H HE- -H HE- TPK version 1.82 96 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - This macro commands will connect you to the BBS F1EBN-1,wait 180 - secs for being connected,then it will wait for the BBS prompt up - to 180 more seconds,it will then send the command K followed by - the number you entered after the macro command when running it - (It will send K 12345 if you ran the macro command by typing M - KMES 12345 or MACRO KMES 12345 or with KMES 12345 ...those - 3 syntaxes do EXACTLY the same thing) - Therefore you don't have to re write the macro command for each - message you want to kill. E--GE-7.2 FUNCTION KEYSGE-HE-HF- -Function keys can still be edited like in previous versions but now -hitting will display a window which will allow you to edit -function keys more easily. -This window can be called while in the main (monitoring) -screen,from within messages lists and while using the built in -message editor. It can be used to chain up commands and include -for example a signing file at the end of a message. E--GE-7.3 SO COMMAND (BELL/CHIMES)GE-HE-HF- -There are three different types of chimes available: -þ Connexion: It will be activated each time a connexion occurs. -þ Alarm: This one will be activated when a specific callsign is - heard. You can specify/modify the callsign with the ALA - command. -þ Call to the operator: remote command /OPE. - Those three bells can be modified and turned ON or OFF - separately. - For each one you can modify the tone and the lenght. E--GE-7.3.1 How to modify bells/chimesGE-HE-HF- -Each bell is made of 9 separate tones,and for each tone you can -modify its frequency and its lenght. -Syntax: -þ SOnnerie CNX!ALA!OPE F1 D1 F2 D2 ...... F9 D9 - - CNX = Connect bell -H HE- -H HE- TPK version 1.82 97 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - - ALA = Alarm bell (rings when a station is heard) - - OPE = Call to the operator (rings when /OPE is sent by a - remote station) - - F1 = The first tone's frequency ) And so on for each of the 9 - tones - - D1 = Lenght of the first tone ) out of which are made - Chimes (=Bells) -þ Example: SO CNX 3000 1 2800 1 3000 ....and so on - The above example will modify the connect bell.The first number - (3000) represents the frequency of the first tone,then the - following number (1) is the lenght of the first tone...Then - "2800" represents the frequency for the second tone and the - following "1" is the lenght of the second tone... and so on for - each of the 9 successive tones in each bell. -You can also display the bell configuration by typing SO followed -by the "type" of the bell. -þ Example: SO CNX - The above line will display the status for the connect bell. -þ Example: SO ALA - The above line will display the status for the Alarm bell. - (Same thing with OPE) E--GE-7.3.2 Enabling/disabling BellsGE-HE-HF- -Each bell can be turned ON or OFF independantly,but you can also -modify all of them at the same time by simply using the following -commands: -þ SO OFF - (to turn all bells off) -þ SO ON - (to turn all bells on) -If you choose SO ON then each bell will work with its own -configuration. -þ SOnnerie CNX!ALA!OPE ON!OFF - Enables/disables each bell individually -H HE- -H HE- TPK version 1.82 98 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ Example: SO CNX OFF - The above command will turn off the connect bell -þ Example: SO OPE ON - The above command will turn on the bell matching /OPE remote - command E--GE-7.3.3 Testing bellsGE-HE-HF- -Each bell can be tested so you can hear what it sounds like after -you have modified it. -Syntax: -þ SOnnerie CNX!ALA!OPE TEST -þ Example: SO ALA TEST - This command will test the alarm bell. E--GE-7.4 THE BUILT IN SCREEN SAVERGE-HE-HF- -The SCREENSAVER command allows the screen to be turned off -automatically once the maximum inactivity time has elapsed.This -function will only work properly with a color video card.With -monochrome video cards or with LCD displays,if it doesn't work,you -can still use a public domain screen saver program...they are -widely available.With desktop computers a screen saver function is -already provided in order to increase batterie's life. -Syntax: -þ SCREENSAVER n - This will turn off the screen after n minutes (Where "n" is a - figure of course...) -þ SCREENSAVER ON - This will enable the screen saver feature with the default - inactivity timing,unless you have already modified it using the - previous command. -þ SCREENSAVER OFF - The screen saver facility will be turned off.The screen will - always remain on. -þ SCREENSAVER CNX -H HE- -H HE- TPK version 1.82 99 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - The screen saver will be activated but the screen will be turned - on each time a connexion occurs so you can see who connects to - you. E--GE-7.5 MESSAGES LISTSGE-HE-HF- -Once a message has been written,TPK will put the cursor in the list -where it was before.This allows to reply to a message and then come -back where you were in the list. -7+ messages stay marked "+" once they have been read so it always -show that they are 7+ and not text messages.Because of this,7+ -messages which are in MSG_PRIV will have to be killed if you want -the "Msg" indicator to stop blinking in the main screen. E--GE-7.5.1 Selecting messagesGE-HE-HF- -þ > by their destination (TO field) -þ @ by their distribution area or destination BBS (AT or BBS - field) -þ < by their sender (FROM field) -þ by their status (R Y F and so on ) -þ * All messages which have been marked (Those with any status but - a space) -þ Using the selection sidebar associated with MSGLST1 to MSGLST0 - macro commands - These macro commands use selecting possibilities described - above. - Keys from 1 to 0 (10 keys) are as follows - Key Description - - 1: Msg_R messages downloaded but not read yet. - - 2: Msg7+ 7plus messages - - 3: IBM Messages sent to IBM - - 4: VHF Messages sent to VHF - - 5: @AMSAT Messages routed at AMSAT - - 6: FBB Messages sent to FBB - - 7: TPK ---------------- TPK -H HE- -H HE- TPK version 1.82 100 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - - 8: ALL ---------------- ALL - - 9: TOUS ---------------- TOUS - - 0: REF ---------------- REF -h3.Suppressing R: lines -Lines starting with R: in messages which show where it has been -through are not always useful.Suppressing them can save quite a big -deal of space on your hard disk.If you choose not to keep those -lines then only the first R: line which gives the originating BBS -will be kept as it is used when you reply to a message. -Here is how to suppress them: -þ BRoadcast RXMSG DELRLINES - (Letters in lower case are not mandatory-This command can be in - config.tpk) E--GE-7.5.2 Sending messagesGE-HE-HF- -Callsigns and addresses (BBSs + their hierachical address) of hams -to whom you send messages are kept in a file named HROUTE.TPK which -will be created in your main TPK directory. -For example if you send a message to F1EBN@F6ABJ.FRPA.FRA.EU ,TPK -will put this callsign and the address in HROUTE.TPK and next time -you'll want to send him a message,you'll only need to put F1EBN and -TPK will add the BBS and its address automatically. -This file is a text file and entries can be added or deleted -manually with an ASCII editor. E--GE-7.5.3 Wait delay when forwarding with a BBSGE-HE-HF- -It might sometimes be usefull to increase the time TPK waits for -the BBS prompt when forwarding takes place...for example when you -want to leave a message on a remote BBS through several nodes. -This modification can be done with an added parameter to the -BRoadcast command: -þ BRoadcast ATTENTE nnn - or -þ BRoadcast WAIT nnn - Where nnn is the time TPK will wait for the BBS prompt when - forwarding (in seconds) -H HE- -H HE- TPK version 1.82 101 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Example: -þ BR F6FBB-1 ATT 600 - With the above example TPK will wait 600 seconds for the BBS - prompt before it starts forwarding (if the prompt is received) - or aborts (if the prompt hasn't been received in time) E--GE-7.6 7PLUSGE-HE-HF- E--GE-7.6.1 Receiving 7PLUS messagesGE-HE-HF- -þ 7PLUS.EXE MUST be in your main TPK directory (usually c:\tpk\) - in order to avoid being over written as it used to be possible - when it was in the capture sub directory (previous TPK - versions). -þ 7PLUS.EXE is called with the parameter -k which will erase - obsolete files (= .7PL and .Pxx files left over once they are - decoded). E--GE-7.6.2 Sending 7PLUS encoded filesGE-HE-HF- -While you're in the built in editor,hit in order to access -the automatic 7+ encoding feature. -You will have to give the name of the file you want to encode and -the maximum size you want each encoded part to be (each part will -then be placed into a separate message ready to send).Then TPK will -run 7PLUS.EXE. -HE-Note: HF-Important, Be aware that TPK will need quite a lot of -conventional memory available in order to run 7plus correctly.Its -best to swap the receive buffer to XMS or EMS (SWape command) -Parts will be numbered starting with 1 and the number of the part -will be included in the title of the message. -Messages titles will be organised as follows: -þ 7+ File_name N1/N2 Title -Where: -þ File_name is the name of the original encoded file -þ N1 is the number of the part -þ N2 is the total number of part into which the file has -H HE- -H HE- TPK version 1.82 102 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - been encoded -þ Title is the title you have entered with the built in - editor -Exemple of the correct procedure to send a message (starting from -within MSG_PRIV list): -þ Start editing a message by hitting (or if you reply to a - message). -þ Select the bbs where you want to leave the message (amongs those - declared with BR commands in CONFIG.TPK). -þ Enter the message's destination (ie: TPK7@EU). -þ Select the type of the message (B for bulletins or P for - personnal). -þ Enter the title but keep in mind that the file name and a part - number will be included before it on the same line...so keep it - short. -þ Once you're in the actual message window hit -þ Enter the name of the file to be 7+ encoded -þ Enter the maximum size of each message (each message will - correspond to one part of the 7+ file) -þ Once you will have validated the process 7+ will be run and TPK - will create all messages. -In order to control the flow of 7+ messages,TPK will only send a -limited amount of them at each upload to the bbs.The default value -for this is 1 which means that TPK will only upload one 7+ message -per upload. -You can modify this number with the command: -þ FOR MAXMES7 nnn - Where nnn is the maximum number of 7+ messages to be uploaded to - the bbs per fwd session. - Example: -þ FOR MAXMES7 5 - This will limit to 5 the maximum number of 7+ message which can - be uploaded during a single connection. -H HE- -H HE- TPK version 1.82 103 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-7.7 SERVERSGE-HE-HF- E--GE-7.7.1 Servers: how they interact with TPKGE-HE-HF- -Servers are programs which are run each time a message is received -(downloaded) by TPK.When a message is entirely received,it is then -"uncompressed" by TPK_COMP.EXE and stored in its destination -directory (defined in TPK.CFG). If servers have been set up then -they are run successively. E--GE-7.7.2 How TPK runs these serversGE-HE-HF- -The following informations are usefull for programers...If you -don't expect to write a server for TPK,you don't really need to -know what's in this paragraph. -Servers are called as follows with several parameters which they -can use: -þ Server's_name.exe File_Name TPK_Path Mycall - Where: - - Server's_name.exe is the name of the server as it has been - set up with BRoadcast command.It's best if you give the full - path of the server when you set it up so TPK will always know - where to find it. - - File_Name is the name of the file with it's directory in - which the message has been stored. - Example: C:\TPK\LISTES\GB7GUR\123456 - - TPK_Path is the main TPK directory (where TPK.EXE is) - This allows,for example,the server to look up configuration - files for TPK or to store a reply in this directory. - Example: C:\TPK\ - - Mycall is the callsign in use (without its SSID) by TPK which - allows servers to know whether the message is sent to the - station's owner (or if it's a bulletin or a message for - someone else). -H HE- -H HE- TPK version 1.82 104 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-7.7.3 Files in which are stored messagesGE-HE-HF- -þ The first line contains the following informations: the type of - the message (Bulletin or private),the destination and the - expeditor of the message. - It uses the same syntax as BBS do when forwarding in - uncompressed mode: (Without spaces between words) - Examples: - - SPGU4YMV @ < $ - SB means it is a bulletin,SP would have to be used in case of - a private message. is the call sign of the ham - to whom the message is to be sent (=the recipient) or the -H HE- -H HE- TPK version 1.82 107 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - category if it's a bulletin. is the BBS on which the - message is to be sent or the distribution area if it's a - bulletin. - is the message's identification.If a BID is specified - with the S command it will be kept "as is" by TPK. Otherwise - TPK will generate a BID like it usually does when you write a - message with the built in editor. - HE-Note: HF-Spaces are not mandatory - -- Example: SB TPK @EU -þ Example: FOR IM MYMAIL.TXT - With the above command,TPK will look for MYMAIL.TXT instead of - MAIL.IN . The import file can be used for example by servers. E--GE-7.9 USING THE PK900 WITH TPKGE-HE-HF- E--GE-7.9.1 Initialising your PK900GE-HE-HF- -In order to start TPK with a fully configured PK900 you must: -þ Switch your PK900 on by pressing on the little RESET button - located next to the RS232 plug.The LCD display must be empty. -þ Run TPK with the PK900 parameter if the software doesn't include - the EXPERT command or with the PK900EX parameter if the version - you're using has the EXPERT command. - Syntax: -H HE- -H HE- TPK version 1.82 108 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H - - TPK PK900 (that's without the EXPERT command) - - TPK PK900EX (with the EXPERT command) - The display must then be activated and TPK should read - CONFIG.TPK which contains dedicated PK900 commands. -Commands which must be in CONFIG.TPK in order to use a PK900 -correctly: -þ EXPERT ON - (If the PK900's eprom software has this command) -þ DCD ON - HE-Note: HF-These previous two commands must be at the begining of the - file. -þ PACKET -þ 8BITCONV ON -þ CHS $7C - HE-Note: HF-This command is important for TPK as it is used to - automatically switch frequency. -þ CONON ON/ON -þ CONM TRANS - HE-Note: HF-It's no use using CONVERS mode as monitoring while - connected is not possible with a PK900 anyway. -þ CONSTAMP ON -þ CPAC ON -þ ECHO OFF -þ MAILDROP OFF - HE-Note: HF-Do NOT use the PMS at the same time as TPK ! -þ MCON 0/0 - HE-Note: HF-No monitoring while connected is possible -þ MFILTER $7C - HE-Note: HF-Important in order to avoid unwated frequency toggling -þ MON 6/6 -H HE- -H HE- TPK version 1.82 109 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -þ MPROTO ON/ON -þ MXMIT ON -þ MYCALL G9XYZ/G9XYZ - HE-Note: HF-The callsign used by TPK is the first one (before the "/") -þ NEWMODE OFF -þ NOMODE ON -þ UBIT 14 ON - HE-Note: HF-This command reduces the size of the PK900's buffer which - allows a better performance during file transfer using YAPP - protocole. -All these commands are in the CONFIG.TPK file which is included in -PK900.ZIP. In order to exctract it type: -þ PKUNZIP -O PK900 - HE-Note: HF-Warning, PKUNZIP.EXE will have to be on your computer in - your current directory or in the DOS path.If you don't have it - you can copy it from TPK's original floppy disk to you TPK - directory. E--GE-7.9.2 Handling of 2 ports by TPKGE-HE-HF- -Both ports on the PK900 can be handled by TPK but in a "single -connection mode".The FREquence command with an added parameter -tells TPK it deals with a PK900 (these commands can of course be -placed in CONFIG.TPK !). -Syntax: -þ FREquence 1 nnnnnn PK900 (port 1) -þ FREquence 2 mmmmmm PK900 (port 2) - (Where nnnnnn and mmmmmm are the frequencies in MHz) -As soon as you will have entered both commands TPK will handle -channel switching.Be sure that the channel "switch caracter" is -configured with the MFILTER command as follows: -þ MFILTER $7C -Use the configuration file distributed with TPK for PK900s (see -above for details). -H HE- -H HE- TPK version 1.82 110 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -Every time something happens on channels 0 to 9,TPK will switch to -"FREquence 1" which is port 1 and every time something happens on -channels A to Z TPK will switch to "FREquence 2" which is port -2.The right frequency will therefore be recorded in the LOG file -for each connection. -In order to change port while using TPK just use the FRE command -like this: -þ FRE 1 - to change for port 1 -and -þ FRE 2 - for switching to port 2 -Channel switch commands would have the same effect: -þ |0 for going on channel 0 and therefore port 1 -þ |A for going on channel A and therefore port 2 -Here is how to use these commands with TPK's BRoadcast commands. -þ Unproto request for port 1: - - BR U |0 - - Example: BR GB7GUR U |0GB7GUR -þ Unproto request for port 2: - - BR U |A/ - - Example: BR F1CVE-1 U |A/F1CVE-1 -þ Connection path for port 1: - - BR C |0^MMON 0/0 - HE-Note: HF-It is important to disable monitoring as if TPK - receives a prompt from another BBS than the one it is - connected to,then it will go to transfer mode before the bbs - is actually ready and the transfer might not work correctly. - - Example: BR GB7GUR C |0GB7GUR^MMON 0/0 -þ Connection path for port 2: - - BR C |A^MMON 0/0 - - Example: BR F1CVE-1 C |AF1CVE-1^MMON 0/0 -H HE- -H HE- TPK version 1.82 111 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-7.9.3 INITCNX and INITDCNX macro commands.GE-HE-HF- -The macro command named INITCNX is run when a connection takes -place (right before it) and it can be used to disable monitoring -and to switch the PK900 in the right mode. -Example: -þ INITCNX ^6MON 0/0^MCONOK OFF/OFF^MTRANS^M - This macro command will switch the PK900 to command mode (^6) - ,will disable monitoring,will prevent anybody from connecting - (as it could interfere with message transfer) and will put the - tnc in TRANS mode. -The macro command named INITDCNX is run when TPK disconnects and -can be used to enable monitoring for example,enable connections -from other stations... -Example: -þ INITDCNX ^6MON 6/6^MCONOK ON/ON^M - This macro command will do the opposite of INITCNX in the - example a few lines above. -HE-Note: HF-Macro commands are case sensitive which means that you must -enter their name in UPPER CASE if you want them to be taken into -acount,as TPK will call them in UPPER CASE ( It is important for -INITCNX and INITDCNX but for other macro commands you can record -them in lower case as long as you run them in lower case too ). E--GE-7.10 USING TPK WITH BAYCOM MODEMGE-HE-HF- -TPK can be used with Baycom through 2 separate drivers: -þ TFPCX which handles packet level 1 and 2 -þ TNCDED which allows TPK and TFPCX to communicate. -It is easier to use a batch file to start TPK with both drivers -than to type each command manually. -Here is an example of a batch file which would start TPK for Baycom -on port COM1: HF- - CD\TPK - TFPCX -PCOM1 - TNCDED 1 - TPK - TNCDED 1 /U - TFPCX -U HF- -H HE- -H HE- TPK version 1.82 112 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H -With TPKINST,you must configure TPK for port COM1: and the serial -driver ("driver serie" in french) on INT14. -For the port COM2: you'll only need to replace "1"s by "2"s in the -batch file and to configure TPK for the port COM2: when running -TPKINST. -The following commands can be included in CONFIG.TPK: HF- - MYCALL G9XYZ - CMSG ON - CONMONDE CONVERS - CONOK ON - CPACTIME ON - CTEXT << TPK 1.82 is on line. /HELP for a list of available cmds >> - DAYUSA OFF - ECHO OFF - MCOM ON - MCON ON - MON ON - NEWMODE OFF - NOMODE ON - RXBLOCK ON HF- -All these files are included in TPKBCOM.EXE -In order to install it,put TPK's original disk in your A: drive and -type: -þ A:TPKBCOM -Then you'll need to configure TPK for the right port using TPKINST -(see above for details),AND you'll have to modify the callsign used -in CONFIG.TPK ( VERY IMPORTANT !!)...Now you should be ready to run -the batch file matching the COM port you're using: -Either -þ TB1.BAT - (For COM1:) -or -þ TB2.BAT - (For COM2:) -H HE- -H HE- TPK version 1.82 113 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H E--GE-8.0 APPENDIX : EXTENSIONS TO THE YAPP PROTOCOLGE-HE-HF- -These extensions are used in TPK 1.65a (and up) and FBB 5.14 and -up. E--GE-8.1 HEADER EXTENSION.GE-HE-HF- -The header now carries the DATE and TIME of the file being -transmitted. -HF-[SOH] [Len] [Filename] [NUL] [File Size] [NUL] [Date] [Time] [NUL] HF- -The Date and Time are the values reported by DOS, coded in 4 -hexadecimal characters and are sent in ASCII. -The receiver has the choice of using either extended Yapp with -checksum or normal Yapp. -þ The normal Yapp reply is RF, as before and the receiver can keep - the date and time information . -þ The extended Yapp reply is : RT Receive_TPK and is coded : - [ACK] [ACK] -If the receiver reply is RT the protocol used will be what I have -called YappC for Yapp with checksum. When the sender gets this -packet he MUST use YappC. E--GE-8.2 DATA PACKETS EXTENSION.GE-HE-HF- -If the receivers reply is RT the protocol used will be YappC. The -checksum allows detection of packets corrupted along the link, -particularly on the RS232 lines where there is no error control or -correction (or it's very poor!) -Data packets : [STX] [Len] [Datas] [Checksum] -Checksum is the sum of all datas bytes in 8 bits like Xmodem. If -the checksum is bad then the receiver must send a Cancel and enters -CW state. E--GE-8.3 CRASH RECOVERY.GE-HE-HF- -A new field has been added to the resume reply to tell the sender -if the receiver can use YappC or not. -Resume reply for Yapp: (as used before by TPK and FBB) -H HE- -H HE- Appendix : Extensions to the Yapp protocol 114 HF- -H -HF-Terminal PacKet TPK v1.82 -H HF- -H -H HF- - [NAK] [Len] [R] [NUL] [Received Length] [NUL] - ³ ³ ³ - ³ ³ ÀÄÄ in ASCII as in the header - ³ ÀÄÄ as Resume ! - ³ - ÀÄÄÄÄÄÄÄ len of the following bytes HF- -Resume reply for YappC: HF- - [NAK] [Len] [R] [NUL] [Received Length] [NUL] [C] [NUL] - ³ - Tells sender I can use YappC ÄÄÄÄÄÙ HF- -When the sender gets this packet then he must also use YappC. -H HE- -H HE- Appendix : Extensions to the Yapp protocol 115 HF- HF-HF-HF-A 2CBHF- -H --HF-Terminal PacKet TPK v1.82 -H -HF- -H -H E--GE-INDEXGE-HE-HF- -GE-CHF- - -CONFIG.TPK 40, 46, 63, 74, 76, - 77, 78, 79, 80, 83, 90 - - -GE-DHF- - -DCD 70, 71, 75, 78, 80 - - -GE-KHF- - -KAM 54, 63, 74, 78, 79, 83 - - -GE-PHF- - -PK232 12, 54, 70, 74, 79, 80 - - -GE-THF- - -TNC2 7, 8, 12, 20, 62, 64, 65, - 70, 71, 74, 75, 79, 82, 83, - 90 -TPK.CFG 7, 10, 53, 54, 62, 63, - 70, 71, 72, 73, 76, 77, 89, - 90 -TPKINST 7, 10, 15, 40, 73, 89, - 90 - - -GE-YHF- - -YAPP 3, 19, 20, 22, 23, 24, 27, - 28, 68, 82, 94, 114 -YAPPC 27, 28, 114, 115 -H HE- -H HE- Index 116