CHGMSGD2 CHANGE MESSAGE DESCRIPTION 2 TAAMSGK
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
** 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
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
** 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.
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
See the previously described restrictions for what is duplicated and
the limits on certain parameters.
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
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
Added to TAA Productivity tools April 1, 1995