Black Box 4

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

/ Black Box 4 / BlackBox.cdr / lan / netmsg.arj / NETMSG.DOC next >

Wrap

Text File | 1992-07-10 | 18KB | 418 lines

Network Message Viewing Utility, (NETMSG) Copyright (c) 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=DREESE (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 <g>), 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 to boring for them. 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'. 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 <g>). 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 DREESE will see message number one two more times, but will not see message number three anymore because the stop date has been passed. 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 'OK' TO EXIT THIS MESSAGE OK Memo 3 3 07/09/91 07/16/91 1 READ THE MESSAGE FOR EXIT INSTRUCTIONS! EXIT Memo Record# MESS_ID U_NAME REPS 1 1 DREESE 2 2 1 SUPERVISOR 0 3 1 JJONES 0 4 2 DREESE 0 5 3 DREESE 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. ┌───────────────────────────────────────────────────────────────────────────┐ │This is message number two. See the autoexec.bat file? │ │ │ │rem C:\CERTUS\COPYBOOT C: │ │rem C:\CERTUS\CERTUS C:\CERTUS │ │rem C:\CERTUS\CTSRESVS C:\CERTUS\VIRUSDB.DAT │ │rem C:\CERTUS\HISTORY │ │rem C:\CERTUS\FAT │ │prompt=$e[1;33;40m$p$g$e[0;36;40m │ │SET USER_NAME=DREESE │ │call \bat\c5.bat │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └───────────────────────────────────────────────────────────────────────────┘ TYPE 'OK' TO EXIT THIS MESSAGE OK ┌───────────────────────────────────────────────────────────────────────────┐ │STACKS=0,0 │ │DEVICE=C:\DOS\SETVER.EXE │ │DEVICE=C:\HIMEM.SYS │ │DEVICE=C:\DOS\EMM386.EXE ON 2048 /d=128 /PE000 /X=CC00-CDFF /X=D800-DBFF │ │DEVICE=ANSI.SYS │ │DEVICE=C:\SYPLUS\syfiles\aspi4dos.sys /d │ │DOS=HIGH │ │SHELL=C:\COMMAND.COM /P /E:2048 │ │BUFFERS=40 │ │FILES=99 │ │ │ │Thank you for reading this message. Please type 'EXIT' to quit viewing. │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └───────────────────────────────────────────────────────────────────────────┘ READ THE MESSAGE FOR EXIT INSTRUCTIONS! EXIT 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. If you want to send money, send it payable to the above. Since I don't know how many people other than myself would use a utility like this, support is limited. If you have questions call the number above. Version .90 July 10, 1992 Completed first bugfree version for release (hahaha)