IBM Support

PH38840: IDMS APPLICATION LOOP WHEN HG IS ACTIVE

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • AGGSVC2 returning with a non-zero PSW condition code when using
it with IDMS.
***************************************************************
* USERS AFFECTED:      All IBM HourGlass users using AGGSVC   *
*                      or AGGSVC2.                            *
***************************************************************
* PROBLEM DESCRIPTION:                                        *
*                      A customer reported AGGSVC2 was        *
*                      returning with a non-zero PSW          *
*                      condition code when using it with IDMS,*
*                      and as a result, the common customer   *
*                      was experiencing a sluggish response   *
*                      at least bordering on infinite loop    *
*                      behavior.                             *
***************************************************************
* RECOMMENDATION:      Apply this APAR to rectify the defect. *
***************************************************************
* PROBLEM CONCLUSION:                                         *
***************************************************************
* FIX DESCRIPTION:                                            *
*                      AGGSVC and AGGSVC2 are now modified to *
*                      fix numerous issues, including newly   *
*                      supporting any caller ASC (Address     *
*                      Space Control) Mode, supporting        *
*                      callers in AMODE-64, fixing handling   *
*                      register zero for the base register    *
*                      used for the call (although not        *
*                      advised), returning the proper         *
*                      condition code, properly restoring     *
*                      AR registers and the upper words of    *
*                      the 64-bit registers, and handling     *
*                      some other special circumstances in a  *
*                      better way.                            *
*                                                             *
*                      AGGINSTL has been modified to work     *
*                      similarly to revised AGGINSVC method   *
*                      for acquiring the SVC Table Enq,       *
*                      to improve handling of non-zero return *
*                      codes when attempting to lock access   *
*                      to the system SVC table.               *
*                                                             *
*                      AGGINSVC has been modified to work     *
*                      similarly to revised AGGINSTL PH16118  *
*                      method for acquiring the SVC Table     *
*                      Enq, to improve handling of non-zero   *
*                      return codes when attempting to lock   *
*                      access to the system SVC table during  *
*                      AGGSVC or AGGSVC2 FUNCTION=INSTALL.    *
*                                                             *
*                      AGGINSVC has been modified to preset   *
*                      the PSW Condition Code to be non-zero  *
*                      prior to calling AGGSVC or AGGSVC2 for *
*                      the FUNCTION=TEST option.              *
*                                                             *
*                      AGGINSVC has been modified to improve  *
*                      information content in it's messages,  *
*                      including more error codes.            *
*                      Additional messages have been added.   *
*                                                             *
* Currently 'AGGSVCXX' in these messages may be either:       *
*     AGGSVC or AGGSVC2, and now confirms input data.         *
* '@ SVC 123=0XFF' in these messages now confirms input data. *
* 'ADDRESS=X12345678' in these messages provides information  *
*           which can useful for matching up with other       *
*           messages displaying the same address, or clarifing*
*           difference in modules for different addresses.    *
*                                                             *
* 'AGGSI01I HOURGLASS AGGSVCXX MODULE SUCCESSFULLY INSTALLED' *
            ' @ SVC 123=0XFF, ADDRESS=0X12345678.'            *
