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.