OpenVMS Alpha Galaxy Guide
←Previous Next→ Contents Tables Close Help
  13.1  SYS$CREATE_GALAXY_LOCK_TABLE

  This service allocates a galaxy locktable structure.  This
  structure is used to maintain information about the shared
  memory section, which this service also creates.  The first
  caller of the service with a unique locktable name creates the
  section.  Additional callers map it.  This shared memory sec-
  tion contains a set of galaxy locks.  All locks residing in the
  section are of the same size.  Once the locktable is created,
  the SYS$CREATE_GALAXY_LOCK service can be used to
  create and allocate a lock from the table.

  The flags GLCKTBL$C_PROCESS and GLCKTBL$C_

  SYSTEM specify whether the shared memory region is
  mapped into system space or process space.  Creation of
  process space sections requires the SHMEM privilege.
  Creation of system space sections requires the SHMEM
  and CMKRNL privileges.

  sys$create_galaxy_lock_table(name, accmode, section_size,
  section_type, prot, lock_size, handle)

                 size
  parameter      (bytes)      type                   usage

  name           8            input by value         address of
                                                     the lock table
                                                     name (ASCIZ)

  accmode        4            input by value         access mode of
                                                     the lock table
  section size      8         input by value         virtual size of
                                                     lock section
  section type      4         input by value         glcktbl$c_
                                                     process or
                                                     glcktbl$c_
                                                     system
  prot           4            input by value         protection ap-
                                                     plied to lock
                                                     section
  lock_size        4          input by value         size of the
                                                     galaxy locks in
                                                     the section
  handle         8            output by ref          lock table
                                                     handle

  Return status:

      SS$_ACCVIO
      SS$_BADPARAM
      SS$_CREATED

      SS$_IVLOCKID
      SS$_NOPRIV
      SS$_NOSHMEM

      SS$_NORMAL
      Any status from the shared memory support routines
←Previous Next→ Contents Tables Close Help