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

    The Remove the Simple Name on the Left from the Full Name routine
    removes the leftmost 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_LEFT_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.
    If the 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 the
    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 that is returned. The resulting-
    fullname-length argument is the address of a word receiving 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

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

 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 that receives the length of the
    simple name returned in resulting-simplename.