A fix is available
APAR status
Closed as new function.
Error description
New Function ZOS0204C/K
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 E2827/K zEDC/K
Problem conclusion
KEYWORDS: ZOS0202C/K ZOS0203C/K ZOS0204C/K
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 / Xsystem
Submitted date
2013-01-09
Closed date
2013-08-01
Last modified date
2019-04-03
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
SA22763819 | SA22763821 | SA22763022 | SA22763026 |
Fix information
Fixed component name
SMF SCHEDULER
Fixed component ID
5752SC100
Applicable component levels
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"770","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"770","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 April 2019