home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 01e / lanut201.zip / LANUTILS.DOC < prev    next >
Text File  |  1991-03-13  |  34KB  |  882 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                   LANutils Version 2.01 (2/91)
  8.               
  9.            Essential Tools for your LANtastic network.
  10.                         
  11.                All programs and documentation are
  12.  
  13.    Copyright 1990,1991 by Jon Marbry.  All rights reserved.
  14.                     
  15.                     
  16.  
  17.  
  18.                        --- INTRODUCTION ---
  19.  
  20. I'll take LANtastic over the networks that come in expensive, big
  21. red  boxes  any day. It's fast , flexible, easy to  install, and
  22. easy  on  system resources.  It can be a bit tricky to set up a
  23. turnkey LANtastic network for novice users, though.  Not every user 
  24. on an  office network needs or  even  wants to use  the tremendous
  25. amount  of control that LANtastic  gives over every aspect  of
  26. operation. Managing the details of  print and  mail queueing, server
  27. selection, printer selection  etc. is a frightening, unfamiliar  job
  28. for someone who just wants to run their WordStar or Lotus 123. What
  29. is needed, then is a  way  to minimize  what users  need to know
  30. about the operation  of  the network in order to get their own
  31. computer to cooperate.
  32.  
  33. The SoftMagic LANutils are tools that I've developed over the past
  34. couple of years to make installing and running LANtastic Networks
  35. just a little bit easier.  
  36.  
  37.  
  38.                          -------------------
  39.                          | IMPORTANT NOTE: | 
  40.                          ------------------- 
  41.  
  42. As of this version (2.01, March 1991) SoftMagic is officially out of
  43. business -- I'm doing product development for Artisoft now, and will
  44. no longer charge for LANutils registration.  Any registration fees
  45. that I receive after March 1, 1991 will be returned. 
  46.  
  47. You are free to use and distribute these programs without charge, and
  48. I could definitely use your help in replacing all those old (v1.5 or
  49. worse!) versions of the LANutils that are floating around the
  50. electronic community.  If you see an old copy on a BBS, please upload
  51. this version or let the sysop know that a new version is available on
  52. Artisoft's BBS at (602) 293-0065. 
  53.  
  54. The programs in this package are the latest, completely functional
  55. versions, without the (only slightly obnoxious) "Shareware" message
  56. that graced previously distributed versions.  
  57.  
  58.  
  59.                         -----------------
  60.                         |  SOURCE CODE! |
  61.                         -----------------
  62.  
  63.  
  64. Complete Microsoft C and Assembler source code for the LANutils is now
  65. available on disk for only $25.  Send check or M.O. to 
  66.  
  67.                           Jon Marbry
  68.                           1 E. River Rd, #2517
  69.                           Tucson, AZ 85704
  70.                           USA
  71.  
  72. All LANutils code and support files are included. To build the LANutils
  73. from source, you need
  74.                           - Microsoft C 4.0 or later 
  75.                           - Microsoft MASM 5.1 or compatible assembler
  76.                           - MS compatible LINK utility
  77.                           - EXE2BIN utility
  78.                           - EXEMOD utility
  79.                           - NMAKE or compatible MAKE utility
  80.  
  81.  
  82.  
  83. The programs included in the LANutils package are: 
  84.  
  85.         LOGIN     - allows you to log in to multiple servers 
  86.                     with a single command. Adds system and
  87.                     user "login script" capability.        
  88.                     
  89.         LOGOUT    - log out of one or more servers with a single
  90.                     command.
  91.                     
  92.         WAITFOR   - pause until a given set of servers are online.
  93.         
  94.         FASTNET   - processes entire files of "NET" commands at
  95.                     once, at .
  96.         
  97.         MSET     - allows you to set variables in DOS's "master"
  98.                    environment from login script files and other
  99.                    programs run from secondary command shells.
  100.         
  101.         REBOOT   - causes your computer to reboot as though 
  102.                    Ctrl-Alt-Del had been pressed.                    
  103.                     
  104.         USERLIST  - gives you a neatly organized list of who's 
  105.                     logged in to what server.                                        
  106.  
  107.     INTERCOM   - INTERCOM is a very compact pop-up station
  108.                  to station communication program.    
  109.  
  110.     SYSTEM       - The SYSTEM utility gives your batch files
  111.              the ability to make decisions based on the
  112.              computer's hardware and software configuration.
  113.              
  114.     FU         - FindUser reports the machine names at which
  115.              a given user is logged in.
  116.                   
  117.     SU         - The SendUser utility allows you to send 
  118.                  network messages to users rather than nodes.
  119.                  
  120.     DELAY      - With DELAY, you can cause your batch files to
  121.               pause for a specified period of time.             
  122.                  
  123.     LUSETUP    - LUSETUP allows you to change the screen color
  124.                  and for MESSAGE and INTERCOM and the activation
  125.                  key for INTERCOM and Artisoft's LANPUP.
  126.                          
  127.         MESSAGE    - an improved version of MESSAGE, a pop-up,
  128.                  receive only message handler is also included.
  129.  
  130.         
  131.             --- HARDWARE AND SOFTWARE REQUIREMENTS ---
  132.  
  133. To use the LANutils, you must have a PC, AT, PS/2 or compatible
  134. computer running MS or PC-DOS 3.1 or greater and the LANtastic
  135. Network Operating System (LANOS) version 2.53 or greater.  
  136.  
  137. Special Note for 4DOS users:  
  138.  
  139. If you need to change environment variables from your login
  140. scripts, you must start 4DOS using the /M command line option to
  141. specifiy environment size instead of the normal /E. For example, 
  142.  
  143. SHELL=C:\4DOS.COM /S:B /M:512 /P
  144.  
  145. The /M option keeps 4DOS from swapping the master environment out
  146. of memory every time it loads a program.
  147.  
  148.  
  149.                   *** DISCLAIMER OF WARRANTY ***
  150.  
  151. THESE PROGRAMS ARE PROVIDED ON AN AS-IS BASIS. SOFTMAGIC, INC. AND
  152. BUSINESS NETWORKS OF AMERICA MAKE NO WARRANTY, EXPRESS OR IMPLIED,
  153. AS TO PERFORMANCE, MERCHANTABILITY OR  FITNESS FOR A PARTICULAR
  154. PURPOSE. IN NO EVENT WILL SOFTMAGIC, INC. OR BUSINESS NETWORKS OF
  155. AMERICA BE HELD LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED
  156. TO LOSS OF USE, LOST REVENUE, SPECIAL, CONSEQUENTIAL, INDIRECT OR
  157. SIMILAR DAMAGES, EVEN IF SOFTMAGIC, INC. OR AN AGENT OF SOFTMAGIC,
  158. INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO
  159. EVENT SHALL SOFTMAGIC, INC.'S LIABILITY FOR ANY DAMAGES EVER EXCEED
  160. THE PRICE PAID FOR THE SOFTWARE, REGARDLESS OF THE FORM OF THE 
  161. CLAIM.  
  162.        
  163.                          --- LOGIN ---
  164.  
  165. The LOGIN utility allows you to log onto multiple servers with  a 
  166. single command.  LOGIN is really handy for setting up boot disks 
  167. on floppy-only workstations, since you don't have the overhead of 
  168. loading NET over and over for each login. 
  169.  
  170. In addition, LOGIN provides a "login script" both for servers and 
  171. for  individual  users.  LOGIN  will  automatically  redirect   a 
  172. specified  drive to the server's network directory and execute  a 
  173. batch file keyed to the user's name.   
  174. The syntax for LOGIN is:
  175.  
  176. LOGIN <server list> <user id list> <password list> [/OPTIONS]
  177.  
  178. The  server  list is a list of file servers to  be  logged  into, 
  179. separated by commas.  The list is processed sequentially, left to 
  180. right.  An  asterisk  (*)  in the server  list  field  means  all 
  181. currently available (but not logged in) servers.
  182.  
  183. The  user id list is a list of user ids, one to a server.   Again 
  184. the  list  is scanned from left to right.  If  more  servers  are 
  185. specified  that  ids, the id list will be reused  in  a  circular 
  186. fashion.   This  makes  it easy for you to  log  in  to  multiple 
  187. servers under the same user id.
  188.  
  189. The  password list works the same way as the user id list.  If  a 
  190. question mark (?) is entered as the password for a server,  LOGIN 
  191. will  prompt the user for the password at an  appropriate  point. 
  192. The  password  list  will also be recycled if  more  servers  and 
  193. userids  are  specified than passwords.  If you've got  the  same 
  194. user ID and password on all the servers on your net, you can  log 
  195. in everywhere with the command.
  196.  
  197. LOGIN * USERNAME ?
  198.  
  199. LOGIN  will ask you once for your password, then it will log  you 
  200. on to all the available servers on the net.
  201.  
  202. If  you  omit  any  of the  parameters,  LOGIN  will  prompt  you 
  203. accordingly. For example, the command
  204.  
  205. LOGIN
  206.  
  207. results  in the following exchange: (Text in all caps entered  by 
  208. user)
  209.  
  210. Server: SERVER1,SERVER2
  211. Userid: MANAGER
  212. Password: PASS  (Not really a good idea for a password, of course!)
  213.  
  214.  
  215.                       COMMAND LINE OPTIONS
  216.  
  217. /NODUPLICATES
  218.  
  219. LOGIN's default behavior on encountering a duplicate login  error 
  220. is to log the user out of that server and retry the login without 
  221. saying anything to the user.
  222.  
  223. If  the /NODUPLICATES option is specified, attempts to log in  to 
  224. the same server more than once will be reported as errors.
  225.  
  226. /NOSCRIPT
  227.  
  228. The /NOSCRIPT option allows you to log in without invoking either 
  229. the system or user login script facilities.  This option is  only 
  230. necessary  when the specified servers HAVE login scripts and  you 
  231. want to bypass them.  LOGIN is smart enough not to try to execute 
  232. login scripts on servers that don't have them set up.
  233.  
  234. /SUPPRESS
  235.  
  236. The  /SUPPRESS option prevents LOGIN from displaying ANY  warning 
  237. or  error messages.  If an error does occur however,  LOGIN  will 
  238. still terminate with a non-zero return code, so your batch  files 
  239. can detect any problems.
  240.  
  241. /HELP
  242.  
  243. /HELP displays a brief instruction summary and a list of  command 
  244. line options. If the /HELP option is specified, all other command 
  245. line input is ignored and no action (i.e. logging in) is taken.
  246.  
  247.  
  248.                     THE LOGIN SCRIPT FACILITY
  249.  
  250. A  login script is simply a batch file to be executed whenever  a 
  251. user logs in to a server.  LOGIN supports two types of scripts, a 
  252. system  login  script,  executed by everyone who  logs  into  the 
  253. server,  and  a user specific login script, with commands  to  be 
  254. executed only when a particular user logs in. 
  255.  
  256. With  the login script capability, when a user logs in,  you  can 
  257. set   his  PROMPT,  COMSPEC  and  other  environment   variables, 
  258. automatically configure a set of network devices for him, print a 
  259. welcoming message, display news bulletins, or even log him  right 
  260. back out.
  261.  
  262. LOGIN  expects  all  its login script files to  be  kept  in  the 
  263. server's  network directory, LANTASTI.NET (the \. device  in  the 
  264. NET  menu).  To create a system login script for a  server,  just 
  265. put  the  commands  you  want executed in  a  batch  file  called 
  266. $SYSTEM.BAT  in  the  network directory.  Similarly,  user  login 
  267. scripts are just batch files with the same names as their  users.  
  268. For example user BOB 's login script would be called BOB.BAT.  
  269.  
  270. Login scripts can contain any command that you'd normally use  in 
  271. a batch file. The node name of the user's machine (the name given 
  272. in the REDIR command) is given to both the system and user script 
  273. files as the first parameter, %1, so that you can check it and do 
  274. different things for different stations (like changing COMSPEC on 
  275. floppy based stations to use a faster network disk). A couple  of 
  276. warnings, however: If you use external (disk based) commands,  be 
  277. sure that the user's computer has a path to them. It's easiest to 
  278. do  all your redirections first, set up proper paths,  then  call 
  279. external  commands. 
  280.  
  281. To set environment variables from login scripts you must use the
  282. included MSET utility. MSET works the same way as the DOS SET
  283. command, but it modifies the master copy of the environment, no
  284. matter how many levels deep in shells and menus you may be. For
  285. example, to set the path in a login script, use the command
  286.  
  287. MSET PATH=F:\;F:\UTILITY;F:\LANTASTI
  288.  
  289. A  Brief  Technical  Note:  The login script  facility  works  by
  290. temporarily  redirecting  drive B: on the user's station  to  the
  291. server's  network directory. The redirection is always  cancelled
  292. after the login script is done. I chose B: because most  machines
  293. don't  need to use the B: floppy (even if they really  have  one)
  294. during  bootup.   If  you normally redirect the  B:  drive  to  a
  295. network  drive however, you will have to wait until  after  LOGIN
  296. has executed to redirect it.
  297.  
  298.           
  299.                         --- LOGOUT ---          
  300.                         
  301. LOGOUT allows you to log out of one or more servers with a single 
  302. command. Its syntax is
  303.  
  304.         LOGOUT <server list> [/HELP]
  305.  
  306. The server list is a list of servers separated by commas,  spaces 
  307. or plus signs.  An asterisk '*' is used to specify all  currently 
  308. active servers, so the command
  309.  
  310.         LOGOUT *
  311.                 
  312. will log you out of all the servers that you are currently logged 
  313. into, as will simply entering the LOGOUT command with no arguments.
  314.  
  315. The  only available command line option is the /HELP option.   As 
  316. with  LOGIN, /HELP causes a brief instruction summary and a  list 
  317. of  available  options to be displayed. If  /HELP  is  specified, 
  318. LOGOUT  will take no other action -- it will not log you  out  of 
  319. any servers.
  320.  
  321.  
  322.                         --- WAITFOR ---
  323.                         
  324. OK, this is the situation -- you've set up a small office, with 6 
  325. or  7 computers connected by LANtastic.  They're turned off  each 
  326. night  after work and turned on in the morning.  It's  a  totally 
  327. turnkey system, so the network is started and everyone is  logged 
  328. in automatically.  So far so good.        
  329.                 
  330. Now  here's the problem.  There's no way you can turn 6 or 7  (or 
  331. 10 or 12) computers on at exactly the same time.  Unless you  put 
  332. a
  333.  
  334.         PAUSE "Press any key when all the machines are ready..."
  335.  
  336. statement in the AUTOEXEC file, the automatic logins stand a good 
  337. chance of failing because of missed timing.
  338.  
  339. The solution? 
  340.  
  341.         WAITFOR <list of servers> [/OPTIONS]
  342.         
  343. WAITFOR will cause the computer to pause until all the servers in 
  344. the given list are on line, or until the escape key is pressed or 
  345. optionally until a specified time-out interval is exceeded.        
  346.         
  347.          
  348.                       COMMAND LINE OPTIONS
  349.  
  350. /TIME=[1..999 seconds] (default: no timeout)
  351.  
  352. The  /TIME  option lets you set the maximum length of  time  that  
  353. WAITFOR will sit around and wait for all the specified servers to 
  354. come on line.  If /TIME is not set, WAITFOR will wait forever.
  355.  
  356. /HELP
  357.  
  358. /HELP displays a brief instruction summary and a list of  command 
  359. line options. If the /HELP option is specified, all other command 
  360. line input is ignored and no other action is taken.
  361.  
  362.  
  363.                          --- FASTNET ---
  364.  
  365. Sometimes it seems to take forever for a batch file of "NET  USE" 
  366. commands  to  execute, especially on floppy  based  workstations.  
  367. The  poor computer not only has to execute the commands, it  also 
  368. has  to  reload  the 16K NET utility for  each  command.  FASTNET 
  369. speeds  things  up  by  processing a whole  file  full  of  "NET" 
  370. commands  at  once.  You can use the batch interpreter  to  debug 
  371. your  network setup, then when you're done, just use the name  of 
  372. your batch file as a parameter to FASTNET and see how much faster 
  373. it runs.
  374.  
  375. FASTNET handles the following NET commands, exactly as  described 
  376. in your LANtastic documentation:
  377.  
  378. NET USE D: \\Server_name
  379. NET USE D: \\Server_name\Path\...\Path
  380. NET USE LPTn: \\Server_name\@Device                
  381. NET UNUSE D:
  382. NET CLOCK \\Server_name
  383. NET LPT [COMBINE,FLUSH,SEPARATE]
  384. NET LPT TIMEOUT t                           
  385. NET QUEUE [START,STOP,HALT,PAUSE,SINGLE,RESTART] \\Server_name
  386.  
  387. If  FASTNET doesn't directly support a command (such as NET  SHOW 
  388. or NET POSTBOX or other batch commands) it will pass it on to the 
  389. command  processor.   In  this way, FASTNET can  handle  all  NET 
  390. commands  and  all  batch file commands  except  those  involving 
  391. branching  within  the  batch file  and  changes  to  environment 
  392. variables.  If  an error occurs, FASTNET returns the  same  error 
  393. messages that NET does, and returns with a non zero error code.
  394.  
  395. FASTNET's syntax is:
  396.  
  397.         FASTNET <file name> [/OPTIONS]                         
  398.         
  399. The filename can be any valid DOS file name. If no extension is
  400. given, an extension of .BAT is assumed.        
  401.                          
  402.  
  403.                       COMMAND LINE OPTIONS
  404. /STOP
  405.  
  406. Normally, if an error occurs, FASTNET will report it and continue  
  407. processing.   If you use the /STOP option, however, FASTNET  will 
  408. immediately terminate with an appropriate return code if any kind 
  409. of error occurs.  
  410.  
  411. /SUPPRESS
  412.  
  413. The /SUPPRESS option prevents FASTNET from displaying ANY warning 
  414. or error messages.  If an error does occur however, FASTNET  will 
  415. still terminate with a non-zero return code, so your batch  files 
  416. can detect any problems.
  417.  
  418. /HELP
  419.  
  420. /HELP displays a brief instruction summary and a list of  command 
  421. line options. If the /HELP option is specified, all other command 
  422. line input is ignored and no other action is taken.
  423.  
  424.  
  425.                         --- MESSAGE ---
  426.                         
  427. The MESSAGE utility is an alternative to LANtastic's built in pop
  428. up message receiver.  Like the built in message handler, MESSAGE
  429. causes messages sent to your machine  with  "NET  SEND" to pop up
  430. on the bottom  lines  of  your screen. Unlike the built in
  431. handler, messages thus popped up will stay on your screen until
  432. you tell them, via the escape key, to leave.  The message display
  433. also includes information on who sent you the message and the time
  434. at which it was sent for your reference.  If you're away from your
  435. desk a lot, MESSAGE will probably work better for you than
  436. LANtastic's message handler, since your messages won't vanish
  437. after a certain interval, never to be seen again. 
  438.  
  439. MESSAGE will also pop up even over graphics programs (by popular
  440. demand). Be warned however, that to save memory, it doesn't save
  441. the underlying screen. You get your message, but you must ask your
  442. application to redraw the screen. Also, as is the case with quite
  443. a few resident programs, MESSAGE doesn't always behave well with
  444. Windows 3.0. 
  445.  
  446. To install the MESSAGE utility, enter the command
  447.  
  448.         MESSAGE
  449.  
  450. The computer will display the installation message 
  451.  
  452.  
  453. SoftMagic Resident Message Handler Version 1.5 for LANtastic
  454.   Copyright 1990 by SoftMagic, Inc.  All rights reserved.
  455.         LANtastic is a trademark of Artisoft, Inc.
  456.  
  457. MESSAGE has no parameters or command line  options and it's 
  458. smart enough not to let you install more than one copy at
  459. a time. Note that if you chose to use MESSAGE, you can disable
  460. Artisoft's pop-up function by entering the command
  461.  
  462.     NET MESSAGE/DISABLE POP
  463.  
  464. at the DOS prompt or in a batch file.
  465.  
  466.  
  467.                           --- REBOOT ---
  468.                           
  469. REBOOT is a small program that causes your computer to execute                          
  470. a "hard" reboot -- a restart that clears everything out of memory
  471. and runs your computer's power-on diagnostics.  
  472.  
  473. It can be handy for all sorts of things, from providing a foolproof
  474. way of resetting communications hardware from a batch file to 
  475. keeping people out of places where they don't belong. I've even
  476. got the habit of typing REBOOT instead of Ctrl-Alt-Del whenever
  477. I need to reboot my machine.  
  478.  
  479. To use REBOOT, simply enter 
  480.  
  481. REBOOT
  482.  
  483. at the DOS command line or in a batch file.  There are no options
  484. or command line parameters. You wanna reboot, you gotta reboot!
  485.  
  486.  
  487.                            --- MSET ---
  488.  
  489. The MSET utility allows you to set or change variables in the
  490. "master copy" of the environment -- the one that belongs to the
  491. command processor that was loaded when your computer was first
  492. started.  You use MSET exactly the same way you would use the
  493. SET command:
  494.  
  495.         MSET <variablename>=<value>
  496.         
  497. For example, to set the variable MONITOR to CGA, you would issue
  498. the command 
  499.         
  500.         MSET MONITOR=CGA
  501.         
  502. MSET is provided with the LANutils specifically so that you can 
  503. set master environment variables from login scripts run by the
  504. LOGIN command.  Just substitute MSET for SET in all your login
  505. scripts and the "right" copy of the environment will be altered.
  506.  
  507.                          --- USERLIST ---
  508.                          
  509. I wrote this one after working on a network in a large office -- I
  510. wanted to send someone a message but I didn't know where they were
  511. logged on. So off I went, through the NET menus, checking the
  512. "Display System Activity on Server" screen for all the various
  513. servers that I was logged into.  "There must be an easier way", I
  514. thought.                             
  515.  
  516. USERLIST makes it easy to find people on the network.  It tells
  517. you who's using what machine and who's logged into which servers.
  518. For example, the userlist for our office network as I write looks
  519. like this:
  520.  
  521.         Users on server JON:
  522.           JON on machine JEARL
  523.           JON on machine JON
  524.           CAROLYN on machine CAROLYN
  525.         (3 users)
  526.  
  527.         Users on server CAROLYN:
  528.           CAROLYN on machine CAROLYN
  529.           JON on machine JEARL
  530.           JON on machine JON
  531.         (3 users)
  532.  
  533.         Users on server JEARL:
  534.           JON on machine JEARL
  535.           JON on machine JON
  536.         (2 users)
  537.  
  538. As you can see, there are a few of us still here at midnight.
  539. To get a user list, type
  540.  
  541.         USERLIST <server list> [/HELP]
  542.  
  543. The  only available command line option is the /HELP option.   As
  544. with the rest of the LANutils, /HELP causes a brief instruction
  545. summary and a  list of  available  options to be displayed. If
  546. /HELP  is  specified, USERLIST will take no other action.
  547.  
  548.  
  549.                            --- INTERCOM ---
  550.                            
  551. At only 2.9K, INTERCOM is the smallest two way pop-up communicator
  552. I've come across.  It allows you to pop up a window from virtually
  553. any application, carry on a conversation with one or several other
  554. users, then return immediately to your application.  
  555.  
  556. To load INTERCOM, type
  557.  
  558.     INTERCOM
  559.     
  560. at the DOS prompt (or include it in your AUTOEXEC.BAT file). Once
  561. the program is loaded, to pop up the INTERCOM window, press Alt-I .
  562. (If you need to, you can change the activation key with the
  563. supplied LUSETUP program).  The INTERCOM window looks like this:
  564.  
  565.      +-From: USERNAME ---------------------------------------------+  
  566.      | This is the (incoming) message line.                        |
  567.      +-To:---------------------------------------------------------+
  568.      | USERNAME                                                    |
  569.      +===========================================Press Esc to exit=+  
  570.  
  571. It's really a lot easier to just try out intercom a time or two
  572. than it is to try to explain how to use it. The top line of the
  573. window tells who last sent you a message and the second line
  574. displays the text of the last received message. The third line
  575. holds a prompt that tells you what to type in the fourth line.
  576.  
  577.     If the prompt is "To:: (as in the example above), enter
  578.     the node name of the station to which you're sending.
  579.     
  580.     If the prompt is "Message:", enter the text of your
  581.     message. You can enter up to 65 characters of text.
  582.     
  583. To move between "To:" and "Message:" fields, use the up and down
  584. arrow keys or simply press enter. Once you have filled out both
  585. fields, press enter and your message will be sent.  For example,
  586. to send a message to node MANAGER, you would use the following
  587. commands:
  588.     Alt-I         (to pop up the INTERCOM window)
  589.     MANAGER       (the name of the intended recipient)
  590.     <enter>       (to switch to the "Message:" field)
  591.     HI THERE      (the text of the message)
  592.     <enter>       (to transmit the completed message)
  593.     
  594. At this point, a message has been transmitted and you can either wait
  595. for a reply or press the escape key to return to what you were doing
  596. before you activated INTERCOM.
  597.  
  598. Note that although you can pop up INTERCOM over graphics programs,
  599. when you leave INTERCOM by pressing escape, it does not restore
  600. the graphics screen. This is a result of a compromise made in the
  601. interest of keeping INTERCOM's RAM usage as low as possible. With
  602. most graphics programs, this isn't much of a problem because the
  603. application itself provides an easy way to redraw the screen. For
  604. other applications, it's easiest to handle it the way I do MS
  605. WINDOWS -- I use MARK and RELEASE to unload INTERCOM before
  606. starting.
  607.  
  608.                           --- SYSTEM ---
  609.  
  610. Have you ever accidentally run a copy of 123 on a network station
  611. with the "wrong" type of video hardware?  The same diversity of
  612. hardware options that makes the PC such a useful computer can 
  613. cause all kinds of headaches for network administrators.
  614.  
  615. Typically, efforts to avoid the problem of different, incompatible
  616. hardware on the network turn even the fanciest, most expensive
  617. system into a jungle of batch files.  For example, to solve the
  618. problem above, you must either write a special batch file for each
  619. type of video hardware or teach all your users to start 123 with
  620. the correct driver set, or both.  In any case, you're likely to
  621. wind up with some confused users with blank, black screens. What
  622. a headache!
  623.  
  624. That's where SYSTEM comes in.  SYSTEM lets your batch files ask
  625. the computer about its hardware and software configuration so 
  626. you can easily pick exactly the right program version or driver
  627. set.  To demonstrate, here's a batch file that solves the 123
  628. video driver problem:
  629.  
  630.     ECHO OFF
  631.     REM Batch file to run Lotus 123 with the proper driver set
  632.     REM for the computer's video board.  Note that the driver
  633.     REM sets must have been created in advance using the Lotus
  634.     REM INSTALL program.
  635.  
  636.     REM Check for monochrome or Hercules video
  637.     SYSTEM (VIDEO LT CGA)
  638.     IF ERRORLEVEL 1 GOTO COLOR
  639.     123 MONO
  640.     GOTO END
  641.  
  642.     :COLOR
  643.     REM Check for CGA video
  644.     SYSTEM (VIDEO = CGA)
  645.     IF ERRORLEVEL 1 GOTO EGA
  646.     123 CGA
  647.     GOTO END
  648.  
  649.     :EGA
  650.     REM Check for EGA 
  651.     SYSTEM (VIDEO = EGA)
  652.     IF ERRORLEVEL 1 GOTO VGA
  653.     123 EGA
  654.     GOTO END
  655.  
  656.     :VGA
  657.     SYSTEM (VIDEO = VGA)
  658.     IF (ERRORLEVEL 1) GOTO ERROR
  659.     123 VGA
  660.     GOTO END
  661.  
  662.     :ERROR
  663.     ECHO Error: Unable to determine video adapter type 
  664.  
  665.     :END
  666.  
  667. Think of SYSTEM as an extension to DOS's "IF" command.   You ask
  668. SYSTEM a question with a true/false answer and it places the
  669. result in the DOS ERRORLEVEL variable -- 0 if the answer was true,
  670. 1 if it was false. You can then use "IF ERRORLEVEL" to check the
  671. result.  The batch file above uses this strategy to accomplish two
  672. things: it runs 123 with the correct driver set for each video
  673. board and it detects errors and gives a safe exit route if the
  674. video board type is unknown.
  675.  
  676.  
  677. The formal syntax for SYSTEM is:
  678.  
  679. SYSTEM <expression> | <@filename> [/OPTIONS]
  680.  
  681. An <expression> is a question composed of a system parameter, a
  682. relational operator and a value. For example, the expression
  683.  
  684.     (EXPANDED = 512)
  685.  
  686. in effect asks the question, "Does this computer have exactly 512K
  687. of expanded memory available?" Expressions can be more complex, as
  688. in
  689.  
  690. (EXPANDED GE 512) AND (VIDEO GE EGA) AND (MOUSE = YES)
  691.  
  692. which asks the compound question, "Does this computer have at
  693. least 512K of expanded memory, EGA video or better and a mouse?"
  694. For all you compiler-writing hacker types out there, SYSTEM scans
  695. expressions from right to left and evaluates from left to right,
  696. using no operator precedence. SYSTEM recognizes the following
  697. system parameters:
  698.  
  699. CPU        - the computer's CPU type, 8086/88, 80286 or 80386
  700. FPU        - is the computer equipped with a coprocessor? YES or NO
  701. MEMORY       - the amount of available conventional memory
  702. EXPANDED   - the amount of available expanded memory
  703. EXTENDED   - the amount of installed extended memory
  704. DISK       - the amount of disk space available on the current drive
  705. VIDEO       - the type of video adapter installed on the computer
  706.          MONO, HERCULES, CGA, EGA or VGA
  707. MOUSE      - is an MS compatible mouse driver loaded? YES or NO
  708. DOSVER     - the current MS-DOS version number
  709. LANVER     - the current LANtastic version number
  710.  
  711. Relational operators available are:
  712.  
  713. Operator(s)         Meaning
  714. --------------------------------------------
  715. =,==,EQ             Equality:                  
  716. !=,NE               Inequality:                
  717. GT                  Greater than:              
  718. LT                  Less than:                 
  719. GE                  Greater than or equal to   
  720. LE                  Less than or equal to      
  721. AND,&,&&            AND                        
  722. OR,|,||             OR                         
  723.  
  724. Here's a complex SYSTEM expression that asks if a station is
  725. capable of running large Microsoft Windows programs like Excel and
  726. Word for Windows.
  727.  
  728. (CPU GT 8088) AND (MEMORY GT 450) AND (EXP GT 512) AND (VIDEO GE EGA)
  729.  
  730. A batch file using the expression to run Excel would look something
  731. like this:
  732.  
  733.     ECHO OFF
  734.     REM This batch file runs MS Excel on stations equipped with 
  735.     REM at least an 80286 CPU, at least 450K of free conventional 
  736.     REM memory, at least 512K of EMS memory, and at least EGA
  737.     REM video.
  738.  
  739.     SYSTEM (CPU GT 8088) AND (MEMORY GE 450) AND (EXP GE 512) 
  740.             AND (VIDEO GE EGA)
  741.     IF ERRORLEVEL 1 GOTO ERROR
  742.     EXCEL
  743.     GOTO END
  744.  
  745.     :ERROR      
  746.     ECHO This station is not equipped to run Excel.
  747.     
  748.     :END
  749.  
  750.  
  751. SYSTEM has two command line options that you can use to get extra
  752. information. They are:
  753.  
  754.                               /HELP
  755. The HELP option    displays a brief instruction summary for the SYSTEM
  756. program. You can also get the HELP instructions by typing 
  757. SYSTEM
  758. on the command line with no parameters.
  759.  
  760.                              /REPORT
  761. Use the REPORT option if you'd like to see exactly what hardware
  762. and operating software your computer is equipped with. You'll get
  763. a summary report that looks like this:
  764.  
  765. SYSTEM utility for LANtastic -- Copyright 1990 by SoftMagic, Inc.
  766. All rights reserved.  LANtastic is a trademark of Artisoft, Inc.
  767.  
  768. Current system configuration:
  769. -----------------------------------
  770. Hardware
  771.   CPU: 80286
  772.   FPU: INSTALLED
  773.   Video: EGA
  774.   Mouse: INSTALLED
  775. -----------------------------------
  776. Available Memory
  777.   Conventional: 349K
  778.   Expanded:     880K
  779.   Extended:     0K
  780. -----------------------------------  
  781. Disk space available: 442K
  782. -----------------------------------
  783. Software
  784.   DOS Version:       3.30
  785.   LANtastic Version: 2.57
  786. -----------------------------------  
  787.           
  788.                             --- FU ---
  789.  
  790. The Finduser utility, FU for short, is a quick way to find out where
  791. people are logged on. It's syntax is:
  792.  
  793. FU <user name 1,user name 2,...user name n> [/OPTIONS]
  794.  
  795. User names can be separated by commas or spaces.  The only
  796. available option is /HELP, which displays the condensed version of
  797. these instructions. To give you an idea of what FU does, I'm going
  798. to find out where user Mark is currently logged in.
  799.  
  800.     FU MARK
  801.     MARK is logged in to server \\CAROLYN using machine MARK.
  802.     MARK is logged in to server \\MAIN using machine MARK.
  803.  
  804.                             --- SU ---
  805.                             
  806. Senduser, SU for short, lets you route network messages to
  807. specific users rather than to nodes. For example, to send a
  808. message to user MARK, no matter what machine he is currently
  809. using, just type
  810.  
  811.     SU MARK "Hello there, Mark"
  812.     
  813. SU will automatically determine where Mark is logged in, and
  814. get the message to him. 
  815.  
  816. Note that you can send messages to more than one user. For example,
  817. to send a message to MARK, JON and CAROLYN, type
  818.  
  819.     SU MARK,JON,CAROLYN "Hello ladies and gentlemen!"
  820.  
  821.                           --- DELAY ---
  822.  
  823. If you're running your network software from your computer's
  824. AUTOEXEC.BAT file, you may have noticed that some servers on the
  825. net may not respond to your first attempt to log on. In fact,
  826. sometimes you may not even be able to log on the first time to a
  827. server that's running on the computer you're using.
  828.  
  829. Usually this is due to the fact that LANtastic servers broadcast
  830. their existance on the net only every few seconds. If your
  831. computer comes up between ID broadcasts, it will not see a given
  832. server until the next time its ID is broadcast.
  833.  
  834. The WAITFOR utility gets around this problem by simply waiting
  835. until all the specified servers are available -- but what if you
  836. don't know in advance which servers are going to be available?
  837.  
  838. DELAY provides an easy answer. Its formal syntax is:
  839.  
  840. DELAY <time> [<message>] [/HELP]
  841.  
  842. You can specify any delay time from 0 to 32768 seconds. The optional
  843. <message> will be displayed on the screen before the delay begins.
  844. The /HELP argument displays a brief summary of DELAY's instructions
  845. on the screen. Pressing the Escape key during a delay will cause
  846. the delay to be aborted, returning you to normal operation.  If you
  847. want to stop a delay and return to the command line, press Ctrl-C.
  848.  
  849. To give LANtastic time to listen for server IDs, just insert a few
  850. seconds of delay between the time you start your network software
  851. and the time you try to log in. For example, if you include the
  852. sequence 
  853.  
  854.     LANBIOS2
  855.     REDIR
  856.     SERVER
  857.     DELAY 5 Pausing to see who's out there...
  858.     LOGIN ?
  859.     
  860. in your AUTOEXEC.BAT file, your computer will pause for 5 seconds
  861. after running the LANtastic server and before attempting to log
  862. in. This should be plenty of time for all the servers on the net
  863. to identify themselves.    
  864.  
  865.                          --- LUSETUP ---
  866.                          
  867. LUSETUP allows you to change the screen colors for the pop-up
  868. programs MESSAGE and INTERCOM and the activation keys for INTERCOM
  869. and Artisoft's LANPUP (version 3.00 only!). For LUSETUP to work, you
  870. have to be in the directory that contains MESSAGE.COM and
  871. INTERCOM.COM.
  872.  
  873. To start LUSETUP, type
  874.  
  875.     LUSETUP
  876.     
  877. from the DOS command line. LUSETUP is menu driven and is fairly
  878. self explanitory. Complete instructions for changing colors and
  879. hotkeys are displayed on the screen. 
  880.  
  881. 
  882.