PI51499: NEW URM TO PROVIDE USER INPUT FOR BMS 3270 PROTECTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide a new BMS URM exit to enable/disable 3270 BMS
  SEND/RECEIVE MAP checking of overwritten protected fields.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provide a new User Replaceable Module   *
  *                      (URM) to decide on actions resulting    *
  *                      from identifying overwritten protected  *
  *                      fields used in 3270 BMS SEND/RECEIVE    *
  *                      MAP processing.                         *
  ****************************************************************
  * RECOMMENDATION: None                                         *
  ****************************************************************
  A new BMS 3270 Data stream Validation for SEND and RECEIVE MAP
  for checking overwritten protected fields by a 3270 emulator
  can now be activated/deactivated using a new CICS URM
  program, DFHBMSX.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• The new BMS 3270 protection URM, DFHBMSX, provides user input
  for BMS 3270 protection of SEND/RECEIVE MAP protected fields.
  
  The following CICS TS manuals at 5.1 and 5.2 have been updated.
  
  The Customization Guide has been updated with the description
  of the new BMS URM, DFHBMSX.
  SC34-2847-00 (CICS TS 5.1)
  SC34-7269-00 (CICS TS 5.2)
  
   The BMS 3270 Datastream Validation Program
  
   This user replaceable module is called to enable validation
   of 3270 data streams in BMS RECEIVE MAP commands.
   The user replaceable module is DFHBMSX. It has a commarea
   interface which is defined in DFHBMSXn (where n is the usual
   language suffix, e.g D for Assembler).
  
   The URM is called with BMSX_FUNCTION set.
   BMSX_FUNCTION can have two values
  
  1. BMSX_FUNCTION_INIT
   This is set once at CICS initialisation to identify whether
   CICS should validate 3270 data streams.
   The URM must set BMSX_ACTION to one of the following
   functions:
   BMSX_ACTION_CHECK   validation is enabled
   BMSX_ACTION_NOCHECK   no validation will be done (this is
   the default).
  
  2. BMSX_FUNCTION_OVERWRITE
   This is set if CICS detects that a protected field has been
   updated incorrectly by a 3270 terminal emulator during a BMS
   RECEIVE MAP command.
   This function is only called if validation is enabled during
   CICS initialisation.
   The URM must set BMSX_ACTION to one of the following
   functions:
   BMSX_ACTION_IGNORE - Do nothing
   BMSX_ACTION_LOG - Issue a DFHTF0200 message (this is the
   default)
   BMSX_ACTION_ABEND - Issue a DFHTF0200 message and abend the
   transaction ABSX.
   The URM can also set BMSX_LOGACTION to tell CICS whether to
   issue a single message for the first field detected on a map
   or a message for all fields.
   BMSX_LOGACTION_FIRST - Only output a message for the first
   field detected.
   BMSX_LOGACTION_ALL - Issue a message for all fields detected.
  
   The URM is also passed details of the first 16 fields which
   have been detected.
  
   If the URM is disabled it will be equivalent to
   BMSX_ACTION_NOCHECK on initialisation, and BMSX_ACTION_IGNORE.
  
  The CICS Messages and Codes manual has been updated with the
  new abend code ABSX and message DFHTF0200.
  GC34-2861-00 (CICS TS 5.1)
  GC34-7283-00 (CICS TS 5.2)
  
   ABSX
    Explanation
     CICS has detected that a BMS protected field has been
     updated by the client.
  
    System action
     The task is abnormally terminated with a CICS transaction
     dump.
  
    User response
     The message DFHTF0200 will give details of the client and
     the field updated. Refer to this message for further
     actions.
  
    Module
     DFHMCPE
  
   DFHTF0200 date time applid termid netname userid tranid
             Ipaddr ipaddr Mapset mapset Map map Field field
             Attr attr Invalid 3270 datastream from client
  
    Explanation
     The 3270 datastream received from a terminal emulator client
     attempted to override a protected field.
  
    System action
     None.
  
    User response
     Check if the terminal emulator is functioning correctly.
  
    Module
     DFHTFIQ
  
    Message inserts
     1.date
     2.time
     3.applid
     4.termid
     5.netname
     6.userid
     7.tranid
     8.ipaddr
     9.mapset
     10.map
     11.field
     12.attr
  
    Destination CSMT
  
  
  The CICS Data Areas, DFHCSADS and TCTTETTE have been updated.
  GC34-2849-00 (CICS TS 5.1)
  GC34-7271-00 (CICS TS 5.2)
  
   DFHCSADS
    In fields CSASSI3 at CICS TS 5.1 and 5.2 add new field
     (C4) ....  ...1             CSABMCHK  BMS field checking
  
    At CICS TS 5.1 after field CSADS24T at (280),
    Replace
     (288)  CHARACTER       8    *  reserved
    With
     (288)  CHARACTER       8    CSABMSTK  BMS 3270 integrity
  
    At CICS TS 5.2 after field CSADS24T at (288),
    Replace
     (290)  CHARACTER       8    *  reserved
    With
     (290)  CHARACTER       8    CSABMSTK  BMS 3270 integrity
  
  
   TCTTETTE
    At CICS TS 5.1 and CICS TS 5.2,
    replace
     (0) STRUCTURE 52 TCTTETTE TCTTE BMS Extension
    with
     (0) STRUCTURE 56 TCTTETTE TCTTE BMS Extension
  
    After
     (33) CHARACTER 1 * Reserved
    new field :-
     (34)    ADDRESS       4  TCTTEBFL  BMS checking table
  
    replace
     (34)  CHARACTER       0  TCTTEEXE  end of extension
    with
     (38)  CHARACTER       0  TCTTEEXE  end of extension
  ×**** PE16/07/06 FIX IN ERROR. SEE APAR PI65435  FOR DESCRIPTION
  

APAR Information

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

  PI50363

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

  PI54386 UI34197 UI34198 UI34199 UI34200 UI34201 UI34202 UI34203
  UI34204

Modules/Macros

•    DFHAPRX  DFHAPRXT DFHBMSX  DFHBMSXH DFHBMSXL
  DFHBMSXO DFHBSTB  DFHCSAD  DFHMCPA$ DFHMCPE$ DFHMCP1$ DFHMCX
  DFHMCY   DFHMETFC DFHMETFE DFHMETFK DFHM32A$ DFHM321$ DFHOSPWA
  DFHPGCP  DFHPGCR  DFHPGLE  DFHPGLET DFHPGLP  DFHPGLPT DFHPGPG
  DFHPGPGT DFHPGRE  DFHPGRET DFHPGXE  DFHPGXET DFHSIC1  DFHSIPLT
  DFHTCTTE DFHTCTZE DFHTFIQ  DFHTFIQT DFHTFTRI DFHXTP   DFHZATT
  DFHZNAC  HCI6800J HCI6900J
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI34197

     UP16/01/15 P F601

• R801 PSY UI34198

     UP16/01/15 P F601

• R802 PSY UI34199

     UP16/01/15 P F601

• R803 PSY UI34200

     UP16/01/15 P F601

• R900 PSY UI34201

     UP16/01/15 P F601

• R901 PSY UI34202

     UP16/01/15 P F601

• R902 PSY UI34203

     UP16/01/15 P F601

• R903 PSY UI34204

     UP16/01/15 P F601

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.