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.