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

    The Remove a Value from a Set routine extracts the first value
    from a set and returns the value with its creation time-stamping
    (UID).

    Format

      DNS$REMOVE_FIRST_SET_VALUE

        set [,value] [,value-length] [,uid] [,uid-length] [,newset]

        [,newset-length]

    Arguments

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

    The set from which the value is extracted. The set argument is the
    address of a descriptor pointing to the set.

 value
    OpenVMS Usage: char_string
    type:          character string
    access:        write only
    mechanism:     by descriptor

    The value extracted from the set. The value argument is the
    address of a descriptor pointing to a buffer containing the value.

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

    The length of the value. The value-length argument is the address
    of a word holding the length of the value placed in value.

 uid
    OpenVMS Usage: char_string
    type:          character string
    access:        write only
    mechanism:     by descriptor

    The buffer holding the creation time-stamping (UID) of the
    extracted value. The uid argument is the address of a descriptor
    pointing to the buffer.

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

    The length of the UID placed in uid. The uid-length argument is
    the address of a word holding the length.

 newset
    OpenVMS Usage: char_string
    type:          character string
    access:        write only
    mechanism:     by descriptor

    The opaque set without the first value. The newset argument is the
    address of a descriptor pointing to a buffer containing that set.
    The buffer can be the same as the one given in the set argument.

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

    The length of the new set copied to the newset buffer. The newset-
    length argument is the address of a word that receives the length.