PH25397: BMS FIELDS DEFINED WITH JUSTIFY(RIGHT,ZERO) LEAD TO DFHTF0200

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• For DFHMDF macro with field defined as JUSTIFY(RIGHT,ZERO), the
  comparison doesn't work correctly. So the DFHTF0200 message and
  subsequent abend ABSX happened.
  
  This only applies when the BMS Intrusion Detection Service is
  being used.
  
  message:
  DFHTF0200 Mapset xxx
  Map xxx Field xxx Attr x Invalid 3270 datastream from client.
  
  Additional Symptom(s) Search Keyword(s):
  JUSTIFY(RIGHT,ZERO)  DFHTF0200 ABSX TF0200  msgDFHTF0200
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHTF0200 issued incorrectly for an     *
  *                      unchanged BMS field.                    *
  ****************************************************************
  CICS is running with the BMS Intrusion Detection Service active.
  A BMS map field defined as ATTRB=(PROT,FSET) and JUSTIFY=(RIGHT,
  ZERO) is sent to the screen.  The field data is in the first
  few field positions and the rest of the field is blank.
  
  The field is unchanged but, during RECEIVE MAP processing,
  DFHTFIQ is incorrectly determining that the data is different.
  This is because the JUSTIFY values ZERO and RIGHT are not being
  taken into account when comparing the data that was on the
  screen and the data that is being returned to the application.
  
  This leads to message DFHTF0200 being issued and the task is
  abended ABSX if requested by DFHBMSX.
  

Problem conclusion

• DFHTFIQ has been updated to take account of the JUSTIFY setting
  for protected fields when detecting if there have been any
  changes to the field data.
  
  The DFHTF0200 message explanation has been updated in the
  Knowledge Centers for CICS 5.3, 5.4, 5.5 and 5.6 to describe how
  to correctly process the decimal field position.
  
  The updated message explanation is;
  
  The 3270 datastream received from a terminal emulator client
  attempted to override a protected field.
  
  The field value returned in the DFHTF0200 message is a 3270
  buffer address in decimal.  This address represents the position
  of a field on the screen, 0 being Row 1 Column 1 and 1919 being
  Row 24 Column 80 for a 24X80 display image screen size.
  
  The field value can be converted into Row/Column using the
  following method below (where W is the column width of the
  display screen):
  
    o (Field value / W) + 1 = Row number
    o The remainder + 1     = Column number
  
  For example, given a display image of 24 rows and 80 columns the
  Row/Column of field value 1602 is:
  
    o (1602 / 80) + 1  = Row 21
    o (1602 -(20 * 80)) = 2 + 1  = Column 03
  
  The attr values returned are:
  
    Value   Meaning
    P       Protected
    N       Non display
    M       Modified
  

Temporary fix

Comments

APAR Information

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

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

  UI70180 UI70181 UI70182 UI70183

Modules/Macros

• DFHMETFE DFHTFIQ
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI70181

     UP20/06/25 P F006

• R100 PSY UI70183

     UP20/06/24 P F006

• R200 PSY UI70182

     UP20/06/24 P F006

• R300 PSY UI70180

     UP20/06/27 P F006

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.