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

    The Remove the Simple Name on the Right from the Full Name routine
    removes the rightmost simple name from an opaque full name. It
    returns both the simple name stripped and the new full name that
    results from the operation.

    Format

      DNS$REMOVE_RIGHT_SIMPLENAME

        fullname [,resulting-fullname] [,resulting-fullname-length]

        [,resulting-simplename] [,resulting-simplename-length]

    Arguments

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

    The opaque full name to strip. The fullname argument is the
    address of a descriptor pointing to the opaque full name to strip.
    When the opaque full name does not contain any simple names, the
    routine returns a value of 0 in cond_value.

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

    The opaque full name resulting from the operation. The resulting-
    fullname argument is the address of a descriptor pointing to a
    buffer containing the resulting opaque full name. This buffer can
    be the same as the buffer referred to by the fullname argument;
    however, the descriptors must be separate.

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

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

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

    A buffer containing the opaque simple name stripped from fullname.
    The resulting-simplename argument is the address of a descriptor
    pointing to the buffer.

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

    The length of the simple name. The resulting-simplename-length
    argument is the address of a word receiving the length of the
    simple name returned in resulting-simplename.