IBM Support

OA42221: NEW FUNCTION - GRS SMF 87 Recording

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

Publications Referenced
SA22760000 SA22763900 SA22762700 SA22759200 SA22763000
GA32085600        

Fix information

  • Fixed component name

    GRS

  • Fixed component ID

    5752SCSDS

Applicable component levels

  • R780 PSY UA69561

       UP13/06/25 P F306

  • R790 PSY UA69562

       UP13/06/25 P F306

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

Operating system(s): MVS, z/OS

Reference #: OA42221

Modified date: 02 July 2013


Translate this page: