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

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.