PI89050: ZIIP ENABLEMENT FOR HP UNLOAD

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables IMS HP Unload to offload some processing to a
  System z Integrated Information Processor (zIIP).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  *                 z/OS Version 1 Release 2 (FMID=H1IN120)      *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables IMS HP Unload to offl *
  *                      some processing to a System z Integrate *
  *                      Information Processor (zIIP).           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the new control statement ZIIPMODE to offload
  some processing to zIIP processors.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Unload for z/OS User's Guide
  Version 1 Release 2 Suffix 8 (SC27-0936-08) should be changed
  as follows:
  ----------------------------------------------------------------
  > Unloading IMS database
  >> Options for HSSR Engine
  |>>> ZIIPMODE Control Statement
  |
  | The ZIIPMODE control statement specifies whether HSSR engine
  | offloads eligible VSAM ESDS I/O workloads to zIIP processors.
  |
  | 0........1.........2.........3.........4.........5..
  | 1234567890123456789012345678901234567890123456789012
  | ZIIPMODE NEVER
  |          COND
  |
  | POSITION  DESCRIPTION
  | 1        Code the ZIIPMODE keyword.
  | 10        Specify one of the following keywords:
  |           NEVER     Does not offload any workload to zIIP
  |                     processors. NEVER is the default to avoid
  |                     unexpected performance degradation.
  |           COND      Offloads VSAM ESDS I/O workloads to zIIP
  |                     processors when all of the following
  |                     conditions are met:
  |                     - zIIP processor are available.
  |                     - The SGLXLOAD library of Tools Base is
  |                       specified to the STEPLIB or JOBLIB.
  |                     - VSAM ESDS is to be read using Media
  |                       Manager. For details, see "HPIO control
  |                       statement"
  |                     If any of these conditions is not
  |                     satisfied, the job runs using the main
  |                     CPs.
  ----------------------------------------------------------------
  > Tuning and customizing HSSR application jobs
  >> Site default options
  >>> How the runtime parameters are determined
  Table 1. Options for which default values can be specified
  | Function: HSSR Engine options
  | Keyword: ZIIPMODE
  | Description: Specifies whether to offload eligible workloads
  | to zIIP processors
  | Related data set: HSSROPT
  ----------------------------------------------------------------
  >>> FABHTOPT macro statements
  
   (label)     FABHTOPT     COMPAT= HPU|DBT|5787LAC
                                  :
                                   ,PCBLIST=HSSR|IMS
  |                                ,ZIIPMODE=NEVER|COND
  
  
  Table 1. Basic settings of FABHTOPT options
   +-------------+-------------+-------------+----------------+
   | Keyword     |COMPAT=HPU   | COMPAT=DBT  | COMPAT=5787LAC |
   +-------------+-------------+-------------+----------------+
   :             :             :             :                :
   +-------------+-------------+-------------+----------------+
   | PCBLIST=    | HSSR        | HSSR        | HSSR           |
   +-------------+-------------+-------------+----------------+
  || ZIIPMODE=   | NEVER       | NEVER       | NEVER          |
   +-------------+-------------+-------------+----------------+
  
    You can use the following keywords to override the values set
    by the basic settings:
    :
    PCBLIST=
         This optional keyword specifies the type of PCB list that
         is passed to the application program.
  | ZIIPMODE=
  |      This optional keyword specifies the default for the
  |      ZIIPMODE option in HSSROPT.
  ---------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  >>>> FABH messages
  ---------------------------------------------------------------
  | FABH0698E INCORRECT ZIIPMODE CONTROL STATEMENT IS SPECIFIED
  | Explanation: An incorrect operand on the ZIIPMODE control
  | statement is specified in the HSSROPT data set.
  | System action: The incorrect statement is ignored.
  | User response: Correct the ZIIPMODE statement.
  ---------------------------------------------------------------
  | FABH0645I ZIIP TIME (HH:MM:SS.THMIJU) WAS: hh:mm:ss.thmiju
  | Explanation: This informational message shows the CPU time
  | consumed by zIIP processors for the IMS HP Unload job.
  | System action: Processing continues.
  | User response: None. This message is informational.
  ---------------------------------------------------------------
  | FABH2017E INCORRECT ZIIPMODE= PARAMETER IS SPECIFIED
  | Explanation: The value specified for the ZIIPMODE keyword
  | parameter is incorrect.
  | System action: The assembly of the option table ends with
  | return code 8. The option table is not replaced.
  | User response: See "ZIIPMODE control statement" and correct
  | the value on the ZIIPMODE keyword.
  ---------------------------------------------------------------
  | FABH0856E LOAD FAILED FOR GEXAPI00
  | Explanation: A LOAD error occurred when HSSR Engine tried to
  | load the GEXAPI00 module.
  | System action: If  ZIIPMODE=FORCE is specified, HSSR Engine
  | ends abnormally. If ZIIPMODE=COND is specified, processing
  | continues.
  | User response: Ensure that GEXAPI00 module exists and is
  | available in the SGLXLOAD library of Tools Base. If it is not
  | available, make it available and rerun the job.
  ---------------------------------------------------------------
  | FABH0646E ERROR RETURNED FROM GEXAPI00: FUNC=xxxxxxx, SERVICE
  | CODE=xxxx, RC=xxxx, RSN=xxxx
  | Explanation: HSSR Engine called the GEXAPI00 module, but an
  | error return code was returned from GEXAPI00.
  | System action: If ZIIPMODE=FORCE is specified, HSSR Engine
  | ends abnormally. If ZIIPMODE=COND is specified and the error
  | occurred during initialization (FUNC=INIT), processing
  | continues.
  | User response: Search for GEX error messages to identify the
  | cause. If the cause is not clear, collect the dump and
  | contact IBM Software Support.
  ---------------------------------------------------------------
  ================ End of Documentation Change ==================
  

APAR Information

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

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

  UI52488

Modules/Macros

•    FABHDOPT FABHLINK FABHMMCL FABHOPT  FABHRTI0
  FABHTCBU FABHTGBL FABHTOPT FABHZCPD FABHZIIP FABH000  FABH002
  FABH015  FABH015A HPSUSTMT HPSU015  HPSU015A H1IN120J
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UI52488

     UP17/12/11 P F712

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.