OA41156: NEW FUNCTION - Tolerate SMF zEDC exploitation and SMFPRMxx keywords

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New Function
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Installations running HBB7770 through        *
    *                 HBB7780 that compress SMF log stream records *
    *                 with zEDC, or share the same SMFPRMxx        *
    *                 parmlib member with a system running at      *
    *                 HBB7790                                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: Toleration support for SMF log stream   *
    *                      compression with zEDC and for SMFPRMxx  *
    *                      keywords COMPRESS and PERMFIX           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This APAR provides toleration support for SMF exploitation of
    zEDC for log stream record compression.
    
    With this apar IFASMFDL, the log stream dump utility, is
    enhanced to read and decompress SMF records that have been
    compressed using zEDC on systems running z/OS V2R1 (HBB7790).
    The new IFASMFDL parameter SOFTINFLATE will allow the
    decompression of compressed log stream records using software
    algorithms. Note: using SOFTINFLATE may decrease IFASMFDL
    performance.
    
    This APAR provides toleration support to allow but ignore new
    SMFPRMxx keyword parameter options COMPRESS and PERMFIX.
    
    This APAR is required when SMFPRMxx is shared between a system
    running at HBB7790 and systems running at HBB7770 through
    HBB7780 or when SMF records are compressed using zEDC on
    HBB7790.
    
    Additional searchable keywords:
    SMFLGS/K  ZOS0201C/K  E2827/K  zEDC/K
    

Problem conclusion

Temporary fix

