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

A fix is available

Subscribe

You can track all active APARs for this component.

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 number

    PM64276

  • Reported component name

    IBM HOURGLASS

  • Reported component ID

    5655U4200

  • Reported release

    610

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-05-09

  • Closed date

    2012-11-13

  • Last modified date

    2013-01-17

  • 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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

HourGlass

Software version:

6.1

Reference #:

PM64276

Modified date:

2013-01-17

Translate my page

Machine Translation

Content navigation