* 'AGGSI02E LOAD REQUEST FAILED FOR AGGSVCXX SERVICE MODULE.' *
* 'AGGSI04E SVCUPDT REQUEST FAILED, RC=12345678.'             *
* 'AGGSI08E SIZE ERROR. AGGSVCXX MODULE LARGER THAN AREA OBT' *
*           'AINED TO CONTAIN IT.'                            *
* 'AGGSI09  @GMSG 'AGGSI09E A LOGICAL ERROR OCCURRED IN MODU' *
*           'LE AGGINSVC#123456, RETURN CODE=XXXX, REASON CO' *
*           'DE=XXXX.'                                        *
* The above actual module version number may be helpful for   *
* support requests to clarity the subject version in use.     *
* 'AGGSI10E SELECTED SVC TABLE SLOT @ SVC 123=0XFF IS OCCUPI' *
*           'ED AND UNAVAILABLE. UNABLE TO CONTINUE.'         *
*                                                             *
* Message AGGSI11 is now used for both AGGSVC and AGGSVC2,    *
* and message AGGSI13 is now defunct.                         *
* STCK output in AGGSI11 may be identified by seven bytes of  *
* trailing zero hex digits in the 'V' string.                 *
*                                                             *
* 'AGGSI12E HOURGLASS AGGSVCXX @ SVC 123=0XFF RETURNED WITH ' *
*           'A NON-ZERO CONDITION CODE. NOTIFY IBM HOURGLASS' *
*           ' SUPPORT.'                                       *
* 'AGGSI14S HOURGLASS FAILS TO LOCK SVC TABLE, TRY 01 RC=0X0' *
*           '4.'                                              *
*           The try number runs from 01 to 60 (seconds).      *
*           In an effort to reduce output, most tries with    *
*           the same RC as previous try are not listed.       *
*           Try will restart at 01 for a new RC value.        *
*           Only 60 tries for the same non-zero RC other than *
*           0X04 will be allowed before program termination.  *
*           Tries for RC=0X04 will continue until success     *
*           (RC=0X00) or operator task termination.           *
*                                                             *
* New messages:                                               *
* 'AGGSI15E HOURGLASS AGGSVCXX MODULE IS NOT THE SVC HANDLER' *
*           ' @ SVC 123=0XFF, ADDRESS=0X12345678.'            *
*           If the actual handler is "the other" HourGlass    *
*           module, AGGSVC or AGGSVC2, then testing continues,*
*           and the true module name, rather than the one     *
*           identified via input, is used for subsequent      *
*           messages. The most likely reason for this message *
*           will be "user error", as the module mentioned was *
*           not the one previously installed at the SVC#.     *
* 'AGGSI16E STCKCONV REQUEST FAILED, RC=12345678.'            *
*           Most likely this would indicate a STCKE value     *
*           beyond that supported by the z/OS version in use, *
*           which for V2.3 was limited to about mid year 2185,*
*           and also likely an HourGlass programming failure. *
*                                                             *
*                      AGGSVCT has been modified to also      *
*                      support testing AGGSVC2.               *
*                                                             *
*                      AGGSVCT has been modified to preset    *
*                      the PSW Condition Code on alternate    *
*                      tests to be non-zero and then zero     *
*                      prior to calling AGGSVC or AGGSVC2     *
*                      in repeated testing iterations.        *
*                                                             *
*                      SAMPLIB( AGGINSVC ) has been modified  *
*                      to include an example install of       *
*                      AGGSVC2 and steps to test both of      *
*                      AGGSVC and AGGSVC2.                    *
* 'AGGSI17E AGGSVCXX MODULE CLOBBERED LOWER REG WORDS:000000' *
*           '00111111112222222233333333444444445555555566666' *
*           '66677777777.',                                   *
*           This message will appear twice in order to show   *
*           the lower order word of all 16 64-bit GPRs.       *
*           Where a register value is shown as 'FFFFFFFF',    *
*           this will indicate the value was (probably)       *
*           unchanged, otherwise it indicates the new value,  *
*           which would indicate the failure of the handler   *
*           to preserve the caller's lower order word.        *
* 'AGGSI18E AGGSVCXX MODULE CLOBBERED UPPER REG WORDS:000000' *
*           '00111111112222222233333333444444445555555566666' *
*           '66677777777.'                                    *
*           This message will appear twice in order to show   *
*           the upper order word of all 16 64-bit GPRs.       *
*           Where a register value is shown as 'FFFFFFFF',    *
*           this will be due to pre-call initialization.      *
*           Anything else will indicate the failure of the    *
*           handler to preserve the caller's upper order word.*
* 'AGGSI19E AGGSVCXX MODULE CLOBBERED AR REGS:00000000111111' *
*           '11222222223333333344444444555555556666666677777' *
*           '777.'                                            *
*           This message will appear twice in order to show   *
*           the values of all 16 AR registers.                *
*           Where a register value is shown as 'FFFFFFFF',    *
*           this will indicate the value was (probably)       *
*           unchanged, otherwise it indicates the new value,  *
*           which would indicate the failure of the handler   *
*           to preserve the caller's AR value.                *
***************************************************************
* PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
***************************************************************
* NEW ELEMENTS ADDED:                                         *
*     None.                                                   *
*                                                             *
***************************************************************
* EXISTING ELEMENTS MODIFIED:                                 *
* For HourGlass V710 (5655-U59-00):                           *
*   SAGGLOAD(AGGINSTL).#000008 2021/11/01.13:47:27.PH38840    *
*   SAGGLOAD(AGGINSVC).#000005 2021/12/10.16:57:49.PH38840    *
*   SAGGLOAD(AGGSVC  ).#000003 2021/11/11.21:59:34.PH38840    *
*   SAGGLOAD(AGGSVCT ).#000003 2021/11/01.18:14:00.PH38840    *
*   SAGGLOAD(AGGSVC2 ).#000003 2021/11/11.22:02:03.PH38840    *
*                                                             *
*   SAGGSAMP(AGGINSVC).#000006 2021/10/15 12:53:02.PH38840    *
*   SAGGSAMP(AGGSVCT$).#000003 2021/11/02 10:49:39.PH38840    *
*                                                             *
* NO V6.1 APAR YET!                                           *
* For HourGlass V610 (5675-P29-00):                           *
*   SAGGLOAD(AGGINSVC).#000064 2021/10/14.20:24:05.PH38840    *
*   SAGGLOAD(AGGSVC  ).#000064 2021/10/14.20:24:05.PH38840    *
*   SAGGLOAD(AGGSVCT ).#000064 2021/10/14.20:24:05.PH38840    *
*   SAGGLOAD(AGGSVC2 ).#000064 2021/10/14.20:24:05.PH38840    *
*   SAGGSAMP(AGGINSVC).#000064 2021/10/14.20:24:05.PH38840    *
*   SAGGSAMP(AGGSVCT$).#000064 2021/10/14.20:24:05.PH38840    *
*                                                             *
***************************************************************
* EXISTING ELEMENTS DELETED:                                  *
*     None.                                                   *
*                                                             *
***************************************************************
* IMPLEMENTATION:                                             *
*                      After applying this PTF,               *
*                      rerun HourGlass customization.         *
*                                                             *
*                      After applying this PTF,               *
*                      you must stop and restart HourGlass.   *
***************************************************************

