PM64276: Enhance IBM HourGlass to provide HourGlass-altered date/time values to MVS STCKSYNC service requesters.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enhance HourGlass function to include providing
  HourGlass-altered date/time values to users of the MVS STCKSYNC
  (Store Clock Synch) system service.
  STCKSYNC - Store Clock Synchronous Service
  Additional Search keyword:  sync
  

Local fix

• None aAvailable.
  

Problem summary

• ***************************************************************
  * USERS AFFECTED:      All IBM HourGlass R610 users intending *
  *                      to use HourGlass to retrieve altered   *
  *                      date/time values via the MVS STCKSYNC  *
  *                      (Store clock synchronous service).     *
  *                                                             *
  ***************************************************************
  * PROBLEM DESCRIPTION: With the installation of this fix,     *
  *                      HourGlass can optionally be used to    *
  *                      retrieve altered date/time values      *
  *                      through time requests made via the     *
  *                      MVS STCKSYNC service.                  *
  *                      The following steps are only necessary *
  *                      if you intend to implement the STCKSYNC*
  *                      feature.                               *
  ***************************************************************
  * RECOMMENDATION:      Apply PTF.                             *
  ***************************************************************
  
  A new HourGlass customization setting: STCKSYNC=Y|N is provided
  in the AGGCUSTM program in the HourGlass SAGGSAMP library
  dataset. This setting can be used to control enablement or
  disablement of the HourGlass STCKSYNC support feature. The
  default setting is STCKSYNC=N.
  
  The AGGOPTS program (Options List Utility) has been enhanced to
  display the status of the STCKSYNC= customization setting.
  
  The AGGVRFY program (install verification job) has been expanded
  to provide verification for the HourGlass STCKSYNC support
  feature. The results of both a 64-bit (STCK) STCKSYNC and a
  128-bit (STCKE) STCKSYNC* time request are displayed.
  
  A new HourGlass integration patch installation process, AGG$SS,
  and a new set of integration patches, AGGSSAAA, et al, are
  provided to make and install the necessary modifications into
  the relevant MVS modules, in order to integrate HourGlass
  support into the MVS STCKSYNC service.
  
  
  Modifications have been made to the AGGLSPC program (TIME
  LINKAGE=SYSTEM Support) to recognize and handle time requests
  originating from the MVS STCKSYNC service.
  
  Note: This change only addresses the date/time value returned
  from the STCKSYNC service request that may be modified by
  HourGlass. The ETRID value and/or the CTNID value returned from
  the STCKSYNC service request are not modified by HourGlass in
  any way.
  
  Implementation of STCKSYNC support.
  
  The following steps are only necessary if you intend to
  implement the STCKSYNC feature.
  
  To complete the implementation of this function, after
  installation by SMP/E, please perform the following steps:
  
  1.) Ensure that the new/updated modules and parts are copied to
  their respective execution libraries.
  
  2.) Following the procedure detailed in the SAGGPINT(AGG$SS)
  procedure, install the HourGlass integration patch for STCKSYNC
  support. This will require at least one IPL of MVS.
  
  The HourGlass SAGGPINT distribution library contains the
  HourGlass Integration Patches, all the AGG$* jobs are located
  here.
  
  For complete details see member AGG$SS in the HourGlass SAGGPINT
  distribution library.
  
  For systems implementing STCKSYNC (executing AGG$SS):
  
  a. The sample SAGGPINT(AGG$SS) job will copy the MVS nucleus
  modules into the specified target load library and make the
  modifications necessary for HourGlass STCKSYNC support.
  
  b. It is strongly recommended that the HourGlass-modified
  nucleus module be created under an alternate nucleus suffix
  number.  See the description of the NEWSUF= parameter in the
  SAGGPINT(AGG$SS) JCL procedure for further information.
  WARNING: An improperly configured and/or modified nucleus may
  cause a catastrophic failure in the IPL of the Z/OS system.
  Having a procedure in place to effect fall-back to the original
  MVS nucleus from the alternate nucleus modified/created by the
  SAGGPINT(AGG$SS) procedure is strongly recommended.
  
  c. Note: Even though only the IEANUC0x nucleus module is
  actually updated by this procedure, the corresponding IEANUC1x
  and IEANUC2x modules are also copied to the specified target
  library in order to provide a complete set of nucleus modules
  with the specified nucleus suffix number.
  
  d. After applying the HourGlass STCKSYNC integration patch, the
  set of nucleus modules created/modified by this procedure:
  IEANUC0x, IEANUC1x, and IEANUC2x need to be copied back to
  'SYS1.NUCLEUS'. This can be done via another IEBCOPY job or via
  ISPF 3.3 (copy utility).
  
  e. Re-IPL the Z/OS system using the patched alternate nucleus
  above. See section b above.
  
  3.) Add a "STCKSYNC=Y" customization setting specification to
  your HourGlass customization process. Re-execute the HourGlass
  customization process and restart HourGlass via the AGGOFF/AGGON
  command sequence.
  
  4.) Verify the functionality of the HourGlass STCKSYNC support
  the AGGSAMP(AGGBVRFY) procedure.
  Note: Once the HourGlass STCKSYNC integration patch has been
  installed on MVS, the enablement/disablement status of the
  HourGlass STCKSYNC feature can be controlled via the
  STCKSYNC=Y|N customization setting.
  
  ***************************************************************
  * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
  ***************************************************************
  * NEW ELEMENTS ADDED:                                         *
  *   SAGGPINT(AGG$SS  ).#000001.2012/11/01.22:52:53.PM64276    *
  *   SAGGPINT(AGGSSAAA).#000001.2012/11/01.22:56:55.PM64276    *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS MODIFIED:                                 *
  *   SAGGLOAD(AGGCUST ) On behalf of modules:                  *
  *            AGGCUST  .#000005.2012/11/01.23:28:32.PM64276    *
  *            AGGZAP   .#000004.2012/11/01.23:29:14.PM64276    *
  *   SAGGLOAD(AGGFRONT).#000015.2012/10/25.17:37:48.PM64276    *
  *   SAGGLOAD(AGGLSPC ).#000035.2012/11/05.17:44:57.PM64276    *
  *   SAGGLOAD(AGGOPTS ) On behalf of modules:                  *
  *            AGGOPTS  .#000010.2012/08/30.14:16:54.PM64276    *
  *            AGGSTAT  .#000004.2012/11/02.11:15:18.PM64276    *
  *   SAGGLOAD(AGGPINS ) On behalf of Modules:                  *
  *            AGGPIND  .#000004.2012/10/25.18:04:56.PM64276    *
  *            AGGPINS  .#000004.2012/10/24.16:08:23.PM64276    *
  *   SAGGLOAD(AGGVRFY ) On behalf of modules:                  *
  *            AGGVRFY  .#000006.2012/09/21.23:07:04.PM64276    *
  *            AGGSTAT  .#000004.2012/11/02.11:15:18.PM64276    *
  *                                                             *
  ***************************************************************
  * EXISTING ELEMENTS DELETED:                                  *
  *     None.                                                   *
  *                                                             *
  ***************************************************************
  

Problem conclusion

• See the Previous section for information on implementing the
  STCKSYNC support.
  

Temporary fix

Comments

• ž**** PE12/12/13 PTF IN ERROR. SEE APAR PM77478  FOR DESCRIPTION
  

APAR Information

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

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

  UK83483

Modules/Macros

•    AGG$SS   AGGCUST  AGGFRONT AGGLSPC  AGGOPTS
  AGGPINS  AGGSSAAA AGGVRFY
  

Fix information

• Fixed component name

  IBM HOURGLASS

• Fixed component ID

  5655U4200

Applicable component levels

• R610 PSY UK83483

     UP12/11/16 P F211

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.