TAA Tools
SNDGRPPRF       SEND GROUP PROFILE USERS A MSG         TAAMSHD

The Send  Group Profile Users  a Message command  allows you to  send a
message  to those users  who are members  of a specific  group profile.
The   user  of  the  command  must   be  authorized  to  the  TAASNDGRP
authorization list.

A typical command would be:

             SNDGRPPRF   GRPPRF(xxx) MSG('...')

By default, the message  is sent to active  users only (those that  are
signed on) and  is sent as a break message to  the work station message
queue.    Only  user  profiles that  are  members  of  the  group would
receive the message.   If the  group profile is  active, it would  also
receive the message.

Supplemental group profiles are supported.

Options exist to:

  **   Send either a break or non-break message.

  **   Send to  the WS message  queue or the  users message queue.   If
       the  WS message  queue is  specified and  the same  user profile
       has signed onto  multiple Workstations  or has  'Jump Key'  jobs
       active (considered  separate devices), each  Workstation address
       would  receive  a message.    If  the user  has  Group Jobs,  or
       System  request  jobs active  at  the same  Workstation address,
       only a single message is sent.

  **   Send to  active members or  all members  of the  group.  If  all
       users are  requested, a  message may only  be sent to  the users
       message  queue (no WS  message queue exists  if the  user is not
       signed on).    No  messages are  sent  if the  user  profile  is
       specified as PASSWORD(*NONE).

The command  returns a message  for each user  that was sent  a message
and a summary message stating how many messages were sent.

You can  determine the members of  a group profile by  using the system
command:

             DSPAUTUSR     SEQ(*GRPPRF)

Comparison with SNDUSGMSG Tool
------------------------------

The SNDUSGMSG command allows you (with  the aid of the USRGRP) tool  to
have a separate list of users that can be sent messages.

The  SNDGRPPRF TAA  Tool sends  messages  to the  members  of a  system
defined Group Profile.

Command parameters                                    *CMD
------------------

   GRPPRF        The  group profile  who's  members to  send  a message
                 to.   The profile named must  be a group profile.  All
                 members of the  group and the  group profile would  be
                 considered   based  on  the   other  options   of  the
                 command.   No messages  will ever be sent  if the user
                 profile is  specified  as  PASSWORD(*NONE).    Only  a
                 single group may be named per use of the command.

   MSG           The message text to be sent.

   ACTIVE        A  *YES/*YES2/*NO   value  that   determines  if   the
                 message is sent to active users.

                 The  default is *YES.   If the user  has multiple jobs
                 active at  the  same  device address  (Group  jobs  or
                 System  request  jobs),  but  all  are  for  the  same
                 profile name, only a single message is sent.

                 If  the user  has  multiple  jobs at  the  same device
                 address,  but some have  different profile names which
                 are also  members for the  specified group profile,  a
                 message is sent for each user.

                 If  none of the  users are  active, an  escape message
                 is sent (CPF9898).

                 *YES2  is  the  same as  *YES  except  that  an escape
                 message is not sent if  none of the users are  active.
                 The same text is sent as a completion message.

                 If *NO  is specified, TOMSGQ(*USRQ)  must be  used and
                 a  message is  sent to the  message queue  assigned to
                 the user profile.

   TOMSGQ        The message  queue  to be  sent  the message  and  the
                 type of message.

                 The  default  is  *BRKWSQ which  will  cause  a  break
                 message  to be sent  to the Workstation  message queue
                 that the user is signed onto.

                 *WSQ  may be  specified which  will cause  a non-break
                 message to be  sent to  the Workstation message  queue
                 that the user is signed onto.

                 *USRQ may  be specified  which will cause  a non-break
                 message  to be sent to the  message queue specified in
                 the users profile.

   REFRESH       An  option  to  determine  if  the  DSPUSRPRF  OUTFILE
                 function is used  to refresh the TAASECKP  file in the
                 TAASECURE  library.  The  default is  *YES meaning the
                 file will be refreshed.

                 *DAYCHG may  be specified  which means  the file  will
                 be refreshed  if  the last  time the  file was  output
                 was  on a  different day.    *DAYCHG assumes  that you
                 are  using  the command  repeatedly  on the  same day,
                 you do  not want to  keep refreshing the  information.

                 *NO may  be specified  to use the  existing data.   If
                 no data exists, the file is output.

Restrictions
------------

A  break message will  only cause a  break at a job  which is specified
as BRKMSG(*NORMAL).  It is possible  for the user to use CHGJOB to  set
the BRKMSG parameter so the job will not be interrupted.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTWRKACT       Convert WRKACTJOB to outfile
     EDTVAR          Edit variable
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

Implementation
--------------

The  tool is  ready to  use, but  requires that  you have  one or  more
group profiles.

Any  user   of  the  command  must  be   authorized  to  the  TAASNDGRP
authorization list.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SNDGRPPRF     *CMD                   TAAMSHD       QATTCMD
   TAAMSHDC      *PGM       CLP         TAAMSHDC      QATTCL
   TAAMSHDC9     *PGM       CLP         TAAMSHDC9     QATTCL
   TAAMSHDR      *PGM       RPG         TAAMSHDR      QATTRPG
					

Added to TAA Productivity tools May 1, 1996


Home Page Up to Top