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

    The Compare Two Strings for Equality routine compares two strings
    to see if they have the same length and contents. Uppercase and
    lowercase characters are not considered equal.

    Format

      STR$COMPARE_EQL  first-source-string ,second-source-string

1 - Returns

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

    The values returned by STR$COMPARE and the conditions to which
    they translate are as follows:

    Returned
    Value         Condition

    0             The length and the contents of first-source-string
                  are equal to the length and contents of second-
                  source-string.
    1             Either the length of first-source-string is not
                  equal to the length of second-source-string, or the
                  contents of first-source-string are not equal to
                  the contents of second-source-string, or both.

2 - Arguments

 first-source-string

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

    First source string. The first-source-string argument is the
    address of a descriptor pointing to the first source string.

 second-source-string

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

    Second source string. The second-source-string argument is the
    address of a descriptor pointing to the second source string.