VMS Help System Services, $ASCTOID  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Translates the specified identifier name into its binary
    identifier value.

    On Alpha systems, this service accepts 64-bit addresses.

    Format

      SYS$ASCTOID  name ,[id] ,[attrib]

    C Prototype

      int sys$asctoid  (void *name, unsigned int *id, unsigned int

                       *attrib);

1 - Arguments

 name

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor (Alpha)
    mechanism:    by 32-bit descriptor-fixed-length string descriptor
                  (VAX)
    Identifier name translated when $ASCTOID completes execution.
    The name argument is the 32- or 64-bit address (on Alpha systems)
    or the 32-bit address (on VAX systems) of a character-string
    descriptor pointing to the identifier name.

 id

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Identifier value resulting when $ASCTOID completes execution. The
    id argument is the 32- or 64-bit address (on Alpha systems) or
    the 32-bit address (on VAX systems) of a longword in which the
    identifier value is written.

 attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Attributes associated with the identifier returned in id when
    $ASCTOID completes execution. The attrib argument is the 32-
    or 64-bit address (on Alpha systems) or the 32-bit address (on
    VAX systems) 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 $KGBDEF library. The symbolic names for each
    bit position are listed in the following table:

    Bit Position           Meaning When Set

    KGB$V_DYNAMIC          Allows holders of the identifier to remove
                           it from or add it to the process rights
                           database by using the DCL command SET
                           RIGHTS_LIST.
    KGB$V_HOLDER_HIDDEN    Prevents someone from getting a list of
                           users who hold an identifier, unless they
                           own the identifier themselves. Special
                           privilege is required to translate hidden
                           names.
    KGB$V_NAME_HIDDEN      Allows holders of an identifier to have it
                           translated-either from binary to ASCII or
                           vice versa-but prevents unauthorized users
                           from translating the identifier. Special
                           privilege is required to translate hidden
                           names.
    KGB$V_NOACCESS         Makes any access rights of the identifier
                           null and void. This attribute is intended
                           as a modifier for a resource identifier or
                           the Subsystem attribute.
    KGB$V_RESOURCE         Allows the holder to charge resources,
                           such as disk blocks, to the identifier.
    KGB$V_SUBSYSTEM        Allows holders of the identifier to create
                           and maintain protected subsystems by
                           assigning the Subsystem access control
                           entry (ACE) to the application images in
                           the subsystem.