Performing actions on message data sets (Step 3)

You can select message sets to be changed from the Main panel of the message editing utility. An example of the Main panel is shown in Figure 51.

The Main panel provides for:

Figure 51. Message editing utility main panel
                      Message Editing Utility - Main panel    Row 1 to 47 of 77
 
   Current language: Brazilian Portuguese
   MEU index: LARMOUR.PQ17125.CICS640.CREATED.AAA
 
   Type one or more action codes.  Then press Enter.
 
   C Copy  E Edit  L Link-edit                     Sort sequence: English name
                                                   Last change
 Action  English name  New name  Status      Date     Time   Userid    Size
 
  _      DFHMEACE      DFHMEACB  Link-edit   1998/07/28 17:23  userid 1205
  _      DFHMEAIE      .         .           .                 .      1827
  _      DFHMEAKE      .         .           .                 .      1216
  _      DFHMEAME      .         .           .                 .      .
  _      DFHMEAPE      DFHMEAPA  Edited      1998/07/28 17:54  userid 205
  _      DFHMEBPE      .         .           .                 .      .
  _      DFHMECCE      .         .           .                 .      .
  _      DFHMECEE      .         .           .                 .      .
  _      DFHMECPE      .         .           .                 .      .
  _      DFHMECRE      .         .           .                 .      .
  _      DFHMEDBE      .         .           .                 .      .
  _      DFHMEDDE      .         .           .                 .      .
  _      DFHMEDEE      .         .           .                 .      .
 COMMAND ===> ________________________________________________ SCROLL === PAGE_
 F1=Help      F2=Split     F3=End       F5=Generate  F6=Sort      F7=Backward
 F8=Forward   F9=Swap     F10=ApplyPTF F11=Defaults F12=Cancel

All the current English message source members are displayed on the Main panel. Use Forward (F8) and Backward (F7) to scroll up and down the list.

The status shown for a member is always the last action performed on that member. For example, if the action performed was Copy and a previously copied version of the source exists, the status changes to one of the following:

The Set defaults panel can be accessed by Defaults (F11). (See Figure 48.)

The PTF update panel can be accessed by ApplyPTF (F10). (See Figure 54.)

The other actions that you can perform from this panel are described in the following topics:

Copying message data set members

To create your own language source member for an English message source member, type C against the member name, then press ENTER. This copies the English source member to your language source data set as a member with the suffix of the current language (as specified on the Set defaults panel). For example, with the current language as S (Spanish) and the target data sets index as target.index, the member DFHMEACE is copied from the target.index.SDFHMSRC data set to the member DFHMEACS in the target.index.SDFHSRCS data set. If the target member exists and the replace option on the Set defaults panel has been selected, the member in the target data set is replaced and the status changes to Replaced.

Selecting message sets to be edited

To edit messages in a source member, type E against the member name, then press ENTER. This displays the Message number selection panel, which lists the messages in the source member and enables you to select messages to be changed. If the selected source member has not previously been copied, requesting the edit action copies the source member before editing it.

Note:

When editing RP messages, these messages are split between four message sets as follows:

When editing FC messages, these messages are split between four message sets as follows:

When editing ZC messages, these messages are split between four message sets as follows:

When you select a message set to be edited, the utility scans the file for the message numbers that it contains, and displays the Message number selection panel for those messages. The message numbers displayed are all the translatable messages from that message set. Any messages that cannot be translated are identified as such by a note added to the message in the CICS Messages and Codes. An example of the Message number selection panel is shown in Figure 52.

Figure 52. Message editing utility message number selection panel
         Message Editing Utility - Message number selection  ROW 1 TO 11 OF 11
 
  Message module: DFHMEACA
 
  Use / to select one or more messages and press ENTER.
 
  _   2001    _   2002    _   2003    _   2004    _   2005    _   2006
  _   2007    _   2008    _   2009    _   2010    _   2012    _   2014
  _   2015    _   2016    _   2017    _   2018    _   2019    _   2020
  _   2021    _   2022    _   2023    _   2024    _   2025    _   2026
  _   2027    _   2028    _   2029    _   2030    _   2033    _   2034
  /   2035    _   2036    _   2037    _   2038    _   2039    _   2040
  _   2041    _   2042    _   2043    _   2044    _   2047    _   2050
  _   2051    _   2052    _   2053    _   2054    _   2055    _   2056
  _   2057    _   2206    _   2207    _   2208    _   2230    _   2236
  _   2237    _   2238    _   2259    _   2260    _   2261    _   2262
  _   2263    _   2603    _   2605    _   2606    _           _
******************************* BOTTOM OF DATA *******************************
 
 
 
 
 COMMAND ===> ________________________________________________ SCROLL == PAGE_
  F1=Help      F2=Split     F3=End       F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

To select one or more messages to be edited, type a / character in the field to the left of the message number, then press ENTER. When you press ENTER the Edit message panel (see Figure 53) is displayed for the messages selected.

Editing selected message sets

You can use the Edit message panel to change the text and reply inserts, and the order of inserts, of selected messages. An example of the Edit message panel is shown in Figure 53.

Figure 53. Example of message editing utility edit message panel
                      Message Editing Utility - Edit message
 
    Message number: AC2035
 
  ****** ***************************** TOP OF DATA *****************************
  419000 text " An invalid error code has been passed "
  420000 text "to DFHACP. "
  421000 text " Transaction "
  422000 special_insert tranid
  423000 text " is terminated. "
  424000 text " Terminal "
  425000 special_insert termid
  426000 text "."
  ****** **************************** BOTTOM OF DATA ***************************
 
 
 
 
 
 COMMAND ===> ________________________________________________ SCROLL ===> PAGE_
  F1=Help      F2=Split     F3=End       F4=Refresh   F5=Rfind     F6=Rchange
  F7=Backward  F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel

For information and rules about editing CICS® messages, see Rules for editing and translating messages.

Assembling and link-editing the changed message data sets

Before you link-edit a source message member, ensure that it is not being used, because this prevents the link-edit job from running.

To link-edit a message source member, type L against the member name, then press ENTER. This submits a job to JES to convert the message source member into assembler language.

Note:
Check the link-edit job output to ensure that it completed successfully. If not, examine the error messages generated, correct the message set and re-submit the link-edit job.

Generating a message load module

When you have edited and link-edited all the messages source members that you require, the next step is to create a load module to use with your CICS regions. To do this, use Generate (F5) on the Main panel. This assembles the link-edited version of all your message members with the English version of any you have chosen not to translate. Successful completion of this step results in DFHMET1x and DFHMET5x load modules being placed in the data set specified in the DFHMEUL load library field on the Set defaults panel. These modules can be used with your CICS job by placing them in the relevant APF-authorized library and specifying the associated language code on the NATLANG system initialization parameter.

Sorting the lists of message set members

To sort the lists of message sets displayed on the Main panel use the sort function key (F6). You can sort the message set member list by:

Each time you press the sort function key the next sort order in the above list is selected.

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 2
Specifying default values for the message editing utility (Step 2)
Go to Step 4
Adding the new message load modules to STEPLIB (Step 4)
Further information
Rules for editing and translating messages
Getting help with the message editing utility
[[ Contents Previous Page | Next Page Index ]]