TAA Tools
SNDCOMPMSG      SEND COMPLETION MESSAGE                TAAMSGW

The Send  Completion  Message command  provides a  simple solution  for
sending  a completion  message  from a  CL  program or  a  HLL program.
Sending   a  message  of   type  *COMP  can  make   the  job  log  more
understandable.

  **   For a  CL program there  is not  much of an  advantage in  using
       SNDCOMPMSG   over  sending   the  message   yourself  with   the
       SNDPGMMSG  command.   The interface  for SNDCOMPMSG is  a little
       simpler, in that you would say:

            SNDCOMPMSG  MSG('Program worked successfully ...')

  **   For an RPG program you would specify:

     IMSGDS       DS                            512
     .
     C                     CALL 'SNDCOMP'
     C                     PARM           MSGDS

       Prior to calling the SNDCOMP  program, you would fill the  MSGDS
       data structure with the text you want to send.

SNDCOMPMSG sends  message ID TAA9855 from  the TAAMSGF message  file in
TAATOOL  as a  completion message  with  the text  provided in  the MSG
parameter as the MSGDTA for TAA9855.

If you want  a more flexible  solution for your  HLL program,  consider
the use of the TAA Tool RPGSNDMSG.

The SNDCOMPMSG  tool uses  the QMHSNDPM  API and  sends the  completion
message  to the program  prior to yours  on the  Call Stack (it  uses a
Stack Counter value of 2).

If  SNDCOMPMSG is  sent from  an ILE program,  the message  goes to the
previous program in the stack (not the previous module).

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

   MSG           The text of the  message you want to send.   A maximum
                 of 512 bytes may be sent.

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

None.

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

None.

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

None, the tool is ready to use.

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

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

   SNDCOMPMSG    *CMD                   TAAMSGW       QATTCMD
   SNDCOMP       *PGM       CLP         TAAMSGWC      QATTCL
					

Added to TAA Productivity tools May 1, 1996


Home Page Up to Top