PI51564: IMS V12 MFS PROTECTED FIELD VALIDATION ENHANCEMENT.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• IMS V12 MFS Protected Field Validation enhancement for
  device type 3270 and SLU2.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS V12 device type 3270 users of the    *
  *                 Message Format Service (MFS).                *
  ****************************************************************
  * PROBLEM DESCRIPTION: Validate content of protected fields    *
  *                      returned on input from MFS formatted    *
  *                      3270/SLU2 devices.                      *
  *                                                              *
  *                      Retro-fit of PI46626                    *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  This service provides a new option if set triggers the Message
  Format Service (MFS) to validate the content of protected
  fields transmitted to the 3270/SLU2 device against changes when
  those fields are returned on input.
  

Problem conclusion

Temporary fix

Comments

• REPINNED RP16/07/11 (ATXT) TO ADD POSTREQ PI65116 INFO.
   **** PE16/07/11 PTF IN ERROR. SEE APAR PI65116 FOR DESCRIPTION.
  -
  This service adds to the IMS Message Format Service (MFS) the
  ability to validate content of protected fields transmitted to
  3270 or SLU2 devices for changes when the field is returned
  thus rejecting the input if data alteration has occurred.
  
  If configured (via new option MFSPFV=Y)
  the MFS feature will reject the input with new error message
  DFS573 'PROTECTED DATA FIELD ALTERED - INPUT IGNORED' if it
  detects that the content of a protected data field has been
  altered from the original formatted content transmitted to the
  3270/SLU2 device.
  
  If not configured (Default or via new option MFSPFV=), no
  changes to MFS operation will occur.
  
  To enable the protect field validation a new keyword 'MFSPFV='
  (MFS Protect Field Validation) is defined in the DFSDCxxx member
  of the IMS Proclib data set.
  
   MFSPFV=Y|N
              N (No) No protected field validation is the default.
              Y (Yes) enables protected field validation for MFS
                formatted 3270 device types.
  
  The following parts have been modified:
  CIB      - Add flag for PFIWORK buffer allocated
           - Add flag indicate that protected field entries exist
  MFSOUT   - Define new PFVWORK buffer
  ISCD     - Add flag for MFS VERIFY PROTECTED FIELD option
  DFSIIDC0 - Add new MFSPFV= Y/N keyword and parm to DFSDCxxx
             proclib member
  DFSCFEI0 - Process A09 when protected field altered to issue new
             DFS0573 message and trace new MFSP 6701 type log
  DFSCFEO0 - Allocate/Free Protect Work Buffer
  DFSCFEQ0 - Free Protect Work Buffer
  DFSCFE00 - Detect alteration in protected field.
  DFSCFE80 - Build Protected Field Validation elements in protect
             work buffer for each PROT + MOD field in output
             formatted display.
  DFSCFEZ0 - Adds MFS_P_WK to selected 6701's (MFSP and DDM1) for
             diagnostic purposes.
  
  ----------------------------------------------------------------
  -The following documentation updates are made with this service-
  
  Update to IMS Version 12 System Definition manual GC19-3021.
  IMS 12.1.0
   >Installing IMS
    >System definition - GC19-3021
     >Members of the IMS PROCLIB data set
      >DFSDCxxx member of the IMS PROCLIB data set
  
  Topic: DFSDCxxx member of the IMS PROCLIB data set
  
  Add new keyword MFSPFV= description to DFSDCxxx member of the
  IMS PROCLIB data set topic.
  
  >--+---------------+------------------------------------------->
     |         .-N-. |
     '-MFSPFV=-+---+-'
               '-Y-'
  Parameters
  
  MFSPFV=N
  MFSPFV=Y
  Specifies whether Y (Yes) or N (No) the Message Format Service
  (MFS) should verify if protected fields returned on input have
  been modified.
  
  ================================================================
  Update to IMS V12 Diagnosis manual GC19-3015
  
  IMS 12.0.0
   >Troubleshooting for IMS>
    >Diagnosis - GC19-3015
     >DC - Data Communication Service Aids
      >DC trace
       >Content of the trace records
  
  Topic: Content of the trace records
  
  Add description for new id MFSP.
  
  MFSP
   MFS detected change in content of a protected field.
   DC option MFSPFV=Y is set in the DFSDCxxx proclib member.
  
   This log record is written even though DC trace is not active
   on the terminal.
  
  In the table that shows types of data communication (DC) trace
  records and what each trace record contains.
  Add MFS protect work to the 'MFS' acronym.
  
  MFS
   MFS input work/MFS output work/MFS protect work.
  
  In Table 1. DC trace records
  Add entry for new trace id MFSP to table 1 DC trace records
  
  Trace  Function            Traced    When      What is traced
   ID                         by       traced
  
  MFSP   MFS input detected  DFSCFEI0  Always    CTB, CLB, CIB,
         alteration of                           MFS, IOBUF
         protected data.
  ----------------------------------------------------------------
  Additional update to Diagnosis manual GC19-3015
  
  IMS 12.1.0
   >Troubleshooting for IMS
    >Diagnosis - GC19-3015
     >DC - Data Communication Service Aids
      >Diagnosing Message Format Service problems
  
  Topic: Diagnosing Message Format Service problems
  
  After existing
   MFS I WK
    Shows complete input message (all segments) and internal
    segment control information used by DFSCFEI0.
  Add
   MFS P WK
    Present only if MFS formatted display has fields containing
    both protect and modify attributes set.
  
    Offset 4 contains address of altered field in input buffer.
    Offset 8 contains MOD name.
    Offset x'10' contains DOF name.
    Offset x'2C' pointer to protected data field entry record
                 (PFVENTRY).
  
    PFVENTRY
    Offset 0 pointer to next entry (if exist).
    Offset 4 Length of entry (includes 8 byte header and data
             length).
    Offset 6 Device field buffer address of protected data field.
    Offset 8 Original content of protected field.
  
  ================================================================
  Update to IMS V12 Communications and connections SC19-3012
  
  IMS 12.0.0
   >IMS administration
    >Communications and connections - SC19-3012
     >IMS VTAM network administration
      >Editing and formatting IMS messages
       >Message Format service
        >Administering MFS
  
  Topic: Administering MFS
  
  Under 'The responsibilities of an MFS administrator include:'
  Add new bullet;
  * Determine whether or not MFS should verify the content of
    protected fields that are returned on input (in DFSDCxxx).
  
  ================================================================
  Update to Operations and automation manual SC19-3018
  
  IMS 12.0.0
   >IMS administration
    >Operations and automation - SC19-3018
     >Operations and IMS-supported devices
      >3270 Information Display System
       >3270 terminal components that operate with IMS
  
  Add new sub topic '3270 MFS protected Field Validation'
  
  3270 MFS protected Field Validation
  
  MFS can be configured to validate the content of protected
  fields sent out to the device when returned on input.
  Use MFSPFV=Y in the DFSDCxxx proclib member to configure this
  option.
  
  ================================================================
  Update to Messages and Codes Volume 1: DFS Messages GC19-4236-01
  IMS 12.1.0
   >Troubleshooting for IMS
    >IMS messages and codes - GC19-4236-01
     >DFS messages
      >DFS messages, DFS551I - DFS600I
       >DFS573
  DFS573   PROTECTED DATA FIELD ALTERED - INPUT IGNORED
  
  MFS dectected altered data in a protected field from the 3270
  device.  The contents of the protected field transmitted to the
  device differs from the contents received.
  
  Operator response
  
  Contact your IMS system programmer for assistance.
  
  Programmer response
  
  Verify the terminal or device is secure and operating properly.
  The device if operating properly is not expected to modify
  contents of protected data fields.
  
  For diagnostic purposes an X'67' record is created on the IMS lo
  with the ID of "MFSP".
  
  Problem determination
  
  3, 5, 16, 23, 24, 36
  
  Module
  
  DFSCFE00
  
  ×**** PE16/07/11 FIX IN ERROR. SEE APAR PI65116  FOR DESCRIPTION
  

APAR Information

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

  PI46626

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

  UI36527 UI36528

Modules/Macros

•    CIB      DFSCFEI0 DFSCFEO0 DFSCFEQ0 DFSCFEZ0
  DFSCFE00 DFSCFE80 DFSCMT30 DFSIIDC0 DFSWDCDF DFSWDCH2 ISCD
  MFSOUT
  

Fix information

• Fixed component name

  IMS V12

• Fixed component ID

  5635A0300

Applicable component levels

• R200 PSY UI36527

     UP16/03/31 P F603

• R202 PSY UI36528

     UP16/03/31 P F603

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.