VMS Help  —  System Services, $DGBLSC
    Marks an existing permanent global section for deletion. The
    actual deletion of the global section takes place when all
    processes that have mapped the global section have deleted the
    mapped pages.

    On Alpha and Integrity server systems, this service accepts 64-
    bit addresses.

    Format

      SYS$DGBLSC  [flags] ,gsdnam ,[ident]

    C Prototype

      int sys$dgblsc  (unsigned int flags, void *gsdnam, struct

                      _secid *ident);

1  –  Arguments

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Mask indicating global section characteristics. The flags
    argument is a longword value. A value of 0 (the default)
    specifies a group global section; a value of SEC$M_SYSGBL
    specifies a system global section; a value of SEC$M_SHMGS on
    an OpenVMS Galaxy system creates a shared-memory global section.

 gsdnam

    OpenVMS usage:section_name
    type:         character-coded text string
    access:       read only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor
    Name of the global section to be deleted. The gsdnam argument
    is the address of a character string descriptor pointing to this
    name string.

    For group global sections, the operating system interprets the
    group UIC as part of the global section name; thus, the names of
    global sections are unique to UIC groups.

    You can specify any name from 1 to 43 characters. All processes
    mapping to the same global section must specify the same name.
    Note that the name is case sensitive.

    Use of characters valid in logical names is strongly encouraged.
    Valid values include alphanumeric characters, the dollar sign
    ($), and the underscore (_). If the name string begins with an
    underscore (_), the underscore is stripped and the resultant
    string is considered to be the actual name. Use of the colon (:)
    is not permitted.

    Names are first subject to a logical name translation, after
    the application of the prefix GBL$ to the name. If the result
    translates, it is used as the name of the section. If the
    resulting name does not translate, the name specified by the
    caller is used as the name of the section.

    Additional information on logical name translations and
    on section name processing is available in the VSI OpenVMS
    Programming Concepts Manual.

 ident

    OpenVMS usage:section_id
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by 32- or 64-bit reference
    Identification value specifying the version number of the global
    section to be deleted and the matching criteria to be applied.
    The ident argument is the 32- or 64-bit address of a quadword
    structure containing three fields.

    The version number is in the second longword. The version number
    contains two fields: a minor identification in the low-order 24
    bits and a major identification in the high-order 8 bits. Values
    for these fields can be assigned by installation convention to
    differentiate versions of global sections. If you specify no
    version number when creating a section, processes that specify a
    version number when mapping cannot access the global section.

    The first longword specifies, in its low-order 3 bits, the
    matching criteria. The valid values, the symbolic names by
    which they can be specified, and their meanings are listed in
    the following table:

    Value Name          Match Criteria

    0     SEC$K_MATALL  Match all versions of the section.
    1     SEC$K_MATEQU  Match only if major and minor identifications
                        match.
    2     SEC$K_MATLEQ  Match if the major identifications are
                        equal and the minor identification of the
                        mapper is less than or equal to the minor
                        identification of the global section.

    If you specify no address or specify it as 0 (the default), the
    version number and match control fields default to 0.
Close Help