═══ 1. About the program ═══

Notify is a small VisPro/REXX program to give a fancy type of notification when 
an event occurs (mainly for REXX programs).

 It is useful with the START command since your original program can end and 
the notification will wait for the user to read it.  I have included many of 
the parameters that I (and others) thought would be most useful.

 To obtain the source code just send an email to the address in the "About the 
author" section.


═══ 2. Command line parameters ═══

Warning: MESSAGE *MUST* be the last parameter (the order doesn't matter for the 
rest of the parameters)

┌──────────┬────────────────────┬──────────────────────────────────────────────────┐
│Parameter │Values              │Description                                       │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│BEEP      │* YES               │Sounds a beep on the speaker                      │
│          │  NO                │Makes no sound                                    │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│BUTTONS   │* OK                │1 button (OK) is shown                            │
│          │  OKCNCL            │2 buttons (OK and CANCEL) are shown               │
│          │  YESNO             │2 buttons (YES and NO) are shown                  │
│          │  YESNOCNCL         │3 buttons (YES, NO, and CANCEL) are shown         │
│          │  RETRY             │2 buttons (RETRY and CANCEL) are shown            │
│          │  IGNORE            │2 buttons (IGNORE and CANCEL) are shown           │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│BLINK     │* YES               │Will cause a blinking (red/yellow) box to appear  │
│          │  NO                │No blink box shows on screen                      │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│X         │  0-n               │Left edge of blink box is at (0 to screen width)  │
│          │* LEFT (or L)       │Left is the same as specifying 0                  │
│          │  RIGHT (or R)      │Right is the same as specifying screen width      │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│Y         │  0-n               │Bottom edge of box is at (0 to screen height)     │
│          │* TOP (or T)        │Top is the same as specifying screen height       │
│          │  BOTTOM (or B)     │Bottom is the same as specifying 0                │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│WIDTH     │  0-n               │0 to width of the screen (default=70 pixels)      │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│HEIGHT    │  0-n               │0 to height of the screen (default=110 pixels)    │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│TITLE     │  single word       │ie. --HOST_Title_--         (no embedded blanks)  │
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│MESSAGE   │  text string       │ie. Is it coffee time yet?       (embedded blanks)│
├──────────┼────────────────────┼──────────────────────────────────────────────────┤
│?         │                    │Lists the parameters and their syntax             │
└──────────┴────────────────────┴──────────────────────────────────────────────────┘


* indicates the default value (title and message are blank by default)


═══ 3. About the author ═══

Craig Park can be reached at either : 

cpark@idirect.com
(Internet Direct - my regular ISP provider)

or 

craig.park@olc.gvc.com
("One Less Car" BBS - Toronto Canada)


═══ 4. Examples ═══

/* Sample REXX program * #1 */

 DO a = 1 to 1000 
 END

 ADDRESS "CMD" "START Notify BEEP=YES BLINK=NO BUTTONS=YESNOCNCL X=Left Y=T 
WIDTH=100 HEIGHT=100 TITLE=--Test_Job-- MESSAGE=Test is now complete"

EXIT 




/* Sample REXX program #2 */

 DO a = 1 to 1000 
 END

 ADDRESS "CMD" "START Notify TITLE=--Test_Job-- MESSAGE=Test is now complete"

EXIT