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