Click above to get retro games delivered to your door ever month!

This function was formerly named N_SEND(). Calls to N_SEND() will not 
produce an error with the current version of NetLib, but you should 
begin using N_PIPE() in new code and update existing code when 
convenient. In addition, the old functions N_CONN() and N_DISC() are no 
longer needed. We recommend you remove calls to those functions from 
existing code.


Syntax

N_PIPE( <nStanum>|<aStanum>, <cMessage> )


Parameters

<nStanum>
Station number.

<aStanum>
An array of station numbers.

<cMessage>
Text of the message.


Returns

Logical true if the message has been successfully received by the 
destination, false if it has not.

Note  Applicable only if you are sending to a single station. If 
you are sending to all stations or an array of stations, then the 
return code is undefined.


Description

N_PIPE(<nStanum>) sends a message to:

<nStanum>     Destination
-1            All stations (not including 
              console).
0             Server console.
1-255         Specific station.


N_PIPE(<aStanum>) sends to a list of stations passed in an array. You 
cannot use an array to send a server console message (0) or a message 
to all stations (-1).

Note  "Piped" messages are not supported by NetWare 386.


Examples

// Send message to all stations on network
N_PIPE(-1, 'Hello, world!')

// Send a message to user who has current record locked
nCulprit = ASC(N_CHECKR(RECNO()))
cMsg = N_WHOAMI(nCulprit) + ', ' + N_WHOAMI() ;
               + ' wants to modify record ' + STR(RECNO())
N_PIPE(nCulprit, cMsg)