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