advr.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
COM Statement Details
  Summary  Details  Example                Contents  Index  Back
──────────────────────────────────────────────────────────────────────────────
 COM(n%) {ON | OFF | STOP}
 
 Usage Notes
   ■ If your program contains event-handling statements and you are compiling
     from the BC command line, use the /W or /V option. If you do not use
     these options and your program contains event traps, Visual Basic
     generates the error message, "ON event without /V or /W on command
     line." See: BC Command-Line Options
 
   ■ COM(n%) ON enables communications-event trapping at COM port n%. If
     a character arrives at a communications port after a COM(n%) ON
     statement, the routine specified in the ON COM statement is
     executed.
 
   ■ COM(n%) OFF disables communications-event trapping at COM port n%. No
     trapping takes place until another COM(n%) ON statement is executed.
     Events occurring while trapping is off are ignored.
 
   ■ COM(n%) STOP suspends communications-event trapping at COM port n%. No
     trapping takes place until a COM(n%) ON statement is executed. Any ON
     COM events that occur while trapping is suspended are remembered and
     processed when the next COM(n%) ON statement is executed. However,
     remembered events are lost if a COM(n%) OFF statement is executed.
 
   ■ When a signal-event trap occurs (that is, the GOSUB is performed),
     an automatic COM(n%) STOP is executed so that recursive traps cannot
     take place. The RETURN from a trapping routine automatically
     executes a COM(n%) ON statement unless an explicit COM(n%) OFF was
     performed inside the routine.