OA49157: NEW FUNCTION - ZEDC SUPPORT FOR IFASEXIT

Obtain the fix for this APAR.

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 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
  

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.