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
|
