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

    The Convert a User Name from String to Opaque routine converts a
    DECnet Phase IV user name to an opaque full name.

    Format

      DNS$PARSE_USERNAME_STRING

        user-string ,phase4-name ,resulting-length

        [,next-character-pointer]

    Arguments

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

    The name string to convert. The user-string argument is the
    address of a descriptor pointing to the DECnet Phase IV username
    string, which is in the format node::user.

 phase4-name
    OpenVMS Usage: char_string
    type:          character string
    access:        write only
    mechanism:     by descriptor

    The opaque full name resulting from conversion. The phase4-name
    argument is the address of a descriptor pointing to the buffer
    that is to contain an opaque full name representing a user name on
    a Phase IV node.

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

    The length of the opaque full name. The resulting-length argument
    is the address of a word holding the length of the name returned
    in phase4-name.

 next-character-pointer
    OpenVMS Usage: address
    type:          address
    access:        write only
    mechanism:     by reference

    The character following the DNS name extracted from user-string.
    The next-character-pointer argument is the address of the
    character following the DNS name. When you use this argument,
    DNS$PARSE_USERNAME_STRING returns DNS$_INVALIDNAME when it
    encounters an invalid name. In such a case, next-character-pointer
    points to the first character in the name that is invalid.