IBM Support

OA50755: New Function - RMF support for zHyperLink

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

Problem summary

  • ****************************************************************
    * USERS AFFECTED: RMF users.                                   *
    ****************************************************************
    * PROBLEM DESCRIPTION: RMF support of Synchronous I/O Links.   *
    *                      Following RMF reports are extended:     *
    *                      - Postprocessor PCIE Activity report    *
    *                      - Postprocessor Device Activity         *
    *                        report                                *
    *                      - Monitor III PCIE report               *
    *                      Following SMF records are extended:     *
    *                      - SMF 74 subtype 1, Device Activity     *
    *                      - SMF 74 subtype 9, PCIE Based          *
    *                        Function Activity                     *
    *                      Overview conditions are added or        *
    *                      modified based on SMF record 74         *
    *                      subtypes 1 and 9.                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This new function APAR provides RMF support for the gathering
    and reporting of Synchronous I/O Link performance data on
    DASD device and PCIE function level.
    +--------------------------------------------------------------+
    >>> POSTPROCESSOR DEVICE ACTIVITY REPORT <<<
    The Postprocessor Device Activity report is modified:
      - A new Synchronous I/O Device Activity section is shown as
        part of the Device Activity report if at least one DASD
        actively performed synchronous I/O requests in a given
        RMF interval.
      - The Direct Access Device Activity report indicates that a
        device had synchronous I/O activity during an interval
        by character 'S' appended to the value in the device's
        Device Activity Rate field.
    Changed and new fields of the Device Activity report:
    DEVICE ACTIVITY RATE
       ....
       This formula applies to the activity rate measured during
       asynchronous I/O processing.
       ...
       A character  S  appended to the DEVICE ACTIVITY RATE value
       of a device shown in the Direct Access Device Activity
       report indicates that the device performed synchronous I/O
       requests and that detailed synchronous I/O performance
       measurements for this device are available in the
       Synchronous I/O Device Activity report section.
       For easy comparison the Synchronous I/O Device Activity
       report lists the asynchronous I/O device activity rate
       (ASYNCH I/O) in adjacent columns showing
       - the rate of successfully completed SYNCH I/O READ requests
       - the rate of SYNCH I/O WRITE requests which completed
         successfully during the interval.
       The synchronous  I/O activity rate is calculated as
                       #Successful Synch I/O read/write requests
          ACTV RATE  = -----------------------------------------
                                     Interval Time
    AVG RESP TIME
       The average number of milliseconds the device required to
       complete an asynchronous I/O request.
       ...
       For easy comparison the Synchronous I/O Device Activity
       report lists the asynchronous I/O average response time
       (ASYNCH I/O) in adjacent columns showing
       - the average processing time (in milliseconds) per success-
         ful SYNCH I/O READ request
       - the average processing time (in milliseconds) per success-
         ful SYNCH I/O WRITE request.
    AVG SYNCH I/O TRANSFER RATE
        READ  The number of megabytes per second read during
              synchronous I/O processing.
        WRITE The number of megabytes per second written during
              synchronous I/O processing.
    % REQ SUCCESS
        Percentage of synchronous I/O requests that completed
        successfully.
    % LINK BUSY
        Percentage of synchronous I/O requests that hit a link busy
        condition when trying to use a synchronous I/O link.
    % CACHE MISS
        Percentage of synchronous I/O read requests that hit a
        cache miss condition.
    % REJECTS
        READ  The percentage of synchronous I/O read requests that
              were rejected for reasons other than a link busy
              condition or a read cache miss.
        WRITE The percentage of synchronous I/O write requests that
              were rejected for reasons other than a link busy
              condition.
    
    >>> POSTPROCESSOR PCIE ACTIVITY REPORT <<<
    General PCIE Activity section:
    The obsolete  DMA Address Space Count  column is removed from
    the report.
    Fields PCI Load Operations Rate, PCI Store Operations Rate,
    PCI Store Block Operations Rate, and Refresh PCI Translations
    Operations Rate are not reported for Synchronous I/O functions.
    There is one new column:
    Data Transfer Rate The number of megabytes per second trans-
                       ferred to and from the PCIE function. For
                       ISM functions, this value reports the number
                       of megabytes transmitted to the function.
    Several non-common metric columns are moved to PCIE function
    type specific report sections as there are
    - Hardware Accelerator Activity
    - Hardware Accelerator Compression Acttivity
    - RoCE Activity
    - Internal Shared Memory Activity
    - Synchronous I/O Link Activity
    - Synchronous I/O Response Time Distribution
    Moved fields from General PCIE Activity section:
    - Adapter Utilization and Work Units Processed Rate are moved
      to Hardware Accelerator Activity section.
    - Physical Network ID Port 1 and 2, Read Transfer Rate,
      Write Transfer Rate, Packets Received Rate, and Packets
      Transmitted Rate are moved to new RoCE Activity section.
    New Internal Shared Memory Activity section:
    Physical Network ID
       Physical-network identifier (PNET ID) that identifies the
       port of the virtual PCIe function for Internal Shared Memory
       (ISM).
    Write Transfer Rate
       The number of megabytes per second transmitted on the ISM
       function.
    New Synchronous I/O Link Activity section:
    The values collected for the whole CPC are only reported if
    Global Performance Reporting is enabled in the LPAR image
    profile of the Hardware Management Console (HMC).
    Port ID
       ID of the port on the zHyperlink card where the
       synchronous I/O link is attached to.
    Serial Number
       The serial number of the storage controller the
       synchronous I/O link connects to.
    Type-Model
       The type and model of the storage controller the
       synchronous I/O link connects to.
    Total Request
       The total number of synchronous I/O requests Rate per
       second for this function. This includes rejected
       requests due to timeout conditions cache failures
       and link busy conditions.
    Total Request Rate (CPC)
       The total number of synchronous I/O requests per second
       for the synchronous I/O link this function is defined on.
       This includes rejected requests due to timeout conditions,
       cache failures and link busy conditions.
    Successful Request %
       The percentage of synchronous I/O requests that completed
       successfully for this function.
    Successful Request % (CPC)
       The percentage of requests that completed successfully for
       the synchronous I/O link this function is defined on.
    Read Transfer Rate
       The number of megabytes per second that were read from the
       storage controller by this synchronous I/O function.
    Read Transfer Rate (CPC)
       The number of megabytes per second that were read from
       the storage controller on the synchronous I/O link this
       function is defined on.
    Read Transfer Ratio
       The number of megabytes read per request processed by this
       synchronous I/O function.
    Read Transfer Ratio (CPC)
       The number of megabytes read per request processed on the
       synchronous I/O link this function is defined on.
    Write Transfer Rate
       The number of megabytes per second that were written to
       the storage controller by this synchronous I/O function.
    Write Transfer Rate (CPC)
       The number of megabytes per second that were written to
       the storage controller on the synchronous I/O link this
       function is defined on.
    Write Transfer Ratio
       The number of megabytes written per request processed by
       this synchronous I/O function.
    Write Transfer Ratio (CPC)
       The number of megabytes written per request processed on
       the synchronous I/O link this function is defined on.
    Time Busy %
       The percentage of time spent on synchronous I/O processing
       by this synchronous I/O function.
    Time Busy % (CPC)
       The percentage of time spent on synchronous I/O processing
       on the synchronous I/O link this function is defined on.
    New Synchronous I/O Response Time Distribution section:
       % Read < (>=) n usec
       Leftmost read bucket:
       Percentage of read samples with a response time less
       than n microseconds.
    Rightmost read bucket:
       Percentage of read samples with a response time greater
       or equal n microseconds.
    Other read buckets:
       Percentage of read samples with a response time less
       than n microseconds and greater or equal to the prior
       bucket time limit.
       % Write < (>=) n msec
       Leftmost write bucket:
       Percentage of write samples with a response time less
       than n microseconds.
       Rightmost write bucket:
       Percentage of write samples with a response time
       greater or equal n microseconds.
       Other write buckets:
       Percentage of write samples with a response time less
       than n microseconds and greater or equal to the prior
       bucket time limit.
    +--------------------------------------------------------------+
    >>> MONITOR III PCIE REPORT (HRM77A0) <<<
    The Mon III PCIE Activity report is enhanced by additional
    PCIE function type dependant pop-up panels which are invoked
    when placing the cursor on the Function ID, CHID or Type column
    of a specific PCIE function and pressing Enter.
    Fields available on all pop-up panels:
    Function ID
       The hexadecimal identifier of the PCIE function for which
       performance data is reported.
    Alloc Time %
       The percentage of the reporting interval for which the PCIE
       function was allocated or in the process of de-allocation.
    Allocated
       Date and time when the PCIE function was allocated.
    Changed fields in Hardware Accelerator pop-up panel:
    Adapter Utilisation
       Utilization of the Hardware Accelerator. This value is not
       reported on zEC12 and zBC12 hardware.
    Work Units Processed
       The number of work units per second that were processed by
       the Hardware Accelerator. This value is not reported on
       zEC12 and zBC12 hardware.
    Transfer Read Rate
       The number of megabytes per second read on the Hardware
       Accelerator. On zEC12 or zBC12, this field designates the
       number of megabytes per second that were transferred by DMA
       reads from all defined DMA address spaces to the PCIE
       function. Otherwise this field is not set.
    Transfer Write Rate
       The number of megabytes per second written on the Hardware
       Accelerator. On zEC12 or zBC12, this field designates the
       number of megabytes per second that were transferred by
       DMA writes from the PCIE function to all defined DMA address
       spaces. Otherwise this field is not set.
    New RoCE pop-up panel:
    Adapter Physical Network ID Port
       Physical-network identifier (PNET ID) that identifies the
       first or second port of the RoCE/RoCE-2 device.
    Transfer Read Rate
       Megabytes: The number of megabytes per second that a
                  RoCE/RoCE-2 device received on the external
                  ethernet interface. On zEC12 or zBC12, this field
                  designates the number of megabytes per second
                  that were transferred by DMA reads from all
                  defined DMA address spaces to the PCIE function.
       Packets:   The number of packets per second that were
                  received on the external Ethernet interface of
                  the RoCE/RoCE-2 device. (Not reported on zEC12
                  and zBC12.)
    Transfer Write Rate
       Megabytes: The number of megabytes per second transmitted
                  from a RoCE/RoCE-2 device on the external
                  ethernet interface. On zEC12 or zBC12, this field
                  designates the number of megabytes per second
                  that were transferred by DMA writes from the PCIE
                  function to all defined DMA address spaces.
       Packets:   Number of packets per second transmitted from the
                  RoCE/RoCE-2 device on the external ethernet
                  interface. (Not reported on zEC12 and zBC12.)
    New ISM pop-up panel:
    Adapter Physical Network ID
       Physical-network identifier (PNET ID) that identifies the
       port of the Internal Shared Memory (ISM) PCIe function.
    Transfer Write Rate
       The number of megabytes per second transmitted on an ISM
       function.
    New Synchronous I/O Link pop-up panel:
    Data in  Link(CPC)  fields is only reported if Global
    Performance Reporting is enabled in the LPAR image profile of
    the Hardware Management Console (HMC).
    Synchronous I/O Link Port ID
       ID of the port on the zHyperlink card where the synchronous
       I/O link is attached to.
    Synchronous I/O Link  Type-Model
       The type and model of the storage controller the synchronous
       I/O link connects to.
    Synchronous I/O Link  Serial Number
       The serial number of the storage controller the synchronous
       I/O link connects to.
    Adapter Time Busy %
       This Function
         The percentage of time spent on synchronous I/O processing
         by this synchronous I/O function.
       Link (CPC)
         The percentage of time spent on synchronous I/O processing
         on the synchronous I/O link this function is defined on.
    Request Rate
       This Function
         The total number of synchronous I/O requests per second
         for this function. This includes requests rejected due to
         timeout conditions, cache failures and link busy
         conditions.
       Link (CPC)
         The total number of synchronous I/O requests per second
         for the synchronous I/O link this function is defined on.
         This includes requests rejected due to timeout conditions,
         cache failures and link busy conditions.
    Request Success %
       This Function
         The percentage of synchronous I/O requests that completed
         successfully for this function.
       Link (CPC)
         The percentage of requests that completed successfully for
         the synchronous I/O link this function is defined on.
    Transfer Read Rate
       This function
         The number of megabytes per second that were read from the
         storage controller by this synchronous I/O function.
       Link (CPC)
         The number of megabytes per second that were read from the
         storage controller on the synchronous I/O link this
         function is defined on.
    Transfer Read Ratio
       This Function
         The number of megabytes read per request processed by this
         synchronous I/O function.
       Link (CPC)
         The number of megabytes read per request processed on the
         synchronous I/O link this function is defined on.
    Transfer Write Rate
       This Function
         The number of megabytes per second that were written to
         the storage controller by this synchronous I/O function.
       Link (CPC)
         The number of megabytes per second that were written to
         the storage controller on the synchronous I/O link this
         function is defined on.
    Transfer Write Ratio
       This Function
         The number of megabytes written per request processed by
         this synchronous I/O function.
       Link (CPC)
         The number of megabytes written per request processed on
         the synchronous I/O link this function is defined on.
    +--------------------------------------------------------------+
    >>>>> SMF RECORD TYPE 70 TO 79 - RMF PRODUCT SECTION <<<<<
    The SMF record level change number SMFxxSRL at offset 51 (x33)
    changes to 128 (x80).
    >>>>> SMF RECORD TYPE 74 SUBTYPE 1 - DEVICE ACTIVITY <<<<<
    The Device Data Section is changed. For a detailed description
    of all changed SMF fields, please refer to the PTF cover letter.
    
    >>>>> SMF RECORD TYPE 74 SUBTYPE 9 - PCIE ACTIVITY <<<<<
    The layout of SMF record 74 subtype 9 is changed. For a
    detailed description please refer to the PTF cover letter.
    +--------------------------------------------------------------+
    >>>>>> POSTPROCESSOR OVERVIEW CONDITIONS <<<<<<
    Overview conditions provided for SMF record type 74 subtype 1:
    Existing overview conditions apply to asynchronous I/O process-
    ing. Following synchronous I/O related conditions are added:
    CONDITION                  CONDITION   SOURCE   ALGORITHM
    --------------------------+-----------+--------+--------------
    Device read activity rate  DARSR       SMF74SQR SQR/INT in sec
                                           SMF74INT
    Device write activity rate DARSW       SMF74SQW SQW/INT in sec
                                           SMF74INT
    Average response time per  DRTSR       SMF74SPR SPR/(SQR*2000)
    successful read request                SMF74SQR
    Average response time per  DRTSW       SMF74SPW SPW/(SQW*2000)
    successful write request               SMF74SQW
    Read transfer rate         DTRSR       SMF74SBR SBR/(INT in
    in megabytes per second                SMF74INT seconds*1000)
    Write transfer rate        DTRSW       SMF74SBW SBW/(INT in
    in megabytes per second                SMF74INT seconds*1000)
    The following SMF 74 subtype 9 based overview conditions are
    enhanced/added to also apply to synchronous I/O functions:
    CONDITION                 CONDITION SOURCE  ALGORITHM
    ---------------------------+-------+--------+------------------
    Percentage of time this    FPGBUSY R749FTET For HwAcc:
    partition kept the PCIE            R749ALLT
    FTET*100/(ALLT*1000)
    function busy (Hardware            R749STPF For Synch I/O:
    Accelerator, Synchronous I/O)
    STPF*100/(ALLT*1000)
    Number of megabytes        PCIBYTR R749DBYR For RoCE:
    received per second (RoCE          R749SRBF DBYR/(ALLT*1000)
    on z13 or later and                R749ALLT For Synch I/O:
    Synchronous I/O)                            SRBF/(ALLT*1000)
    Number of megabytes trans- PCIBYTT R749DBYT For RoCE:
    mitted per second (RoCE            R749DBYX DBYT/(ALLT*1000)
    on z13 or later, ISM and           R749SWBF For ISM:
    Synchronous I/O)                   R749ALLT DBYX/(ALLT*1000)
                                                For Synch I/O:
                                                SWBF/(ALLT*1000)
    Number of requests per     SYNCTR  R749SSRF (SSRF+SLRF+SRRF)
    second (Synchronous I/O)           R749SLRF  *1000/ALLT
                                       R749SRRF
                                       R749ALLT
    Number of successful       SYNCSR  R749SSRF SSRF*1000/ALLT
    requests per second                R749ALLT
    (Synchronous I/O)
    

