HELPLIB.HLB  —  System Services, $FIND HELD
    Returns the identifiers held by a specified holder.

    Format

      SYS$FIND_HELD  holder ,[id] ,[attrib] ,[contxt]

    C Prototype

      int sys$find_held  (struct _generic_64 *holder, unsigned int

                         *id, unsigned int *attrib, unsigned int

                         *contxt);

1  –  Arguments

 holder

    OpenVMS usage:rights_holder
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by reference
    Holder whose identifiers are to be found when $FIND_HELD
    completes execution. The holder argument is the address of a
    quadword data structure containing the holder identifier. This
    quadword data structure consists of a longword containing the
    holder UIC, followed by a longword containing the value 0.

 id

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Identifier value found when $FIND_HELD completes execution.
    The id argument is the address of a longword containing the
    identifier value with which the holder is associated.

 attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Attributes associated with the holder returned in id when $FIND_
    HELD completes execution. The attrib argument is the address of a
    longword containing a bit mask specifying the attributes.

    Symbol values are offsets to the bits within the longword. You
    can also obtain the values as masks with the appropriate bit set
    using the prefix KGB$M rather than KGB$V. The symbols are defined
    in the system macro library ($KGBDEF). The following are the
    symbols for each bit position:

    Bit Position    Meaning When Set

    KGB$V_DYNAMIC   Allows holders of the identifier to remove it
                    from or add it to the process rights list by
                    using the DCL command SET RIGHTS_LIST.

    KGB$V_          Makes any access rights of the identifier
    NOACCESS        null and void. This attribute is intended as
                    a modifier for a resource identifier or the
                    Subsystem attribute.

    KGB$V_          Allows the holder to charge resources, such as
    RESOURCE        disk blocks, to the identifier.

    KGB$V_          Allows holders of the identifier to create and
    SUBSYSTEM       maintain protected subsystems by assigning the
                    Subsystem ACE to the application images in the
                    subsystem.

 contxt

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Context value used when repeatedly calling $FIND_HELD. The contxt
    argument is the address of a longword used while searching for
    all identifiers. The context value must be initialized to 0,
    and the resulting context of each call to $FIND_HELD must be
    presented to each subsequent call. After contxt is passed to
    $FIND_HELD, you must not modify its value.
Close Help