.TH CLNTEXEC
 6 "IRIT Version 6.0" 
.SH NAME
CLNTEXEC



 NumericType CLNTEXEC( StringType ClientName )

Initiate communication channels to a client named ClientName.
ClientName is executed by this function as a sub process and
two communication channels are opened between the IRIT server and the
new client, for read and write. See also CLNTREAD, CLNTWRITE, and
CLNTCLOSE. if ClientName is an empty string, the user is provided
with the new communication port to be used and the server blocks for the
user to manualy executed the client after setting the proper
IRIT_SERVER_HOST/PORT environment variables.

Example:

   h1 = CLNTEXEC( "" );
   h2 = CLNTEXEC( "nuldrvs -s-" );

executes two clients, one is named nuldrvs and the other one is
prompted for by the user. As a result of the second invokation of
CLNTEXEC, the user will be prompted with a message similar to,

    Irit: Startup your program - I am waiting...

    setenv IRIT_SERVER_PORT 2182

and he/she will need to set the proper environment variable and execute
their client manually.