home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / NOVELL / SEND_FE1.ZIP / SEND_FE.DOC next >
Encoding:
Text File  |  1990-08-24  |  6.0 KB  |  142 lines
  1.  
  2. SEND_FE         SEND front end utility
  3.  
  4.  
  5. This program works in conjunction with Novell SEND v1.11 and USERLIST
  6. v2.10 for use in Saber (and other) menu shells.
  7.  
  8. It should work with any version of SEND v1.11 or greater, but (since
  9. it depends upon the text output formatting of USERLIST) may have to be
  10. edited for different versions. Better yet, get the DOS or C calls and
  11. poll NetWare directly.
  12.  
  13.  (C)opyright 08/08/90 by Bob Welker. Written in QB v4.5 with code from
  14.     Crescent Software QuickPak Professional library v3.14
  15.  
  16.    Disclaimer : Caveat emptor! No guarantees! You are on your own!
  17.    Released into the user community ... if you use code from this
  18.    please give mention to the few hours I spent writing it.
  19.  
  20.    Acknowledgements : Crescent Software, and their excellent QuickPak v3.14
  21.    Professional libraries. Microsoft, and their equally notable QuickBASIC v4.15
  22.    program.
  23.  
  24.   Saber Menu environment strings used in this program :
  25.  
  26.   S_SERVER=SERVERNAME      current server
  27.   S_USER=SUPERVISOR        current user
  28.   S_FILEDIR=F:\TRASH\      this is where temporary files will be
  29.                            written. F:\TRASH is a directory with all
  30.                            but parental rights for the creation of
  31.                            transient files.
  32.  
  33.  
  34. This program is a front end to the Novell Advanced Netware v2.15 SEND
  35. command. It expects Saber MENU v4.00+ compatable S_FILEDIR, S_SERVER,
  36. and S_USER environment variables to be available in the DOS
  37. environment, but may work without them (if the user has sufficient
  38. rights in the default directory).
  39.  
  40. The 'default server' field is filled from S_SERVER, and temporary
  41. files are created in S_FILEDIR. You can edit, and have the opportunity
  42. to re-edit the server name. Once accepted, you are prompted to enter a
  43. message (which you can re-edit before sending).
  44.  
  45. Finally, USERLIST is run to list the network users currently online,
  46. and allow you to send the message to whomever you select. The default
  47. group name EVERYONE is also included for global message broadcasts.
  48.  
  49. Legal text input box commands are {home}, {left}, {right}, {up},
  50. {end}, {del}, {backspace}, {tab}, and {AltC} (which erases all
  51. text). As an added bonus, both a simple calculator and calendar are
  52. provided.
  53.  
  54. This program has been tested on an EGA Packard Bell PB286 and IBM
  55. 3270/PC running MSDOS v3.30 and Novell Advanced NetWare v2.15, SEND
  56. v1.11, and USERLIST v2.10.
  57.  
  58. SEND_FE features :
  59.  
  60.     ■   written specifically for Saber MENU support, but usable with
  61.         any menu system, or from the command line.
  62.  
  63.     ■   Help screen via 'F1' key
  64.  
  65.     ■   '4-banger' calculator emulator via 'F3' key
  66.  
  67.     ■   Calendar for current month via 'F5' key
  68.  
  69.     ■   Program exit via 'F10' key
  70.  
  71.     ■   Supplies current server name, and allows editing (not too useful
  72.         to us yet, but will when more servers are connected)
  73.  
  74.     ■   Subtracts the length of your network user name from 45 (the
  75.         maximum allowable Novel message length) to prevent your messages
  76.         from being 'cut off'.
  77.  
  78.     ■   Both server name and message text input routines allow fairly
  79.         comprehensive editing flexability (left/right cursor, backspace, del,
  80.         insert, and Control-C, which erases all input from the message box).
  81.  
  82.     ■   Determines who is currently logged into the network (to prevent
  83.         you from sending messages to computers which are off-line), and
  84.         allows you to choose any or all those logged in to receive your
  85.         messages.
  86.  
  87. SEND_FE was written to augment Saber MENU in that there was no easy way to send
  88. a Novell message from the menu. For instance -
  89.  
  90.   ITEM Send Messages {}
  91.     GETP SEND MESSAGE TO : {}12{}
  92.     GETP MESSAGE TO BE SENT : {}50{}
  93.     EXEC SEND "%2" TO %1
  94.     EXEC CLS
  95.  
  96. This would have been fine, except that DOS considers a space as a command line
  97. delimiter, and the %2 parameter (containing the message) would ignore everything
  98. passed the first word. I would imagine most menu programs would have the same
  99. problem (although it appears Marshall McGee's AUTOMENU corrects for this
  100. internally).
  101.  
  102. Originally I had intended to write a quick n' dirty filter to replace the space
  103. character (ASCII 32d) with another 'blank' character (ASCII 255d), but expanded
  104. it to include the above features in order to test some of the routines in the
  105. Crescent Software QuickPak Professional v3.14 library. Although it is
  106. less-than-perfectly color-aware (first time I've written for a color system), it
  107. does run on EGA and the 3270/PC adaptor without looking too ridiculous.
  108.  
  109.  
  110. revision history
  111.  
  112. 08/08/90   Wrote initial version to fix problem with using SEND
  113. v1.00ß     from a batch file (i.e. - as with Saber Menu).
  114.            Bare minimum .. could be improved w/o too much effort
  115.  
  116. 08/09/90   Added support for Saber Menu environment strings
  117. v1.10ß     Changed temporary file creation for unique filenames (to avoid
  118.            problems when multiple users are sending messages simultaneously)
  119.            Added group EVERYONE as 'built-in' global SEND recipient
  120.  
  121. 08/11/90   Added display of current time and date at message input screen
  122. v1.20ß     Added command line parameter handling (not tested)
  123.            Added help and error message boxes    (not tested)
  124.            Experimented with color combinations.
  125.  
  126. 08/22/90   Truncated date display to hr:min format. Rework help screen.
  127. v1.30ß     Drop command line parameter option. Rework input routines.
  128.            Comment source code. Tested on 3270 graphics adaptor. Added
  129.            calculator and calendar. Final beta. Released into user community.
  130.            Note : Made changes in QPRO TEXTIN.BAS module. Renamed TEXTIN2.BAS
  131.  
  132.  
  133. If you have any comments or suggestions (or especially, if you know
  134. how to obtain the user list directly from the OS instead of shelling to
  135. USERLIST, and/or would like to point me at some assembler or QB source code)
  136. drop me a line.
  137.  
  138. Sat  08-25-1990      CIS      73577,1257
  139.                      GEnie    R.A.WELKER
  140. Bob Welker           Exec-PC
  141.  
  142.