Local fix

  • 



Problem summary


    

  • A customer reported AGGSVC2 was returning with a non-zero PSW
condition code when using it with IDMS, and as a result, the
common customer was experiencing a sluggish response at least
bordering on infinite loop behavior.

    



Problem conclusion


    

  • Several modules have been modified to resolve this issue.

    



Temporary fix


    

  • 



Comments


    

  • 



APAR Information




    

  • APAR number
    PH38840
    • 

  • Reported component name
    IBM HOURGLASS
    • 

  • Reported component ID
    5655U4200
    • 

  • Reported release
    710
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    YesHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2021-07-09
    • 

  • Closed date
    2022-01-10
    • 

  • Last modified date
    2022-02-01
    • 





    

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

    • 

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

    
UI78863
    

    • 



Modules/Macros


    

  • AGGINSTL AGGINSVC AGGSVC   AGGSVC2  AGGSVCT  AGGSVCT$

    



Fix information


    

  • Fixed component name
    IBM HOURGLASS
    • 

  • Fixed component ID
    5655U4200
    • 



Applicable component levels


    

  • R710  PSY  UI78863
       UP22/01/11  P  F201  ¢
    • 



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.
    








      
              
                            

              

              [{"Line of Business":{"code":"LOB10"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"HourGlass"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1"}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            02 February 2022
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback