TAA Tools
SNDJLGMSG       SEND JOB LOG MESSAGE TOOL              TAAMSHV

The Send Job  Log Message command  provides a simple method  of sending
a message  with a message ID to  the job log.  This  allows for setting
a  'mark' in the job log that can be  read by a tool such as CHKSAVRST.
Only the message IDs TAA9871 - TAA9878 may be used.

A typical series of commands would be:

             SNDJLGMSG     MSG('SAVE1') MSGID(TAA9878)
             SAVLIB        ...
             CHKSAVRST     ... STRMSGVAL('SAVE1')

This would set  a mark  in the job  log so  that the CHKSAVRST  command
would  begin considering messages  when the  mark was  found (CHKSAVRST
requires the use of TAA9878).

The  message is sent to  the program message queue  of the program that
uses SNDJLGMSG.

SNDJLG Program
--------------

A program  (SNDJLG) is provided  to allow  simple messages  to be  sent
from a HLL program to the job log.  Typical RPG code would look like:

     C                     MOVEL'My msg  'MSG   256
     C                     CALL 'SNDJLG'
     C                     PARM           MSG

The  MSG  parameter must  be  specified  as  256  bytes.   The  TAA9871
message is sent to the job log with the provided text.

Sending messages  to the job log  can be followed by a  Call to the TAA
ABORT program which will end the current program.

For example, this could be used  if the program is processing  specific
code types and finds an unsupported type:

     C            'Bad typ'CAT  TYPE:1    MSG   256
     C                     CALL 'SNDJLG'
     C                     PARM           MSG
     C                     CALL 'ABORT'

SNDJLGMSG escape messages you can monitor for
---------------------------------------------

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

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

   MSG           The text of the message to be sent.

                 Up to 256 bytes  may be sent, but if the  intent is to
                 use the  value for a command like  CHKSAVRST, only the
                 first 20 bytes are tested.

   MSGID         The  Message ID to  be sent.   The default is TAA9871.
                 It must be a  message ID between the range  of TAA9871
                 and TAA9878.   These message IDs exist  in the TAAMSGF
                 message file in TAATOOL.

                 CHKSAVRST uses the TAA9878 message.

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

None.

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

None.

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

None, the tool is ready to use.

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

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

   SNDJLGMSG     *CMD                   TAAMSHV       QATTCMD
   TAAMSHVC      *PGM       CLP         TAAMSHVC      QATTCL
   SNDJLG        *PGM       CLP         TAAMSHVC2     QATTCL
					

Added to TAA Productivity tools December 15, 2000


Home Page Up to Top