Specifying default values for the message editing utility (Step 2)

When you start the message editing utility for the first time, the Set defaults panel 1 (of 2) is displayed for you to enter your default values for the utility. For example, see Figure 48.

Note:
When you first start the message editing utility, the following message is overlaid on the CICS® macro library and CICS SDFHAUTH library lines; but after you press the ENTER key, the message is removed.
MEU017  Defaults must be set before the Message Editing Utility can be used.

While entering the defaults you can press the ENTER key to save the values as you progress. When you have entered all the required default values, you can save the values and exit the panel by using End (F3). This either returns you to the "Message Editing Utility" main panel or displays the Set defaults panel 2, as shown in Figure 49.

When you have defined your default values, any subsequent start of the message editing utility displays the message editing utility Main panel first.

Figure 48. Message editing utility set defaults panel (1 of 2)
                    Message Editing Utility - Set defaults          Page 1 of 2
                                                                  More:   +
 
 Values are saved when ENTER, Forward (F8), or End (F3) is pressed.
 
 MEU target data sets index  userid_______________
 
 Current language (NATLANG)  A  +   (ENG) Alternative English
 
 Replace members during
     English source copy?  . NO_   Yes/No
 
 SMP/E maintained SDFHMSRC . CICSTS31.CICS.SDFHMSRC_______________________ ____
 
 DFHMEUL load library  . . . userid.load.library_____________________
 
 CICS macro library  . . . . CICSTS31.CICS.SDFHMAC________________________ ____
 
 CICS LOAD library   . . . . CICSTS31.CICS.SDFHAUTH_______________________ ____
COMMAND ===> __________________________________________________________________
 F1=Help      F2=Split     F3=End       F4=Language  F5=Refresh   F8=Forward
 F9=Swap     F12=Cancel
Note:
After the MEU target data sets index and the SMP/E maintained SDFHMSRC parameters have been set they should not be changed. The message editing utility creates a copy of the SMP/E maintained SDFHMSRC for its own use, called MEU target data sets index.SDFHMSRC. These parameters are also used as a base for the PTF update job. Changing either can result in inconsistencies in the message files.

The + sign beside the current language suffix field indicates that further help is available. Select Language (F4) to view the Language selection panel. (See Figure 50.) The language suffix that you select is shown in the Current language (NATLANG) field.

To refresh the values back to the values last saved, use Refresh (F5).

You are recommended to use one target data set index for all languages. This makes it easier to create message modules for all languages, and to apply any PTF updates for the utility.

To create a message module, the utility needs to find all the translated messages for a language under the same target data set index. Therefore, you must not split the messages modules for a language between data sets with different indexes.

When the utility creates a new message module, it adds the module to the DFHMEUL load library specified on the Set defaults panel. For CICS to use this library, it must be APF-authorized, and added to the STEPLIB concatenation of your CICS startup job. (Alternatively, you can copy the new message module to another library in the STEPLIB concatenation.)

The CICS SDFHAUTH library specified on the Set defaults panel is used only to find the message module for messages that have not been edited.

Figure 49. Message editing utility set defaults panel (2 of 2). This defines the job statement information added to the JCL to link-edit and generate message load modules, and to apply PTF updates.
                   Message Editing Utility - Set defaults        Page 2 of 2
                                                                 More:  -
 
Values are saved when ENTER, Backward (F7), or End (F3) is pressed.
 
 
JCL output class  . . . . . *
 
Jobcard 1  . . //useridxx JOB (ACCOUNTING INFO),'NAME',_____________________
        2  . . //________MSGCLASS=H,________________________________________
        3  . . //________NOTIFY=userid,_____________________________________
        4  . . //________CLASS=M____________________________________________
        5  . . //*__________________________________________________________
 
 
 
 
 
 
 
 
 
 COMMAND ===> ______________________________________________________________
  F1=Help      F2=Split     F3=End       F5=Refresh   F7=Backward  F9=Swap
 F12=Cancel

Selecting languages for message translation

You can select the language to be used in your message set members on the Language selection panel. An example of the Language selection panel is shown in Figure 50. The languages supported by the message editing utility are listed in the Language selection panel and for reference in Table 10.

Table 10. Languages and codes supported by the message editing utility
NATLANG code NLS code Language
A ENG Alternative English
Q ARA Arabic
1 BEL Byelorussian
L BGR Bulgarian
B PTB Brazilian Portuguese
T DBCS CHT Traditional Chinese
2 CSY Czech
D DAN Danish
G DEU German
O ELL Greek
S ESP Spanish
W FIN Finnish
F FRA French
X HEB Hebrew
3 HRV Croatian
4 HUN Hungarian
J ISL Icelandic
I ITA Italian
H DBCS KOR Korean
M MKD Macedonian
9 NLD Dutch
N NOR Norwegian
5 PLK Polish
P PTG Portuguese
6 ROM Romanian
R RUS Russian
Y SHC Serbo-Croatian (Cyrillic)
7 SHL Serbo-Croatian (Latin)
V SVE Swedish
Z THA Thai
8 TRK Turkish
U UKR Ukrainian
Notes:
  1. DBCS denotes Double-Byte Character Set languages.
  2. The following language module suffixes are not supported by the message editing utility:
    • E - US English master data sets.
    • K - Japanese data sets, where translation is performed by IBM®.
    • C - Simplified Chinese data sets, where translation is performed by IBM.
  3. A for alternative English. Code letter A means "alternative English" to distinguish your edited English message tables from the default US English message tables supplied by CICS. The default US English tables are designated by the language code letter E.
  4. You can select only one language a particular message editing utility edit session.
  5. The NATLANG code for the selected language is used as the suffix of your edited message data sets to be created from the English language message data sets.
Figure 50. Message editing utility language selection panel
                     Language selection    ROW 1 TO 10 OF 33
 
  Use / to select a language, then press ENTER.
 
   NATLANG  Status  NLS   Language                     DBCS
                    code
 _    A     Copied  ENG   Alternative English
 _    B             PTB   Brazilian Portuguese
 _    D             DAN   Danish
 _    F             FRA   French
 _    G             DEU   German
 _    H             KOR   Korean                       DBCS
 _    I             ITA   Italian
 _    J             ISL   Icelandic
 _    L             BGR   Bulgarian
 
 COMMAND ===>______________________________SCROLL ===> PAGE
  F1=Help        F2=Split       F3=End         F7=Backward
  F8=Forward     F9=Swap       F12=Cancel

Languages that have already been set up and used are indicated by the status Copied.

To select a language type a / character in the field to the left of the NLS code column and press ENTER.

Related reference
Back to introduction
Message editing utility (DFHMEU)
Back to full list of steps
Process for using the message editing utility
Back to Step 1
Starting the message editing utility (Step 1)
Go to Step 3
Performing actions on message data sets (Step 3)
Further information
Rules for editing and translating messages
Getting help with the message editing utility
[[ Contents Previous Page | Next Page Index ]]