HELPLIB.HLB  —  System Services, $IDTOASC
    Translates the specified identifier value to its identifier name.

    On Alpha and Integrity server 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 and Integrity
                  servers)
    Number of characters in the identifier name translated by
    $IDTOASC. The namlen argument is the 32- or 64-bit address (on
    Alpha and Integrity server 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 and Integrity servers)
    Identifier name text string returned when $IDTOASC completes the
    translation. The nambuf argument is the 32- or 64-bit address (on
    Alpha and Integrity server 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 and Integrity
                  servers)
    Identifier value of the identifier name returned in nambuf.
    The resid argument is the 32- or 64-bit address (on Alpha and
    Integrity server 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 and Integrity
                  servers)
    Mask of attributes associated with the identifier returned in
    resid. The attrib argument is the 32- or 64-bit address (on
    Alpha and Integrity server 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 and Integrity
                  servers)
    Context value used when repeatedly calling $IDTOASC. The contxt
    argument is the 32- or 64-bit address (on Alpha and Integrity
    server 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.
Close Help