PC Online 1997 November

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

/ PC Online 1997 November / PCO1197.ISO / FilesBBS / OS2 / SL13A8.ARJ / SL13A8.ZIP / SL13A8.RAR / SHOWL.DOC < prev next >

Wrap

Text File | 1997-09-11 | 72.3 KB | 1,828 lines

▐▒█▀▀█ ▐▒█ █ ▐▒█▀▀█ ▐▒█ ▐▒█ █ ▐▒█ ▐▒█▀▀█ ▐▒█▀▀▀ ▐▒█▄▄▄ ▐▒█▄▄█ ▐▒█ █ ▐▒█ █▐▒█ █ ─── ▐▒█ ▐▒█ █ ▐▒█ ▄▄ ▄▄▄▄█ ▐▒█ █ ▐▒█▄▄█ ▐▒█ ▐▒█ ▐▒█▄▄█ ▐▒█▄▄█ ▐▒█▄▄█ ─────────────────────── Version 1.30 ──────────────────────── Copyright (c) by Marcel Becker & Soeren Boettner; 1996,97 A comfortable logfile-viewer for MainDoor, FrontDoor, Binkley, T-Mail, McMail, Intermail, Cantaloup, Xenia, RemoteAccess, Maximus, Proboard, SBBS, Concord, PcBoard Argus and FX.uucico - for DOS and OS/2 - User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── Directory ───────── 1. Foreword................................................................ 4 1.1. Registration etc.................................................. 4 2. Technical Details....................................................... 5 2.1. MainDoor.......................................................... 5 2.2. FrontDoor 2.12sw/2.02nc........................................... 5 2.3. FrontDoor 2.20ml.................................................. 5 2.4. Binkley........................................................... 5 2.5. T-Mail............................................................ 5 2.6. McMail............................................................ 6 2.7. FX.UUCICO......................................................... 6 2.8. Other Mailers..................................................... 7 2.7.1. Different mailers on different lines etc?....................... 7 2.8. BBS programs...................................................... 8 2.8.1 Special cases running MAILER -> BBS.............................. 8 BBS_SUBST........................................................ 8 2.9. Other Connects & Errors........................................... 8 3. Configuration........................................................... 9 3.1. Installation...................................................... 9 3.2. ASCII-Config (Keywords)........................................... 9 LANGUAGE......................................................... 9 BBSNAME.......................................................... 9 SYSOP............................................................ 9 AKA.............................................................. 9 TIME_SLICES...................................................... 9 MULTI_LINE....................................................... 9 MAX_TASKS........................................................ 9 BEGIN_COUNT...................................................... 9 MAILER........................................................... 9 BBS.............................................................. 10 SEMA............................................................. 10 RESCAN_SEMA...................................................... 10 MAILER_LOG....................................................... 10 BBS_LOG.......................................................... 10 SL_LOG........................................................... 10 SHOW_USER {+}.................................................... 10 USE_INDEX........................................................ 10 FD_SCRIPT........................................................ 10 LOG.............................................................. 10 FILTER_EXTRACT................................................... 11 SEARCH_ALL....................................................... 11 SHOW_ALL......................................................... 11 HIGHLIGHT_IF..................................................... 11 HIGHLIGHT........................................................ 11 HIGHLIGHT_LINE................................................... 11 NETMAIL.......................................................... 11 REPORT_TEXT...................................................... 11 STATIST_TEXT..................................................... 11 STATIST_TEMPLATE {+}............................................. 11 REPORT_TEMPLATE {+}.............................................. 12 REPORT_TO_SYSOP.................................................. 12 REPORT_TO {+}.................................................... 12 KILL_NETMAIL..................................................... 12 ══════════════════════════════════════════════════════════════════════════════ Directory Page 1 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── APPEND........................................................... 12 USER_NM_TEMPLATE................................................. 12 INCLUDE.......................................................... 12 COLOR............................................................ 12 COST............................................................. 12 EDITOR........................................................... 12 INTRO {+}........................................................ 12 SAVE_LAST........................................................ 12 LINES............................................................ 12 SAVER............................................................ 13 SAVER_TEXT....................................................... 13 HIDE_LINE........................................................ 13 REREAD_SEMA...................................................... 13 TERMINATE_SEMA................................................... 13 REINDEX_SEMA..................................................... 13 NEW_MAIL_FLAG.................................................... 13 WEEKLY_STAT_ON................................................... 13 MONTHLY_STAT_ON.................................................. 13 PKT_PATH......................................................... 13 PKT_AREA......................................................... 13 PKT_ORIGIN....................................................... 13 PKT_AKA.......................................................... 13 SHOW_EMPTY_STAT.................................................. 13 SHOW_EMPTY_REPORT................................................ 13 START_IN_OUTBOUND................................................ 13 CUT_DAYS, CUT_LOGS............................................... 13 CUT_DAYS......................................................... 13 CUT_AFTER_DAYS................................................... 14 CUT_TO_SIZE...................................................... 14 CUT_SIZE_ABOVE................................................... 14 ARC_LOGS......................................................... 14 ARC_PATH......................................................... 14 ARC_NAME......................................................... 14 ARC_PACKER....................................................... 14 CUT_LOGS......................................................... 14 FAX_VIEWER....................................................... 14 EXIT_PROMPT...................................................... 14 REP_NM_SUBJ...................................................... 14 STAT_NM_SUBJ..................................................... 14 PKT_PASSWORD..................................................... 14 STAT_EM_SUBJ..................................................... 14 REP_EM_SUBJ...................................................... 14 CALLER_SUBJ...................................................... 14 START_APP........................................................ 14 SHOW_FAX_PRIMARILY............................................... 15 FAX_PATH......................................................... 15 FAX_LOG.......................................................... 15 FAX_CALLER....................................................... 15 REPLACE_IN_FAXNR................................................. 15 SAVE_FILE........................................................ 15 CREATE_NM_AS_PKT................................................. 15 NM_AREA.......................................................... 15 4. Program execution....................................................... 15 4.1. parameters........................................................ 15 Examples......................................................... 16 ══════════════════════════════════════════════════════════════════════════════ Directory Page 2 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── 5. Automatic reports and statistics........................................ 16 5.1. Reports........................................................... 16 5.1.1. Report templates................................................ 17 Macros and keywords.............................................. 17 Example template................................................. 19 5.2. Weekly and monthly statistics..................................... 19 5.2.1. Statistic Templates............................................. 19 6. Shorten Logs and arc.them............................................... 21 7. How to use SHOWLOG...................................................... 23 7.1. Tasks (ALT+T)..................................................... 23 7.2. Inbound/Outbound (F4)............................................. 23 7.3. Reports (ALT+R)................................................... 23 7.4. Date (ALT+D)...................................................... 23 7.5. Internal Logfile viewer (ALT+L)................................... 23 External Editors (ALT+E)......................................... 24 7.6. Indexes (ALT+I)................................................... 24 7.7. Re-Read Logfiles (ALT+N).......................................... 24 7.8. Callers of all lines in one Window (ALT+A)........................ 24 7.9. Statistics (Alt+S)................................................ 24 8. Fax-Features of ShowLog................................................. 25 9. Color Definitions of ShowLog............................................ 25 10. Miscellaneous.......................................................... 25 ALT+S - save logfile extract........................................... 25 ALT+N - Generating a simple netmail.................................... 25 Cost calculation....................................................... 25 Appendix................................................................... 25 Meaning of Files....................................................... 26 Copyrights/Notes/etc................................................... 27 Credits................................................................ 28 ══════════════════════════════════════════════════════════════════════════════ Directory Page 3 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 1. FOREWORD ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ This program was written to make the work of sysops much more easier. I also know the problem looking every morning or night who has called my system. I always used an ascii-viewer to browse through my looong log- files. Some might use a tool which shows every caller, but if you want to know details about a specific session you still have to browse through your logfiles using an ascii editor/viewer. This program should end this. The idea comes from Carsten Kruse (2:248/4002). This tool allows you to see whom you have called _and_ who has called you. Everything on one screen. If you want to know more about a session you have the opportunity to view the part of the logfile which belongs to the session. SHOWLOG is aware of mailer calls as well as of online calls. SHOWLOG just uses the logfiles of your mailer- and BBS software. The program can be installed and set up easily in almost every environment, including multiline systems. Meanwhile SHOWLOG has developed to a very powerfull and usefull tool, which in fact has the ability to do more than it ever should. But try yourself. ;) Marcel Becker, 01.06.1997 ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 1.1. REGISTRATIONS ETC. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ This is copyrighted software owned by TRIBBLE M. This is NOT public domain or freeware. TRIBBLE M grants you a TEMPORARY license to try this software for EVALUATION purposes ONLY ! You may use this package for an evaluation time of 30 days. After this time you have to register SHOWLOG or stop using it ! Any other or further use of this software is strictly forbidden and may result in legal action! To register SHOWLOG please refer to REGINFO.DOC. Registered users receive a key file with a unique serial number. These files are copyrighted stuff owned by TRIBBLE M and MUST NOT be distributed, hacked, re-engineered etc. If you don't follow these rules, your license expires immediately and legal actions may be started against you. If you are of the opinion that you do not want to test a program which is limited in some features, well you are right then. :) Feel free to ask your local Reg.Site for a free Demo key which will work for 21 days. During this period you may test all features of SHOWLOG without any limits. ══════════════════════════════════════════════════════════════════════════════ Foreword, Registration Page 4 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2. TECHNICAL DETAILS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├─────────────────────────┬─────────────────────────────────────────────────┘ │▒▒ 2.1. MAINDOOR ▒▒▒▒▒▒▒▒│ └─────────────────────────┘ ! To use SHOWLOG you have to set following options in the Maindoor setup as described below: MDSETUP -> MAILER -> LOGFILE: = MODEM RESPONSES YES $ TOTAL TIMES YES : REMOTE INFO YES ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.2. FRONTDOOR 2.12sw/2.02nc ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you are using FrontDoor 2.21sw or 2.02nc do NOT set the keyword MULTILINE in SHOWL.CFG to YES! ! To use SHOWLOG you have to set following options in the Frontdoor setup as described below: FDSETUP -> MAILER -> LOG: ~ SESSION INFORMATION YES REMOTE SYSTEM'S INFO YES + BRIEF MESSAGES YES $ ACCOUNTING INFO YES = MODEM RESPONSES YES ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.3. FRONTDOOR 2.20ml ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ! To use SHOWLOG you have to set following options in the Frontdoor setup as described below: FDSETUP -> MAILER -> LOG: ~ SESSION INFORMATION YES REMOTE SYSTEM'S INFO YES + BRIEF MESSAGES YES $ ACCOUNTING INFO YES = MODEM RESPONSES YES ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.4. BINKLEY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ! To use SHOWLOG you have to set the parameter LOGLEVEL in BINKLEY.CFG to 4 or higher. ══════════════════════════════════════════════════════════════════════════════ MainDoor, FrontDoor, Binkley, T-Mail Page 5 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.5. T-MAIL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ To get SHOWLOG working with a multiline T-mail system you have to use logfiles like this. T-MAIL1.LOG; T-MAIL2.LOG etc. This allows you to use the $TASK$-Variable in SHOWL.CFG as stated below: T-MAIL$TASK$.LOG ! T-Mail has NOT been tested with the T-Mail command line option -D1 (terse log) ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.6. Mc MAIL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ! To use SHOWLOG you have to switch on following options: + ? ! ~ # You MUST shut down McMail at least once a day. (eg. shortly after midnight.), or SHOWLOG won't be able to detect every day. ══════════════════════════════════════════════════════════════════════════════ McMail, FX.uucico Page 6 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌──────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.8. FX.UUCICO ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └──────────────────────────────────────────────────────────────────────────┘ ! To use SHOWLOG you have to set uu.debug to 3 in your fxuucp.cfg Q: I'm using a fidomailer as my main mailer and I want ShowLog to parse my FX.UUCIO logfile as well. A: There is no problem. This is how it works: Let us assume you have 3 lines for your fidos-ystem (eg.: T-Mail) and you are using fx.uucico as well. Thats how your config should look like: MULTI_LINE YES ; BEGIN_COUNT 1 MAX_TASKS 4 ; MAILER TM ; MAILER_LOG e:\log\t-mail$TASK$,T-Mail-Logfile Task $TASK$ ; MAILER [4] UU ; MAILER_LOG [4] e:\usenet\logs\uucio,FX.UUCIO Log. ; So you are setting up a virtuell 4th task for your FX.UUCICO. MULTI_LINE hast to be set to yes even on singleline systems. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.8. OTHER MAILERS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOWLOG was NOT tested with other mailers than the ones stated above. If you still want to use any other mailer software you have to make sure that it is compatible with any of the mailers above. InterMail: Intermail uses almost the same logfile output as FrontDoor. If you are using InterMail make sure to set MAILER to IM. ══════════════════════════════════════════════════════════════════════════════ special cases Page 7 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌──────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.7.1. MAILER, MAILER_LOG & BBS_LOG differnet for each line ▒▒▒▒▒▒▒▒▒▒▒│ └──────────────────────────────────────────────────────────────────────────┘ Yes, it is possible to use a different mailer for each line. And forthermore to use the same ShowLog config file for each line. You may even use all features of ShowLog like statistics etc. running different mailers on each line. The keywords MAILER, MAILER_LGO and BBS_LOG provide the ability to use different definitions for every line. You do this by inserting the task-id between the keyword and its statement: <keywort> [<task_id>] <statement> Example: MAILER [2] TM (Line 2 will be using T-Mail) or: MAILER BINK MAILER [3] CL Means: You are running Binkley on all lines except on line 3. Line 3 uses Cantaloup. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.8. BBS PROGRAMS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOWLOG tries to recognize any online call in your mailer logfile. With SHOWLOG you also have the opportunity to view the extract of your BBS logfile. This logfile should be compatible to the following BBS- software: RA, Maximus, Proboard, SBBS, PcBoard or Concord. ┌──────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.8.1. Special cases ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └──────────────────────────────────────────────────────────────────────────┘ By using the keyword BBS_SUBST you may specify which mailer task uses which bbs task and if there is any bbs task connected to this mailer task. Default settings for ShowLog are: mailertask 1 = bbstask 1 etc. If you want to change this behavior use BBS_SUBST as following: BBS_SUBST <mailer_task> <bbs_task> or: BBS_SUBST <mailer_task> NO Example: BBS_SUBST 3 1 (Mailertask 3 is connected to BBS-Task 1) BBS_SUBST 4 NO (Mailertask 4 is Mailonly, means it is not connected to any BBS-Task) ══════════════════════════════════════════════════════════════════════════════ special cases Page 8 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.9. OTHER CONNECTS & ERRORS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOWLOG tries to recognize almost every kind of connect. Does your modem responses with FAX or FCON, SHOWLOG will show this session as a fax connect. Should there be any errors during any session, SHOWLOG will show a flashing '!' in front of the session time ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 3. CONFIGURATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├───────────────────────┬───────────────────────────────────────────────────┘ │▒▒ 3.1. INSTALLATION ▒▒│ └───────────────────────┘ It is very easy to install SHOWLOG. Just unpack the archive in any directory. Then edit the file EXAMPLE.CFG with any ascii-editor. To get SHOWLOG working you have to rename EXAMPLE.CFG to SHOWL.CFG. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 3.2. ASCII-CONFIG (Keywords) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ LANGUAGE The language SHOWLOG should use for screen outputs. Available languages are: GERMAN & ENGLISH example: LANGUAGE GERMAN BBSNAME The name of your BBS/system example: BBSNAME The BOX SYSOP Your name example: SYSOP Joe Sysopa AKA your addresses (max. 50). The first is the Main Aka example: AKA 2:248/4004 TIME_SLICES Should SHOWLOG release timeslices when running under a multitasking system such as OS/2 or Windows? example: TIME_SLICES YES MULTI_LINE Do you run a multi-line system? example: MULTI_LINE YES MAX_TASKS If MULTILINE YES, how many lines/nodes do you have? example: MAX_TASKS 4 BEGIN_COUNT If MULTI_LINE YES, which is your first task? example BEGIN_COUNT 1 or BEGIN_COUNT A MAILER Which type of mailer do you use? MD=MainDoor;FD=FrontDoor;BINK=Binkley;TM=T-Mail;MM=McMail IM=InterMail;CL=Cantaloup;XM=Xenia; UU=FX.UUCICO;ARG=Argus;MSD=Self defined ══════════════════════════════════════════════════════════════════════════════ Config Page 9 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── example: MAILER MD NOTE: If you set MAILER to MSD, SHOWLOG will use the file you have specified using MAILER_SD (See SELFDEF.ZIP) BBS Which BBS type do you use? (RA,MAXIMUS,PRO,SB,CC,PCB,BSD) example: BBS RA NOTE: If you set BBS to BSD, SHOWLOG will use the file you have specified using BBS_SD (See SELFDEF.ZIP) SEMA Full path+filename of your semaphore directory. example: E:\MDOOR\FLAGS\ RESCAN_SEMA File which should be touched/updated to force the mailer to rescan its outbound directory. example: RESCAN_SEMA MDRESCAN.NOW MAILER_LOG Full path+filename of your mailer logfile. The use of $TASK$ is possible and recommended if you have a multiline system. Syntax MAILER_LOG <filename>,<description>,[arc/no_arc], [<maxsize>,<minsize>],[<maxdays>,<mindays>] See also chapter 5. (Shorten) BBS_LOG Full path+filename of your BBS logfile The use of $TASK$ is possible and recommended if you have a multiline system. Syntax: BBS_LOG <filename>,<description>,[arc/no_arc], [<maxsize>,<minsize>],[<maxdays>,<mindays>] See also chapter 5. (Shorten) SL_LOG Full path+filename of SHOWLOG's own logfile You may also include the following line in your cfg file: LOG <path+filename of SL_LOG>,BINK SHOW_USER {+} Shows the real name of an online user instead of 'Online user'. example: SHOW_USER YES USE_INDEX Forces SHOWLOG to use a small index reading the logfile. This will increase the reading time enormously example: USE_INDEX YES FD_SCRIPT Should SHOWLOG be aware of FD script calls? NOTE: Please set this option to NO if you don't have any Script calls to avoid problems. example FD_SCRIPT YES LOG Here you can specify up to 50 logfiles/textfiles which you want to view with the internal logfile viewer. (unreg. only 2 logfiles) The use of $TASK$ is possible. ══════════════════════════════════════════════════════════════════════════════ Config Page 10 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── LOG <filename>,<description>,FD/BINK/SIZE_ONLY, [arc/no_arc],[<maxsize>,<minsize>],[<maxdays>,<mindays>] See also chapter 5 (shorten) FILTER_EXTRACT If set to YES, SHOWLOG will just display the log extract of the highlighted session. If set to NO, SHOWLOG will display the whole logfile and then will just jump to the begin of the log extract of the highlighted session. example: FILTER_EXTRACT NO SEARCH_ALL Tells SHOWLOG to search in all available BBS logfiles if it realizes a MAILER-BBS switch. NOTE: In most cases this should be NO SHOW_ALL If set to YES, SHOWLOG will display also your mailer- and BBS logfiles in the internal logfile viewer. NOTE: This keyword MUST be situated after MAILER_LOG, BBS_LOG, BEGIN_COUNT, MAX_TASKS, LOG example: SHOW_ALL YES HIGHLIGHT_IF Here you can specify different strings and colors. If any of these strings is found in a logfile extract, the related session entry will be displayed in the given color. Syntax: HIGHLIGHT_IF <String>,<foreground>,<Background> example: HIGHLITE_IF Joe Sysop,WHITE,BLUE (All sessions which have the string 'Joe Sysop' in it, will be displayed white on blue.) Maximum: 20 entrys. (unreg. only 2) HIGHLIGHT Works quite the same as HIGHLIGHT_IF, with the difference that the specified string will be displayed in the given color if it is found in _any_ logfile. You can specify for example the string ERROR. Then any string 'ERROR' will be displayed in a certain/given color. Same syntax as HIGHLIGHT_IF. example: HIGHLIGHT CONNECT,YELLOW,BLACK HIGHLIGHT_LINE Here you can specify a char. Whenever this char appears in the specified column in any logfile extract, the whole line will be displayed in the given color. if column=0, <char> will be search somewhere in the line. syntax: HIGHLIGHT_LINE <char>,<column>,<foregr.>,<backgr.> example: HIGHLIGHT_LINE +,1,LGREEN,BLACK NETMAIL Full path+filename of your netmail directory. example: NETMAIL E:\MDOOR\NETMAIL\ REPORT_TEXT Full path+filename of file which should be created by using parameter -R:T The use of $TASK$ is also possible. example: REPORT_TEXT E:\ALOG\REP$TASK$.TXT STATIST_TEXT Same as report_text ══════════════════════════════════════════════════════════════════════════════ Config Page 11 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── STATIST_TEMPLATE {+} Full path+filename of the statistic template SHOWLOG should use. example: STATIST_TEMPLATE statist.tpl REPORT_TEMPLATE Full path+filename of the report template SHOWLOG {+} should use. Default is SHOWL.TPL. The use of $TASK$ is possible example: REPORT_TEMPLATE SHOWL.TPL REPORT_TO_SYSOP If this is set to yes than using the option -R:N will force SHOWLOG to create a netmail addressed to you. example: REPORT_TO_SYSOP YES REPORT_TO {+} Who else should receive a netmail report? You can specify more than one address. Note: You may specify another template SHOWLOG should use: Syntax: REPORT_TO <name>,<aka>,<flags>,<template> example: REPORT_TO Dirk Cosysop,2:248/4004.1,-HLD,-DIR Available flags: -HLD, -DIR, -CRA, -IMM KILL_NETMAIL If this option is set to yes, every created netmail will get the kill/sent flag. example: KILL_NETMAIL YES APPEND Should the report be append to an existing file (YES), or should it be overwritten (NO). example: APPEND YES USER_NM_TEMPLATE Path and filename of a template the internal netmail generator should use INCLUDE Here you can specify some other config files which SHOWLOG should also read. COLOR [...] Use this to specify the look of SHOWLOG see COLOR.CF~/COLOR.CFG for details/syntax. COST [...] This keyword allows you to define simple cost calculations. See COST.CF~/COST.CFG for more details/syntax. EDITOR Full path and filename of an external editor example: EDITOR C:\DOS\EDIT.COM INTRO {+] Should SHOWLOG display a small intro screen? example INTRO YES SAVE_LAST Should SHOWLOG save the last settings upon exit of the program? example: SAVE_LAST YES LINES How many Lines SHOWLOG should use for display ══════════════════════════════════════════════════════════════════════════════ Config Page 12 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── (anything from 25 to 27) example: LINES 25 SAVER After how many minutes the screensaver should become active example: SAVER 10 SAVER_TEXT The text the screensaver should display example: SAVER_TEXT SHOWLOG - the best! HIDE_LINE Same Syntax as HIGHLIGHT_LINE Will NOT display the line the string is found in. May be toggled by pressing TABULATOR. REREAD_SEMA Specifies a file which forces SHOWLOG to reread the logfiles. TERMINATE_SEMA Specifies a file which forces SHOWLOG to exit immediately REINDEX_SEMA Specifies a file which forces SHOWLOG to build up the indexes NEW_MAIL_FLAG If set to YES SHOWLOG will display a new mail line if it founds unread mail in your netmail folder WEEKLY_STAT_ON The day the weekly statistic should be created WEEKLY_STAT_ON <day of the week> 1=monday...7=sunday MONTHLY_STAT_ON The day the monthly statistic should be created MONTHLY_STAT_ON_ <day of the month> PKT_PATH Path to the directory where echomail packets should be created (usually your Local inbound) PKT_AREA The Echomail Area the mail should be posted in PKT_ORIGIN The origin created echomails should have PKT_AKA The origination adress SHOWLOG should use in echomails SHOW_EMPTY_STAT Should SHOWLOG produce empty stats for lines without any traffic? SHOW_EMPTY_REPORT Should SHOWLOG produce empty reports for lines without any traffic? START_IN_OUTBOUND Should SHOWLOG show the Outbound Window after startup? CUT_DAYS, CUT_LOGS Default Settings for -K:X[,L/B/M] example: CUT_DAYS 30, CUT_LOGS LB CUT_DAYS Default settings for shorten/storing ══════════════════════════════════════════════════════════════════════════════ Config Page 13 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── Minimal value of days logfiles should have Example: CUT_DAYS 30 CUT_AFTER_DAYS Default settings for shorten/storing Maximal value of days logfiles should have Example: CUT_AFTER_DAYS 50 CUT_TO_SIZE Default settings for shorten/storing Maximal value of bytes logfiles should have Example: CUT_TO_SIZE 100000 CUT_SIZE_ABOVE Default settings for shorten/storing Maximal value of bytes logfiles should have Example: CUT_TO_SIZE 200000 ARC_LOGS Default settings for shorten/storing Should old logfiles be stored as archives ARC_PATH paths the archives should be stored in ARC_NAME The name the archives should have. 4 macros are possible: @day@, @month@, @year@ und @year2@. @year@ 4 digits @year2@ 2 digits Example: @day@@month@year2@ ARC_PACKER Definition of the packer program. Macros: @archive@ and @files@ Example: rar m -ep @archive@ @files@ CUT_LOGS Default settings for K:[L/B/M] Example: CUT_LOGS L FAX_VIEWER Path and filename of an external fax viewer EXIT_PROMPT Should ShowLog prompt before exiting? REP_NM_SUBJ The subject generated report netmails should have. ($TASK$ and $DATE$ are possible) Example: REP_NM_SUBJ Report: Line $TASK$ on $DATE$ STAT_NM_SUBJ The subject generated statistic netmails should have. (same as RE_NM_SUBJ) PKT_PASSWORD The password that generated PKTs should have STAT_EM_SUBJ The subject generated statistic echomails should have REP_EM_SUBJ The subject generated report echomails should have CALLER_SUBJ The subject generated 'netmails-to-caller' should have START_APP The mode the OS/2 version should start external programs in. (Possible are F=Fullscreen and W=windowed) ══════════════════════════════════════════════════════════════════════════════ Config Page 14 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── Example: START_APP F SHOW_FAX_PRIMARILY Specifies what should happen after hitting ENTER on a fax call. FAX_PATH The path the received faxes are stored in. FAX_LOG Specifies the software you are using to receive faxes and where ShowLog should get the information from. Syntax: FAX_LOG <id>,<file>,<description> ID= BGFAX, T-Mail, internal If ID=internal then <file> and <description> are not necessary. Example: FAX_LOG BGFAX,e:\faxes\bgfax.log,bgfax logfile FAX_CALLER Use this to replace some fax numbers with the real name of the caller. Example: FAX_CALLER 03124,Joe Fax REPLACE_IN_FAXNR Example: REPLACE_IN_FAXNR +49,0 REPLACE_IN_FAXNR 036604, SAVE_FILE Default name for the file ShowLog should write logfile extracts to. (ALT+S) CREATE_NM_AS_PKT Should ShowLog create Netmail as MSG files in your netmail folder or as PKTs in your local inbound NM_AREA If ShowLog should create netmails as PKTs you have to specify the area name of your netmail folder Example: NM_AREA NETMAIL ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 4. PROGRAM EXECUTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├──────────────────────┬────────────────────────────────────────────────────┘ │▒▒ 4.1. PARAMETERS ▒▒▒│ └──────────────────────┘ It is possible to start SHOWLOG with parameters. (Normal execution: just SHOWL.EXE) Parameters: (SHOWL.EXE -[parameter]:[option]) You can use more than one parameter a time. -? short online help screen -R:N creates reports about all incoming and outgoing calls. -R:T N - Netmail -R:E T - Text E - Echomail -T:X only use if MULTILINE is set to YES ══════════════════════════════════════════════════════════════════════════════ parameters Page 15 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── starts SHOWLOG with task X as default without the parameter -T, SHOWLOG interprets the TASK environment variable. If there isn't any, SHOWLOG assumes TASK=1 as default. -T:A Only if you are using the parameter -R: Reports will be created for All lines. -T:M Will SHOWLOG force to create a 'mixed/merged' report of all lines. Just try it. ;-) -D:DD-MM-YYYY The date SHOWLOG should use. If you don't use the parameter -D, SHOWLOG uses the date the internal system clock provides. -D:G Tells SHOWLOG to use yesterday's date. -C:<config> Tells SHOWLOG to use a different config file. SHOWLOG needs the full path and file name of the config file. If you don't use parameter -C:, SHOWLOG will search for its default config file SHOWL.CFG in the same directory SHOWL.EXE is located. -K:X[,Y] Shortens all logfiles, which are specified by mailer/BBS_log. All entries which are older than X days will be cut out. Y can be M or B. M: Only mailer logfiles will be shortened B: Only BBS logfiles will be shortened. -S:<template> Tells SHOWLOG to use a different template than the one specified with REPORT_TEMPLATE. {+} If you do not specify a path, SHOWLOG will search in its own directory for the file. -G:T,<file> Will create a small statistic as a text file. <file> must be the full path and filename of the file to be created. -G:N Will create a small statistic as a netmail. This will use the same settings as for reports. -G:E Echomail -O Startet dirket im Outbound Bildschirm -I Forces SHOWLOG to build up its indexes Examples: SHOWL.EXE -T:2 -D:12-01-1996 -R:N -C:C:\FD\SHOW\SHOWL.CFG Creates a report of all callers on line 2. The date is the 12nd of january in 1996. It will use C:\FD\SHOW\SHOWL.CFG as config file. SHOWL.EXE -R:T -D:G -K:30,B -C:C:\SHOWL\MYCONFIG.CFG Creates a report of all callers on line 1 (default). It will use yesterday's date and will cut out all entrys which are older than 30 days from the BBS logfiles. It will use C:\SHOWL\MYCONFIG.CFG as config file. ══════════════════════════════════════════════════════════════════════════════ Reports Page 16 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.0 AUTOMATIC REPORTS AND STATISTICS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├──────────────────────┬────────────────────────────────────────────────────┘ │▒▒ 5.1. REPORTS ▒▒▒▒▒▒│ └──────────────────────┘ SHOWLOG is able to create reports listing all incoming and outgoing calls of a certain day. (Parameter -R). This feature allows you to automatically create a netmail report every night of the day before. You can choose whether the report should be created as netmail, as plain ascii text or as an echomail packets. Netmails will have your name and aka as origination address. If you set REPORT_TO_SYSOP to YES then a report to the same address will be created. You can also define more recipients by using the keyword REPORT_TO. {+} If there are any errors during an automatic report please refer to the file SHOWL.ERR for reasons. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.1.1 REPORT TEMPLATES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you are a registered user of SHOWLOG you can specify a template SHOWLOG should use creating its reports by using the keyword REPORT_TEMPLATE. In the original distribution archive of SHOWLOG are many example templates included. One template consists of three parts. The descriptive part, the outbound part and the inbound part. Of course you can leave out one or more of these parts, but you have to be sure that the outbound/inbound part is always just one block. NOTE: The inbound block MUST be situated BEFORE the outbound block! right: @outbound@<text1> @outbound@<text2> wrong: @outbound@<text1> @desc@<text3> @outbound<text2> So a descriptive part is only be allowed before an outbound/inbound block or after an outbound/inbound block. eg: @desc@<text1> @outbound@<text2> @outbound@<text3> @desc@<text4> Following keywords are allowed: (SHOWLOG will ignore blank lines) @desc@ - descriptive text ══════════════════════════════════════════════════════════════════════════════ Templates Page 17 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── @outbound@ - Outbound block (will be used for every session entry) @inbound@ - Inbound block (will be used for every session entry) You can insert following macros in <text>: @fsname@ First name of the sysop @lsname@ Surname of the sysop @sname@ Full name of the sysop @frname@ First name of the current recipient @lrname@ Surname of the current recipient @rname@ Full name of the current recipient @saka@ Your Main address (AKA) @raka@ The address of the current recipient @bbs@ Your system/BBS-name @mailer@ Your mailer software @task@ Current task id @time@ Current time @date@ Current date @redate@ Date the report is about @location@ Location @using@ Mailer software of the session partner @sesname@ Sysop name of the session partner @sestime@ Time of the session @sesaka@ AKA of the session partner @system@ System name of the session partner @online@ The time the session partner was online @cost@ Cost of this session More keyword you may use: @IFILES@ Number of received files @OFILES@ Number of sent files @IFILES_SIZE@ Total size of received files @OFILES_SIZE@ Total size of sent files @IFILES_CPS@ cps of received files @OFILES_CPS@ cps of sent files @FILE_LIST@,<xpos> List of all transferred files Only use after each (inbound/outbound) block: @ierror@ Number of errors in inbound @oerror@ Number of errors in outbound @icount@ Total of inbound calls @ocount@ Total of outbound calls @pid@ Full version name of SHOWLOG You may also use 'formatted' keywords: @<keyword>,<length>,<l/r>@ example: @location,15,r@ ══════════════════════════════════════════════════════════════════════════════ Templates Page 18 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── This will result in the location string with a length of 15 beginning at right. So a template might look like this: @desc@ @desc@Hallo @frname@, @desc@ @desc@All incoming and outgoing calls of @bbs@: @desc@-------------------------------------------------- @desc@ @desc@Incoming calls on line @task@ on @redate@ via @mailer@: @desc@------------------------------------------------------------ @desc@ @inbound@@sestime@: @system@, @sesname@, @aka@ @inbound@from @location@ with @using@ @inbound@========================================================== @inbound@ @desc@Outgoing calls on line @task@ on @redate@: @desc@----------------------------------------------- @desc@ @outbound@@sestime: @system@, @sesname@, @aka@ @outbound@from @location@ with @using@ @outbound@========================================================= @outbound@ @desc@ @desc@This list was created by @pid@, @date@ at @time@. @desc@ @desc@ @desc@Bye, @fsname@; @saka@ ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.2. STATISTICS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By using the keywords WEEKLY_STAT_ON and MONTHLY_STAT_ON you may tell SHOWLOG when to generate those statistics (advanced statistics) See also parameter -G ══════════════════════════════════════════════════════════════════════════════ Templates Page 19 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.2.1. STATISTIC TEMPLATES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Statistic templates are using the same syntax and rules as report templates. Statistic templates consists of three parts: Two descriptive parts (one at the beginning of a template and one at the end) and one data part. The 'data' part will be used for every line, the statistic will be generated for. descriptive parts may only appear at the top and at the bottom of a statistic. Description: @desc@ Data: @data@ This is one example for better understanding: ; ; Macros: ; ~~~~~~~ ; @fsname@ First name of sysop ; @lsname@ last name of sysop ; @sname@ first+last name of sysop ; @frname@ first name of current receipient (netmail) ; @lrname@ last name of current receipient (netmail) ; @rname@ first+last name of current receipient (netmail) ; @saka@ AKA of sysop ; @raka@ AKA of receipient (netmail) ; @task@ current line number ; @statdate@ Date of this statistic ; @pid@ Name and version number of ShowLog ; ; @count_i@ Number of incomming calls ; @count_o@ Number of outgoing calls ; @count_u@ Number of incoming bbs-calls ; @time_i@ Time of all incoming calls ; @time_o@ Time of all outgoing calls ; @time_u@ Time of all incoming bbs-calls ; @avtime_i@ Average time of incoming calls ; @avtime_o@ Average time of outgoing calls ; @avtime_u@ Average time of incoming bbs calls ; @uoc_i@ Incoming calls in percent ; @uoc_o@ Outgoing calls in percent ; @uoc_u@ Incoming bbs-calls in percent ; @part_u@ Inxoming bbs-calls in percent of all incoming calls ; @cost_i@ Cost of all incoming calls ; @cost_o@ Cost of all outgoing calls ; @err_i@ Number of sessions with errors (in) ; @err_o@ Number of sessions with errors (out) ; @noerr_i@ Number of sessions without errors (in) ══════════════════════════════════════════════════════════════════════════════ Templates Page 20 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ; @noerr_o@ Number of sessions without errors (out) ; @err%_i@ Errors in percent (in) ; @err%_o@ Errors in percent (out) ; @fcount_i@ Number of received files ; @fcount_o@ Number of sent files ; @fsize_i@ Size of all received files ; @fsize_o@ Size of all sent files ; @ffsize_i@ Size of all received files (formated) ; @ffsize_o@ Size of all sent files (formated) ; @fcps_i@ Average cps rate of all received files ; @fcps_o@ Avergae cps rate of all sent files ; @desc@LOGFILE-STATISTIC of @statdate@: @desc@================================= @desc@ @data@Line @task@: @data@--------- @data@ Inbound (Online-User) Outbound @data@Number of calls @count_i,4,R@ (@count_u,4,R@) @count_o,4,R@ @data@Time @time_i@ (@time_u@) @time_o@ @data@Time per call @avtime_i@ (@avtime_u@) @avtime_o@ @data@ @uoc_i,4,R@% (@uoc_u,4,R@%) @uoc_o,4,R@% @data@ @data@Anteil der Onlineuser am Inbound: @part_u@% @data@ @data@ Inbound Outbound @data@Kosten @cost_i,6,R@ @cost_o,6,R@ @data@Fehleranzahl @err_i,6,R@ @err_o,6,R@ @data@fehlerfreie Sessions @noerr_i,6,R@ @noerr_o,6,R@ @data@Fehleranteil @err%_i,6,R@% @err%_o,6,R@% @data@ @data@ Gesendet Empfangen @data@Dateianzahl @fcount_o,5,R@ @fcount_i,5,R@ @data@Dateigröße @fsize_o,10,R@ @fsize_i,10,R@ ;unformatiert @data@Dateigröße @ffsize_o,13,R@ @ffsize_i,13,R@ ;formatiert @data@Durchschn. CPS-Rate @fcps_o,5,R@ @fcps_i,5,R@ @data@ @desc@Created by @pid@. ; ; EOF ══════════════════════════════════════════════════════════════════════════════ Shorten Page 21 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 6. SHORTEN LOGS AND ARC. THEM ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Following keywords are necessary for this feature: CUT_LOGS CUT_SIZE_ABOVE CUT_TO_SIZE CUT_AFTER_DAYS CUT_DAYS ARC_LOGS ARC_PATH ARC_NAME ARC_PACKER For a description of these keywords, please refer to chapter 3.2. ShowLog knows two 'variants' of this feature: Simply cut off old data and erase it or cut it off and store it as an archive. By using CUT_LOGS you set globaly which Logfiles should be honored by this feature. By using ARC_LOGS you say ShowLog what to to with the old data. If you set this to yes, please use ARC_PATH to specify a path the old logs should be stored in, use ARC_NAME to specify a name for this archive and use ARC_PACKER to specify your favorite packing software. How does ShowLog shorten the logfiles? ShowLog uses two methods. a) by date and b) by date. There are always two paramters for every method. The maximum and minimum. ShowLog starts to shorten if the logfile meets the maximum and shortens to the minimum. Let us asume CUT_AFTER_DAYS is at 50 und CUT_DAYS at 30. The logfile itself is 52 days old. ShowLog now strips of 22 days. So 30 days will remain in the logfile. If ARC_LOGS is set to yes, ShowLog will store these 22 days in ARC_PATH. Keep in mind: The keywords above are just default/global settings. It is possible to specify the maximum and minimum for each and every logifle. See descripion of MAILER_LOG, BBS_LOG and LOG in chapter 3.2. Here are some example for better understanding: CUT_LOGS BML - All logfiles will be shortened (BBS, Mailer and LOGfiles). MAILER_LOG e:\log\mcmail$TASK$.log,McMaillogfile,NO_ARC,-1,-1,50,30 - The mailer logfile will not be stored, the log will be shortened from 50 to 30 days. ══════════════════════════════════════════════════════════════════════════════ Shorten Page 22 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── LOG c:\log\sl.log,ShowLog Logfile,SIZE_ONLY,ARC,200000,100000 - This log will be shortened by size, stored. (200kb to 100kb) LOG c:\log\fe.log,FastEcho Logfiles,FD,ARC,200000,100000,60,30 - This logfile will be shortened using both methods. The logfile is FD-Style. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7. HOW TO USE SHOWLOG ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├────────────────────────┬──────────────────────────────────────────────────┘ │▒▒ 7.1. TASKS ▒▒▒▒▒▒▒▒▒▒│ └────────────────────────┘ By pressing ALT+T you can switch the active task. Pressing ctrl+left/right is also possible. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.2. INBOUND/OUTBOUND ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing F4 you can switch between inbound and outbound. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.3. REPORTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Pressing ALT+R allows you to create reports. SHOWLOG will use the selected task and date. SHOWLOG will ask you whether you want the report created as a netmail or as a plain ascii text. If you choose ascii text you now will be presented the path+filename which SHOWLOG read in from SHOWl.CFG under REPORT_TEXT. You can now just press enter or alter the path+ filename. If the file already exists, SHOWLOG will ask you to append the new report to it or to overwrite it. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.4. DATE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+D you can choose any date SHOWLOG should use. Pressing Cursor Left/Right will decrease/increase the date. ══════════════════════════════════════════════════════════════════════════════ ALT+T, Inbound/Outbound, ALT+R, ALT+T, ALT+L Page 23 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.5. INTERNAL LOGFILE VIEWER ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Press ALT+L. SHOWLOG will allow you to specify additional log/textfiles in SHOWL.CFG which then can be viewed by using SHOWLOG'S internal logfile viewer. The maximum is 50 entries. (only 2 in the unreg. version) Syntax: LOG <path+filename>,<description>. If you execute the internal viewer, SHOWLOG will present the descriptions. By using the cursor keys you can select any logfile to view it. THE INTERNAL LOGFILE VIEWER TOGETHER WITH AN EXTERNAL EDITOR: In case you have specified an external editor using the keyword EDITOR, SHOWLOG allows you to press ALT+E while viewing any log/text file to edit it. Note: The full path and filename of the current log/text file will be given to the editor as an parameter. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.6. INDEXES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By setting USE_INDEX to YES, SHOWLOG will use small indexes reading your logfiles. This will increase the reading speed enormously. Every time you start SHOWLOG, the index will be updated/(re)created. There will be one index for every logfile. (e.g.: MD1.NDX, MD2.NDX). The index files are located in the same directory with SHOWL.EXE. By pressing ALT+I you can force SHOWLOG to rebuild its index files. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.7. RE-READ LOGFILES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+N you can re-read your logfiles (and update the indexes). ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.8. CALLERS OF ALL LINES IN ONE WINDOW ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+A all callers of all lines will be shown in one window just as you know it from one line. Use parameter -T:M to force this feature upon startup. ══════════════════════════════════════════════════════════════════════════════ External Editors, ALT+I, ALT+N, All Lines in 1 window, Statistics Page 24 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 7.9. STATISTICS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+S SHOWLOG will create a small statistic. You can save it by pressing ALT+S or edit it pressing ALT+E. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 8. FAX-FEATURES OF SHOWLOG ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 9. COLOR DEFINITIONS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 10. MISCELLANEOUS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Pressing ALT+S while viewing a logfile extract will allow you to save this extract in a text file. While viewing a logfile extract you can press ALT+N to generate a small netmail addressed to the caller. Note: To use this feature you have to specify an external editor. COST CALCULATION: .. is just implemented in a very simple form. (see COST.CF~/COST.CFG) There is very good program which does this perfectly for almost every mailer. Freq. FDLOG at 2:314/20. Try it. It's perfect! ══════════════════════════════════════════════════════════════════════════════ Fax-Features, Color Definitions of ShowLog, Misc., ALT+N, Appendix Page 25 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ APPENDIX ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ A1: Files EXAMPLE.CFG - Example configuration (English; rename to SHOWL.CFG) SHOWL.EXE - Dos executable SHOWLOS2.EXE - OS/2 executable SHOWL386.EXE - DPMI executable RTM.EXE - Necessary for the DPMI version SHOWL.DOC - English documentation for SHOWLOG REGINFO.DOC - Registration-informations (English) HISTORY.TXT - the history of SHOWLOG OS2ICONS.ZIP - contains a few OS/2 icons for SHOWLOG README.1ST - Important information for the current version UPDATE.DOC - How to update from a previous version SITES.DOC - Current support and reg-sites of TRIBBLE M COST.CF~ - Example configuration file for cost calculation COLOR.CF~ - Example configuration file for self defined colors REGFORMS.ZIP - Official Reg. Forms for SHOWLOG. TEMPLATE.ZIP - Example template files for SHOWLOG. COLORS.ZIP - Example Color files SELFDEF.ZIP - Example files how to define a MAILER/BBS ══════════════════════════════════════════════════════════════════════════════ Fax-Features, Color Definitions of ShowLog, Misc., ALT+N, Appendix Page 26 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── A2: Copyrights/Notes/etc. Copyright: ~~~~~~~~~~ SHOWLOG (C)opyright by Marcel Becker & Soeren Boettner; 1996,97 Notes: ~~~~~~ SHOWLOG is provided 'as is', without warranty of any kind, neither expressed nor implied. The author only guarantees that SHOWLOG and the included tools occupy disk space. In no event will the author be liable to you for any damages, in- cluding lost profits, lost savings or other incidental or consequential damages arising out of the use of this program. All mentioned products and packages are copyrighted by and trade- marks of their respective holders. Modification, reverse engineering and "run-time" manipulation of any of the files included in the SHOWLOG packages - especially deve- lopment, distribution and use of so-called "patch programs" which modi- fy the executables - is strictly prohibited and will result in immedia- te legal action. Where to get the latest version of SHOWLOG can be found in SITES.DOC. Future: ~~~~~~~ An OS/2-PM Version will soon be released. ══════════════════════════════════════════════════════════════════════════════ Fax-Features, Color Definitions of ShowLog, Misc., ALT+N, Appendix Page 27 User's Manual for Show-Log 1.30 (C) by TRIBBLE M - 1996,97 ────────────────────────────────────────────────────────────────────────────── Credits: ~~~~~~~~ Authors: Soeren Boettner: Programming Marcel Becker: Design & Documentation Carsten Kruse: Idea & Testing ;) Terry O'Hearn: English Documentation (Thank You!) Many thanks go to: Thomas Rohnfeld Thomas Burgau Markus Kaemmerer Peter Liebchen Oliver M. Wimmer Peter Hampf Beta-Team: Stefan Schlamp 2:2461/315 FrontDoor 2.12/2.20 DOS/OS2/WIN95 Oliver M. Wimmer 2:246/1600 T-Mail OS2 Markus Kaemmerer 2:248/2004 T-Mail OS2 Heinz Matthes 2:2464/33 InterMail 2.50 DOS/NWDOS Wolfgang Trenz 2:245/6851 Binkley 2.60 WIN95 Achim Theobald 2:245/6844 CantaLoup OS2 Lothar Lindinger 2:314/20 McMail 1.0 OS2 Erik Sturm 2:248/6301 MainDoor/2 1.10 OS2 Daniel Kirstenpfad 2:248/6601 MainDoor/2 1.10 OS2 Peter Hampf 2:241/1090 FrontDoor 2.30 DOS Alexander Hoppe 2:241/1104 Xenia OS2 Jan Dierich 2:2454/522 Xenia OS2 Sven Wachsmuth 2:248/2004.38 T-Mail WIN95 Andreas Garten 2:249/3540 McMail 1.0 OS/2 How we can be reached: If possible, please use: showlog@tribble-m.com Soeren Boettner: FIDO: 2:248/4004.2 E-Mail: sb@ttb.tribble-m.com Marcel Becker: FIDO: 2:248/4004 E-Mail: mb@ttb.tribble-m.com Send a mail to listserv@ttb.tribble-m.com and place SUBSCRIBE TRIBBLEM in the body of the mail to subscribe to tribblem@ttb.tribble-m.com, the tribble-m mailinglist. Wishes and bug reports are welcome and should be send to the addresses above. This document was compiled with DocForma from Lothar Lindinger. ══════════════════════════════════════════════════════════════════════════════ Fax-Features, Color Definitions of ShowLog, Misc., ALT+N, Appendix Page 28