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

    The Join Two Names routine joins two opaque full names to form a
    new full name.

    Format

      DNS$CONCATENATE_NAME

        fullname1 ,fullname2 ,resulting-fullname ,resulting-length

    Arguments

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

    The opaque full name to be joined. The fullname1 argument is the
    address of a descriptor pointing to the opaque full name.

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

    The opaque full name appended to fullname1. The fullname2 argument
    is the address of a descriptor pointing to the full name to be
    appended.

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

    The buffer where the new full name will be written. The resulting-
    fullname argument is the address of a descriptor pointing to the
    buffer. This buffer can be the same as the buffer referred to by
    the fullname1 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.