VMS Help RTL Routines, PPL$, PPL$CREATE_EVENT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Create an Event routine creates an arbitrary user-defined
    event and returns the event identifier. You use the event
    identifier to perform all operations on that event.

    Format

      PPL$CREATE_EVENT  event-id [,event-name]

1 - Arguments

 event-id

    OpenVMS usage identifier
    type          longword (unsigned)
    access        write only
    mechanism     by reference
    Identifier of the event. The event-id argument is the address of
    an unsigned longword containing the identifier. Event-id must be
    used in other calls to identify the event.

 event-name

    OpenVMS usage char_string
    type          character string
    access        read only
    mechanism     by descriptor
    Name of the event. The event-name argument is the address of a
    descriptor pointing to a character string containing the event
    name. The name of the event is entirely arbitrary. If you do
    not specify a value for event-name, or if you specify 0, a new
    unnamed event is created, which can be referenced only by its
    identifier. An arbitrary number of unnamed events can be created
    by a given application.