The z/OS Unicode environment mapping utility (CUNMIMAP)

The z/OS Unicode environment mapping utility (CUNMIMAP) helps diagnose problems with the conversion environment. The utility reads the z/OS Unicode environment (or a conversion image) and reports its content. The report content is similar to the CUN3000I messages produced by the DISPLAY UNI command, but with more details. The report shows the conversions loaded, techniques available, sub-CCSID information, where control blocks and conversion tables are stored, and more.

Note: This is a diagnostic tool. This is not a programming interface. The data and the data format given by this interface is subject to change without notice. APIs are not supplied to determine the content of the z/OS Unicode environment.

To get information about a specific character conversion, use the z/OS Unicode Services conversion information service.

There is a tool to format a character conversion table that is shipped in data set SYS1.SCUNJCL(CUNJITG1).

The CUNMIMAP utility can format either the z/OS Unicode environment or a Unicode image (created by the z/OS Unicode image generator CUNMIUTL). The jobs shown below show how to invoke the z/OS Unicode environment mapper utility (shipped in SYS1.LINKLIB(CUNMIMAP)).

To format the z/OS Unicode environment, specify PARM='ACTIVE':

//TESTXXX JOB (12345678),'TEST JOB',NOTIFY=&SYSUID,
//     MSGCLASS=A,MSGLEVEL=(1,1),CLASS=A,
//     REGION=512K
//STEP1    EXEC PGM=CUNMIMAP,PARM='ACTIVE'
//SYSPRINT DD   SYSOUT=*

To format a Unicode image, specify PARM='FILE' and DD SYSUT1 to specify which Unicode image to format:

//JCLMIMAP JOB (12345678),'TEST JOB',NOTIFY=&SYSUID,
//     MSGCLASS=A,MSGLEVEL=(1,1),CLASS=A,
//     REGION=512K
//STEP1    EXEC PGM=CUNMIMAP,PARM='FILE'
//SYSPRINT DD   SYSOUT=*
//SYSUT1   DD   DSN=MY.IMAGES(CUNIMGXX),DISP=SHR

The z/OS Unicode environment and Unicode images have different formats, but contain many common elements. The following is an example of part of the output of the CUNMIMAP utility:

   Image Header Report.      01/12/2009   21:29
---------------------------------------------------------------
 
ACTIVE....................YES
Creation time.............11/18/2009 22:07:35
Dataspace token...........80003C0000000042
Dataspace alet............01FF000E
Dataspace size............524287
Dataspace ttoken..........00000004000000010000000000FDA4B8
Dataspace start...........00000000
Pages used................0
Number of UCCEs...........45
Number of top level UCCEs.31
Number of UCAEs...........0
Address of first UCCE.....001D92C0
Address of first UCAE.....00000000
 
   UCCE Structure Report.       01/12/2009   21:29
 
Address   Structure                TabPtr    TabSize Conversion
--------  -----------------------  --------  ------- ----------
000E3780  13488-00037-E            000E4000    65536 Two  To One
00156000  01047-13488-L            001561C0      512 One  To Two
00156B80  13488-00819-L            00157000    65536 Two  To One
001A8000  13488-00850-L            001A9000    65536 Two  To One
000A1580  01208-00037-E                              Two Stage
000A1660   01208-01200-ER                          0 UTF8 To Two
000A1740   13488-00037-E           000A2000    65536 Two  To One
001254A0  13488-01047-L            00126000    65536 Two  To One

Note: Not all the fields present in the data are formatted.