TAA Tools
CHKLVLMSG       CHECK LOW LEVEL MESSAGE                TAAMSJZ

The  Check Low  Level  Message  command allows  you  to monitor  for  a
message  ID sent by  a command  that does  not send an  escape message.
For  example, it may be a  *DIAG type.  The  message being sent must be
from a  message file  (it  cannot be  an 'impromptu'  type).   See  the
example in the tool documentation for how to use CHKLVLMSG.

CHKLVLMSG  may only be  used in  a CL  program.   You must  precede the
command  that  is sending  the  message you  want to  monitor  for with
RTVMSGKEY.

Typical code would appear as:

             DCL        &MSGKEY *CHAR LEN(4)
              .
             RTVMSGKEY  MSGKEY(&MSGKEY)
             /* A command that sends a non-escape message */
             CHKLVLMSG  MSGID(xxxxxxx) MSGKEY(&MSGKEY)
             MONMSG     MSGID(xxxxxxx) EXEC(DO) /* MSGID found */
                        /*                           */
                        /*   Your handing of the ID  */
                        /*                           */
             ENDDO      /* MSGID found */

If the message ID  specified does not exist  in the job log,  CHKLVLMSG
ends normally without a message being sent.

For example,  the CMPPFM  command sends one  of two  completion (*COMP)
messages.

            SPC6001  No differences found
            SPC6002  Differences found

The  following  code  would  cause SPC6002  to  be  sent  as an  escape
message.

             DCL        &MSGKEY *CHAR LEN(4)
              .
             RTVMSGKEY  MSGKEY(&MSGKEY)
             CMPPFM      ...
             CHKLVLMSG  MSGID(SPC6002) MSGKEY(&MSGKEY)
             MONMSG     MSGID(SPC6002) EXEC(DO) /* MSGID found */
                        /*                           */
                        /*   Your handing if CMPPFM  */
                        /*    finds differences      */
                        /*                           */
             ENDDO      /* MSGID found */

If CMPPFM found no differences, the  SPC6001 *COMP message would be  in
the job  log and CHKLVLMSG  would complete  normally without a  message
being sent.

If  CMPPFM  found  differences, SPC6002  would  be  sent  as an  escape
message.    Both  the  SPC6002 *COMP  message  and  the  SPC6002 escape
message would exist in the job log.

CHKLVLMSG escape messages you can monitor for
---------------------------------------------

The escape message you specify should be monitored for.

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

   MSGID         The message  ID that  you want  to send  as an  escape
                 message.   The message  ID would  typically be  from a
                 *DIAG or *COMP type.

   MSGKEY        The   message  received  by   the  RTVMSGKEY  command.
                 Normally, RTVMSGKEY  should be  specified just  before
                 the  command that  does not  send  an escape  message.
                 CHKLVLMSG  would  be  specified immediately  following
                 the command that does not send an escape message.


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

Because RTVMSGKEY is required  to return a  message key, the  CHKLVLMSG
command may only be used in a CL program.

The  message to  be  monitored for  must  be from  a  message file  (it
cannot be an 'impromptu' type).

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

The following TAA Tools must be on your system:

     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
   ------        ----    ---------      ----------    ----------

   CHKLVLMSG     *CMD                   TAAMSJZ       QATTCMD
   TAAMSJZC      *PGM       CLP         TAAMSJZC      QATTCL
					

Added to TAA Productivity tools April 15, 2012


Home Page Up to Top