CD Shareware Magazine 1996 December

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

/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / DOS / Comunic / SL12A2.ZIP / SHOWL.DOC < prev next >

Wrap

Text File | 1996-07-24 | 48.2 KB | 1,217 lines

▐▒█▀▀█ ▐▒█ █ ▐▒█▀▀█ ▐▒█ ▐▒█ █ ▐▒█ ▐▒█▀▀█ ▐▒█▀▀▀ ▐▒█▄▄▄ ▐▒█▄▄█ ▐▒█ █ ▐▒█ █▐▒█ █ ─── ▐▒█ ▐▒█ █ ▐▒█ ▄▄ ▄▄▄▄█ ▐▒█ █ ▐▒█▄▄█ ▐▒█ ▐▒█ ▐▒█▄▄█ ▐▒█▄▄█ ▐▒█▄▄█ ─────────────────────── Version 1.2 ───────────────────────── Copyright (c) by Marcel Becker & Soeren Boettner; 1996 A comfortable logfile-viewer for MainDoor, FrontDoor, Binkley, T-Mail, McMail, Intermail, Cantaloup, Xenia, RemoteAccess, Maximus, Proboard, SBBS, Concord - for DOS and OS/2 - User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── Directory ───────── 1. Foreword................................................................ 3 1.1. Registration etc.................................................. 3 2. Technical Details....................................................... 4 2.1. MainDoor.......................................................... 4 2.2. FrontDoor 2.12sw/2.02nc........................................... 4 2.3. FrontDoor 2.20ml.................................................. 4 2.4. Binkley........................................................... 4 2.5. T-Mail............................................................ 5 2.6. McMail............................................................ 5 2.7. Other Mailers..................................................... 5 2.8. BBS-Programms..................................................... 5 2.9. Other Connects & Errors........................................... 5 3. Configuration........................................................... 6 3.1. Installation...................................................... 6 3.2. ASCII-Config (Keywords)........................................... 6 LANGUAGE......................................................... 6 BBSNAME.......................................................... 6 SYSOP............................................................ 6 AKA.............................................................. 6 TIME_SLICES...................................................... 6 MULTI_LINE....................................................... 6 MAX_TASKS........................................................ 6 BEGIN_COUNT...................................................... 6 MAILER........................................................... 6 BBS.............................................................. 6 SEMA............................................................. 6 RESCAN_SEMA...................................................... 8 MAILER_LOG....................................................... 8 BBS_LOG.......................................................... 8 SHOW_USER {+}.................................................... 8 USE_INDEX........................................................ 8 FD_SCRIPT........................................................ 8 LOG.............................................................. 8 FILTER_EXTRACT................................................... 8 SEARCH_ALL....................................................... 8 SHOW_ALL......................................................... 8 HIGHLIGHT_IF..................................................... 8 HIGHLIGHT........................................................ 9 HIGHLIGHT_LINE................................................... 9 NETMAIL.......................................................... 9 REPORT_TEXT...................................................... 9 REPORT_TEMPLATE {+}.............................................. 9 REPORT_TO_SYSOP.................................................. 9 REPORT_TO {+}.................................................... 9 KILL_NETMAIL..................................................... 9 NM_SUBJECT {+}................................................... 9 APPEND........................................................... 9 USER_NM_TEMPLATE............................................... 9 INCLUDE.......................................................... 10 COLOR............................................................ 10 COST............................................................. 10 EDITOR........................................................... 10 INTRO {+}........................................................ 10 ══════════════════════════════════════════════════════════════════════════════ Directory Page 1 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── SAVE_LAST........................................................ 10 LINES............................................................ 10 SAVER............................................................ 10 SAVER_TEXT....................................................... 10 4. Program execution....................................................... 10 4.1. paramters......................................................... 10 Examples......................................................... 11 4.2. Automatic reports................................................. 11 4.3. Report templates.................................................. 12 Macros and keywords.............................................. 12 Example template................................................. 13 4.4. Paramter -K:X (Shorten)........................................... 13 5. How to use SHOW-LOG..................................................... 15 5.1. Tasks (ALT+T)..................................................... 15 5.2. Inbound/Outbound (F4)............................................. 15 5.3. Reports (ALT+R)................................................... 15 5.4. Date (ALT+D)...................................................... 15 5.5. Internal Logfile-Viewer (ALT+L)................................... 15 External Editors (ALT+E)......................................... 15 5.6. Indexes (ALT+I)................................................... 16 5.7. Re-Read Logfiles (ALT+N).......................................... 16 5.8. Callers of all lines in one Window (ALT+A)........................ 16 5.9. Statistics (Alt+S)................................................ 16 6. Miscellaneous........................................................... 16 ALT+S - save logfile extract........................................... 16 ALT+N - Generating a simple netmail.................................... 16 Cost calculation....................................................... 16 Appendix................................................................... 17 Meaning of Files....................................................... 17 Copyrights/Notes/etc................................................... 17 Credits................................................................ 18 ══════════════════════════════════════════════════════════════════════════════ Directory Page 2 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 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 allways 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 Kurse (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 oportunity to view the part of the logfile which belongs to the session. SHOW-LOG is aware of mailer-calls as well as of online-calls. SHOW-LOG 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. Marcel Becker, 01.07.1996 ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 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 SHOW-LOG or stop using it ! Any other or further use of this software is strictly forbidden and may result in legal action! To register SHOW-LOG 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, reengineered 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 programm 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 SHOW-LOG without any limits. ══════════════════════════════════════════════════════════════════════════════ Foreword, Registration Page 3 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2. TECHNICHAL DETAILS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├─────────────────────────┬─────────────────────────────────────────────────┘ │▒▒ 2.1. MAINDOOR ▒▒▒▒▒▒▒▒│ └─────────────────────────┘ ! To use SHOW-LOG 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 oder 2.02nc do NOT set the keyword MULTILINE in SHOWL.CFG to YES! ! To use SHOW-LOG 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 SHOW-LOG 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 SHOW-LOG you have to set the paramter LOGLEVEL in BINKLEY.CFG to 4 or higher. ══════════════════════════════════════════════════════════════════════════════ MainDoor, FrontDoor, Binkley Page 4 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.5. T-MAIL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ To get SHOW-LOG 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 SHOW-LOG you have to switsh on following options: + ? ! ~ # You MUST shut down McMail at least once a day. (eg. shortly after midnight.), or SHOW-LOG won't be able to detect every day. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.7. OTHER MAILERS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOW-LOG 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. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.8. BBS-PROGRAMMS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOW-LOG tries to recognize any online call in your mailer-logfile. With SHOW-LOG you also have the oportunity to view the etract of your BBS-logfile. This logfile should be combatible to the following BBS- software: RA, Maximus, Proboard, SBBS or Concord. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 2.9. OTHER CONNECTS & ERRORS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOW-LOG tries to recognize almost every kind of connect. Does your modem responses with FAX or FCON, SHOW-LOG will show this session as a fax-connect. Should there be any errors during any session, SHOW-LOG will show a flashing '!' in front of the session-time ══════════════════════════════════════════════════════════════════════════════ T-Mail, McMail Page 5 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 3. CONFIGURATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├───────────────────────┬───────────────────────────────────────────────────┘ │▒▒ 3.1. INSTALLATION ▒▒│ └───────────────────────┘ It is very easy to install SHOW-LOG. Just unpack the archive in any directory. Then edit the file EXAMPLE.CFG with any ascii-editor. To get SHOW-LOG working you have to rename EXAMPLE.CFG to SHOWL.CFG. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 3.2. ASCII-CONFIG (Keywords) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ LANGUAGE The language SHOW-LOG 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 main-adress (commonly FIDO) example: AKA 2:248/4004 TIME_SLICES Should SHOW-LOG release timescliceses 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 firtst task? example BEGIN_COUNT 1 MAILER Which type of mailer do you use? MD=MainDoor;FD=FrontDoor;BINK=Binkley;TM=T-Mail;MM=McMail IM=InterMail;MSD=Self defined example: MAILER MD NOTE: If you set MAILER to MSD, SHOW-LOG 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, MSD) example: BBS RA NOTE: If you set BBS to BSD, SHOW-LOG 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\ ══════════════════════════════════════════════════════════════════════════════ Config Page 6 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ══════════════════════════════════════════════════════════════════════════════ Config Page 7 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── 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 recomended if you have a multiline-system. example: MAILER_LOG E:\ALOG\MD$TASK$.LOG,[<description>] BBS_LOG Full path+filename of your BBS-logfile The use of $TASK$ is possible and recomended if you have a multiline-system. example: BBS_LOG E:\ALOG\RA$TASK$.LOG,[<description>] SHOW_USER {+} Shows the real name of an online-user instead of 'Online-User'. example: SHOW_USER YES USE_INDEX Forces SHOW-LOG to use a small index reading the logfile. This will increase the reading-time enormoulsy example: USE_INDEX YES FD_SCRIPT Should SHOW-LOG 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/text-files which you want to view with the internal logfile-viewer. (unreg. only 2 logfiles) The use of $TASK$ is possible. Syntax: LOG <path+filename>,<description> FILTER_EXTRACT If set to YES, Show-Log will just display the log extract of the highlighted session. If set to NO, Show-Log 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 SHOW-LOG 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, SHOW-LOG 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 emxample: SHOW_ALL YES HIGHLIGHT_IF Here you can speficy 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>,<Forground>,<Background> example: HIGHLITE_IF Joe Sysop,WHITE,BLUE (All sessions which have the string 'Joe Sysop' in it, ══════════════════════════════════════════════════════════════════════════════ Config Page 8 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── will be displayd 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 spefify 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 speficy a char. Whenever this char appears in the spefied column in any logfile-extract, the whole line will be displayd in the given color. if column=0, <char> will be search somewhere in the line. syntax: HIGHLIGHT_LINE <char>,<column>,<foregr.>,<backgr.> esample: 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 paramter -R:T The use of $TASK$ is also possible. example: REPORT_TEXT E:\ALOG\REP$TASK$.TXT REPORT_TEMPLATE Full path+filename of the report-template SHOW-LOG {+} 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 SHOW-LOG to create a netmail adressed to you. example: REPORT_TO_SYSOP YES REPORT_TO {+} Who else should receive a netmail-report? You can speficy more than one adress. Note: You may specify another template SHOW-LOG should use: Syntax: REPORT_TO <name>,<aka>,<template> example: REPORT_TO Dirk Cosysop,2:248/4004.1 KILL_NETMAIL If this option is set to yes, every created netmail will get the kill/sent-flag. example: KILL_NETMAIL YES NM_SUBJECT {+} The subject created netmails should have.. ($TASK$ and $DATE$ is possible. example: NM_SUBJECT Line $TASK$ of $DATE$ 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 ══════════════════════════════════════════════════════════════════════════════ Config Page 9 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── generator should use INCLUDE Here you can speficy some other config-files which SHOW-LOG should also read. COLOR [...] Use this to speficy the look of SHOW-LOG 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 (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! ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 4. PROGRAM-EXECUTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├──────────────────────┬────────────────────────────────────────────────────┘ │▒▒ 4.1. PARAMETERS ▒▒▒│ └──────────────────────┘ It is possible to start SHOW-LOG 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 T - Text -T:X only use if MULTILINE ist set to YES starts SHOW-LOG with task X as default without the parameter -T, SHOW-LOG interpretes the TASK environment variable. If there isn't any, SHOW-LOG assumes TASK=1 as default. -T:A Only if you are using the parameter -R: ══════════════════════════════════════════════════════════════════════════════ paramters Page 10 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── 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 SHOW-LOG should use. If you don't use the parameter -D, SHOW-LOG uses the date the internal system clock provides. -D:G Tells SHOW-LOG to use yesterday's date. -C:<config> Tells SHOW-LOG to use a different config file. SHOW-LOG needs the full path and file name of the config file. If you don't use parameter -C:, SHOW-LOG 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 shortend B: Only BBS logfiles will be shortend. -S:<template> Tells SHOW-LOG to use a different template than the one specified with REPORT_TEMPLATE. {+} If you do not specify a path, SHOW-LOG will search in its own directory for the file. -G:T,<file> Will create a small statistic as s textfile. <file> must be the full path and filename of the file to be created. -G:N Will create a small statstic as a netmail. This will use the same settings as for reports. Examples: SHOWL.EXE -T:2 -D:12-01-1996 -R:N -C:C:\FD\SHOW\SHOWL.CFG Creates a reoprt 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. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 4.2. AUTOMATIC REPORTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ SHOW-LOG is able to create reports listing all incoming and ougoing calls of a certain day. (Paramter -R). This feature allows you to automaticly create a netmail-report every night of the day befor. You can choose wheter the report should be created as netmail or as plain ascii-text. Netmails will have your name and aka as origination-adress. ══════════════════════════════════════════════════════════════════════════════ Reports Page 11 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── If you set REPORT_TO_SYSOP to YES then a report to the same adress 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. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 4.3. REPORT-TEMPLATES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you are a registered user of SHOW-LOG you can specify a template SHOW-LOG should use creating its reports by using the keyword REPORT_TEMPLATE. In the original distribution-archiv of SHOW-LOG 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 BEFOR the outbound-block! right: @outbound@<text1> @outbound@<text2> wrong: @outbound@<text1> @desc@<text3> @outbound<text2> So a descriptive part is only be allowed befor an outbound/inbound-block or after an outbound/inbound-block. eg: @desc@<text1> @outbound@<text2> @outbound@<text3> @desc@<text4> Following keywords are allowed: (SHOW-LOG will ignore blank lines) @desc@ - descriptive text @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@ Prename of the current recipient @lrname@ Surname of the current recipient @rname@ Full name of the current recipient @saka@ Your Main-Adress (AKA) @raka@ The adress of the current recipient @bbs@ Your system/BBS-name ══════════════════════════════════════════════════════════════════════════════ Templates Page 12 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── @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 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 SHOW-LOG 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@ ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 4.4. PARAMETER -K:X (Shorten) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ══════════════════════════════════════════════════════════════════════════════ Shorten Page 13 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── └───────────────────────────────────────────────────────────────────────────┘ By using the parameter -K:X you tell SHOW-LOG to shorten all logfiles which are stated in SHOWL.CFG. All entries older than X days will be cut out. The variabe $TASK$ will be used in addition with MAX_TASKS. Let us assume you have set MAILER_LOG to C:\MD$TASK$.LOG and BBS_LOG to C:\RA$TASK$.LOG. MAX_TASKS ist set to 3. The result would be that the following logfiles will be shortend: C:\MD1.LOG, C:\MD2.LOG, C:\MD3.LOG as well as C:\RA1.LOG, C:\RA2.LOG and C:\RA3.LOG. Should a logfile not be found than SHOW-LOG will write this to the file SHOWL.ERR and will continue with the next file untill it reaches the maximum amount of MAX_TASKS. ! CAUTION: If you are using InterMail, FrontDoor or McMail make sure to shut down the line you are shorten the logfile of! ══════════════════════════════════════════════════════════════════════════════ Shorten Page 14 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5. HOW TO USE SHOW-LOG ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ ├────────────────────────┬──────────────────────────────────────────────────┘ │▒▒ 5.1. TASKS ▒▒▒▒▒▒▒▒▒▒│ └────────────────────────┘ By pressing ALT+T you can switch the active task. Pressing ctrl+left/right is also possible. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.2. INBOUND/OUTBOUND ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing F4 you can swich between inbound and outbound. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.3. REPORTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Pressing ALT+R allows you to create reports. Show-Log will use the selected task and date. SHOW-LOG 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 SHOW-LOG read in from SHOWl.CFG under REPORT_TEXT. You can now just press enter or alter the path+ filename. If the file already exists, SHOW-LOG will ask you to append the new report to it or to overwrite it. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.4. DATE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+D you can choose any date SHOW-LOG should use. Pressing Cursor Left/Right will decrease/increase the date. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.5. INTERNAL LOGFILE-VIEWER ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Press ALT+L. SHOW-LOG will allow you to specify additional log/textfiles in SHOWL.CFG which then can be viewed by using SHOW-LOG'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, SHOW-LOG 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, SHOW-LOG allows you to press ALT+E while viewing any loo/text file to edit it. ══════════════════════════════════════════════════════════════════════════════ ALT+T, Inbound/Outbound, ALT+R, ALT+T, ALT+L, External Editors Page 15 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── Note: The full path and filename of the current log/text file will be given to the editor as an parameter. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.6. INDEXES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By setting USE_INDEX to YES, SHOW-LOG will use small indexes reading your logfiles. This will increase the reading-speed enormously. Every time you start SHOW-LOG, the index will be updatet/(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 SHOW-LOG to rebuild its index-files. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.7. RE-READ LOGFILES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+N you can re-read your logfiles (and update the indexes). ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.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. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 5.9. STATISTICS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ By pressing ALT+S SHOW-LOG will create a small statistic. You can save it by pressing ALT+S or edit it pressing ALT+E. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ 6. 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 adressed to the caller. Note: To use this feature you have to specify an external editor. COSTCALCULATION: .. 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! ══════════════════════════════════════════════════════════════════════════════ ALT+I, ALT+N, All Lines in 1 window, Statistics, Misc., ATL+N Page 16 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒ APPENDIX ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ A1: Files EXAMPLE.CFG - Example configuration (English; rename to SHOWL.CFG) SHOWL.EXE - DOS-Executable SHOWLOS2.EXE - OS/2-Executable SHOWL.DOC - English documentation for SHOW-LOG REGINFO.DOC - Registration-informations (English) HISTORY.TXT - the history of SHOW-LOG MDLANG.ZIP - Languagefiles for MainDoor 1.10 107Beta OS2ICONS.ZIP - contains a few OS/2-icons for SHOW-LOG README.1ST - Important informations 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-calulation COLOR.CF~ - Example configuration file for self definied colors REGFORMS.ZIP - Official Reg.-Forms for SHOW-LOG. TEMPLATE.ZIP - Example-Template files for SHOW-LOG. COLORS.ZIP - Example Colorfiles SELFDEF.ZIP - Example files how to define a MAILER/BBS A2: Copyrights/Notes/etc. Copyright: ~~~~~~~~~~ SHOW-LOG (C)opyright by Marcel Becker & Soeren Boettner; 1996 Notes: ~~~~~~ SHOW-LOG is provided 'as is', without warranty of any kind, neither expressed nor implied. The author only guarantees that SHOW-LOG and the included tools occupy diskspace. 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 Show-Log 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 SHOW-LOG can be found in SITES.DOC. Future: ~~~~~~~ ══════════════════════════════════════════════════════════════════════════════ Appendix Page 17 User's Manual for Show-Log 1.2 (C) by TRIBBLE M ────────────────────────────────────────────────────────────────────────────── 1.2 Release Well, More features ;), the first 1.2 betas. Credits: ~~~~~~~~ Authores: Soeren Boettner: Programming Marcel Becker: Design & Documentation Carsten Kruse: Idea, Documentation & Testing ;) Many thanks go to: Thomas Rohnfeld Thomas Burgau Markus Kaemmerer Peter Liebchen Oliver M. Wimmer Beta-Team: Joachim Grabinski 2:248/8001 FrontDoor 2.20 Oliver M. Wimmer 2:246/1600 T-Mail Markus Kaemmerer 2:248/2004 T-Mail Heinz Matthes 2:2464/33 InterMail 2.29h Roger Remark 2:245/6853 Binkley 2.59 Lothar Lindinger 2:314/20 McMail 1.0g5 Kevin Miller 1:218/921 InterMail 2.29g Erik Sturm 2:248/6301 MainDoor/2 1.10 Daniel Kirstenpfad 2:248/6601 MainDoor'95 1.10 Peter Hampf 2:241/1090 FrontDoor 2.30 How we can be reached: Marcel Becker: FIDO: 2:248/4004 E-Mail: mb@ttb.gera.thur.de Soeren Boettner: FIDO: 2:248/4004.2 E-Mail: mb@ttb.gera.thur.de Wishes and bugreports are welcome and should be send to the adresses above. This document was compiled with DocForma from Lothar Lindinger. ══════════════════════════════════════════════════════════════════════════════ Appendix Page 18