TAA Tools
DSPMSGSID       DISPLAY MESSAGE DESCRIPTION CCSID      TAAMSIH

The  Display Message  CCSID  command displays  the  actual CCSID  of  a
Message   Description.      DSPMSGSID   is   designed  as   a   problem
determination  aid.   When a  Message File  has a  CCSID of  65535, the
CCSID of the Message Description  is ignored and 65535 is  used because
no conversion will  occur at the time of an ADD/CHGMSGD  or if the text
is retrieved (such as by SNDPGMMSG).

You  must  have  *CHANGE  authority  to  the  Message  File  if  it  is
specified as CCSID 65535.   During the  processing of the command,  the
CCSID will be  changed to 65534 to  allow the correct display  and then
changed back again.

A typical command would be:

            DSPMSGSID     MSGF(xxx) MSGID(yyynnnn)

To see the CCSID:

  **   Select Option 5 for the Message Attributes and press Enter

  **   Use Rollup to the second page to see the CCSID

An alternative is to use OUTPUT(*PRINT) and view the spooled file.

If  the Message  File is not  65535, the  Message File is  not changed.
The Message Description is still displayed.

What problem is being solved by DSPMSGSID
-----------------------------------------

CCSID (Coded  Character  Set IDs)  allow  different languages  to  have
unique code  points for values  such as the  US '$' or  unique language
characters  such as  those  with  diacritical marks  (for  example, the
Spanish  'tilde'  or the  German  'umlaut').   Different  characters in
different languages  may share  the same  code point  (such as  X'8B'),
but  the system  keeps them  straight  by use  of CCSIDs.   The  system
converts  data  based  on  the assigned  CCSID  of  an  object  and the
assigned CCSID of a job.

A CCSID of 65535 is  the default for US English.   If you have only  US
English, you can ignore CCSIDs.

There  is  a  CCSID  parameter  for  both  Message  Files  and  Message
Descriptions.

When  a Message Description  is added to  a Message File,  the CCSID of
the job is used (by default) for the Message Description.

If  the  Message  File  is  CCSID  65535,  the  CCSID  of  the  Message
Description is essentially  ignored during processing and the  CCSID of
the Message  File is used instead.   If the Message File  is 65535, and
you  display  a Message  Description,  you will  see  a CCSID  of 65535
regardless of what value was  assigned when ADD/CHGMSGD was used.   The
actual CCSID is  still retained by the system, but  since 65535 will be
used, 65535 is displayed.

If  the Message File  has a  CCSID other than  65535, the  CCSID of the
Message Description is used instead  of the CCSID of the Message  File.
If  DSPMSGD  is  used,  you  will see  the  actual  CCSID  assigned  by
ADD/CHGMSGD.

A  special CCSID of 65534  exists to allow US  English Message Files to
have unique CCSIDs for different language text.

DSPMSGSID is  a problem  determination  aid to  allow  you to  see  the
actual  CCSID of  the  Message Description  rather  than 65535  if  the
Message File is 65535.

DSPMSGSID escape messages you can monitor for
---------------------------------------------

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

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

   MSGF          The qualified  name of the Message File.   The library
                 value  defaults to *LIBL.   *CURLIB may  also be used.

   MSGID         The Message Description to be displayed.

   OUTPUT        The type of  output to be used.   * is the  default to
                 cause either  a display or print depending  on the job
                 type.     *PRINT  may  be  entered  to  cause  printed
                 output.

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

You must have  *CHANGE authority  to the  Message File if  it is  CCSID
65535.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     RTVMSGFA        Retrieve message file attributes
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPMSGSID     *CMD                   TAAMSIH       QATTCMD
   TAAMSIHC      *PGM       CLP         TAAMSIHC      QATTCL
					

Added to TAA Productivity tools March 15, 2002


Home Page Up to Top