Applying PTFs to the message editing utility (Step 5)

This topic outlines the process that you use to apply service to the message data sets built via the message editing utility. This is necessary to keep the message files created by the message editing utility in step with the PTF level for your CICS® system. It is important that the PTF update process is run whenever you update your CICS PTF level. Failure to do this can result in errors when your running CICS regions issue messages.

To apply PTF updates to your message files:

  1. Apply PTFs to the SMP/E-maintained source. This happens as part of the normal process of applying PTFs to CICS.
  2. Select the ApplyPTF (F10) option of the Main panel. This displays the Submit PTF update job panel is displayed; for example, see Figure 54. To apply a PTF:
    1. Complete the data set details for the SMP/E maintained SDFHMSRC data set and the update log.
    2. Press ENTER to validate the input fields.
    3. Press Submit (F5) to submit the PTF update job.
  3. When the update is complete check the output log for messages requiring re-translation.
  4. Translate any messages as needed, and re-run the link-edit and generate jobs. This creates a new message module to use with your CICS jobs.

Figure 54. Message editing utility submit PTF update job panel
          Message Editing Utility - Submit PTF update job     ROW 1 TO 2 OF 2
 
 Change the values below, press ENTER to save or F5 to Submit.
 
 
 SMP/E maintained SDFHMSRC. CICSTS31.CICS.SDFHMSRC___________________________
 
 PTF update log . . . . . . your.PTFLOG_________________________________
 
 Write log in upper case? . NO_   Yes/No
 
 The PTF updates will be applied to the following data sets.
 
 Data set                                        Language
 userid.MEU.SDFHSRCA                             Alternative English
 userid.MEU.SDFHSRCM                             Macedonian
 ***************************** BOTTOM OF DATA ********************************
 
 
 
 
 
 
 COMMAND ===> ________________________________________________ SCROLL ===>____
  F1=Help      F2=Split     F3=End       F5=Submit    F7=Backward  F8=Forward
  F9=Swap     F12=Cancel

When the details have been completed and verified, press the Submit (F5) to instruct the message editing utility to build and submit a TSO CLIST to apply the PTF updates. This CLIST is intended for TSO Background execution only.

Immediately after pressing Submit (F5), the message editing utility terminates. The utility is prevented from restarting while the PTF update job is in progress. If the update process should fail for any reason, two data sets will be left over that will prevent the message editing utility from running. In this situation the following data sets can safely be deleted:

userid.MEU.PTFJOB
userid.MEU.PTFCLIST

The submit PTF update job can now be restarted.

Guidelines for PTF update job

The PTF update job does the following processing:

PTF update log sample output

Figure 55 shows a sample of the output for the message editing utility PTF update log.

Figure 55. Message editing utility PTF update log sample output
 
DFHMEUU *** PTF update program started *** yy/mm/dd hh:mm:ss
 
DFHMEUU PTF COMPARISON STARTED
COMPARING PTF DFHMEACE - ENGLISH DFHMEACE
COMPARING PTF DFHMEAIE - ENGLISH DFHMEAIE
COMPARING PTF DFHMEAKE - ENGLISH DFHMEAKE
 
DFHMEUU PTF COMPARISON COMPLETED
 
DFHMEUU ---------------------------------------
 
DFHMEUU PTF UPDATE STARTED   userid.MEU.SDFHMSRC
 
DFHMEUU DFHMEAPE UPDATED MESSAGE 0701 - OLD DETAILS FOLLOW
SPECIAL_INSERT APPLID                                                   07300000
TEXT " AN ABEND (CODE "                                                 07310000
INS#1 FORMAT CHAR PUBSCHAR "ABCODE"      * 6-CHAR ABEND CODE            07320000
TEXT ") HAS OCCURRED IN EXIT PROGRAM "                                  07330000
INS#2 FORMAT CHAR PUBSCHAR "PROGNAME"    * 8-CHAR EXIT PROGRAM NAME     07340000
TEXT " AT EXIT POINT "
INS#3                                    * 8-CHAR EXIT POINT NAME
TEXT "."
 
DFHMEUU DFHMEDEE ADDED   MESSAGE 0118
 
DFHMEUU DFHMETDE ADDED   MESSAGE 1280
 
DFHMEUU DFHMETOE DELETED MESSAGE 6024
 
DFHMEUU PTF UPDATE COMPLETED userid.MEU.SDFHMSRC
 
DFHMEUU ---------------------------------------
 
DFHMEUU PTF UPDATE STARTED   userid.MEU.SDFHSRCA
 
DFHMEUU PTF UPDATE COMPLETED userid.MEU.SDFHSRCA
 
DFHMEUU *** PTF UPDATE PROGRAM COMPLETED *** yy/mm/dd hh:mm:ss

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 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 ]]