HELPLIB.HLB  —  RTL Routines, LIB$  LIB$COMPARE_NODENAME
    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.
Close Help