OA45545: ABEND0C4 IN PROGRAM HSIPINQ WHEN RUNNING SCANPGM FULLIDR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A SCANPGM request with the FULLIDR operand which
  selects a program from a PDSE program library abends
  in program HSIPINQ with S0C4 RC4 caused by a bad
  instruction attempting to move data to protected low
  storage.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM Tivoli Asset Discovery for z/OS V8.1 *
  *                 customers.                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. SCANPGM FULLIDR of PDSE produces     *
  *                         ABEND0C4 PIC4.                       *
  *                      2. MSGHSIP078W reports incorrect        *
  *                         DESERV macro reason code.            *
  *                      3. There is no indication of which part *
  *                         or parts of a bad program parameter  *
  *                         have been discarded.                 *
  *                      4. DYNALLOC produces large SYSOUT       *
  *                         volumes even when ALLMSG and DSNMSG  *
  *                         are not set.                         *
  *                      5. Program default of MAXTASKS(200)     *
  *                         can degrade DASD I/O response for    *
  *                         other applications.                  *
  *                      6. PLX=Y cannot be used unless it       *
  *                         applies to all systems in the        *
  *                         SYSPLEX.                             *
  *                         That is, multiple separate           *
  *                         sub-SYSPLEX "DASDPLEXes" are         *
  *                         not supported.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1. Bad MVC instruction addresses protected low storage.
  2. DESERV reason code is overlaid before being reported.
  3. There is no PARM= program parameter error detailing.
  4. HSIPINQ DYNALLOC calls never use S99MSGL0 request flag.
  5. MAXTASKS(200) can overload some DASD controllers and increase
     I/O queuing times significantly, affecting other workloads.
  6. When PLX=Y is used it replaces all data for all SYSPLEX
     members even if some of them have completely different DASD.
  

Problem conclusion

• 1. The bad MVC instruction is corrected.
  2. The correct DESERV reason code data is displayed in HSIP078W.
  3. Discarded parameter parts are reported in the SYSPRINT file.
  4. S99MSGL0 is set for DYNALLOC unless DSNMSG or ALLMSG is
  specified.
  5. The program default is changed to MAXTASKS(10).
  6. A new PLEXNAME=xxxxxxxx program parameter setting is allowed
  which specifies the nominal SYSPLEX name for the IQ scan's data.
  This facilitates unique "SYSPLEX" names for each "DASDPLEX" so
  that the effects of PLX=Y can be limited to a subset of the
  members of a SYSPLEX.
  
  
  Administration Guide and Reference SC22-5474-00
  
  Product documentation is updated as follows:
  
  +--- Tivoli Asset Discovery for z/OS Version 8 Release 1    ---+
  |                                                              |
  |PROGRAM NUMBER: 5698-AA4                                      |
  |                                                              |
  |TITLE: Tivoli Asset Discovery for z/OS                        |
  |            Administration Guide and Reference                |
  |                                                              |
  |Chapter 6. Collecting and importing data with                 |
  |                IBM Tivoli Asset Discovery for z/OS           |
  |                                                              |
  |Section:                                                      |
  |        "Inquisitor program parameters and files"             |
  |                                                              |
  |update the Table 8.                                           |
  |        "Parameter settings for the Inquisitor"               |
  |                                                              |
  |by adding a new row between the PLX= and the LLQ= rows.       |
  |                                                              |
  |The new row is for the Parameter of                           |
  |        "PLEXNAME="                                           |
  |                                                              |
  |with a description :                                          |
  |     This is a value up to 8 characters long, and specifies   |
  |     the sysplex identifier to be contained in the data       |
  |     output from the Inquisitor. If the PLEXNAME identifier   |
  |     override is omitted, the actual sysplex name is used.    |
  |     The primary purpose of the PLEXNAME parameter is to      |
  |     provide a means for controlling the scope of             |
  |     sysplex-wide inventory updates, but it can be used       |
  |     whenever any need for it occurs.                         |
  |                                                              |
  |Section:                                                      |
  |        "Inquisitor program command syntax"                   |
  |                                                              |
  |under                                                         |
  |        "SYSIN commands"                                      |
  |                                                              |
  |Update description for MAXTASKS operand by replacing the      |
  |sentence :                                                    |
  |        "The default value is 200."                           |
  |with the following:                                           |
  |        "The default value is 10."                            |
  |                                                              |
  +--------------------------------------------------------------+
  

Temporary fix

Comments

APAR Information

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

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

  UA74298

Modules/Macros

•    HSIBRZIP HSIPINQ
  

Fix information

• Fixed component name

  TIV ASSET DISC

• Fixed component ID

  5698B39TD

Applicable component levels

• R810 PSY UA74298

     UP14/07/26 P F407

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.