PI92715: ZIIP SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables IB V3R1 to offload some processing to IBM z
  Integrated Information Processors (zIIPs).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Index Builder for z/OS      *
  *                 Version 3 Release 1 (FMID=H22O310).          *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables to offload some       *
  *                      processing to zIIP.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR enables IMS Index Builder to offload some processing
  to System z Integrated Information Processor (zIIP).
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-06) should be changed as follows:
  ================================================================
  > Using IMS Index Builder
  >> JCL and input control statements
  >>> IMS Index Builder JCL
  >>>> DD statements
   STEPLIB DD statement
   This DD statement can contain the following libraries:
   :
   - IMS Tools Knowledge Base load library, if writing reports to
     the knowledge base is enabled
  |- The SGLXLOAD library of Tools Base, if you want to offload
  |  eligible workloads to zIIP processors
   - Libraries that contain exit routines and IMS dynamic
     allocation modules (MDAs). These libraries must be present if
     there are any exits or dynamic allocation modules.
   :
  >>> IMS Index Builder input control statements
  >>>> Optional control statements
  |ZIIPMODE control statement
  |The ZIIPMODE control statement specifies whether IMS Index
  |Builder offloads eligible workloads to zIIP processors.
  |             +-NEVER-+
  | >>-ZIIPMODE-+-COND--+?<
  | COND
  |  Offloads eligible IBSCAN VSAM I/O workloads to zIIP
  |  processors. The following conditions must be satisfied.
  |  Otherwise, the job is run on the main CPs.
  |  - ZIIPMODE COND statement is specified.
  |  - The SGLXLOAD library of Tools Base is specified to the
  |    STEPLIB DD.
  |  - zIIP processors are available.
  |  - The data sets of the prime database that IMS Index Builder
  |    scans are VSAM ESDS.
  | NEVER
  |  Does not offload any workload to zIIP processors.
  |If the ZIIPMODE statement is not specified, NEVER is the
  |default.
  |Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | COMPAUTH entry in "Defining runtime parameters".
  >> Defining runtime parameters
  |IIURDFLT ZIIPMODE entry
  | Use the IIURDFLT ZIIPMODE entry to specify whether IMS Index
  | Builder offloads eligible workloads to zIIP processors.
  | For details, see "ZIIPMODE control statement".
  > Troubleshooting
  >> IMS Index Builder messages
  |IIUB130I HPIO ZIIP USED (HH:MM:SS.THMIJU) WAS: xx:xx:xx.xxxxxx
  | Explanation: This informational message shows the CPU time
  |  consumed by zIIP processors for the IMS Index Builder job.
  | System action: Processing continues.
  | User response: None. This message is informational.
  

APAR Information

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

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

  UI55084

Modules/Macros

•    H22O310J IIUBIBCD IIUBINIT IIUBMSGS IIUBSTMS
  IIUFOINT IIUFZCPD IIUHMMCL IIUHZIIP IIUH001  IIUH002  IIUH015
  IIUH015A IIULINK  IIUSCA01 IIUSCA11 IIUSCA12 IIUSIBCD IIUSMP10
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R310 PSY UI55084

     UP18/04/12 P F804

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.