PM62845: ABEND ISSUING DFHFC0165 MESSAGE DUE TO INVALID DBCS CHARACTERS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• VSAM RLS FILES ARE BEING SHARED CICS AND BATCH JOBS.  WHEN A TIM
  EOUT OCCURS FOR A RECORD LOCK, CICS CREATES MESSAGE DFHFC0165 TO
   INFORM THE USER OF THE FAILING CALL AND THE HOLDER OF THE LOCK.
  THE CICS MESSAGE IS BASED ON IFGVPDI WHICH IS PASSED BACK TO CIC
  S.  THE VPDIITOSS FIELD CONTAINS THE SUBSYSTEM ID WHICH HAPPENS
  TO BE A TIMESTAMP FOR BATCH JOBS.  IF THE TIMESTAMP CONTAINS
  x'0E' or x'0F', AN ERROR WILL OCCUR WHEN CICS ATTEMPTS TO FORMAT
  THE FIELD AS DBCS.  THE USER IS THEN UNABLE TO TELL WHAT JOB IS
  HOLDING THE RECORD LOCK.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS fails to issue a DFHFC0165 message *
  *                      due to invalid DBCS formatting and      *
  *                      instead issues a DFHME0121 message.     *
  *                      Alternatively the applid field of the   *
  *                      DFHFC0165 message is missing.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  VSAM RLS is being used to share files between CICS and batch
  jobs.  A timeout occurs for a record lock and CICS creates a
  DFHFC0165 message to notify the user.  VSAM returns IFGVPDI data
  which is used to populate the DFHFC0165 message.  If the lock
  in question is held by a job which is not a CICS system a
  timestamp is returned in place of an applid. If this timestamp,
  contained in the VPDIITOSS field, contains DBCS shift-in or
  shift-out characters, CICS may issue a DFHME0121 message due
  to an invalid DBCS format.
  If VSAM PTF UA64714, UA64715 or UA64745 has been applid to z/OS
  1.11, 1.12 or 1.13 respectively the above error will not occur.
  However the applid field of the DFHFC0165 message will be empty
  as the aforementioned VSAM PTFs place blanks in the VPDIITOSS
  field of the IFGVPDI.
  Additional keywords: msgDFHFC0165 FC0165 0165 msgDFHME0121
  ME0121 0121 OA37709
  

Problem conclusion

• VSAM PTFs UA64714, UA64715 and UA64745 for z/OS 1.11, 1.12 and
  1.13 respectively, replace the timestamp in the VPDIITOSS field
  with blank characters for batch jobs.  In this PTF, DFHFCRS has
  been modified such that the applid insert into a DFHFC0165
  message is now 'BATCHPGM' if the VPDIITOSS field returned by
  VSAM is blank.
  
  The CICS Transaction Server for z/OS Version 4 Release 1 CICS
  Messages and Codes manual (GC34-7035-02) will be altered as
  follows.
  
  The description of message DFHFC0165 in Chapter 1. DFH messages,
  will be modified such that the applid2 bullet point will now
  read:
  
  applid2 is the applid of the CICS system that owns the lock.
  If the job that owns the lock is not a CICS system, applid2
  equals BATCHPGM.
  
  The same change will also be made to the DFHFC0165 message
  description in the CICS Transaction Server for z/OS Version 4
  Release 2 CICS Messages and Codes Vol 1 manual (GC34-7175-01).
  In this manual the change will be made in Chapter 4. DFH
  messages - DFH01 to DFHM.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK79361 UK79362

Modules/Macros

•    DESFCRS  DFHFCRS  DFHMEFAE DFH62845
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK79361

     UP12/07/31 P F207

• R700 PSY UK79362

     UP12/07/31 P F207

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.