Comments

  • Toleration support is provided for the SMF exploitation of
    z/OS v2R1 feature zEDC.
    
    This APAR allows but ignores SMFPRMxx keyword parameter options
    COMPRESS and PERMFIX.
    
    This APAR also allows IFASMFDL to read compressed SMF records
    with new keyword SOFTINFLATE.
    
    The following publication are updated with this APAR:
    
    ORDER NO  - SA22-7638-00
    Book Title- MVS System Messages, Vol 8 (IEF-IGD)
    
    + ------ LOCATION IN PUBLICATION -----------------------+
    |                                                       |
    |  In:  Chapter IFA Messages                            |
    |       Sections: IFA788I, IFA790I, IFA849I             |
    |                                                       |
    +-------------------------------------------------------+
    
    - Add the new keywords to the list of keywords for which
      this message is issued:
    
      IFA788I
    
        IFA788I   UNSUPPORTED OPTION SPECIFIED xxxxxxxx
    
      Explanation: This message is issued when an unsupported
      keyword is specified in the SMFPRMxx member. These
      keywords include the following:
    
          :
    |     COMPRESS
    |     PERMFIX
    
    - Explain the IFA790I service name when the data is compressed
    
      IFA790I LOGGER SUBSYSTEM (ssname) EXIT SYSTEM
              LOGGER SERVICE ERROR DD=ddname
              EXIT=exitname FUNCTION=function
              SERVICE=service
              RETCODE=retcode RSNCODE=rsncode
              ANSDIAG=diag1,diag2,diag3,diag4
      Explanation:
       The system logger subsystem (LOGR) exit function for SMF
       encountered an error condition from one of the system logger
       services.
    
      In the message text:
       ssname
        The logger subsystem name.
       ddname
        One of the following:
         The name of the DD JCL statement.
         Equivalent dynamic allocation DD name.
         Blanks for a concatenated DD.
       exitname
        The name of exit, IFASEXIT.
       function
        The function, which is one of the following:
         OPEN
         GET
         CLOSE
         UNALLOCATION
       service
    |   One of the following:
    |    IXGCONN - System logger connect operation
    |    IXGBRWSE - System logger browse operation
    |    COMP BLK - IXGBRWSE returned a compressed block
       retcode
        The return code for the error.
       rsncode
        The reason code for the error.
       diagx
        Diagnostic fields 1-4 from the IXGANSAA data area.
    
      System action: The system continues processing.
    
      System programmer response:
    | If the service is IXGCONN or IXGBRWSE:
      See z/OS MVS Programming: Authorized Assembler Services
      Reference EDT-IXG for information about the system logger
      service use at the time of the error, including the return
      and reason codes displayed in the message. Check the SUBSYS=
      keyword specified in the JCL for the LOGR subsystem and if
      necessary, correct any errors and resubmit the job.
    
      If the problem persists, search problem reporting databases
      for a fix to the problem. If no fix exists, contact the IBM
      Support Center.
    
    | If the service name is 'COMP BLK' then the SMF records
    | IFASEXIT is attempting to read have been compressed on a V2R1
    | system or above.  IFASEXIT is unable to interpret compressed
    | SMF records.  To retrieve compressed SMF records from a log
    | stream use the IFASMFDL utility.
    
      Source: System Management Facilities (SMF)
      Detecting Module: IFASEXIT
      Routing Code: 11
      Descriptor Code: 6
    
    - Add message IFA849I
    
      IFA849I ENVIRONMENT ERROR. IFASMFDL FAILED DUE TO BAD SMF
       RECORD CONTENT IN LOGSTREAM smf_log_stream_name.
       reason.
       DIAGNOSTIC INFORMATION diag1 diag2 diag3 diag4
    
      Explanation: IFASMFDL read a log block from the named SMF log
      stream, but it was unable to interpret the data in the log
      block as valid SMF record content.
    
      In the message text:
    
      smf_log_stream_name
       The name of the SMF log stream.
    
      reason
       The reason is one of the following:
        * COMPRESSED DATA WAS UNEXPECTED
        * ERROR PROCESSING COMPRESSED DATA
    
      diag1 diag2 diag3 diag4
       Diagnostic information for use by the IBM Support Center.
    
      System action: IFASMFDL stops processing the named SMF log
      stream, but continues processing the remaining SMF log
      streams.
    
      Operator response: Contact the system programmer.
    
      System programmer response:
      If the reason is COMPRESSED DATA WAS UNEXPECTED:
      Verify the following:
       * The system is running z/OS V2R1, or higher, on an IBM
         zEnterprise zEC12 GA2.
       * A zEDC Express is available.
    
      To access compressed data from an SMF log stream, run the
      IFASMFDL utility on a system that meets these requirements,
      or specify the IFASMFDL SOFTINFLATE keyword option.
      Note: SOFTINFLATE allows installations to access
      compressed data for toleration and coexistence, but may not
      have the desired performance. When compressed data is found,
      specifying SOFTINFLATE may cause the IFASMFDL utility to take
      additional time and system resources than before.
    
      If the reason is ERROR PROCESSING COMPRESSED DATA, contact the
      IBM Support Center.
    
      Source: System Management Facilities (SMF)
    
      Module: IFALSMOD
    
      Routing code: 11
    
      Descriptor code: -
    
    ORDER NO  - SA22-7630-00
    Book Title- MVS Systems Management Facility (SMF)
    
    + ------ LOCATION IN PUBLICATION -----------------------+
    |                                                       |
    |  In:  Chapter Using SMF Dump Programs                 |
    |       Section:Dumping SMF Logstreams                  |
    |                                                       |
    +-------------------------------------------------------+
    
    - Add to the end:
    
      When reading SMF records from a log stream that has been
      compressed with zEDC, IBM recommends that you run the
      IFASMFDL utility on a system running with z/OS V2R1 or higher
      that has access to a zEDC Express.  If the IFASMFDL utility
      is run with the default NOSOFTINFLATE option and the system
      does not currently have access to a zEDC Express, IFASMFDL
      will halt processing log streams containing zEDC compressed
      SMF records, and will generate a return code of 4.  When
      SOFTINFLATE is specified, the IFASMFDL utility can use
      software decompression to read the records when hardware is
      unavailable. The SOFTINFLATE option may cause the IFASMFDL
      utility to use additional time and CPU resources.
    
    + ------ LOCATION IN PUBLICATION -----------------------+
    |                                                       |
    |  In:  Chapter Using SMF Dump Programs                 |
    |       Section: Specifying parameters for the SMF log  |
    |                stream dump program                    |
    +-------------------------------------------------------+
    
    - Add to the table:
    
      Option: SOFTINFLATE | NOSOFTINFLATE
    
      Explanation:
      Specifies whether the SMF log stream dump program can
      decompress SMF records compressed with zEDC using software
      decompression.
    
      NOSOFTINFLATE:  The default. Specifies that SMF records
      compressed with zEDC can not be decompressed using software
      decompression. This option will result in an error when SMF
      records compressed with zEDC are found and either zEDC
      Express hardware is unavailable or the system is running a
      pre z/OS V2R1 release.
    
      SOFTINFLATE: Specifies that SMF records compressed with zEDC
      can be decompressed using software decompression. When zEDC
      Express hardware is unavailable and at pre z/OS V2R1
      releases, software algorithms will be used to decompress SMF
      records. This may result in greater CPU utilization or a
      longer job time than expected.
     KEYWORDS: SMFLGS/K
    

APAR Information

  • APAR number

    OA41156

  • Reported component name

    SMF

  • Reported component ID

    5752SC102

  • Reported release

    770

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2013-01-09

  • Closed date

    2013-08-01

  • Last modified date

    2013-09-04

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

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

    UA70162 UA70163

Modules/Macros

  •    IEEMB824 IEEMB826 IEEMB832 IEEMB837 IFASEXIT
    IFASMFDL
    

Publications Referenced
SA22763819 SA22763821 SA22763022 SA22763026  

Fix information

  • Fixed component name

    SMF SCHEDULER

  • Fixed component ID

    5752SC100

Applicable component levels

  • R770 PSY UA70162

       UP13/08/21 P F308

  • R780 PSY UA70163

       UP13/08/21 P F308

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.



Rate this page:

(0 users)Average rating

Document information


More support for:

z/OS family

Software version:

770

Operating system(s):

MVS, z/OS

Reference #:

OA41156

Modified date:

2013-09-04

Translate my page

Machine Translation

Content navigation