Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Book 4-Appendices - <b>nnetsndusr()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETSNDUSR()
 Sends a message to a user
------------------------------------------------------------------------------
 Syntax

     NNETSNDUSR(<cName>,<cMessage>,[<lNoSender>],
        [<cServer>|<nConId>]) --> nNumber

     Netware: 2.2 and 3.11

 Arguments

     <cName>  Designates the login name of the user to whom the message
     is sent.

     <cMessage>  Designates the message that is sent to <cName>.  The
     message can be up to 55 characters long (including information about the
     sender) and can contain only characters that have an ASCII value between
     32 and 127.

     <lNoSender>  Designates an optional parameter that allows you to
     suppress the sender information (from ...) when designated as .T..  When
     the parameter is designated .F., the sender information is generated
     automatically.

     <cServer>  Designates the name of the file server through which the
     message is sent.  Your workstation must be attached to <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETSNDUSR() returns the number of workstations to which the message
     <cMessage> has been sent successfully.  The function returns 0 if
     <cName> is not logged in or not ready to receive messages.

 Description

     NOVELL NET SEND USER
     NNETSNDUSR() allows you to send a message of up to 55 characters to a
     user.  The function can be compared to the Novell utility SEND.  The
     user <cName> must be logged in either on the default server or on the
     server specified by <cServer>|<nConId> because the sending of messages
     is processed through a file server.  The message is sent to all
     workstations on which <cName> is logged in and the message receipt is
     not disabled (castoff).  The message is displayed in line 24 of the
     screen and must be confirmed with <Ctrl> <Return>.  The message system
     of CA-Clipper Tools ( NNETMSGOPN()) allows the interrupt-controlled
     receipt of messages in the background.  The incoming messages can be
     processed within the application, and the computer is not interrupted in
     critical moments.

     If the parameter <lNoSender> is set to .F. or if no parameter is set,
     the message contains the information about the sender.  This information
     consists of the word "from", the name of the sender, and the connection
     ID.  By passing <lNoSender> with .T., the sender information can be
     suppressed.  With the parameters <cServer> or <nConId>, the message can
     be sent on any attached file server.  The connection ID of a server is
     returned by NNETATTACH() or NNETLOGIN().

 Examples

     .  Send a message to user MIKE:

        nNumber= NNETSNDUSR('MIKE','Good morning')
        ? 'Message has been sent to '+NTOC(nNumber)+' stations!'

     .  Send a message to the supervisor without the sender
        information:

        NNETSNDCON('SUPERVISOR','You fool!',.T.)

See Also: NNETMSGOPN() NNETSNDALL() NNETSNDCON() NNETSNDGRP()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson