home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / OS2 / SL13A8.ARJ / SL13A8.ZIP / SL13A8.RAR / UPDATE.DOC < prev   
Encoding:
Text File  |  1997-09-11  |  11.9 KB  |  505 lines

  1.  
  2.   HOW TO UPDATE SHOW-LOG FROM A PREVIOUS VERSION
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.   You may use the build-in update feature of the menu driven setup
  5.   as well.
  6.  
  7.   1.30.alpha7 -> 1.30.alpha8
  8.   ~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.   1. Delete your old index files in .\INDEX
  10.  
  11.   2. Include follwing lines in your config file:
  12.  
  13. ;
  14. ; Full path and filename of the statistic template ShowLog should use.
  15. ; Please refer to SHOWL.DOC for details.
  16. ;
  17. STATIST_TEMPLATE statist.tpl
  18. ;
  19.  
  20.   3. Read documentation for the new statistic template feature
  21.  
  22.  
  23.   1.30.alpha6 -> 1.30.alpha7
  24.   ~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.   ! No need to update any config-file
  26.  
  27.   Read history.txt for new features
  28.  
  29.   1.30.alpha5 -> 1.30.alpha6
  30.   ~~~~~~~~~~~~~~~~~~~~~~~~~~
  31.   ! No need to update any config-file
  32.  
  33.   1.30.alpha4 -> 1.30.alpha5
  34.   ~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.   ! No need to update any config-file
  36.  
  37.   1.3.alpha3 -> 1.3.alpha4
  38.   ~~~~~~~~~~~~~~~~~~~~~~~~
  39.   ! New Syntax for LOG, MAILER_LOG & BBS_LOG.
  40.     Please read documentation!
  41.  
  42.   1. Include follwing lines in your config file:
  43.  
  44. ;
  45. ; Default settings for shorten/storing
  46. ; Minimal value of days a logfile should have
  47. ;
  48. CUT_DAYS 30
  49. ;
  50. ; Default settings for shorten/storing
  51. ; Maximal value of days a logfile should have
  52. ;
  53. CUT_AFTER_DAYS 50
  54. ;
  55. ; Default settings for shorten/storing
  56. ; Minimal value of bytes a logfile should have
  57. ;
  58. CUT_TO_SIZE 100000
  59. ;
  60. ; Default settings for shorten/storing
  61. ; Maximal value of bytes a logfile should have
  62. ;
  63. CUT_SIZE_ABOVE 200000
  64. ;
  65. ; Default settings for shorten/storing
  66. ; Should the old parts of the log be stored as an archive?
  67. ;
  68. ARC_LOGS Yes
  69. ;
  70. ; Path, the logfiles should be stored in
  71. ;
  72. ARC_PATH e:\logs\archive
  73. ;
  74. ; The name the stored logs should have.
  75. ; 4 macros are possible:
  76. ; @days@, @month@, @year@ und @year2@. 
  77. ; @year@:4 digits  @year2@: 2 digits.
  78. ;
  79. ARC_NAME @days@@month@year2@
  80. ;
  81. ; Definition of the program which should be used to arc your logfiles.
  82. ; Macros: @archive@ und @files@
  83. ;
  84. ARC_PACKER rar m -ep @archive@ @files@
  85. ;
  86. ; Default settings for K:[L/B/M]
  87. ;
  88. CUT_LOGS LBM
  89. ;
  90.  
  91.   1.3.alpha2 -> 1.3.alpha3
  92.   ~~~~~~~~~~~~~~~~~~~~~~~~
  93.   ! A new keyfile is required. Read README.1ST.
  94.  
  95.   1. Delete following keywords from you config file:
  96.  
  97.   PKT_SUBJECT
  98.   NM_SUBJECT
  99.  
  100.   2. Include follwing lines in your config file:
  101.  
  102. ;
  103. ; Which subject should created netmails have? 
  104. ; ($TASK$ and $DATE$ is possible)
  105. ;
  106. ; Reports:
  107. ;
  108. REP_NM_SUBJ Report: Line $TASK$ on $DATE$
  109. ;
  110. ; Statistics:
  111. ;
  112. STAT_NM_SUBJ BBS stats
  113. ;
  114. ; The password generated PKTs should have
  115. ;
  116. PKT_PASSWORD secret
  117. ;
  118. ; Subject the generated mails should have (statistics)
  119. ;
  120. STAT_EM_SUBJ BBS statistics
  121. ;
  122. ; Subject the generated mails should have (reports)
  123. ;
  124. REP_EM_SUBJ BBS statistics
  125. ;
  126. ; Wich subject should caller netmails have for default
  127. ;
  128. CALLER_SUBJ Your Call
  129. ;
  130. ; The mode ShowLog should start external programs in
  131. ; F=fullscreen, W=windowed
  132. ;
  133. START_APP F
  134. ;
  135. ; Switches the ENTER/CTRL+ENTER feature for faxcalls
  136. ;
  137. ;SHOW_FAX_PRIMARILY No
  138. ;
  139.  
  140.  
  141.   1.3.alpha1 -> 1.3.alpha2
  142.   ~~~~~~~~~~~~~~~~~~~~~~~~
  143.   1. Delete ALL index files!
  144.  
  145.   2. Include following lines in your config file:
  146.  
  147. ;
  148. ; Path of your received faxes
  149. ;
  150. FAX_PATH e:\fax
  151. ;
  152. ; ID, path+filename and description of a logfile of an external fax program
  153. ; Supported (=ID): BGFAX, internal
  154. ;
  155. FAX_LOG BGFAX,e:\faxes\bgfax.log,bgfax logfile
  156. ;
  157. ; ShowLog is able to replace a phone number of a calling fax with its
  158. ; real name
  159. ;
  160. FAX_CALLER 03124,Joe Fax
  161. ;
  162. ; Strings ShowLog should replace in phone numbers of calling faxes
  163. ;
  164. REPLACE_IN_FAXNR +49,0
  165. REPLACE_IN_FAXNR 036604,
  166. ;
  167. ; Default path and filename ShowLog should write logfile extracts to
  168. ;
  169. SAVE_FILE SAVE.$TASK$
  170. ;
  171. ; ShowLog is able to create netmails as pakets (Squish)
  172. ;
  173. CREATE_NM_AS_PKT No
  174. ;
  175. ; Area the netmails should be posted to
  176. ;
  177. NM_AREA NETMAIL
  178. ;
  179.  
  180.  
  181.   1.22 -> 1.3.alpha1
  182.   ~~~~~~~~~~~~~~~~~~
  183.   1. Include following lines in your config file:
  184.  
  185. ;
  186. ; Full path and filename of an external fax viewer
  187. ;
  188. FAX_VIEWER C:\BGFAX\VIEW.EXE
  189. ;FAX_VIEWER/2 C:\BGFAX2\VIEW2.EXE
  190. ;
  191. ; Should ShowLog be prevented from displaying the whole path in filelists?
  192. ;
  193. NO_PATHS_IN_FILELIST NO
  194. ;
  195. ; Should ShowLog be prevented from displaying the whole path in logextracts?
  196. ;
  197. NO_PATHS_IN_LOG_EXTRACT NO
  198. ;
  199. ; Should ShowLog always highlight the last session in list
  200. ; automaticly?
  201. ;
  202. START_AT_BOTTOM Yes
  203. ;
  204.  
  205.  
  206.   1.2 -> 1.21 & 1.22
  207.   ~~~~~~~~~~~~~~~~~~
  208.   1. Include following lines in your config file:
  209.  
  210. ;
  211. ; Path and filename of the logfile ShowLog should write
  212. ; Note: This logfile will be in binkley  style.
  213. ; This gives you the opportunity to view and shorten it, using 'LOG'
  214. ; ex: LOG E:\ALOG\SL.LOG,BINK
  215. ;
  216. SL_LOG E:\ALOG\SL.LOG
  217. ;
  218. ; Semaphore file which forces ShowLog to build up new indexes
  219. ;
  220. REINDEX_SEMA REINDEX.SL
  221. ;
  222.  
  223.  
  224.   1.1x -> 1.2
  225.   ~~~~~~~~~~~
  226.   NOTE: -Cost-Definition has changed.
  227.          See COST.CF~ for details!
  228.         -New keywords for color definition (see COLOR.CF~ for details!)
  229.  
  230.   1. Include following lines in your new config file:
  231.  
  232. ;
  233. ; Semaphore file which tells ShowLog to reread the logfiles
  234. ;
  235. REREAD_SEMA REREAD.SL
  236. ;
  237. ; Lines ShowLog should use to display
  238. ; (25-75 is possible)
  239. ; NOTE: Not every video card supports every mode!
  240. ;
  241. LINES 25
  242. ;
  243. ; Screensaver: After how many minutes it should become active
  244. ;
  245. SAVER 10
  246. ;
  247. ; Screensaver: The text which should be displayed
  248. ;
  249. SAVER_TEXT ShowLog - simply the best!
  250. ;
  251. ; Path and filename of a template the internal netmail generator should use
  252. ;
  253. USER_NM_TEMPLATE usernm.tpl
  254. ;
  255. ; Defintion for Lines which sould be hidden while viewing logfiles 
  256. ; (TAB-Key)
  257. ; same syntax as HIGHLIGHT_LINES (without colors of course ;)
  258. ;HIDE_LINE *,1
  259. ;
  260. ; Days ShowLog should create the monthly/weekly statistics
  261. ; WEEKLY_STAT_ON <day of the week> 1=monday...7=sunday
  262. ; MONTHLY_STAT_ON <day ot the month>
  263. ;
  264. WEEKLY_STAT_ON 7
  265. MONTHLY_STAT_ON 30
  266. ;
  267. ; Which area the report should be posted to
  268. ;
  269. PKT_AREA STATISTICS.LOCAL
  270. ;
  271. ; Path where the PKT files should be created (Should be the local inbound
  272. ; of your tosser)
  273. ;
  274. PKT_PATH C:\FE\LOCIN\
  275. ;
  276. ; Subject the generated mails should have
  277. ;
  278. PKT_SUBJECT BBS statistics
  279. ;
  280. ; Origin the generated mails should have
  281. ;
  282. PKT_ORIGIN ShowLog - the ultimate log tool
  283. ;
  284. ; Should ShowLog mark 'small' errors?
  285. ;HIDE_SMALL_ERRORS NO
  286. ;
  287. ; You may use BBS_SUBST do specify wich bbs task uses which mailer task
  288. ;
  289. ; BBS_SUBST <mailer task> <bbs task/NO>
  290. ; BBS_SUBST 0 1
  291. ; BBS_SUBST 2 NO
  292. ;
  293. ; Semaphore file which tell ShowLog to exit immediately
  294. ;
  295. TERMINATE_SEMA EXIT.SL
  296. ;
  297. ; Full path and file name of the statistic text
  298. ;
  299. STATIST_TEXT STAT.SL
  300. ;
  301. ; Should ShowLog display a NEW MAIL Line if new mail is found
  302. ; in the netmail folder?
  303. ;
  304. NEW_MAIL_FLAG YES
  305. ;
  306. ; Default value for the TAB option
  307. ;
  308. ;SHOW_SYSOP_IN_LIST YES
  309. ;
  310. ; Path of an alternate netmail directory (Newmail Scan)
  311. ;
  312. ;NEWMAIL_NM C:\FD\NETMAIL\MYMAIL\
  313. ;
  314. ; The Adress, ShowLog should use as origination adress in echomail packets
  315. ;
  316. PKT_AKA 2:248/4999
  317. ;
  318. ; Should ShowLog produce empty stats/reports for lines without any traffic?
  319. ;
  320. SHOW_EMPTY_STAT NO
  321. ;
  322. SHOW_EMPTY_REPORTS_NO
  323. ;
  324. ; Should ShowLog produce a detailed statistic for every line in multiline
  325. ; environments?
  326. ;
  327. DETAILED_STAT YES
  328. ;
  329. ; Default settings for the paramter -K (For more information see
  330. ; the descreption of -K:X[,L/B/M]
  331. ;
  332. CUT_DAYS 30
  333. ;
  334. CUT_LOGS LBM
  335. ;
  336. ; Should ShowLog startup with the Outbound Window?
  337. ;
  338. START_IN_OUTBOUND NO
  339. ;
  340.  
  341.  
  342.   1.0x -> 1.1a/1.1b
  343.   ~~~~~~~~~~~~~~~~~
  344.   NOTE: Color-Definition has changed with this version.
  345.         Color numbers are not longer supported. Use color names instead.
  346.         Read COLOR.CF~/COLOR.CFG for more details.
  347.  
  348.         There is a new macro you may insert in your template files:
  349.         @cost@ 
  350.  
  351.  
  352.   1. Delete following lines in your 1.0x config:        (optional)
  353.  
  354.   HIGHLIGHT             
  355.   HIGHLIGHT_IF
  356.  
  357.   2. Include following lines in your new config-file:   (optional)
  358.  
  359. ;
  360. ; Should SHOW-LOG just show the logfile-extract of an session after 
  361. ; pressing ENTER on an inbound/outbound-call (YES), or should SHOW-LOG
  362. ; display the whole logfile and just jump to the right position (NO).
  363. ;
  364. FILTER_EXTRACT YES
  365. ;
  366. ; Should SHOW-LOG search in all available BBS-Logfiles if it
  367. ; realizes an Mailer->BBS switch?
  368. ; Note: Setting this to YES does only make sense if your mailer task2
  369. ;       does not neccessarily is calling your bbs task2.
  370. ; Note2: In most cases this should be NO
  371. ;
  372. SEARCH_ALL NO
  373. ;
  374. ; Should all settings be saved if ShowLog is aborted so next time you start
  375. ; ShowLog you will be at the same 'position'.
  376. ;
  377. SAVE_LAST NO
  378. ;
  379. ; Should SHOW-LOG start with a small intro screen?
  380. ;
  381. INTRO YES
  382. ;
  383. ; Full path and filename of an external editor
  384. ; Note: ShowLog will append the full path and file name of the current
  385. ;       logfile automaticly
  386. ;
  387. EDITOR C:\DOS\EDIT.COM
  388. ;
  389. ; INCLUDE allows you to 'include' other cfg-files in your main config.
  390. ; ie. your color config file.
  391. ;
  392. ;
  393. INCLUDE COLOR.CFG
  394. INCLUDE COST.CFG
  395. ;
  396.  
  397.   3. Rename COLOR.CF~ to COLOR.CFG     (optional)
  398.   4. Edit COLOR.CFG                    (optional) 
  399.   5. Rename COST.CF~ to COST.CFG       (optional)
  400.   6. Edit COST.CFG                     (optional)
  401.  
  402.  
  403.   1.0 Beta9 -> 1.0x
  404.   ~~~~~~~~~~~~~~~~~
  405.   1. Delete following keywords in your Beta 9 config:
  406.  
  407.   NM_FOOTER
  408.   NM_HEADER
  409.   REPORT_STYLE
  410.  
  411.   2. Include following lines in your Beta 9 Config-File:
  412.  
  413. ;
  414. ; If MULTILINE YES, which is your first task?
  415. ;
  416. BEGIN_COUNT 1
  417. ;
  418. ; Should SHOW-LOG also display your mailer- and bbs-logfiles in the
  419. ; internal logfile-viewer?
  420. ; NOTE: This keyword MUST be situated after MAILER_LOG, BBS_LOG, BEGIN_COUNT,
  421. ;       MAX_TASKS
  422. ;
  423. SHOW_ALL YES
  424. ;
  425. ; Full path and filename of the report-template SHOW-LOG should use.
  426. ; Please refer to SHOWL.DOC for details.
  427. ; The use of $TASK$ is possible: REPORT_TEMPLATE SHOWL$TASK$.TPL
  428. ;
  429. REPORT_TEMPLATE SHOWL.TPL
  430. ;
  431.  
  432.   1.0 Beta8x -> 1.0 Beta9
  433.   ~~~~~~~~~~~~~~~~~~~~~~~
  434.   1. Change the keyword NM_BETREFF to NM_SUBJECT.
  435.  
  436.   2. Include following lines in your Beta8 Config-File:
  437.  
  438. ;
  439. ; The language SHOW-LOG should uses for screen outputs.
  440. ; GERMAN/DEUTSCH or ENGLISH/ENGLISCH
  441. ;
  442. LANGUAGE ENGLISH
  443. ;
  444. ; Should SHOW-LOG be aware of Script-Calls? 
  445. ; This feature is only interesting for FrontDoor-systems.
  446. ; NOTE: Do NOT use this feature, if you don't have FD-Script-Calls!
  447. ;
  448. FD_SCRIPT NO
  449. ;
  450.  
  451.  
  452.   1.0 Beta7x -> 1.0 Beta8x
  453.   ~~~~~~~~~~~~~~~~~~~~~~~~
  454.   1. Include following lines in your Beta7 Config-File:
  455.  
  456. ;
  457. ; Some more logfiles you want to view with the internal logfile viewer of
  458. ; SHOW-LOG. (max. 50; unreg.: 2)
  459. ; Syntax: LOG <path+filename>,<description>
  460. ;
  461. LOG E:\ALOG\OT.LOG,O/T-Track Logfile
  462. LOG E:\ALOG\FE.LOG,FastEcho Logfile
  463. ;
  464. ; Strings, SHOW-LOG should search for. If one of theses strings is found
  465. ; the session entry the string belongs to will be shown in the color
  466. ; you have chosen. (max 20 entrys; unreg. 2)
  467. ; Syntax: HIGHLIGHT_IF <String>,<Foreground>,<Background>.
  468. ; <Foreground/Background> consists of the standard color-numbers.
  469. ; Foreground: 0-15 ; Background 0-7
  470. ;
  471. HIGHLIGHT_IF Terminate,15,1
  472. ;
  473. ; strings which will be shown in _every_ logfile in the selected
  474. ; color if they appear.
  475. ; Same syntax as HIGHLIGHT_IF
  476. ; (max. 20 entrys; unreg. 2)
  477. ;
  478. HIGHLIGHT CONNECT,15,0
  479. HIGHLIGHT ERROR,14,4
  480. ;
  481. ; Name of the file which should be touched (updated) in your
  482. ; semaphore directory (SEMA), to force the mailer to rescan its
  483. ; outbound directory.
  484. ; FrontDoor:         FDRESCAN.NOW
  485. ; MainDoor:          MDRESCAN.NOW
  486. ; Binkley:           BTRESCAN.NOW
  487. ; McMail:
  488. ; NOTE:    T-MAIL doesn't use hardcoded rescan-semaphores. 
  489. ;          So you should use the same filename as in T-MAIL.CTL
  490. ;
  491. RESCAN_SEMA MDRESCAN.NOW
  492. ;
  493. ; Should SHOW-LOG show the names of online users instead of
  494. ; 'Online-User'
  495. ;
  496. SHOW_USER YES
  497. ;
  498. ; Should SHOW-LOG use a fast and small index, reading the logfiles?
  499. ; (see SHOWL.DOC for more details)
  500. ;
  501. USE_INDEX YES
  502. ;
  503.  
  504.   
  505.