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