VMS Help  —  RTL Routines, PPL$  PPL$DELETE_SHARED_MEMORY
    The Delete Shared Memory routine deletes or unmaps from a global
    section that you created using the PPL$CREATE_SHARED_MEMORY
    routine. Optionally, this routine writes the contents of the
    global section to disk before deleting the section.

    Format

      PPL$DELETE_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 you want to delete. 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 global section that you want
    to delete 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 of the area of memory.

 flags

    OpenVMS usage mask_longword
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Bit mask specifying actions to be performed before deleting the
    global section. The flags argument is the address of a longword
    bit mask containing the flag. Valid values for flags are as
    follows:

    PPL$M_FLUSH     Writes the global section to disk before deleting
                    it.
    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$DELETE_SHARED_MEMORY.
Close Help