SNDGRPPRF -- Send Group Profile Users a Message

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

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