Network Support Library

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

/ Network Support Library / RoseWare - Network Support Library.iso / logbatch / netmsg.exe / NETMSG.DOC < prev next >

Wrap

Text File | 1993-05-08 | 21.8 KB | 505 lines

Network Message Viewing Utility, (NETMSG) Copyright 1992 Micro-Support 302 Garner Avenue Waldorf, Md. 20602 (301) 843-8234 All Rights Reserved Overview - NETMSG is a utility that allows network administrators to show LAN users a single message or a series of messages. The administrator can opt to show each message only once, or several times. There are several other options that can be configured. A date to start showing this message, or to stop showing it during the logon process. Addtionally, the message requires that the LAN user type something to acknowledge that the message has indeed been read. If messages are not purged from the file, a record is kept showing who has read each item and who has not. Why - Every network administrator has at one time used LOGIN script files to display messages to users. The message displays on the screen with a prompt to 'Press any Key to continue...'. While some users will read this information, others will not. This utility was written to address the latter group. Using NETMSG will allow you to show LAN users important information without getting them into the habit of banging away on the keyboard while trying to login. So in essense it serves two purposes: 1. Show a user a message a specified number of times and requires that they read a portion of it at minimum. 2. Keeps a record of who has read each message and keeps LOGIN interuptions to a minimum. Contents - NETMSG contains the following files: NETMSG.EXE - The main executable MSG_SHOW.DBF - Message database MSG_SHOW.DBT - Message text database MSG_USER.DBF - User database USER_FDX.FDX - Index to user database NETMSG.EXE is the only required file. All of the other files will be created if they do not exist in the current directory. Installation - NETMSG should be installed on the file server by the system administrator. It does not require any specified directory or volume name or other complicated scheme. Simply place the NETMSG.EXE file in a directory that all users will have READ and WRITE access to. READ access is required so they can read the messages. WRITE access is required so that the user database can be updated when a message has been read. If you do not already have a DOS environment variable called 'USER_NAME', you can create one in the LOGIN script or from any batch file. EXAMPLE: - From LOGIN Script: DOS SET USER_NAME="%LOGIN_NAME" From DOS: - SET USER_NAME=DSMITH (or whatever you want) Usage - This utility was written to accept information from the DOS environment. The USER_NAME variable M U S T be set to SUPERVISOR if you wish to use the editing functions. SUPERVISOR is the only name recognized to allow adding/editing/deleting records in the message database. So to create a new message file, follow these steps: 1. Install the software on the file server 2. Insure that users have read/write rights 3. Set an environment variable for each user 4. Set your DOS environment variable to 'SUPERVISOR' 5. Then enter the program name at the DOS Prompt, eg; F:\PUBLIC\SET USER_NAME=SUPERVISOR f:\PUBLIC\NETMSG (your prompt may be different than this) The screen will clear and you will be presented with this prompt. Do message base maintenance ? (Y/N) N Just press the Enter key, and the system will process you just as if you were a normal user logging onto the network. Enter a 'Y' and pressing Enter will bring up the maintance screen. Add Edit Next Prev Memo Del Quit ┌─────────────────────────────────────────────────────────────┐ │Message ID Number ............... 1 │ │Message Start Date .............. 07/09/92 │ │Message Stop Date ............... 07/16/92 │ │Number of Viewing Repetitions ... 3 │ │ByPass Instructions prompt ...... │ │ TYPE 'OK' TO QUIT VIEWING THIS MESSAGE │ │What must the user type to leave? OK │ └─────────────────────────────────────────────────────────────┘ Add a message to the Database If the database is empty (which is the case the first time), You will notice that the message ID number has been incremented to 1 and the cursor is flashing. It is suggested you accept the default message ID. Message ID's are automatically incremented by one. NETMSG as present does not check to see if a duplicate message ID has been entered. You do not have to accept the default ID and can in fact assign any four character ID you wish. You can come up with as complicated a scheme to number messages as you feel comfortable with. (Just DON'T duplicate the ID's). Entering your first message consists of two steps: 1. Complete the fields displayed on the screen 2. Enter the actual message text into the database. The fields and their descriptions from top to bottom are as follows: a. Message ID Pressing the Enter key will accept the default. The ID field is incremented by one automatically. b. Message Start Date This is the date you want the messgae to start appearing. It will default to today's date, but can be overwritten with any date you wish. It is in the format MM/DD/YY. c. Message Stop Date This is the date the message will stop displaying. Start and stop dates are inclusive. The format is the same as the start date and defaults to 7 days later. d. Number of viewing repetitions This is the number of times a user will see the message. You may enter any number from 0 to 99. Entering a zero will result in a user never seeing the message. e. Instructions on how to bypass the message screen. You may enter a one line set of instructions on what the user must type to quit viewing this message. Another alternative to this is to include the instructions in the message text and leave this line blank. It is your choice. f. What must the user type This field contains the keystrokes the user must enter to acknowledge that the message has been read and continue on to the next message or complete the LOGIN process. This is a character field and all entry is converted to uppercase. You could have the user enter OK,YES,ABCD, or any combinations of alphanumeric text. For example, A178CD. It is suggested that you vary the place you include instructions and that you also vary what the user must type. Remember, this utility is supposed to insure that a user will read the message and not merely bang on the keyboard to bypass it. Since you will only be showing it to them a specified number of times, it shouldn't get too boring for them. If you wish, you may leave the 'what the user must type' field blank and the user may just press the enter key to continue on. You should still include the appropriate message in the 'ByPass' field. Once you have entered all the information, you will be prompted if you wish to save the information. Press 'Y' to save or press the Enter key on the default of 'N' if you decide to to save the message. The options in the edit screen are as follows: Add - Add a new record Edit - Edit the contents of the record displayed Next - Skip to the next record in the database Prev - Skip backwards to the previous record Memo - Add/Edit the actual message text Del - Delete this message Quit - Quit from the maintance screen NOTE: Once you quit, the databases are checked for deletions and both files are purged of deleted records and user records that indicated that a message that has been deleted has been read. If you wish to keep a record of messages that have been posted and who has read them, just change the stop date to yesterday's date. It will then remain in the system but will not be shown to anyone else. While the files are being purged, you will see the following message: Checking databases for deletions ... please wait Once the databases have been purged, you will automatically go through the message viewing process. When you have viewed all the messages currently in the system, you will be returned to DOS. Messages are kept in a memo field. (Hence the command 'MEMO' on the menu ). It is suggested you keep messages to about 21 lines of 75 characters each. This will allow them to be displayed on one screen without the user needing to press any keys other than what is required to exit that message. The following figure details the memo editing keys. ╔══│ KEY(s) │═════════════════════│ ACTION │═══════════════════════╗ ║ ║ ║ Right arrow ............... Moves cursor to the right ║ ║ Left arrow ................ Moves cursor to the left ║ ║ Ctrl-Right arrow .......... Moves word right ║ ║ Ctrl-Left arrow ........... Moves word left ║ ║ Ctrl-PgUp ................. Positions cursor at beginning of text ║ ║ Ctrl-PgDn ................. Positions cursor at end of text ║ ║ Ctrl-K-F .................. Search for a word ║ ║ Ctrl-K-L .................. Continue word search ║ ║ Ctrl-T .................... Deletes word ║ ║ Ctrl-Y .................... Deletes line ║ ║ Ctrl-N .................... Insert a line ║ ║ Ctrl-KR ................... Read in a text file ║ ║ Ctrl-KW ................... Write text ║ ║ Ctrl-W ................... Save text and exit ║ ║ End ....................... Moves cursor to the end of line ║ ║ Home ...................... Moves cursor to beginning of line ║ ║ Escape .................... Abort editing ║ ╚═══════════════════════════════════════════════════════════════════╝ Listed below are sample data for the two databases. Notice that USER_NAME DSMITH will see message number one two more times, but will not see message number three anymore because the stop date has been passed. This data assumes that today's date is 07/12/92 Record# MESS_ID START STOP REPS U_PROMPT U_ASK MESS 1 1 07/09/92 07/16/92 3 TYPE 'OK' TO QUIT VIEWING THIS MESSAGE OK Memo 2 2 07/09/92 07/16/92 1 TYPE 'EXIT' TO EXIT THIS MESSAGE OK Memo 3 3 07/09/91 07/10/91 1 READ THE MESSAGE FOR EXIT INSTRUCTIONS! EXIT Memo Record# MESS_ID U_NAME REPS 1 1 DSMITH 2 2 1 SUPERVISOR 0 3 1 JJONES 0 4 2 DSMITH 0 5 3 DSMITH 1 Below is an example of the message viewing screen. Notice how the instructions and what the user was required to type are at the bottom of the screen. The second screen has an example of including the user instructions in the body of the text. The third screen will allow the user to just press the ENTER key. You accomplish this by not placing any required text in the field 'What must the user type'. ┌───────────────────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ Welcome to NETMSG! │ │ │ │ NETMSG is a nifty little program that will allow │ │ you to see important messages when you LOGIN to │ │ the Local Area Network. │ │ │ │ Most messages you will only see once. │ │ │ │ Some messages may appear more often. If you think you │ │ are seeing a message(s) to many times, your │ │ LAN ADMINISTRATOR has the time to hear your concerns. │ │ │ │ We hope you enjoy this NEW utility! │ │ │ │ │ │ │ │ │ └───────────────────────────────────────────────────────────────────────────┘ TYPE 'OK' TO EXIT THIS MESSAGE OK ┌───────────────────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ │ │ This extremely IMPORTANT message requires you to: │ │ │ │ │ │ a. READ the MESSAGE │ │ │ │ b. Type the letters 'EXIT' without the quotes │ │ and then press your ENTER key. │ │ │ │ │ │ Once you do these two things, you'll never have to │ │ bother with this message again! │ │ │ │ │ │ │ │ │ │ │ └───────────────────────────────────────────────────────────────────────────┘ READ THE MESSAGE FOR EXIT INSTRUCTIONS! EXIT ┌───────────────────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ │ │ This extremely IMPORTANT message requires you to: │ │ │ │ │ │ a. READ the MESSAGE │ │ │ │ b. Press the ENTER key to quit viewing this message. │ │ │ │ │ │ │ │ Once you do these two things, you'll never have to │ │ bother with this message again! │ │ │ │ │ │ │ │ │ │ │ └───────────────────────────────────────────────────────────────────────────┘ PRESS THE ENTER KEY TO EXIT THIS MESSAGE DISCLAIMER - MICRO-SUPPORT DISCLAIMS ANY WARRANTY EITHER EXPRESS OR IMPLIED AND ANY CLAIMS AS TO MERCHANTABILITY OF FITNESS FOR ANY PARTICULAR PURPOSE. ALL RISKS IN USING THIS SOFTWARE ARE ASSUMED BY THE USER. USE OF THE SOFTWARE ACKNOWLEDGES AGREEMENT. Distribution - There is no cost associated with this software. Feel free to upload it to Electronic Bulletin Boards, copy it for friends, mail it to business's, or hand carry it to all your business associates. You may not charge for this software or include it as part of a package you do charge for except for a nominal disk duplication fee. If you charge a fee for disks, drop a postcard in the mail to the following address: Micro-Support 302 Garner Avenue Waldorf, Md. 20602 (301) 843-8234 Registration - You don't have to do anything to register this software. Just start using it. If you like this utility, use this utility, have comments about this utility, or would like to suggest enhancements or point out obvious bugs, please drop a note in the mail. Comments and suggestions will be implemeted at my sole discretion, but if you don't make them or I don't think of them, too bad. If you want to send a donation, send it payable to the above. If you have questions call the number above. Additionally, you may reach me in one of the following ways: CIS : 76420,1077 GEnie: MICRO.SUPPT Updates - This is the last update I will send out electronically. Version Control - Version 1.0 July 31, 1992 A suggestion was made to restore the screen colors after leaving the message showing routine. Actually the screen colors were restored, just didn't clear the screen. So you ended up with yellow text on a blue background. Now the screen colors are set back to DOS black and white and then the screen is cleared. Message text is entered separately from the rest of the data. This resulted in a few of my users seeing the screen and the instructions on how to exit, but they never saw the message. This only happened when someone was logging in during the editing process. I suggested that we were trying a new invisible screen color. They bought it! That is a weakness in the way this language handles the text portion of the record. My suggestion to you if it is a big problem; create the message text as an ASCII file and use the Ctrl-K-R keys to read the text into the memo field. It's more work, but then you don't have to explain why you are experimenting with invisible screen colors. AND thats all the suggestions I got! Not bad for a first release of such a wonderful utility! Thanks for all those kind comments, cards and letters. Version .90 July 10, 1992 Completed first bugfree version for release Coming Attractions - Do away with ENVIRONMENT VARIABLES Limit messages to GROUPS or USERS Add Reports to the SUPERVISOR options Add archive database to track all message reads forever Get a real (better) editor for messages Specify alternate USERID's for Adding/Editing etc. Add a USER FEEDBACK/SURVEY option configurable by message. Add a daily quote (might even make it a security type message!) Add option to reset message counter for all USERS or a GROUP Add 'TechnoFlash' to message display These enhancements will constitute a major upgrade and will be available for the nominal charge of $49 US per server. One word of caution to those who are considering purchasing the upgrade. The enhanced version currently takes 2-4 seconds to load on a 4 megabit Token Ring network. The load size is currently 328k. There are many more features, hence the larger file size. Upgrades include a printed bound manual and new disk. The upgrade will not be compatible with older files.