A fix is available
APAR status
Closed as new function.
Error description
New function
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: * * Installations running HBB77A0 or above * **************************************************************** * PROBLEM DESCRIPTION: * * New function APAR to provide support * * for a configurable SMF temporary * * buffer size * **************************************************************** * RECOMMENDATION: * **************************************************************** With this APAR, installations can customize the size of the SMF temporary buffer that is used during IPL processing to hold data while SMF is initializing. See the documentation for this APAR for more details. Additional keywords: SMFTBUFF SMFREC/K SMFTYPE0 SMFTYPE7 SMFTYPE23 SMF0 SMF7 SMF23
Problem conclusion
Temporary fix
Comments
This APAR provides the following new functions: - A new IEASYSxx option, SMFTBUFF, which is used to designate the size, in megabytes, of the SMF temporary buffer that is used to hold data during IPL SMF initialization processing. - A new SMF type 0 field, SMF0TBUF, which reports the specified SMFTBUFF parameter value. - A new SMF type 7 field, SMF7TBLS, which reports the number of bytes lost, if any, during IPL. This field will be non zero if the SMF temporary buffer is exhausted and therefore records are lost during SMF initialization. - A new SMF type 23 field, SMF23MBU, which reports the maximum number of bytes stored in the temporary buffer that is used at IPL during SMF initialization. The following documentation updates are included with this APAR: Book No - SA23-1380 Book Title - z/OS MVS Initialization and Tuning Reference +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: Statements/parameters for IEASYSxx | | | +----------------------------------------------------------- - Add the following text to describe the SMFTBUFF parameter: SMFTBUFF SMFTBUFF=nnn This parameter specifies the number of megabytes that SMF should designate as the size of the temporary buffer that is used to hold SMF data during IPL processing while SMF completes initialization. See the SMF buffer options: BUFSIZMAX, BUFUSEWARN, DSPSIZMAX, NOBUFFS, and SMFTBUFF section of the z/OS MVS System Management Facilities (SMF) manual for additional information about the SMF temporary buffer. Value Range: 5-512 Maximum value length: 3, including leading zeroes Default Value: 5 Order No - SA38-0674 Book Title - z/OS MVS System Messages, Vol 7 (IEB-IEE) +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: IEE979W | | | +----------------------------------------------------------- - Add the text below, flagged with "|" IEE979W SMF DATA LOST - NO BUFFER SPACE AVAILABLE TIME=hh.mm.ss System programmer response |If the message is issued due to a data loss during IPL while |SMF was initializing, consider tuning the size of the SMF |temporary buffer with the IEASYSxx SMFTBUFF option. See the |z/OS MVS Initialization and Tuning Reference for information |on SMFTBUFF. Book No - SA38-0675 Book Title - z/OS MVS System Messages, Vol 8 (IEF-IGD) +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: New: IFA400I | | New: IFA401I | | | +----------------------------------------------------------- - Add descriptions of the new messages, IFA400I and IFA401I: IFA400I SMFTBUFF PARAMETER VALUE OF nnn MEGABYTES NOW IN EFFECT. Explanation This message identifies the value specified by the SMFTBUFF IEASYSxx parameter option. This value is used by SMF to designate the size of the buffer that is used to hold data during IPL processing while SMF initializes and configures the actual logstream or data set buffers. In the message text: nnn is the specified SMFTBUFF parameter value. System Action SMF obtains a buffer of the size indicated in the message. SMF places data into the buffer until the time that SMF completes initialization. Once SMF initialization is complete, SMF moves the data from this buffer to the logstream or to the MANx data set, depending on the requested recording mode. Operator response: None System programmer response: None Module: IFASTART Routing code: 2 Descriptor code: 4 IFA401I SMFTBUFF PARAMETER VALUE OF nnn IS INVALID. PARAMETER IS IGNORED. Explanation This message indicates that the value specified by the SMFTBUFF IEASYSxx parameter option is invalid. In the message text: nnn is the specified SMFTBUFF parameter value, up to a length of 8. System Action SMF obtains a 5 megabyte buffer, which is the default size. SMF places data into the buffer until the time that SMF completes initialization. Once SMF initialization is complete, SMF moves the data from this buffer to the logstream or to the MANx data set, depending on the requested recording mode. Operator response: Notify the system programmer of the error. System programmer response: Refer to the IEASYSxx section of the z/OS MVS Initialization and Tuning Reference manual for a description of the SMFTBUFF parameter. Correct the specified SMFTBUFF parameter value. This value will take effect during the next IPL of the system. Module: IFASTART Routing code: 2, 10 Descriptor code: 4 Book No - SA38-0667 Book Title - z/OS MVS System Management Facilities (SMF) +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: BUFSIZMAX, BUFUSEWARN, DSPSIZMAX, and NOBUFFS - | | Specifying SMF buffer options | | | +----------------------------------------------------------- - Change the name of the section to: SMF buffer options: BUFSIZMAX, BUFUSEWARN, DSPSIZMAX, NOBUFFS, and SMFTBUFF - Add text to describe SMFTBUFF, as flagged with "|": You can use the BUFSIZMAX, BUFUSEWARN, DSPSIZMAX, NOBUFFS and SMFTBUFF parameters to specify SMF buffering options. Note how these parameters apply: - BUFUSEWARN and NOBUFFS apply to SMF log streams and data sets - BUFSIZMAX applies to data set record - DSPSIZMAX applies to logstream recording. |- SMFTBUFF, an IEASYSxx parameter, applies to the | temporary buffer that SMF uses to hold data during IPL | processing while SMF completes initialization. - Add a description of the SMFTBUFF parameter: SMFTBUFF considerations: SMFTBUFF is an IEASYSxx parameter option. It is used to specify the size, in megabytes, of the buffer that SMF will use to hold data during IPL processing while SMF completes initialization. SMFTBUFF specifies the SMF temporary buffer size regardless of the recording mode (logstream or data set). Its value, if correctly specified, is reported in message IFA400I. Message IFA401I will report an erroneously specified SMFTBUFF value. The default SMF temporary buffer size is 5 megabytes. SMF fields that can help determine an installation appropriate SMFTBUFF value: - The SMF type 23 field, SMF23MBU, reports the maximum number of bytes that SMF stored into the temporary buffer during IPL processing. - If data is lost during IPL processing due to a shortage of buffer space, the SMF type 7 field, SMF7TBLS, reports the total number of bytes of SMF data that were lost. +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: Record Type 0 (00) -- IPL | | | +----------------------------------------------------------- - Add a description of the new field SMF0TBUF, as flagged with "|": Offsets Name Length Format Description : : : : : 68 44 SMF0MTWT 4 binary TSO wait time limit (SMFPRMxx TWT(hhmm) value) converted to minutes.End of change |72 48 SMF0TBUF 2 binary The number of megabytes | specified by the SMFTBUFF | IEASYSxx parmlib option. If | the SMFTBUFF parameter | value is incorrectly | specified or SMFTBUFF is | not specified, this value | will be zero, and the | default buffer size of 5 | megabytes was used during | IPL SMF initialization | processing. +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: Record Type 7 (07) -- Data Lost | | | +----------------------------------------------------------- - Add a description of the new field SMF7TBLS, as flagged with "|": Offsets Name Length Format Description : : : : : 36 24 SMF7LSN 26 char The name of the log stream associated with the data space that experiences the loss. Only filled in when SMF7LSD is ON. |62 3E SMF7TBLS 8 binary The number of bytes lost | during SMF initialization. | This field will be non | zero if the SMF temporary | buffer is exhausted and | therefore records are lost | during SMF initialization. +--- LOCATION IN PUBLICATION -------------------------------+ | | | Section: Record Type 23 (17) -- System Status | | | +----------------------------------------------------------- Sub section - SMF Statistics section - Add a description of the new field SMF7TBLS, as flagged with "|": Offsets Name Length Format Description : : " : : 152 98 SMF23SRD 8 binary Total number of SRB dispatches for this interval. For the cumulative total, see the explanation of SMF23SRB. |160 A0 SMF23MBU 4 binary The maximum number of | bytes stored in the | temporary buffer that is | used during SMF | initialization.
APAR Information
APAR number
OA52828
Reported component name
SMF SCHEDULER
Reported component ID
5752SC100
Reported release
7A0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2017-05-10
Closed date
2018-02-23
Last modified date
2018-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA95411 UA95412 UA95413 UA95414
Modules/Macros
IFASMF IFALSWTR IFASMFR IHAIPA IEAVNPIL BLSAIPIN IEECB985 IEAVNP03 IEEMB823 IEAVNPCF IFASMFR2 IFAPCWTR IEEMB824 IEEMB842 IEAIPAMD IEEMB826 IFALSMOD BLSXIPLP IFASMFEN IFASTART IFASMFR1 IEAIPASR IEAVNIPX IFASMFJP
| SA23138000 | SA38066700 | SA38067500 | SA38067400 |
Fix information
Fixed component name
SMF SCHEDULER
Fixed component ID
5752SC100
Applicable component levels
R7BJ PSY UA95412
UP18/03/07 P F803
R7B0 PSY UA95411
UP18/03/07 P F803
R7A0 PSY UA95413
UP18/03/07 P F803
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":"7A0","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":"7A0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 April 2018