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.