The Send  Hex Message  command sends  a message  containing hex  values
(such as  X'C1' or X'03') and  displays the message in  both EBCDIC and
the  converted hex  format.   This is  designed as  a testing  aid when
dealing with  hex values  as the  system  support will  display a  blob
character for a value such as X'03'.

A typical SNDHEXMSG command would be:

            SNDHEXMSG   INPVAL(xxxx)

If the INPVAL had been X'C1C2F8'), the message would read:

         Input hex - AB8     Hex - C1C2F8

SNDHEXMSG escape messages you can monitor for
---------------------------------------------

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

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

   INPVAL        The input  value to convert.   Up to 128  bytes may be
                 entered.     The   actual  length  is   determined  by
                 scanning for the rightmost non-blank position.

   TOPGMQ        The  program queue  to  send  the  message  to.    The
                 default  is *PRV  meaning  the  previous program  from
                 the  one using  the SNDHEXMSG  command.   For example,
                 if PGMA  calls  PGMB  and  PGMB  uses  SNDHEXMSG,  the
                 message is sent to the PGMA message queue.

                 *SAME may  be  specified meaning  the program  message
                 queue of the same program that used SNDHEXMSG.

   ID            The  ID to  be part of  the message.   The  default is
                 *NONE meaning there is no ID.

                 If  an ID is  entered, it appears  at the beginning of
                 the message  that is  sent.   The intended  use is  to
                 help identify the value.

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

SNDHEXMSG cannot be used from the top program in the program stack.

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

The following TAA Tools must be on your system:

     CVTHEX          Convert hex
     SCNVARRGT       Scan variable right
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   SNDHEXMSG     *CMD                   TAAMSHU       QATTCMD
   TAAMSHUC      *PGM       CLP         TAAMSHUC      QATTCL