Allocates an OpenVMS Galaxy lock table.

    Note that this system service is supported only in an OpenVMS
    Alpha Galaxy environment.

    For more information about programming with OpenVMS Galaxy system
    services, see the VSI OpenVMS Alpha Partitioning and Galaxy Guide.

    Format

      SYS$CREATE_GALAXY_LOCK_TABLE  name ,accmode ,section_size

                                    ,section_type ,prot ,lock_size

                                    ,lcktbl_handle

    C Prototype

      int sys$create_galaxy_lock_table  (void *name, unsigned int

                                        accmode, unsigned __int64

                                        section_size, unsigned int

                                        section_type, unsigned int

                                        prot, unsigned int lock_size,

                                        unsigned int *lcktbl_handle);

1  –  Arguments

 name

    OpenVMS usage:address
    type:         ASCID string
    access:       read
    mechanism:    input by reference
    The name parameter is a pointer to an ASCID string (passed by
    descriptor). The name is given to the global section that is
    created to contain the galaxy locks.

 accmode

    OpenVMS usage:access mode
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    Access mode that is to be the owner of the pages created during
    the mapping. The accmode argument is a longword containing the
    access mode.

 section_size

    OpenVMS usage:byte count
    type:         quadword (unsigned)
    access:       read
    mechanism:    input by value
    Length of the global section to be created, in bytes. The size
    must be specified as a multiple of the CPU-specific page size. A
    size of zero is illegal.

 section_type

    OpenVMS usage:bit mask
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    Used to control where in virtual memory the global section
    is created. If GLCKTBL$C_PROCESS is specified, the section is
    created in P2 (process) space. If GLCKTBL$C_SYSTEM is specified,
    the section is created in S0/S1 (system) space. These constants
    are defined in the GLOCKDEF macro.

 prot

    OpenVMS usage:protection
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    Protection to be applied to the global section.

 lock_size

    OpenVMS usage:byte count
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    The size of the galaxy lock in bytes. Galaxy locks have two
    sizes. The legal values are returned by SYS$GET_GALAXY_LOCK_SIZE.

 lcktbl_handle

    OpenVMS usage:address
    type:         longword
    access:       write
    mechanism:    output by reference
    Pointer to a longword. The value returned is a 32-bit handle that
    uniquely identifies the lock table galaxy-wide.