TipcSrvConnGetArch

Name

TipcSrvConnGetArch — get the architecture name of the connection handle to RTserver

Synopsis

T_BOOL TipcSrvConnGetArch(srv, arch_return) 
T_IPC_SRV srv; 
T_STR *arch_return; 

Arguments

srv — connection handle to RTserver

arch_return — storage for RTserver architecture name

Return Values

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

Diagnostics

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

Description

TipcSrvConnGetArch 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 TipcSrvConnGetArch and TipcSrvMonServerGeneralPoll, but TipcSrvConnGetArch is easier to use if only the architecture name is needed instead of all RTserver general information.

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

Caution

If TipcSrvConnGetArch 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, TipcSrvMonServerGeneralPoll, TipcSrvConnGetNode, TipcSrvConnGetPid, TipcSrvConnGetUniqueSubject, TipcSrvConnGetUser

Examples

This example prints the architecture name of the connected RTserver:

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