A fix is available
APAR status
Closed as new function.
Error description
New Function
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All users of HBB7780 and above * **************************************************************** * PROBLEM DESCRIPTION: See Problem Summary * **************************************************************** * RECOMMENDATION: * **************************************************************** GQSCAN and ISGQUERY REQINFO=QSCAN services can cause spikes in GRS CPU usage and GRS private storage when invoked many times for global, generic queue scans. For GQSCAN, a scan is global and generic if SCOPE=SYSTEMS or ALL, XSYS=YES or is not specified, and either the QNAME or RNAME (or both) are not specific. For ISGQUERY, a scan is global and generic if SCOPE=SYSTEMS or ANY, GATHERFROM=SYSPLEX, and either the QNAME or RNAME(or both) are not specific. In GRS Star mode, the potential impact is greater than in other modes. There is no simple way to identify which programs may be invoking queue scan services in this manner.
Problem conclusion
Temporary fix
Comments
GRS has been enhanced to provide monitoring of GQSCAN and ISGQUERY REQINFO=QSCAN global, generic queue scans using SMF type 87 records. For GQSCAN, a scan is global and generic if SCOPE=SYSTEMS or ALL, XSYS=YES or is not specified, and either the QNAME or RNAME (or both) are not specific. For ISGQUERY, a scan is global and generic if SCOPE=SYSTEMS or ANY, GATHERFROM=SYSPLEX, and either the QNAME or RNAME (or both) are not specific. See the ENHancement and DOCumentation HOLDS for additional details. AUTOMATION INFO FOR OA42221 **************************************************************** * FUNCTION AFFECTED: GRS (OA42221) * **************************************************************** * DESCRIPTION : Message/command change/addition/deletion * **************************************************************** * TIMING : As Needed * **************************************************************** AO: MSG=ISG343I CHANGE=TEXT-INSERT AO: MSG=ISG008E CHANGE=TEXT-INSERT AO: MSG=ASA100I CHANGE=TEXT-INSERT AO: MSG=ASA101I CHANGE=TEXT-INSERT AO: ENDAO COMMENT='***End of the list of changes that could affect your automated operations. The DOC text has details of the change. No extra DOC has been provided for ASA100I or ASA101I since they are generic messages.***' ENHANCEMENT INFO FOR OA42221 **************************************************************** * FUNCTION AFFECTED: GRS (OA42221) * **************************************************************** * DESCRIPTION : Enhancement * **************************************************************** * TIMING : As Needed * **************************************************************** In z/OS 1.13 (HBB7780), GRS provides monitoring of global, generic queue scans using SMF type 87 records. GQSCAN and ISGQUERY REQINFO=QSCAN services can cause spikes in GRS CPU usage and GRS private storage when invoked many times for global, generic queue scans. For GQSCAN, a scan is global and generic if SCOPE=SYSTEMS or ALL, XSYS=YES or is not specified, and either the QNAME or RNAME (or both) are not specific. For ISGQUERY, a scan is global and generic if SCOPE=SYSTEMS or ANY, GATHERFROM=SYSPLEX, and either the QNAME or RNAME (or both) are not specific. In GRS Star mode, the potential impact is greater than in other modes. SMF 87 records can help identify programs that issue global generic queue scans. See the DOCumentation HOLD for more details. DOCUMENTATION INFO FOR OA42221 **************************************************************** * FUNCTION AFFECTED: GRS (OA42221) * **************************************************************** * DESCRIPTION : Documentation updates * **************************************************************** * TIMING : As Needed * **************************************************************** Summary of changed Publications- z/OS MVS Planning: Global Resource Serialization (SA22-7600-00) z/OS MVS System Messages, Vol 9 (IGF-IWM) (SA22-7639-00) z/OS MVS System Commands (SA22-7627-00) z/OS MVS Initialization and Tuning Reference (SA22-7592-00) z/OS MVS System Management Facilities (SMF) (SA22-7630-00) z/OS MVS Data Areas Volume 4 (GA32-0856-00) Book Title - z/OS MVS Planning: Global Resource Serialization +--- LOCATION IN PUBLICATION ---------------------------+ | | | Add new subtopic under 4.1 Chapter 11 Diagnosing | | Global Resource Serialization | +-------------------------------------------------------+ <existing Section 4.1 Chapter 11 - please add link to new subtopic below> Using SMF 87 Records to identify global generic queue scan issuers <new Section 4.1.10 Using SMF 87 Records to identify global generic queue scan issuers > In APAR OA42221, GRS provides monitoring of global, generic queue scans using SMF type 87 records. GQSCAN and ISGQUERY REQINFO=QSCAN services can cause spikes in GRS CPU usage and GRS private storage when invoked many times for global, generic queue scans. For GQSCAN, a scan is global and generic if SCOPE=SYSTEMS or ALL, XSYS=YES or is not specified, and either the QNAME or RNAME (or both) are not specific. For ISGQUERY, a scan is global and generic if SCOPE=SYSTEMS or ANY, GATHERFROM=SYSPLEX, and either the QNAME or RNAME (or both) are not specific. In GRS Star mode, the potential impact is greater than in other modes. SMF 87 records can help identify programs that issue global generic queue scans. The SMF 87 records are mapped by macro ISGYSMFR. In order to access the record programmatically, use macro IFASMFRA. See the ISGYSMFR macro for details on how to invoke IFASMFRA. The records contain some information about the caller. For example, the TCB, ASID, PSW, and some details about the queue scan service invocation. To turn GRS monitoring on, specify MONITOR(YES) in your GRSCNFxx PARMLIB member, or issue the SETGRS MONITOR=YES command. You can dynamically turn the monitor on and off. Issue DISPLAY GRS to view the MONITOR status (YES or NO) on your system. GRS might not write the records in some cases. For example, if the caller is holding a local lock, or if there is an unexpected error with the queue scan processing. Book Title - z/OS MVS System Messages, Vol 9 (IGF-IWM) +--- LOCATION IN PUBLICATION ---------------------------+ | | | ISG Messages | | | +-------------------------------------------------------+ <update ISG008E description to include MONITOR> ISG008E SYNTAX ERROR IN GRSCNFxx - RECORD nnnnnn text Explanation: text is one of the following: TOLINT KEYWORD VALUE INVALID, TOLINT KEYWORD IGNORED ACCELSYS KEYWORD VALUE INVALID REJOIN(YES) NOT ALLOWED WITH RESTART(NO), REJOIN(YES) IGNORED SYNCHRES KEYWORD VALUE INVALID, SYNCHRES KEYWORD IGNORED GRSQ KEYWORD VALUE INVALID, GRSQ KEYWORD IGNORED ENQMAXA KEYWORD VALUE NOT VALID, ENQMAXA KEYWORD IGNORED ENQMAXU KEYWORD VALUE NOT VALID, ENQMAXU KEYWORD IGNORED MONITOR KEYWORD VALUE NOT VALID, MONITOR KEYWORD IGNORED During initialization, global resource serialization found a syntax error in the GRSCNFxx parmlib member. In the message text: xx The suffix of the GRSCNFxx parmlib member. nnnnnn The number of the record containing the syntax error. TOLINT KEYWORD INVALID, TOLINT KEYWORD IGNORED The value specified for the TOLINT keyword is incorrect. The TOLINT value, specified in seconds, must be greater than 0 and less than 86000 (24 hours). ACCELSYS KEYWORD VALUE INVALID The value specified for the ACCELSYS keyword is incorrect. The ACCELSYS value must be greater than 1 and less than 100. REJOIN(YES) NOT ALLOWED WITH RESTART(NO), REJOIN(YES) IGNORED REJOIN(YES) and RESTART(NO) are mutually incompatible and cannot be used in the same GRSCNFxx parmlib member. GRSQ KEYWORD VALUE INVALID, GRSQ KEYWORD IGNORED GRSQ must be CONTENTION, LOCAL, or ALL. The default of ALL will be used. ENQMAXA KEYWORD VALUE NOT VALID, ENQMAXA KEYWORD IGNORED ENQMAXA must be in the range of 250000 to 99999999. ENQMAXU KEYWORD VALUE NOT VALID, ENQMAXU KEYWORD IGNORED ENQMAXU must be in the range of 16384 to 99999999. AUTHQLVL KEYWORD VALUE NOT VALID, AUTHQLVL KEYWORD IGNORED AUTHQLVL must be a decimal value of 1 or 2. MONITOR KEYWORD VALUE NOT VALID, MONITOR KEYWORD IGNORED MONITOR must be YES or NO. <update ISG343I description to include MONITOR> ISG343I hh.mm.ss GRS [LATCH] STATUS idr text Explanation: This message was received in response to a DISPLAY GRS command. In the message text: ... [GRS STAR MODE INFORMATION] [LOCK STRUCTURE (ISGLOCK) CONTAINS lockentries LOCKS.] [THE CONTENTION NOTIFYING SYSTEM IS sysname] [SYNCHRES: YES/NO/DIS] [ENQMAXU: value] [ENQMAXA: value] [GRSQ: CONTENTION/LOCAL/ALL] [AUTHQLVL: 1] [MONITOR: YES/NO] [GRS NONE MODE INFORMATION] [SYNCHRES: YES/NO/DIS] [ENQMAXU: value] [ENQMAXA: value] [AUTHQLVL: 1] [MONITOR: YES/NO] ... This heading: [GRSQ: CONTENTION] [AUTHQLVL: value] indicates the authorized QNAME level value for global resource serialization that is set by the GRSCNFxx parmlib member or SETGRS AUTHQLVL command or the GRSCNFxx parmlib member where value is the decimal number 1 or 2. This heading: [AUTHQLVL: value] [MONITOR: YES|NO] indicates whether GRS SMF 87 monitoring is active. This heading: [GRS NONE MODE INFORMATION] [SYNCHRES: YES/NO/DIS] [ENQMAXU: value] [ENQMAXA: value] indicates that global resource serialization is not operating in ring or star mode. This heading: [AUTHQLVL: value] indicates the authorized QNAME value for global resource serialization that is set by the SETGRS AUTHQLVL command where value is the decimal number 1 or 2. This heading: [AUTHQLVL: value] [MONITOR: YES|NO] indicates whether GRS SMF 87 monitoring is active. The GRS NONE mode information is as follows: ... Book Title - z/OS MVS System Commands +--- LOCATION IN PUBLICATION ---------------------------+ | | | Section 4.38 SETGRS Command | +-------------------------------------------------------+ <existing Section 4.38 please add monitor to existing list> 4.38 SETGRS Command Use the SETGRS command to: Migrate a currently active global resource serialization ring complex to a star complex Modify the current RESMIL or TOLINT values Set the system values for GRSQ SYNCHRES ENQMAXA ENQMAXU MONITOR ... <existing Section 4.38.1 Syntax please add monitor> SETGRS {MODE=STAR} {[RESMIL=nnnnnnnn|RESMIL=OFF][,TOLINT=nnnnn] [,SYNCHRES={YES|NO}]} {ENQMAXA|ENQMAXU=nnnnnnnn} [,{NOPROMPT|NP}] {CNS=sysname}[,{NOPROMPT|NP}] {GRSQ=ALL|CONTENTION|LOCALQ} {AUTHQLVL=n} {MONITOR={YES|NO}} <existing Section 4.38.2 Parameters. Please add the following in after AuthQlvl> MONITOR={YES|NO} This parameter indicates to write SMF 87 monitoring records. MONITOR is system-specific; the effect is only taken on the system where the command is issued. Refer to the Global Resource Serialization Diagnosis topic in z/OS MVS Planning: Global Resource Serialization for more information. To issue the command you must have appropriate access to the RACF resource named MVS.SETGRS.MONITOR. See the topic about MVS Commands, RACF Access Authorities, and Resource Names in z/OS MVS System Commands for more information. <under Examples please add> Example: SETGRS MONITOR=YES result: enables monitoring of SMF 87 records +--- LOCATION IN PUBLICATION ---------------------------+ | | | Section 3.2.2 | | System Console Operations | | Defining and Changing Console Characteristics | | Changing Console Characteristics | +-------------------------------------------------------+ <existing Section 3.2.2.2 "MVS Commands, RACF Access Authorities, and Resource Names" please update the SETGRS entry in Table 11 to the following> Command/Keyword Authority Resource-Name ... SETGRS MODE=STAR | UPDATE | MVS.SETGRS.TOLINT ENQMAXA | | MVS.SETGRS.RESMIL ENQMAXU | | MVS.SETGRS.MODE.STAR CNS | | MVS.SETGRS.SYNCHRES MONITOR | | MVS.SETGRS.GRSQ | | MVS.SETGRS.ENQMAXA | | MVS.SETGRS.ENQMAXU | | MVS.SETGRS.CNS | | MVS.SETGRS.MONITOR __________________|________|______________________ Book Title - z/OS MVS Initialization and Tuning Reference +--- LOCATION IN PUBLICATION ---------------------------+ | | | 35.0 Chapter 35. GRSCNFxx (global resource | | serialization configuration) | +-------------------------------------------------------+ <in section 35.0, please add MONITOR to the list> The majority of GRSCNFxx parameters are specific to defining a global resource serialization ring complex. However, GRSQ is specific to star mode, and the following keywords are relevant for all modes, including GRS=NONE: SYNCHRES ENQMAXA ENQMAXU AUTHQLVL MONITOR <in section 35.2, please add MONITOR to the syntax> GRSDEF [MATCHSYS {(name) }] [ {(*) }] [RESMIL {(1-8 decimal digit) }] [ {(OFF) }] [CTC (3-4 hexadecimal digit device number)...] [RESTART {(YES) }] [ {(NO) }] [REJOIN {(YES) }] [ {(NO) }] [TOLINT (1-8 decimal digit) ] [ACCELSYS (1-2 decimal digit) ] [CTRACE (parmlib member name) ] [SYNCHRES {(YES) }] [ {(NO) }] [GRSQ {(ALL) }] [ {(CONTENTION) }] [ {(LOCAL) }] [ ENQMAXA(1-8 decimal digit) ] [ ENQMAXU(1-8 decimal digit) ] [ AUTHQLVL(decimal digit 1 or 2) ] [ MONITOR{(YES) }] [ {(NO) }] <in section 35.4, please add MONITOR to the parameters> MONITOR{(YES)} {(NO) } Indicates whether the system defined in the GRSCNFxx MATCHSYS parameter is to have GRS SMF 87 monitoring activated. Default: NO Note: See the Global Resource Serialization Diagnosis topic in z/OS MVS Planning: Global Resource Serialization for more information. Book Title - z/OS MVS System Management Facilities (SMF) +--- LOCATION IN PUBLICATION ---------------------------+ | | | Section 13.2 Record Types by number | | | +-------------------------------------------------------+ <please add new subtopic "Record Type 87 (57) = GRS Monitoring"> Record Type 87 (57) - GRS Monitoring In OA42221, beginning in z/OS 1.13 (HBB7780) GRS writes SMF type 87 records for monitoring functions. The records are mapped by macro ISGYSMFR. Reference information: For more information about SMF type 87 records, see the topic about Global Resource Serialization Diagnosis in z/OS MVS Planning: Global Resource Serialization. Book Title - z/OS MVS Data Areas Volume 4 +--- LOCATION IN PUBLICATION ---------------------------+ | | | please add new chapter for ISGYSMFR after Chapter 20, | | ISGYREPL Information | | | +-------------------------------------------------------+ <please build this section from the new macro ISGYSMFR in this APAR>
APAR Information
APAR number
OA42221
Reported component name
GRS
Reported component ID
5752SCSDS
Reported release
780
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2013-05-09
Closed date
2013-06-14
Last modified date
2013-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA69561 UA69562
Modules/Macros
IFASMFRA ISGCDSP ISGCSET ISGGVT ISGMIMSP ISGMIMST ISGNCBIM ISGNCNFP ISGQPC ISGQSC ISGYSMFR
| SA22760000 | SA22763900 | SA22762700 | SA22759200 | SA22763000 |
| GA32085600 |
Fix information
Fixed component name
GRS
Fixed component ID
5752SCSDS
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":"780","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":"780","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2013