

              how to call dpgnbel7 from a batch program



	what's it for?

	dpgnbel7 will beep until any key hit

	it also returns an errorlevel = to the ascii value of the key hit.
		e.g., if your keystroke is A it returns errorlevel 65, 
		which is the ascii value of A.  see ascii.txt, included.

	it's called from a batch program or from the dos command line

;----------------------------------------------------------------------

	any restrictions on this program?

	ms-dos/windows/xp operating system
	386 cpu or better

;----------------------------------------------------------------------

	how do i call it from a ms-dos batch file?

        see (and run) demo7.bat for example

	echo [your menu]
	call dpgnbel7    
rem --------------------------------------------------
rem errorlevel = ascii value of keystroke = 65 = A
rem see ascii.txt for ascii values
rem --------------------------------------------------
	if errorlevel 65 call subroutineA

>>>>negative test for keystroke = A or to do more than 1 thing ...

	if not errorlevel 65 goto notA
rem --------------------------------------------------
rem errorlevel = ascii value of keystroke = 65 = A
rem see ascii.txt for ascii values
rem --------------------------------------------------
	        call subroutineA
	        call subroutineAA
:notA


;----------------------------------------------------------------------

	what happens when i call it?

	it beeps forever until any key hit.  the beeps should be about 
	2 per second regardless of your cpu clock speed.  it returns
	the ascii value of the key you hit as an errorlevel.  after 
	you hit any key, it goes to the next line in the batch program

;----------------------------------------------------------------------

	what errorlevels does it return?

	it returns an errorlevel equal to the ascii value of the key hit
	(e.g., if A is hit, it returns an errorlevel of 65, which is
	the ascii value of A.)

	for ascii values of selected keys, see ascii.txt, included
	in this package.

	for an example of using returned errorlevels, see (and run)
	demo7.bat
;----------------------------------------------------------------------

	any warnings about this program?


	any warnings about this program?

	1)  DO NOT USE THIS PROGRAM WHERE OTHERS CAN HEAR IT.  USE 
	    THIS PROGRAM ONLY AT HOME OR IN EMERGENCY SITUATIONS 
	    WHEN YOU **MUST** HEAR A BEEP.

	    the reason why is illustrated by the following scenario:

	    1)  you run a batch program which calls dpgnbel7, and
	    2)  you leave for a meeting.  then
	    3)  your batch program calls dpgnbel7, which
	    4)  beeps 4000 times, and
	    5)  just before it gets to beep 4001,
	    6)  the guy in the next cubicle destroys your computer 
	        with a large axe.

	    constant beeping drives people CRAZY.  [don't ask me how i 
	    found this out.]

	    for the office, use dpgnbel8 which is part of this package.  
	    see readme.1st to find the docs for dpgnbel8.


	2)  THE BEEP IS NOT VERY LOUD.  you may not hear it if tv or radio
	    is playing loudly.
;----------------------------------------------------------------------

	can i control the sound volume?

	no.  the chip does not allow it.
;----------------------------------------------------------------------
