The  Change Message  Description  2 command  is  intended for  an  easy
solution for  changing second level  text that exceeds 512  bytes.  The
system supports a maximum of 3000 bytes for the second level text.

The  WRKMSGD command allows you to see  the current value of the second
level text before  you change it.   However, the  support that is  used
is the  command prompter which  has a limit  of 512 bytes for  a value.
If  the second level  text exceeds this,  a string of  periods is shown
at the end of the value.

You can  change  second level  text greater  than  512 bytes  with  the
CHGMSGD  command, but  this  does  not allow  you  to  see the  current
value.  You can only replace it.

The  CHGMSGD2 command  lets you  change  most of  the parameters  on an
existing message using the prompter.   It then displays the first  1500
bytes  of the  second  level text  and  allows you  to  change it.    A
command key may be used to access the second 1500 bytes.

A typical command is entered as:

        CHGMSGD2    MSGID(aaannnn) MSGF(xxxx)

Beginning and  ending apostrophes are  not needed for  the second level
text.     You  may  enter  a   single  apostrophe  where  needed  (e.g.
o'clock).   If  the  second level  text  exceeds  1500 bytes  you  must
manage the spacing at the end of the first 1500 bytes.

Not  all of the  function of  CHGMSGD is  supported.   The restrictions
are:

  **   The validity parameters RANGE and REL cannot be changed.

  **   Up to 40 field definitions for message data can be changed.

It  is valid  to use a  combination of  CHGMSGD and  CHGMSGD2 and avoid
any restrictions.

The CHGMSGD2  function  is performed  by  using  DSPMSGD to  a  spooled
file,  CPYSPLF  and  a  program which  reads  the  printed  output  and
performs selective  prompting for most of the  CHGMSGD parameters.  The
second level text is then shown  using a display file with two  screens
each containing 1500 bytes.

If your  second level text  does not exceed  512 bytes, you  should use
WRKMSGD to change the text rather than CHGMSGD2.

Command key usage
------------------

The  first  display shown  is  the normal  command  prompt for  CHGMSGD
without  the SECLVL  parameter.  Selective  prompting is  used to cause
the display.   If  you  exit this  display normally  (i.e.   the  Enter
key),  the values  shown will  be changed  for the  message description
regardless  of what  happens on  the next  displays.   If you  exit the
command prompt normally,  the next display shows  the first 1500  bytes
of the second level text.  The following command keys exist:

  **   F3.   This  will  end the  command without  any  changes to  the
       second level text.

  **   F12.   This  will cause  a return  to the  prompt for  the other
       command parameters.   Any  second level  text changes  made  are
       ignored.

  **   F6.  This  will cause a prompt for  the second 1500 bytes.   The
       second  display has  similar command  keys  except that  F6 will
       return  to the 1st  1500 bytes display.   Any changes made while
       F6 is  used  on either  display are  remembered  and the  second
       level text will be changed unless F3 or F12 are used.

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

   MSGID         The message ID to be changed.

   MSGF          The  qualified   name  of  the  message   file  to  be
                 changed.  The library defaults to *LIBL.

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

Because  the  DSPMSGD  output  is  copied  with  CPYSPLF, the  CHGMSGD2
function is release dependent.   Only the lower and upper case  English
language  versions  are  supported.   If  the  format  of  the  DSPMSGD
printed  output is changed  on a  subsequent release, the  program must
be modified.

See the previously  described restrictions for  what is duplicated  and
the limits on certain parameters.

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

The following TAA Tools must be on your system:

     DUPMSGD      Duplicate message description
     SNDCOMPMSG   Send completion message
     SNDESCMSG    Send escape message
     SNDSTSMSG    Send status message

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

None, the tool is ready to use.

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

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

   CHGMSGD2      *CMD                       TAAMSGK       QATTCMD
   TAAMSGKC      *PGM           CLP         TAAMSGKC      QATTCL
   TAAMSGKD      *FILE          DSPF        TAAMSGKD      QATTDDS

The RPG program TAAMSGJR  from the DUPMSGD TAATOOL is called  by the CL
program TAAMSGKC.