Returns a LOCATION for the given name.

#include <rt.h> 
    LOCATION GetRtNodeLocationByName(const char *NodeName);

Parameters

NodeName

An zero-terminated ASCII string containing the name of the node whose location is sought. The format of NodeName can be one of the following:

For nodes on the same host as the caller:

"nodename"

"node-only" form; the name of a node with no host name, e.g. "NodeA"

"///nodename"

"null url" form

"intime:///nodename"

"hostless url" form

For nodes on other hosts:

"intime://hostname/nodename"

"full url" format, e.g. intime://rtoshost.mydomain.com/NodeA

"hostname/nodename"

"host+node" form

Remarks

This call does not interact with the target node.

Return Values

A valid LOCATION handle

Success; the name is valid.

BAD_LOCATION

Failure. The function sets GetLastRtError to one of these values:

E_BAD_ADDR	NodeName is not a valid pointer to a zero-terminated string.
E_PARAM	NodeName is invalid (longer than 63 characters).
E_INVALID_ADDR	Location does not exist.

Requirements