VMS Help RTL Routines, DNS$, DNS$APPEND_SIMPLENAME_TO_RIGHT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Append a Simple Name to the End of a Full Name routine adds an
    opaque simple name to the end of an opaque full name to create a
    new full name.

    Format

      DNS$APPEND_SIMPLENAME_TO_RIGHT

        fullname ,simplename ,resulting-fullname ,resulting-length

    Arguments

 fullname
    OpenVMS Usage: char_string
    type:          character string
    access:        read only
    mechanism:     by descriptor

    The opaque full name gaining a new simple name. The fullname
    argument is the address of a descriptor pointing to the opaque
    full name that is to be extended.

 simplename
    OpenVMS Usage: char_string
    type:          character string
    access:        read only
    mechanism:     by descriptor

    The opaque simple name that is appended. The simplename argument
    is the address of a descriptor pointing to an opaque simple name
    that is to be appended to the full name, thus creating a new full
    name.

 resulting-fullname
    OpenVMS Usage: char_string
    type:          character string
    access:        write only
    mechanism:     by descriptor

    The new full name. The resulting-fullname argument is the address
    of a descriptor that points to the buffer that receives the new
    full name. This buffer can be the same as the buffer referred
    to by the fullname argument; however, the descriptors must be
    separate.

 resulting-length
    OpenVMS Usage: word_unsigned
    type:          word (unsigned)
    access:        write only
    mechanism:     by reference

    The length of the new full name. The resulting-length argument
    is the address of a word that receives the length of the new full
    name found in resulting-fullname.