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.