PH16118: AGGINSTL U0901 ABENDS WITH REASON CODE 3 DURING IPL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Cases TS002650901 and  TS003757571
  
  HG v6.10 APAR is PH16180.
  ================================================================
  PROBLEM SUMMARY:
  ***************************************************************
  * USERS AFFECTED:      All IBM HourGlass users.               *
  ***************************************************************
  * PROBLEM DESCRIPTION:                                        *
  *                      When doing an AGGON command and there  *
  *                      is a proble locking the SVC table for  *
  *                      installing AGGFRONT, AGGINSTL may      *
  *                      ABEND with a U0901 message with reason *
  *                      code 3.                                *
  *                                                             *
  *                      Presently there is not enough          *
  *                      diagnostic information displayed by    *
  *                      AGGINSTL to determine the cause of the *
  *                      issue, although it likely that the     *
  *                      reason is that there one or more       *
  *                      other non-HourGlass programs competing *
  *                      to lock and use the same SVC table,    *
  *                      and HourGlass is just giving up "too   *
  *                      quickly", even though it is doing      *
  *                      some retries.                          *
  ***************************************************************
  * RECOMMENDATION:      Apply this APAR to rectify the defect. *
  *                                                             *
  ***************************************************************
  * PROBLEM CONCLUSION:                                         *
  ***************************************************************
  * FIX DESCRIPTION:                                            *
  *                      AGGINSTL is changed to reduce the wait *
  *                      times in between attempts to lock the  *
  *                      SVC table from 5 seconds down to 1,    *
  *                      and it will always retry at least 60   *
  *                      times (up from 5), with a corresponding*
  *                      increase in the minimum "give up" time *
  *                      from about 20 seconds to about 60.     *
  *                      This is done to increase the odds of   *
  *                      getting the SVC table locked for       *
  *                      AGGINSTL against other competitors,    *
  *                      and improve the average delay time     *
  *                      before locking.                        *
  *                                                             *
  *                      Additionally in the case the return    *
  *                      code being return from the lock        *
  *                      is 0x04, meaning some other process    *
  *                      currently has the lock, then there is  *
  *                      no limit on the number of attempts.    *
  *                      Otherwise there is a limit of 60       *
  *                      attempts.                              *
  *                                                             *
  *                      AGGINSTL is changed to produce at      *
  *                      least one AGGIN09S message when it     *
  *                      fails to lock the SVC table:           *
  *                                                             *
  *                        AGGIN09S HOURGLASS FAILS TO LOCK SVC *
  *                        TABLE, TRY 01 RC=0x04.               *
  *                                                             *
  *                      If the error code is not 0x04, then    *
  *                      AGGINSTL will display the AGGIN09S     *
  *                      message immediately and once a second  *
  *                      each time the lock fails.              *
  *                      Otherwise, for the more likely         *
  *                      "already in use" situations, it will   *
  *                      display the AGGIN09S message only once *
  *                      a minute.                              *
  *                                                             *
  *                      If AGGINSTL ultimately ends with a     *
  *                      U0901 abend with reason code 3, which  *
  *                      means AGGINSTL has ultimately given up *
  *                      trying to lock and modify the SVC      *
  *                      table to install AGGFRONT, then the    *
  *                      reason code(s) in the earlier AGGIN09S *
  *                      message(s) should help diagnose the    *
  *                      reason(s) for the problem.             *
  *                                                             *
  ***************************************************************
  * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
  ***************************************************************
  * NEW ELEMENTS ADDED:                                         *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS MODIFIED:                                 *
  *                                                             *
  * For HourGlass V610 (5697-P29-00):                           *
  *   SAGGLOAD(AGGINSTL).#000007 2019/09/19.07:53:39.PH16180    *
  *                                                             *
  * For HourGlass V710 (5655-U59-00):                           *
  *   SAGGLOAD(AGGINSTL).#000004 2019/09/19.07:53:39.PH16118    *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS DELETED:                                  *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  * IMPLEMENTATION:                                             *
  *                      After applying this PTF, you must:     *
  *                                                             *
  *                      Rerun HourGlass customization.         *
  *                      Stop and restart HourGlass.            *
  ***************************************************************
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM HourGlass users.                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: When doing an AGGON command and there   *
  *                      is a proble locking the SVC table for   *
  *                      installing AGGFRONT, AGGINSTL may       *
  *                      ABEND with a U0901 message with reason  *
  *                      code 3.                                 *
  *                                                              *
  *                      Presently there is not enough           *
  *                      diagnostic information displayed by     *
  *                      AGGINSTL to determine the cause of the  *
  *                      issue, although it likely that the      *
  *                      reason is that there one or more        *
  *                      other non-HourGlass programs competing  *
  *                      to lock and use the same SVC table,     *
  *                      and HourGlass is just giving up "too    *
  *                      quickly", even though it is doing       *
  *                      some retries.                           *
  ****************************************************************
  * RECOMMENDATION: Apply this APAR to rectify the defect.       *
  ****************************************************************
  

Problem conclusion

• AGGINSTL is changed to reduce the wait times in between
  attempts to lock the SVC table from 5 seconds down to 1, and it
  will always retry at least 60 times (up from 5), with a
  corresponding increase in the minimum "give up" time from about
  20 seconds to about 60. This is done to increase the odds of
  getting the SVC table locked for AGGINSTL against other
  competitors, and improve the average delay time before locking.
  
  Additionally in the case the return code being return from the
  lock is 0x04, meaning some other process currently has the lock,
  then there is no limit on the number of attempts. Otherwise
  there is a limit of 60 attempts.
  
  AGGINSTL is changed to produce at least one AGGIN09S message
  when it fails to lock the SVC table:
  
  AGGIN09S HOURGLASS FAILS TO LOCK SVC
  TABLE, TRY 01 RC=0x04.
  
  If the error code is not 0x04, then AGGINSTL will display the
  AGGIN09S message immediately and once a second each time the
  lock fails. Otherwise, for the more likely "already in use"
  situations,it will display the AGGIN09S message only once a
  minute.
  
  If AGGINSTL ultimately ends with a U0901 abend with reason code
  3, which means AGGINSTL has ultimately given up trying to lock
  and modify the SVC table to install AGGFRONT, then the reason
  code(s) in the earlier AGGIN09S message(s) should help diagnose
  the reason(s) for the problem.
  

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:

  UI69808

Modules/Macros

•    AGGINSTL
  

Fix information

• Fixed component name

  IBM HOURGLASS

• Fixed component ID

  5655U4200

Applicable component levels

• R710 PSY UI69808

     UP20/06/05 P F006

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.