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

    Translates the specified identifier value to its identifier name.

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

    Format

      SYS$IDTOASC  id ,[namlen] ,[nambuf] ,[resid] ,[attrib]

                   ,[contxt]

    C Prototype

      int sys$idtoasc  (unsigned int id, unsigned short int *namlen,

                       void *nambuf, unsigned int *resid, unsigned

                       int *attrib, unsigned int *contxt);

1 - Arguments

 id

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Binary identifier value translated by $IDTOASC. The id argument
    is a longword containing the binary value of the identifier. To
    determine the identifier names of all identifiers in the rights
    database, you specify id as -1 and call $IDTOASC repeatedly until
    it returns the status code SS$_NOSUCHID. The identifiers are
    returned in alphabetical order.

 namlen

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Number of characters in the identifier name translated by
    $IDTOASC. The namlen argument is the 32- or 64-bit address (on
    Alpha systems) or the 32-bit address (on VAX systems) of a word
    containing the length of the identifier name written to nambuf.

 nambuf

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       write 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 text string returned when $IDTOASC completes the
    translation. The nambuf argument is the 32- or 64-bit address
    (on Alpha systems) or the 32-bit address (on VAX systems) of a
    descriptor pointing to the buffer in which the identifier name is
    written.

 resid

    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 of the identifier name returned in nambuf. The
    resid argument is the 32- or 64-bit address (on Alpha systems) or
    the 32-bit address (on VAX systems) of a longword containing the
    32-bit code of the identifier.

 attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by by 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Mask of attributes associated with the identifier returned in
    resid. 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 the attribute mask.

    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 following symbols
    for each bit position are defined in the system macro library
    ($KGBDEF):

    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 using the DCL command SET RIGHTS_
                           LIST.
    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.
    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 holders of an identifier to charge
                           disk space to the identifier. It is used
                           only for file objects.
    KGB$V_SUBSYSTEM        Allows holders of the identifier to
                           create and 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 32- or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    Context value used when repeatedly calling $IDTOASC. The contxt
    argument is the 32- or 64-bit address (on Alpha systems) or
    the 32-bit address (on VAX systems) of a longword used while
    $IDTOASC searches for all identifiers. The context value must
    be initialized to the value 0, and the resulting context of each
    call to $IDTOASC must be presented to each subsequent call. After
    contxt is passed to $IDTOASC, you must not modify its value.