*I  General Help Ù  Port Number Œ  Baud Rate 8  Data Bits 0  Parity   Stop Bits H  Log File Name -  Private Flag File Name É Bad Flag File Name  Bad Numbers List File B Output Log String Format 5 Configuration File Name ™" Full Path Name X# Full Path Name ÿÿÿÿ *B 1,General Help The ICALLER ID CONFIGURATION ProgramI is designed to create a configuration file for the CALLERID.EXE program. Use the Up and Down Arrow Keys to highlight the different fields, and edit the fields to contain the desired data for your system's configuration. While on each field you can press IF1I to get help on that field. For any FILE that you don't want to have CALLER ID create, leave the field blank. Press PgDn for More... *P Movement Keys for Editing the Fields on the Screen I Help F1 Exit and Save F10 Exit Without Saving Escape Move Down One Field Tab, Down Arrow Move Up One Field Shift-Tab, Up Arrow Insert Mode Toggle InsI Press PgDn for More... *P Also see these topics for more information: ^Port Number^ ^Baud Rate^ ^Data Bits^ ^Parity^ ^Stop Bits^ ^Log File Name^ ^Private Flag File Name^ ^Bad Flag File Name^ ^Bad Numbers List File^ ^Output Log String Format^ *E *B 2,Port Number Enter the ICOM Port NumberI that your Caller ID Box is connected to in this field. If you have an IBM PC/XT/AT/386 compatible computer, valid values are 1 or 2. Sorry, but non-standard COM ports are not supported yet. If you have an IBM PS/2 computer, you can enter from COM 1 through COM 8. Default is I1I. ^General Help^ *E *B 3,Baud Rate Enter the IBAUD RateI of your Called ID Box in this Field. Valid baud rates are: 300, 1200, 2400, 9600, and 19200. Default is I1200I. ^General Help^ *E *B 4,Data Bits Enter the IDATA BITI setting for your Caller ID Box in this field. Valid data bits are, 5, 6, 7, or 8. Default is I8I. ^General Help^ *E *B 5,Parity Enter the IPARITYI that your Caller ID Box uses in this field. Valid parity settings are: IOIdd, IEIven, INIone, IMIark, or ISIpace. Default is INIone. ^General Help^ *E *B 6,Stop Bits Enter the ISTOP BITSI that your Caller ID Box uses in this field. Valid stop bits are 1 or 2. Default is I1I. ^General Help^ *E *B 7,Log File Name Enter the IName of the Log FileI you want CALLERID to send it's log to. This log is IexactlyI what the Caller ID Box sends to the computer. Each time the Caller ID Box sends a line to the computer, it will get sent to this log file. Many people use their Bulletin Board Log File to capture this log. This allows them to see what number a user called from while browsing their BBS Log File. See ^Output Log String Format^ for information on how you can change this log output to better meet your needs. Also see: ^Full Path Name^ File Type: Output ^General Help^ *E *B 8,Private Flag File Name Enter the IName of the Private Flag FileI. This file is created when the Caller ID Box tells us that the caller has his caller ID information disabled. CALLERID will send the line received from the Caller ID Box to this I"flag"I file. The contents of this private flag file are not important. It is meant to be a flag to your BBS that a caller has their ID blocked. If you don't want a Private Flag file created, leave this field blank. Also see: ^Full Path Name^ File Type: Output ^General Help^ *E *B 9,Bad Flag File Name Enter the IName of the Bad Number Flag FileI you want created when a caller calls from a number that is in the Bad Number File List. You can have a list of numbers that you don't want calling your BBS. If one of these numbers is received, CALLERID will create a I"flag"I file to indicate to your BBS that this has happened. This flag file contains the line that is sent to the computer from the Caller ID Box, but again, the contents is not important. *P If you don't want a Bad Number Flag file created, leave this field blank. Also see ^Bad Numbers List File^ or ^Private Flag File Name^ for more information. Also see: ^Full Path Name^ File Type: Output ^General Help^ *E *B 10,Bad Numbers List File Enter the IName of the Bad Number List File.I This file that holds a list of phone numbers that you do not want to call your BBS. Each time a call comes in, CALLERID will search this list to see if the number is a I"bad" number.I This is sort of like a trash can file. If you don't have a Bad Numbers File List, leave this field blank. Also see: ^Full Path Name^ File Type: Input ^General Help^ *E *B 11,Output Log String Format This is a tricky one. If you are a C programmer, then just use a valid formatting string that you would use in a printf() function call. REMEMBER: The Caller ID Box sends I29I characters in this form: I03/02 11:03 (123)555-1212 GI If you are not a C programmer, let me see if I can explain this to you a little. This is not an real powerful formatting option. It will allow you to put extra spaces before and after your log file entry, as well as other text. *P Use a "I%sI" (without the quotes) to represent the line that is received from the Caller ID Box, and sent to the Log File. A carriage return/line feed are always put at the end of the log entry. Note in the example that follows, the [] brackets are here to show the exact field, but don't include them in your field unless you want those characters to show up in your log. Put 10 spaces BEFORE the log entry. Format String: I[ %s]I Result in Log File: I" 03/02 11:03 (123)555-1212 G"I *P Put 10 spaces BEFORE and AFTER the log entry. Format String: I[ %s ]I Result in Log File: I" 03/02 11:03 (123)555-1212 G "I Put some text before the log entry to tell what it is. Format String: I[FROM THE CALLER ID BOX: %s]I Result in Log File: I"FROM THE CALLER ID BOX: 03/02 11:03 (123)555-1212 G"I *P Put some asterisks before and after the log entry. Format String: I[********** %s **********]I Result in Log File: I"********** 03/02 11:03 (123)555-1212 G**********"I *P You can use a number right before the "s" in the %s field. This number tell the program to print the line from the Caller ID Box in 'x' number of spaces. A positive number makes the entry right justified, while a negative number makes it left justified. Format String: I[%80s]I This will make the line 80 characters long with the number right justified on the line. *P Format String: I[%-80s]I This will do the same, but the number will be on the left with enough spaces after the number to make the line 80 characters long. Format String: I[ %-56s]I This is what you use to make the line match the callers log entry in a IPCBoard log file.I PCBoard wants every line in the log file to be I62I characters long. This format string will put 6 spaces at the beginning of the line, then the number from the Caller ID Box, and pad the line with spaces on the end to make it a total of 62 characters long. *P If you need help with this setting, send me a small portion of your log file and I will see if I can come up with a format setting for your system. I can't promise anything, but I'm willing to try. ITHE TECH LINE BBS at 301-696-1393I, and you will be able to download this program on your first call, and send me a COMMENT with your example. ^General Help^ *E *B 12,Configuration File Name Enter the Iname of the output file you want to save this information into.I ^General Help^ *E *B 13,Full Path Name You will encounter problems if you don't use a FULL PATH NAME in the fields that require a file name to be entered! Lets assume you just enter a file name like "LOG.TXT". When you run CALLERID, it remains memory resident and does it's thing in the background. If it goes to open a file, it will open "LOG.TXT", and this will be created in whatever directory you are in when this happens. If you use a full path like "C:\PCB\LOG.TXT", then it does not matter what drive or directory you are in when CALLERID goes to create a file. ^General Help^ *E