OA66837: NEW FUNCTION - SYSTEM RECOVERY BOOST (SRB) ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• System Recovery Boost (SRB) Enhancements
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users running with System Recovery Boost     *
  *                 (SRB) enabled on HBB77E0 and above           *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function - System Recovery Boost    *
  *                      (SRB) Enhancements                      *
  ****************************************************************
  New Function - System Recovery Boost (SRB) Enhancements
  

Problem conclusion

Temporary fix

Comments

• New Function - System Recovery Boost (SRB) Enhancements will:
  
  1. Add to message IEA687I the following: procname, step-ID,
  jobstep-program-name for middleware startup boosts.
  2. Add to SMF record type 90 subtype 40 the following:
  boost start and end timestamps, timezone and leap-second
  offsets, and procname, step-ID, and jobstep-program-name for
  middleware startup boosts.
  3. Add to SMF record type 89 the recovery process boost total
  duration for the life of the IPL.
  4. When configuring a transient (boost) zIIP online via a CONFIG
  CPU|CORE command, result in the zIIP becoming a normal online
  zIIP, which will remain online after the end of the boost.
  5. Provide a new API to allow a program to identify transient
  (online) zIIPs.
  6. Provide infrastructure for new Recovery Process Boost for
  Dynamic I/O Activate.
  
  Keywords: SRB/K, E3931/K, SMFREC/K, SMFTYPE89,
  SMFTYPE90 SUBTYPE40
  
  Documentation Updates:
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Overview of System Recovery Boost
  
  Bookshelf: z/OS MVS
  Book: Planning: Workload Management
  Chapter: System Recovery Boost
  
    Starting with IBM z15, System Recovery Boost can deliver
    higher processor capacity for a limited time after an IPL,
    while shutting down a system, or during specific, short-term
    sysplex recovery events. The increased capacity can be
    provided in one or more of the following ways:
  
    - In an LPAR on a sub-capacity machine, by utilizing the full
      speed for the general purpose processors of the boosted
      partition (speed boost)
    - Dispatching some work on z Integrated Information
      Processors (zIIP), even if the work is not eligible for
      zIIP (zIIP boost)
    - Configure online zIIPs that are in the standby state for
      the duration of the boost period (zIIP boost)
  
  | Note: These three basic functions of SRB continue to be fully
  | supported on the IBM z15 and above.  System Recovery Boost
  | Upgrade is not offered on z17, and will not be offered for
  | future purchases of the z15. Customers who have already
  | purchased SRB Upgrade on z15/z16 can continue to use it, but
  | SRB Upgrade will only be available for future purchase on
  | the z16.
  
    Starting with IBM z16, System Recovery Boost is extended with
    recovery process boost cases for SVC dumps, loading HyperSwap
    configuration information, customer-selected middleware region
  | starts and restarts, and dynamic I/O activate.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: System Recovery Boost basics
  Section: zIIP boost
  Subsection: How does zIIP boost work?
  
    There are variations of zIIP boost, depending on how the CPC
    is configured. If you have no zIIPs, you will of course see no
    benefit from zIIP boost. There is also the priced System
    Recovery Boost Upgrade feature that allows you to take
    additional advantage of zIIP boost.
  
  | Note: System Recovery Boost Upgrade is not offered on z17, and
  | will not be offered for future purchases of the z15. Customers
  | who have already purchased SRB Upgrade on z15/z16 can continue
  | to use it, but SRB Upgrade will only be available for future
  | purchase on the z16.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: System Recovery Boost basics
  Section: zIIP boost
  Subsection: What is System Recovery Boost Upgrade?
  
  ...
    These zIIPs then behave just like any other physical zIIPs,
    in that the processors are shared across the CPC based on
    their LPAR weights, and additional reserved zIIPs can be
    brought online at the beginning of a boost due to the
    additional physical capacity being made available.
  
  | Note: System Recovery Boost Upgrade is not offered on z17, and
  | will not be offered for future purchases of the z15. Customers
  | who have already purchased SRB Upgrade on z15/z16 can continue
  | to use it, but SRB Upgrade will only be available for future
  | purchase on the z16.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Planning and Setup
  Section: Turning on System Recovery Boost
  Subsection: Recovery process boost
  
    Recovery process boosts can be used many times during an IPL.
    They are based on recovery events, including HyperSwap
    processing, coupling facility structure recovery, sysplex
    partitioning recovery, and, with the z16, SVC dumps,
    middleware region startup as well as loading HyperSwap
  | configuration information and Dynamic I/O activate. You can
    dynamically enable or disable all recovery process boosts
    with the IEASRB proc.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Using System Recovery Boost
  Section: Recovery process boost
  
  <Update 'o Middleware region startup' with the following:>
  
  <At the end of the bulleted list, add the following:>
  
  | o Dynamic I/O activate
  |   Boost to accelerate Dynamic I/O activate processing.
  |   This boost is only supported on z16 and higher.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Performance Considerations
  Section: Configuring Processors During a Boost Period
  
  <Replace all text with the following:>
  
  | Do not configure a zIIP processor offline or online during a
  | boost, as you might not the get expected results. If you
  | configure a zIIP processor offline during a boost, you might
  | inadvertently bring zIIP processors offline that system
  | recovery boost configured online as transient zIIP processors
  | for the boost. If you configure a transient zIIP processor
  | online, the zIIP processor becomes a normal zIIP which will
  | remain online after the boost ends.  Automation that brings a
  | zIIP processor online or offline should wait until there are
  | no active boosts.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Messages
  Section: IEA687I
  
  and
  
  Bookshelf: z/OS MVS
  Book: MVS System Messages, Vol 6
  Chapter: IEA Messages
  Section: IEA687I
  
    string
    ...
    o SVC Dump
  | o Middleware region startup (procname, step-ID,
  |    jobstep-program-name)
  |   where:
  |    procname
  |     The name of the started procedure that triggered the
  |     boost, taken from the CHMEMNAM field of the CSCB.
  |    step-ID
  |     The name of the job-step program that triggered the
  |     boost, taken from the CHKEY field of the CSCB.
  |    jobstep-program-name
  |     The name of the job step that triggered the boost, taken
  |     from the SCTPGMNM field of the SCT.
    o Hyperswap Config Load
  | o Dynamic I/O Activate
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: Messages
  Section: IEE258I
  
  and
  
  Bookshelf: z/OS MVS
  Book: MVS System Messages, Vol 7
  Chapter: IEE messages (IEE200I - IEE399I)
  Section: IEE258I
  
    Requestor: string
    ...
    o Hyperswap Config Load
  | o Dynamic I/O Activate
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: z/OS Data Gatherer, SMF, and WLM Details
  Section: Record type 89 (X'59') - Usage Data
  Subsection: System ID section
  
  and
  
  Bookshelf: z/OS MVS
  Book: System Management Facilities (SMF)
  Chapter: SMF Records
  Section: Record type 89 (X'59') - Usage Data
  Subsection: System ID section
  
  <<Add the following to the bottom of the table>>
  
  | Offsets Name         Len Format Description
  | ...
  | 270 10E SMF89SI_       8 binary Total duration for the life
  |         RPB_Duration            of the IPL of recovery
  |                                 process boosts, in STCK
  |                                 format. Updated when RP
  |                                 boost is extended or ends.
  |                                 Valid when SMF89SIL is at
  |                                 least SMF89_Len_V3.
  
  Bookshelf: Comprehensive Content Collections
  Book: System Recovery Boost
  Chapter: z/OS Data Gatherer, SMF, and WLM Details
  Section: Record type 90 (X'5A') - System status
  Subsection: Subtype 40 - Boost information
  
  and
  
  Bookshelf: z/OS MVS
  Book: System Management Facilities (SMF)
  Chapter: SMF Records
  Section: Record type 90 (X'5A') - System status
  Subsection: Subtype 40 - Boost information
  
  <<Replace SMF90T40_ETOD row with the following rows>>
  
    Offsets Name         Len Format Description
    ...
  | 0   0   SMF90T40_ETOD 16 binary Time of boosts end, in STCKE
  |                                 format, as follows:
  |                                 For IPLBoosts_Start,
  |                                  not applicable.
  |                                 For IPLBoosts_End,
  |                                  time of IPL boosts end.
  |                                 For SDBoosts_Start,
  |                                  not applicable.
  |                                 For SDBoosts_End,
  |                                  time of shutdown boosts end.
  |                                 For RPBoosts_Start,
  |                                  not applicable.
  |                                 For RPBoosts_End,
  |                                  time of recovery process
  |                                  boosts end.
  |                                 For RPBoosts_Start,
  |                                  see the subfield
  |                                  SMF90T40_RPB_End_ETOD_0_7.
  |                                 In STCKE format.
  | 0   0   SMF90T40_RPB_  8 binary First 8 bytes of ETOD when RP
  |         End_ETOD_0_7            boosts end. Boosts are, at the
  |                                 time of starting, expected to
  |                                 end. This might end up not
  |                                 being the actual end time
  |                                 because the end time may be
  |                                 extended if there are
  |                                 overlapping RP boost events.
  |                                 Valid only for RPBoosts_Start
  |                                 event. STCKE format. Valid
  |                                 when SMF90T40_BoostLevel >= 3.
  
  <<Update the following row as follows:>>
  
    Offsets Name         Len Format Description
    ...
  | 24  18  SMF90T40_RPB_  1 binary The ID of the requestor
            Start_                  for which the boost
            Requestor_ID            was started. Applies only
                                    to "recovery process
                                    boosts start" events.
                                    Possible values are:
  ...
                                    7 Hyperswap config load
  |                                 8 Dynamic I/O activate
  
  <<Add the following rows to the end of the table>>
  
    Offsets Name         Len Format Description
    ...
  | 80  50  SMF90T40_RPB_  8 EBCDIC PROC name for middleware
  |         Mid_ProcName            region startup. Applies only
  |                                 to RPBoosts start event. Valid
  |                                 when
  |                                SMF90T40_RPB_Start_Requestor_ID
  |                                 = 6 and SMF90T40_BoostLevel
  |                                 >= 3.
  | 88  58  SMF90T40_RPB_  8 EBCDIC Step name for middleware
  |         Mid_StepName            region startup. Applies only
  |                                 to RPBoosts start event. Valid
  |                                 when
  |                                SMF90T40_RPB_Start_Requestor_ID
  |                                 = 6 and SMF90T40_BoostLevel
  |                                 >= 3.
  | 96  60  SMF90T40_RPB_  8 EBCDIC Program name specified
  |         Mid_PgmName             on the EXEC PGM=xxx statement
  |                                 for middleware region
  |                                 startup. Applies only to
  |                                 RPBoosts start event. Valid
  |                                 when
  |                                SMF90T40_RPB_Start_Requestor_ID
  |                                 = 6 and SMF90T40_BoostLevel
  |                                 >= 3.
  | 104 68  SMF90T40_TZO   8 binary Current time zone offset (copy
  |                                 of CVTLDTO). STCK format.
  |                                 Valid when
  |                                 SMF90T40_BoostLevel >= 3.
  | 112 70  SMF90T40_      8 binary Current leap seconds (copy of
  |         LeapSeconds             CVTLSO). STCK format. Valid
  |                                 when SMF90T40_BoostLevel >= 3.
  | 120 78  SMF90T40_RPB_  8 binary First 8 bytes of ETOD when RP
  |         Start_ETOD_0_7          boosts start (not changed upon
  |                                 extend). Valid only for
  |                                 RPBoosts_Start and
  |                                 RPBoosts_End
  |                                 events. STCKE format. Valid
  |                                 when SMF90T40_BoostLevel >= 3.
  

APAR Information

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

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

  UJ97450 UJ97451

Modules/Macros

• IEAECVTP IEASC0EN IEASC0JP IEASVTXP IEAVECVT IEAVEFB  IEAVELCR
  IEAVEMMT IEAVMMTI IEAVNIP0 IEAVNP09 IEAVRPBS IEECB985 IEECNAEN
  IEECNAJP IEEMB821 IEEMB842 IEEVCNF1 IEEVCPR  IEFSD263 IFASMFRA
  IHAECVT  IHAENF84 IHAGSDA  IHASVTX
  

Fix information

• Fixed component name

  SUPERVISOR CONT

• Fixed component ID

  5752SC1C5

Applicable component levels

• R7E0 PSY UJ97450

     UP25/07/09 P F507  

• R7EJ PSY UJ97451

     UP25/07/09 P F507  

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.