IBM Support

OA49157: NEW FUNCTION - ZEDC SUPPORT FOR IFASEXIT

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: HBB7790 and above installations that use SMF *
    *                 recording to logstreams.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: New function to enhance the IFASEXIT    *
    *                      SMF logstream dump exit.                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This APAR enhances the IFASEXIT SMF logstream dump exit by
    providing support to obtain records from logstreams with zEDC
    compressed data.
    

Problem conclusion

Temporary fix

Comments

  • This APAR enhances the IFASEXIT SMF logstream dump exit by
    providing support to obtain records from logstreams with zEDC
    compressed data.
    
    Additional keywords:  ZEDC/K SMFLGS/K
    
    This APAR includes the following documentation updates:
    +--- LOCATION IN PUBLICATION ---------------------------------+
    ORDER NO:   SA38-0667
    Book Title: z/OS MVS System Management Facilities (SMF)
    Chapter:    Setting Up and Managing SMF
    Section:    Setting Up and Managing SMF Recording to Logstreams
    Subsection: Using SMF Logstreams
    Subsection: Obtaining Records from SMF Logstreams
    +-------------------------------------------------------------+
    Please add the following changes (marked by |):
    Obtaining records from SMF log streams
      You can use either of the following interfaces to extract data
      from the SMF log stream:
      o IFASMFDL, which is the SMF dump utility
      o IFASEXIT, which is the SMF Logstream Subsystem Exit
      With IFASMFDL, you can dump the data from one or more
      specified log streams into one or more data sets. For detailed
      information, see Using IFASMFDL - the SMF log stream dump
      program.
      Using IFASEXIT, you can obtain records from one SMF logstream
      at a time. IFASEXIT is executed as a logstream exit routine
      that is invoked in JCL using the SUBSYS DD statement
      parameter. Figure 1 shows the syntax of this statement.
    | NOTE:
    | o IBM does not support retrieving records from a logstream
    |   under multiple tasks in the same address space when using
    |   IFASEXIT.
    | o If obtaining records from a logstream which contains
    |   zEDC compressed data, ensure that the system is properly
    |   configured to use zlib. For more information on using zlib,
    |   refer to the z/OS MVS Programming: Callable Services For
    |   High-Level Languages book under Invoking Unauthorized
    |   Interfaces for zEnterprise Data Compression.
    
      Figure 1. Syntax of SUBSYS JCL for IFASEXIT
      //ddname   DD  DSNAME=log.stream.name,
      //  SUBSYS=(LOGR,IFASEXIT ,'SUBSYS-options1'
      //     ,'SUBSYS-options2' )
      log.stream.name
        Specifies the name of the log stream to read. The name can
        be 1 to 26 characters in a data-set-name format.
      SUBSYS-options1
        Specifies options that are meaningful to all exit routines.
        For detailed information, see "JCL for the LOGR Subsystem"
        in z/OS MVS Programming: Assembler Services Guide.
      SUBSYS-options2
        Specifies unique exit routine options. For IFASEXIT, the
        following parameters are accepted:
          SID(xxxx)
          :
          :
          SMEP(hhmm)
          :
          :
          If the following SUBSYS-options1 parameters are specified,
          the SMEP parameter is not allowed
          o TO=YOUNGEST
          o DURATION
    |
    |     NSI
    |       This is an optional parameter used to indicate that SMF
    |       records which are compressed with zEDC cannot be
    |       decompressed using software decompression. This option
    |       results in an error when SMF records compressed with
    |       zEDC are found and the zEDC Express feature is
    |       unavailable.
    
      Example of using the IFASEXIT LOGR interface exit.
    
    +--- LOCATION IN PUBLICATION ---------------------------------+
    ORDER NO   - SA38-0675
    Book Title - z/OS MVS System Messages, Vol 8 (IEF-IGD)
    +-------------------------------------------------------------+
    Update IFA790I with the following changes (marked by |):
      IFA790I LOGGER SUBSYSTEM (ssname) EXIT SYSTEM
      :
      :
        service
    |     The service being used at the time of the error.
          One of the following:
              IXGCONN  - System logger connect operation.
              IXGBRWSE - System logger browse operation.
    |         ZEDC     - zEDC software operation.
    |         ZLIB     - zlib compression operation.
      :
      :
    
      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 in 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 service name is ZEDC, the error occurred because the
    | NSI parameter was specified and the zEDC Express feature was
    | unavailable. Remove the NSI keyword and re-run the job, or
    | run the job on a system that has the zEDC Express feature
    | configured.
    | If the service name is ZLIB, ensure that the system is
    | properly configured to use zlib. This error is most likely
    | due to lack of access to the SAF FACILITY resource class
    | FPZ.ACCELERATOR.COMPRESSION.
    | For more information on using zlib, refer to the z/OS MVS
    | Programming: Callable Services for High-Level Languages book
    | under Invoking unauthorized interfaces for zEnterprise Data
    | Compression.
      If the problem persists, search problem reporting databases
      for a fix to the problem. If no fix exists, contact the IBM
      Support Center.
    KEYWORDS: ZEDC/K SMFLGS/K
    

APAR Information

  • APAR number

    OA49157

  • Reported component name

    SMF SCHEDULER

  • Reported component ID

    5752SC100

  • Reported release

    790

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2015-10-19

  • Closed date

    2016-02-24

  • Last modified date

    2016-04-05

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

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

    UA80795 UA80796

Modules/Macros

  • FPZTSCMP IFASEXIT IFAZLIB
    

Publications Referenced
SA38066700 SA38067500      

Fix information

  • Fixed component name

    SMF SCHEDULER

  • Fixed component ID

    5752SC100

Applicable component levels

  • R7A0 PSY UA80795

       UP16/03/09 P F603

  • R790 PSY UA80796

       UP16/03/09 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.



Document information

More support for: z/OS family

Software version: 790

Operating system(s): MVS, z/OS

Reference #: OA49157

Modified date: 05 April 2016