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

    The Flush Shared Memory routine writes (flushes) to disk
    the contents of a global section that you created using the
    PPL$CREATE_SHARED_MEMORY routine. Only pages that have been
    modified are flushed to disk.

    Format

      PPL$FLUSH_SHARED_MEMORY  section-name [,memory-area] [,flags]

1 - Arguments

 section-name

    OpenVMS usage char_string
    type          character string
    access        read only
    mechanism     by descriptor
    Name of the global section whose contents are to be written to
    disk. The section-name argument is the address of a descriptor
    pointing to a character string containing the global section
    name.

 memory-area

    OpenVMS usage vector_longword_unsigned
    type          longword (unsigned)
    access        read only
    mechanism     by reference, array reference
    The area of memory into which the specified global section
    is mapped. The memory-area argument is the address of a two-
    longword array containing, in order, the length (in bytes) and
    the starting virtual address for the area of memory.

 flags

    OpenVMS usage mask_longword
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Bit mask specifying actions to perform before flushing the global
    section. The flags argument is the address of a longword bit mask
    containing the flag. The valid value for flags is as follows:

    PPL$M_NOUNI   Identifies the global section as having a nonunique
                  name. By default, PPL$CREATE_SHARED_MEMORY gives
                  the specified global section a name unique to
                  the application by using PPL$UNIQUE_NAME. If you
                  specified this value to give the global section a
                  nonunique name when you called PPL$CREATE_SHARED_
                  MEMORY, you must also specify it when you call
                  PPL$FLUSH_SHARED_MEMORY.