TAA Tools
CHGMSGQ2        CHANGE MESSAGE QUEUE 2                 TAAMSKL

The Change  Message Queue  2 command  allows a  change to  one or  more
*MSGQ object  types.  Not all of the  CHGMSGQ parameters are supported.
CHGMSGQ2  simplifies making mass changes to  *MSGQ objects.  For a more
complete understanding  of  the  parameters, see  the  CHGMSGQ  command
help text.   A  *MSGQ object owned  by one of  the system  profiles may
not be changed.

You must have *ALLOBJ special authority to use CHGMSGQ2.

A typical command would be:

             CHGMSGQ2  MSGQ(ABC/*ALL) SEV(10)

All  *MSGQ objects in  library ABC  would be set  to severity  10.  All
other values in the message queue objects would remain unchanged.

At least  one of  the  values to  be  changed must  be other  than  the
default of *SAME or RESET(*NO).

The  system DSPMSG  command  does  not show  all  the  attributes of  a
message queue.  The TAA command DSPMSGQA may be used.

CHGMSGQ2 escape messages you can monitor for
--------------------------------------------

      TAA9891    The command failed.  Diagnostic messages will exist
      TAA9892    Not all values to be changed can be *SAME

Escape messages from based on functions will be re-sent.

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

   MSGQ          The   qualified  name  of  the   *MSGQ  object  to  be
                 changed.  A single message  queue, a generic name,  or
                 the special value *ALL may be used.

                 A single library must be specified.

   SEV           The lowest  severity of  a message  that will cause  a
                 break.  *SAME is the default.

                 A number between 0 - 99 may be specified.

   RESET         A  *YES/*NO value  for whether  to reset  old messages
                 to new.  *NO is the default.

                 *YES  may be  specified to  reset the  old messages to
                 new.

   FORCE         Whether  to   force  changes   to  messages  (or   new
                 messages)  to   auxiliary  storage.     *SAME  is  the
                 default.

                 *YES may be specified to force the messages.

                 *NO may be specified to not force the messages.

   MSGQFULL      The  action to be taken if  the message queue is full.
                 *SAME is the default.

                 *SNDMSG may  be specified  to send  a  message to  the
                 job that is sending the message.

                 *WRAP may  be specified to  remove the  oldest message
                 to allow the new message to be written.


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

You must have *ALLOBJ special authority to use CHGMSGQ2.

A  *MSGQ  object  owned  by one  of  the  system  profiles  may not  be
changed.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKIBMPRF       Check IBM profile
     CHKOBJ3         Check object 3
     CVTOBJD2        Convert object description 2
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDIAGMSG      Retrieve diagnostic message
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHGMSGQ2      *CMD                   TAAMSKL       QATTCMD
   TAAMSKLC      *PGM       CLP         TAAMSKLC      QATTCL
					

Added to TAA Productivity tools January 15, 2014


Home Page Up to Top