Ref: 11640167
Title: ViewBuilder:  Event Task Generated Screen Messages
Date: 8/26/91

Copyright 3Com Corporation, 1991.  All rights reserved.

Quite often it is handy to have a ViewBuilder generated event include
a message on the ViewBuilder screen indicating that an event occurred or
has been acted upon.  ViewBuilder includes a program which will display
messages on the screen along with an "!" exclamation mark inside of a yellow
round circle.

The name of the program is PMMSG.EXE and can be found in C:\VIEWBLDR\PROG.

Simply "send" any textual data and/or ViewBuilder variables (such as &n, &t,
etc.) to a batch file and refer to the data as %1 through %X variables.

Assumptions:  It is assumed that you are completely familiar with the
process of creating and editing ViewBuilder Event tasks.

Process:

1.  Create a batch file that calls PMMSG.EXE.  Include any pertinent
textual information that you wish PMMSG to pass along.  For example:

    *  PMMSG screen message for generic events
    *  Batch file name:  GENEVNTS.CMD
    PMMSG "Managed System " %1 "reported an event at:" "%2"
    *  End

%1 would represent the managed system name variable $n.
%2 would represent the time ($t) the event occurred.

Note that when you specify the time variable in the Parameters section of
the Application Parameters definition screen, you must enclose the variable
within quotes:

        $n "$t"


2.  Create/Modify Event Task.

    a.  Create a new task or modify an existing event task to specify the
variables you wish to pass to PMMSG.EXE via the batch file.  List the
variable(s) in the" Parameters:" section of the Application Parameters
definition screen.  They must be listed in the order you use them within
the batch file.

    b.  Using the Create option, add the batch file name to the "Applications"
section of the Event Task definition screen.

    c.  Save the new task definition.

Note:  PMMSG has limits on the number and length of the text strings that
it can handle at one time.  You might have to experiment a little to get
pleasing results.

