TipcSrvGetArch

Name

TipcSrvGetArch — get the architecture name of the connected RTserver

Synopsis

T_BOOL TipcSrvGetArch(arch_return) 
T_STR *arch_return; 

Arguments

arch_return — storage for RTserver architecture name

Return Values

TRUE if the architecture name was successfully retrieved from the connection to RTserver, FALSE otherwise.

Diagnostics

If TipcSrvGetArch fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvGetArch gets the architecture name of the RTserver this RTclient is connected to by calling TipcConnGetArch. The RTserver architecture name can be useful for diagnostic purposes. The architecture name is the SmartSockets architecture, using the format:

Machine_OperatingSystem  

where:

For example:

sun4_solaris 

This value is stored in the environment variable RTARCH.

There is some overlap between TipcSrvGetArch and TipcMonServerGeneralPoll, but TipcSrvGetArch is easier to use if only the architecture name is needed instead of all RTserver general information.

TipcSrvGetArch may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvGetArch does not use the warm connection, because the warm connection does not have a peer process with an architecture name. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

If TipcSrvGetArch returns FALSE, it does not store a value in arch_return.

The value stored in arch_return points directly into an internal data structure and should not be modified.

See Also

TipcConnGetArch, TipcMonServerGeneralPoll, TipcSrvGetNode, TipcSrvGetPid, TipcSrvGetUniqueSubject, TipcSrvGetUser

Examples

This example prints the architecture name of the connected RTserver:

T_STR arch; 
 
if (!TipcSrvGetArch(&arch)) { 
  return;  /* error */ 
} 
 
TutOut("RTserver architecture name is <%s>.\n", arch);