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>nnetsndgrp()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETSNDGRP()
 Sends a message to all group members
------------------------------------------------------------------------------
 Syntax

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

     Netware: 2.2 and 3.11

 Arguments

     <cName>  Designates the name of the group that has members to which
     the message is sent.

     <cMessage>  Designates the message that is sent to the members of
     <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 this parameter is designated .F., the sender information is
     generated automatically.  The default value is .F..

     <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

     NNETSNDGRP() returns the number of workstations to which the message
     <cMessage> was successfully sent.  The function returns 0 if no member
     of <cName> is currently logged in or ready to receive messages..

 Description

     NOVELL NET SEND GROUP
     NNETSNDGRP() allows you to send a message of up to 55 characters to all
     the users of a group.  The function can be compared with the Novell
     utility SEND.  The group <cName> must exist 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 a member of <cName> is logged in and the message
     receipt is not disabled (castoff).  The message is displayed on 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 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 inforation 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().

 Example

     Send a message to all members of the group TOOLS:

     nNumber= NNETSNDGRP('TOOLS','Data backup in 5 minutes!')
     ? 'Message has been sent to '+NTOC(nNumber)+' stations!'

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

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