home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / networks / xnews130.zip / MANUAL.DOC < prev    next >
Text File  |  1993-10-01  |  13KB  |  354 lines
  1. x-NEWS3 Network News Login System
  2. Version 1.30 - Revised 10/01/93
  3. Extensions Software Corporation
  4.  
  5.  
  6. Operations Guide Table of Contents
  7. ----------------------------------
  8. Shareware Note..................................... 2
  9. Disclaimer Agreement............................... 2
  10. Copyright Notice................................... 2
  11. Trademarks Notice.................................. 2
  12. Introduction....................................... 3
  13. Requirements....................................... 3
  14. Installation....................................... 4
  15. Configuration File..................................5
  16. News/Announcement Files............................ 7
  17. x-NEWS3 Display.................................... 7
  18. Technical Support.................................. 8
  19.  
  20.  
  21. Ombudsman Statement
  22. -------------------
  23. Extensions Software Corporation is a member of the Association of
  24. Shareware Professionals (ASP). ASP wants to make sure that the
  25. shareware principle works for you. If you are unable to resolve a
  26. shareware-related problem with an ASP member by contacting the member
  27. directly, ASP may be able to help. The ASP Ombudsman can help you
  28. resolve a dispute or problem with an ASP member, but does not provide
  29. technical support for members' products. Please write to:
  30.  
  31.           _______
  32.      ____|__     |               (r)
  33.   --|       |    |-------------------     ASP Ombudsman
  34.     |   ____|__  |  Association of        545 Grover Road
  35.     |  |       |_|  Shareware             Muskegon, MI 49442-9427 USA
  36.     |__|   o   |    Professionals         616-788-2765 FAX
  37.   -----|   |   |---------------------     70007,3536 CompuServe
  38.        |___|___|
  39.  
  40.  
  41. x-NEWS3 Operations Guide - Page 2
  42.  
  43.  
  44. Shareware Note
  45. --------------
  46. This program is being distributed as shareware or try-before-you-buy
  47. software. You are granted a temporary license to use and evaluate the
  48. program, but continued use after the initial testing period requires
  49. registration with Extensions Software Corporation.
  50.  
  51. This unregistered software version contains the following limitations
  52. and/or characteristics:
  53.  
  54.   - Registration reminder screens will be displayed.
  55.   - The maximum number of users allowed is 10.
  56.  
  57. Registration of this software provides users with the following:
  58.  
  59.   - Serialized disks (dual media) of the latest software without
  60.     registration reminder screens and without user limitations
  61.   - Desk-top-published, laser-printed operations guide
  62.   - Technical support by mail/phone/FAX/BBS/CompuServe
  63.   - Notification of major software updates/upgrades
  64.   - New product announcements
  65.  
  66.  
  67. Disclaimer Agreement
  68. --------------------
  69. Users of this program must accept the following disclaimer of
  70. warranty:
  71.  
  72.   THIS SOFTWARE AND OPERATIONS GUIDE ARE SUPPLIED AS IS. EXTENSIONS
  73.   SOFTWARE CORPORATION DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED,
  74.   INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY AND
  75.   FITNESS FOR ANY PURPOSE. EXTENSIONS SOFTWARE CORPORATION ASSUMES NO
  76.   LIABILITY FOR DAMAGES, EITHER DIRECT OR CONSEQUENTIAL, WHICH MAY
  77.   RESULT FROM THE USE OF THIS SOFTWARE.
  78.  
  79.  
  80. Copyright Notice
  81. ----------------
  82. The x-NEWS3 software and x-NEWS3 operations guide are copyrighted (c)
  83. 1993 by Extensions Software Corporation. All Rights Reserved.
  84.  
  85.  
  86. Trademarks Notice
  87. -----------------
  88. Banyan, VINES, and StreetTalk are trademarks of Banyan Systems, Inc.
  89. Novell and NetWare are trademarks of Novell, Inc.
  90. IBM and PC DOS are trademarks of International Business Machines Corp.
  91. MS DOS is a trademark of MicroSoft Corp.
  92.  
  93. All other product names and/or trademarks used within the software or
  94. operations guide are the property of their respective companies.
  95.  
  96. x-NEWS3 Operations Guide - Page 3
  97.  
  98.  
  99. Introduction
  100. ------------
  101. x-NEWS3 is a network software product from Extensions Software
  102. Corporation that provides a low-cost, easy-to-maintain method of
  103. displaying company news, information, notices, announcements, and
  104. bulletins to network users.
  105.  
  106. x-NEWS3 features include the following:
  107.  
  108.   - Automatic tracking of news/announcements read per user
  109.  
  110.   - Configurable display intervals (every network login or only once
  111.     on specified days of the week) per news/announcement
  112.  
  113.   - Use of standard ASCII text files for notices and announcements
  114.  
  115.   - Use of imbedded macro commands to add color to news and
  116.     announcements
  117.  
  118.   - Use of imbedded control macro commands for displaying the logged
  119.     in user name and for centering text
  120.  
  121.   - Up to 25 news/announcement files with up to 20 lines of text each
  122.  
  123.   - Configurable system name and display timeout
  124.  
  125.   - Network-aware of both Banyan VINES(R) and Novell NetWare(R)
  126.  
  127.  
  128. Requirements
  129. ------------
  130. For Standalone PC Use:
  131.  
  132.   - IBM or 100% compatible computer with 256K available memory
  133.   - Floppy disk drive (5.25" 360K or 1.2M, or 3.50" 720K or 1.44M)
  134.   - Fixed disk drive
  135.   - Monochrome or color (CGA/EGA/VGA) display
  136.   - MS or PC DOS 3.1 or higher
  137.  
  138. For Network Use:
  139.  
  140.   Banyan VINES(R) or Novell NetWare(R) network operating system and
  141.   workstations that meet the standalone PC requirements listed above.
  142.  
  143. x-NEWS3 Operations Guide - Page 4
  144.  
  145.  
  146. Installation
  147. ------------
  148. The x-NEWS3 diskette (or self-archived/zipped file) contains the
  149. single X-NEWS3.EXE executable program.
  150.  
  151. The x-NEWS3.EXE file can be copied to any network or standalone PC
  152. subdirectory and then executed.
  153.  
  154. The example explained below, however, offers maximum security benefits
  155. for installation on a computer network. Note that you must have ADMIN
  156. or SUPERVISOR rights to all specified subdirectories in order to
  157. install and initially run x-NEWS3.
  158.  
  159. To install x-NEWS3:
  160.  
  161. A) Create three subdirectories on your standalone PC or your network
  162.    file server per the following example:
  163.  
  164.    1) \NEWS
  165.    2) \NEWS\DATA
  166.    3) \NEWS\TEXT
  167.  
  168.    ...where:
  169.  
  170.    Subdirectory  Contents                            User Access
  171.    ------------  ----------------------------------  -----------------
  172.    \NEWS         The X-NEWS3.EXE file                Read-Only
  173.    \NEWS\DATA    The database and index files        Read/Write/Modify
  174.    \NEWS\TEXT    The news/announcement text files    Read-Only
  175.  
  176. B) Copy the X-NEWS3.EXE file from the floppy diskette to the \NEWS
  177.    subdirectory.
  178.  
  179. C) At the DOS prompt, type X-NEWS3 followed by the data
  180.    volume/subdirectory name plus the news volume/subdirectory name.
  181.  
  182.    For example, assuming that drive volume N: is the network drive,
  183.    the syntax to start x-NEWS3 would be as follows:
  184.  
  185.    N:\NEWS\X-NEWS3 N:\NEWS\DATA N:\NEWS\TEXT
  186.  
  187.    Typically, this DOS command line syntax would be included in a
  188.    batch file which is subsequently called by a Banyan VINES POSTLOGIN
  189.    command or by the Novell NetWare SYSTEM LOGIN script.
  190.  
  191.    Note that if x-NEWS3 has been installed on a Banyan VINES network,
  192.    the user login name is obtained directly from StreetTalk(tm). If
  193.    x-NEWS3 has been installed on a Novell NetWare network, the user
  194.    login name and unique NIC address are obtained directly from the
  195.    network operating system. Otherwise, the user name for x-NEWS3
  196.    defaults to LOCAL USER.
  197.  
  198. D) x-NEWS3 will self-install when run for the first time by creating
  199.    the necessary database/index files, the X-NEWS3.CFG configuration
  200.    file, and two sample news text files named NEWS_01 and NEWS_02.
  201.  
  202. x-NEWS3 Operations Guide - Page 5
  203.  
  204.  
  205. Configuration File
  206. ------------------
  207. The X-NEWS3.CFG configuration file allows easy maintenance of certain
  208. x-NEWS3 operating parameters as well as announcement/news file names,
  209. descriptions, and display intervals.
  210.  
  211. When first installed, x-NEWS3 will automatically create the following
  212. X-NEWS3.CFG configuration file:
  213.  
  214.   * x-NEWS3 Configuration File *
  215.   *----------------------------*
  216.   SYSNAME = XYZ Corporation IMS
  217.   DISPLAY = 45
  218.   FILE_01 = NEWS_01
  219.   DESC_01 = x-NEWS3 Welcome!
  220.   DAYS_01 = SUN MON TUE WED THU FRI SAT
  221.   FILE_02 = NEWS_02
  222.   DESC_02 = Required Virus Scans
  223.   DAYS_02 =
  224.  
  225.   ...where:
  226.  
  227.   Parameter  Description
  228.   ---------  -------------------------------------------------------
  229.   SYSNAME    The name assigned to your x-NEWS3 system or location
  230.   DISPLAY    The screen display time per news/announcement (seconds)
  231.   FILE_01    The file name of news/announcement number 1
  232.   DESC_01    The description of news/announcement number 1
  233.   DAYS_01    The display interval for news/announcement number 1
  234.   FILE_02    The file name of news/announcement number 2
  235.   DESC_02    The description of news/announcement number 2
  236.   DAYS_02    The display interval for news/announcement number 2
  237.  
  238. The SYSNAME parameter must be 30 characters or less in length.
  239.  
  240. The DISPLAY parameter is the maximum number of seconds each
  241. news/announcement is displayed to the user, although the user may
  242. advance to the next news/announcement with a single keypress.
  243.  
  244. A maximum of twenty (25) news/announcement files, descriptions, and
  245. intervals may be included in the X-NEWS3.CFG configuration file. These
  246. must be labeled FILE_01/DESC_01/DAYS_01 thru FILE_25/DESC_25/DAYS_25
  247. as indicated in the above example.
  248.  
  249. X-NEWS3.CFG configuration file names (FILE_xx) must be 12 characters
  250. or less in length. Descriptions (DESC_xx) must be 30 characters or
  251. less in length. Intervals (DAYS_xx) must use the following days of
  252. the week syntax:
  253.  
  254.   SUN = Sunday
  255.   MON = Monday
  256.   TUE = Tuesday
  257.   WED = Wednesday
  258.   THU = Thursday
  259.   FRI = Friday
  260.   SAT = Saturday
  261.  
  262. x-NEWS3 Operations Guide - Page 6
  263.  
  264.  
  265. News/announcement interval examples are as follows:
  266.  
  267.   DAYS_xx = SUN MON TUE WED THU FRI SAT --> will be displayed the
  268.                                             first time a user logs
  269.                                             into the network on each
  270.                                             day of the week
  271.  
  272.   DAYS_xx = MON WED FRI                 --> will be displayed the
  273.                                             first time a user logs
  274.                                             into the network on each
  275.                                             Monday, Wednesday, and
  276.                                             Friday
  277.  
  278.   DAYS_xx =                             --> will be displayed EVERY
  279.                                             time a user logs into the
  280.                                             network
  281.  
  282. Note that the X-NEWS3.CFG configuration file may not contain more than
  283. 80 total lines of text, and each line of text may not exceed 70
  284. characters total length.
  285.  
  286. x-NEWS3 Operations Guide - Page 7
  287.  
  288.  
  289. News/Announcement Files
  290. -----------------------
  291. To add news or announcements, simply create them using any ASCII text
  292. editor, copy the files to your x-NEWS3 text subdirectory, and then
  293. include the file names/descriptions/intervals in the X-NEWS3.CFG
  294. configuration file.
  295.  
  296. Each news/announcement text file may have a maximum of twenty (20)
  297. lines of text. Information files that must be displayed but are longer
  298. than 20 lines of text can simply be divided into separate text files.
  299.  
  300. The default news/announcement display color is GRAY. Color macros may
  301. be imbedded into any x-NEWS3 news/announcement text file by including
  302. a proper color command macro enclosed in brackets. Allowable color
  303. command macros include the following:
  304.  
  305.   [RED] = Red
  306.   [WHT] = White
  307.   [GRY] = Gray
  308.   [MAG] = Magenta
  309.   [BLU] = Blue
  310.   [GRN] = Green
  311.   [BRN] = Brown
  312.   [YEL] = Yellow
  313.  
  314. The logged in user name may be displayed in any news/announcement file
  315. by using the [USERNAME] command macro.
  316.  
  317. A line of text in any news/announcement file may be centered by
  318. including the [CENTER] command macro at the beginning of the line of
  319. text.
  320.  
  321. Please examine the sample files NEWS_01 and NEWS_02 for additional
  322. insight as to the use of these x-NEWS3 command macros.
  323.  
  324.  
  325. x-NEWS3 Display
  326. ---------------
  327. Once a news/announcement text screen has been displayed, pressing any
  328. key causes x-NEWS3 to display the next news/announcement. x-NEWS3
  329. always displays news/announcements in numerical order (ie, FILE_01
  330. followed by FILE_02 followed by FILE_03 etc).
  331.  
  332. x-NEWS3 Operations Guide - Page 8
  333.  
  334.  
  335. Technical Support
  336. -----------------
  337. Limited technical support by mail, phone, FAX, BBS, and CompuServe is
  338. provided at no cost to UNREGISTERED x-NEWS3 users during the initial
  339. software evaluation period.
  340.  
  341. Continued technical support by mail, phone, FAX, BBS, and CompuServe
  342. is provided at no cost to REGISTERED x-NEWS3 users.
  343.  
  344. For technical support, please contact:
  345.  
  346. Extensions Software Corporation
  347. 224 Thompson Street  #165
  348. Hendersonville, NC 28792-2805
  349. 704-692-0887
  350. 704-692-8879 FAX
  351. 704-693-0339 BBS @ 14.4 Kbps
  352. 72007,571 CompuServe
  353.  
  354.