HELPLIB.HLB  —  RTL Routines, PPL$  PPL$CREATE_BARRIER
    The Create a Barrier routine creates and initializes a barrier,
    and returns the barrier identifier. You use the barrier
    identifier to perform all operations on that barrier.

    Format

      PPL$CREATE_BARRIER  barrier-id [,barrier-name] [,quorum]

1  –  Arguments

 barrier-id

    OpenVMS usage identifier
    type          longword (unsigned)
    access        write only
    mechanism     by reference
    Identifier of the barrier. The barrier-id argument is the address
    of an unsigned longword containing the identifier. Barrier-id
    must be used in calls to the other barrier routines (listed in
    the Description section) to identify the barrier.

 barrier-name

    OpenVMS usage char_string
    type          character string
    access        read only
    mechanism     by descriptor
    Name of the barrier. The optional barrier-name argument is the
    address of a descriptor pointing to a character string containing
    the barrier name. The name of the barrier is arbitrary. If you
    do not specify this argument, or if you specify 0, an unnamed
    barrier is created. An arbitrary number of unnamed barriers may
    be created by a given application.

 quorum

    OpenVMS usage word_signed
    type          word (signed)
    access        read only
    mechanism     by reference
    Number of participants required to terminate an active wait for
    this barrier. The quorum argument is the address of a signed
    word containing the quorum number. For example, a quorum value
    of 3 indicates that the first two callers of PPL$WAIT_AT_BARRIER
    specifying this barrier-id are blocked until a third caller calls
    PPL$WAIT_AT_BARRIER. At that point, all three participants are
    released for further processing. If you do not specify a value
    for quorum, a default value of 1 is assigned.
Close Help