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

    The Compare Two Node Names routine compares two node names to see
    if they resolve to the same full name.

    Format

      LIB$COMPARE_NODENAME  nodename1 ,nodename2 ,comparison-result

1 - Returns

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

2 - Arguments

 nodename1

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

    First node name to be compared. The nodename1 argument contains
    the address of a descriptor pointing to this node-name string.

    The error LIB$_INVARG is returned if nodename1 contains an
    invalid node name, points to a null string, or contains more
    than 1024 characters. The error LIB$_INVSTRDES is returned if
    nodename1 is an invalid descriptor.

 nodename2

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

    Second node name to be compared. The nodename2 argument contains
    the address of a descriptor pointing to this node-name string.

    The error LIB$_INVARG is returned if nodename2 contains an
    invalid node name, points to a null string, or contains more
    than 1024 characters. The error LIB$_INVSTRDES is returned if
    nodename2 is an invalid descriptor.

 comparison-result

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

    Result of the comparison. The comparison-result argument is the
    address of an unsigned longword that contains the comparison
    result. If the two node names are equal, 0 is returned. If they
    are not equal, 1 is returned.

    Comparison-result contains an unusable result when LIB$COMPARE_
    NODENAME returns in error.