Problem conclusion

Temporary fix

Comments

  • KEYWORDS: E3906/K
    &#215;**** PE17/11/06 FIX IN ERROR. SEE APAR OA54339  FOR DESCRIPTION
    

APAR Information

  • APAR number

    OA50755

  • Reported component name

    RMF

  • Reported component ID

    566527404

  • Reported release

    790

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2016-06-20

  • Closed date

    2017-08-23

  • Last modified date

    2017-12-14

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA93329 UA93330 UA93331

Modules/Macros

  • ERBDUDEV ERBDUPCI ERBEXCIT ERBEXDEV ERBEXPCI ERBFLCNV ERBGDEV
    ERBGGDG3 ERBMFBSR ERBMFDAS ERBMFDDP ERBMFDEA ERBMFEAR ERBMFEAS
    ERBMFEAX ERBMFEDV ERBMFEVT ERBMFE33 ERBMFIDA ERBMFIDB ERBMFIDV
    ERBMFIDX ERBMFIZS ERBMFLDV ERBMFLRV ERBMFL3J ERBMFL3V ERBMFMFC
    ERBMFPER ERBMFPIR ERBMFPSC ERBMFRDR ERBMFSCS ERBMFSMS ERBPCTBL
    ERBPPASS ERBPPCOM ERBPPCON ERBPPRPC ERBRMFPP ERBR741  ERBR749
    ERBSCAN  ERBSMFI  ERBSMF74 ERB0PCIA ERB0PCIB ERB0PCIC ERB3CGAT
    ERB3GADR ERB3GCFC ERB3GCFI ERB3GCFS ERB3GCOC ERB3GCPD ERB3GCSR
    ERB3GCTC ERB3GDAS ERB3GDSA ERB3GDSI ERB3GEAR ERB3GEKL ERB3GENC
    ERB3GEND ERB3GENQ ERB3GENX ERB3GEN3 ERB3GESA ERB3GESV ERB3GGET
    ERB3GGSS ERB3GHFS ERB3GHSM ERB3GINI ERB3GIQD ERB3GIQP ERB3GIQS
    ERB3GISG ERB3GISS ERB3GIXC ERB3GIXI ERB3GJSX ERB3GJS2 ERB3GJS3
    ERB3GLOK ERB3GMEM ERB3GMES ERB3GMFC ERB3GMGP ERB3GMRC ERB3GMRG
    ERB3GMSU ERB3GOPD ERB3GPCI ERB3GRQA ERB3GSCM ERB3GSCV ERB3GSCX
    ERB3GSIG ERB3GSIL ERB3GSIS ERB3GSMF ERB3GSMG ERB3GSML ERB3GSMM
    ERB3GSMS ERB3GSPG ERB3GSPI ERB3GSTH ERB3GSTO ERB3GTER ERB3GUSR
    ERB3GVRI ERB3GVSC ERB3GVSI ERB3GVSW ERB3GXCC ERB3GXCF ERB3GXIT
    ERB3GXMV ERB3GZFX ERB3GZXD ERB3PCII ERB3PCIP ERB3PP1  ERB3PP10
    ERB3PP2  ERB3PP20 ERB3PP3  ERB3PP30 ERB3PP4  ERB3PP40 ERB3PP5
    ERB3PP50 ERB3RCAI ERB3RPCI ERB3RPUT ERB3RSDC ERB3RTBR ERB4MAIN
    GPMDDSRV GPMHTC   GPMINI
    

Fix information

  • Fixed component name

    RMF

  • Fixed component ID

    566527404

Applicable component levels

  • R7AJ PSY UA93331

       UP17/09/07 P F709  

  • R7A0 PSY UA93329

       UP17/09/07 P F709  

  • R790 PSY UA93330

       UP17/09/07 P F709  

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":"790","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":"790","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2017