Library /sys$common/syshlp/helplib.hlb  —  RTL Routines, LIB$  LIB$EXPAND_NODENAME
    The Expand a Node Name to Its Full Name Equivalent routine
    expands a node name to its full name equivalent.

    Format

      LIB$EXPAND_NODENAME  nodename, fullname [,resultant-length]

1  –  Returns

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

2  –  Arguments

 nodename

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

    Node name to be expanded. The nodename argument contains the
    address of a descriptor pointing to this node-name string.

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

 fullname

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

    Expanded node name. The fullname argument contains the address
    of a descriptor pointing to the expanded node-name string.
    LIB$EXPAND_NODENAME writes the expanded node-name string into
    the buffer pointed to by the fullname descriptor.

    The error LIB$_INVSTRDES is returned if fullname is an invalid
    descriptor.

    The length field of the fullname descriptor is not updated unless
    fullname is a dynamic descriptor with a length less than the
    resulting expanded full name. Refer to the OpenVMS RTL String
    Manipulation (STR$) Manual for dynamic string descriptor usage.

    The fullname argument contains an unusable result when
    LIB$EXPAND_NODENAME returns in error.

 resultant-length

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference

    Length of the expanded node name. The resultant-length argument
    is the address of an unsigned word that contains this length in
    bytes.

    The resultant-length argument contains an unusable result when
    LIB$EXPAND_NODENAME returns in error.
Close Help