A fix is available
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