PM71432: GENERAL IMS FIXES

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Once an //HGIMSMSG DD statement is found in the IMS startup JCL,
    HG immediately stops looking for and parsing other DD Date and
    Time statements.
    

Local fix

  • Place the //HGIMSMSG DD DUMMY statement after the DD Date and
    Time statements.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IBM HourGlass R610 users who use         *
    *                 IMS with HG date and time DD statements      *
    *                 to control simulated date or time.           *
    *                 Does NOT affect behavior of IMS regions      *
    *                 which use ONLY HG IMS Control Elements       *
    *                 without HG date and/or time DDs.             *
    ****************************************************************
    * PROBLEM DESCRIPTION: N: DD STATEMENT HANDLING ERRORS:        *
    *                      1. //HGIMSMSG DD STATEMENT CAUSED EXIT  *
    *                         FROM DD STATEMENT HANDLING, AND      *
    *                         LEFT SUBSEQENT OTHER DD STATEMENTS   *
    *                         (EG. DATE)                           *
    *                      2. OPTIMIZATION FOR AVOIDING LOOKING    *
    *                         FOR CONTROL ELEMENTS WHEN BOTH DD    *
    *                         TIME AND DATE ARE SPECIFIED CAUSED   *
    *                         BYPASS OF IMS MSG REGION FLAGS       *
    *                         SETTINGS AND MVS BATCH-LIKE          *
    *                         BEHAVIOR, INCLUDING DATE ROLLING     *
    *                         AT SIMULATED MIDNIGHT.               *
    ****************************************************************
    * RECOMMENDATION:    Apply PTF, regardless of whether you      *
    *                    are presently experiencing symptoms.      *
    *                 1. You may now put the //HGIMSMSG first,     *
    *                    if you so prefer.                         *
    *                    This allows more order independence       *
    *                    among HG DD statements with differing     *
    *                    kinds of functionality, and avoids the    *
    *                    puzzlements and complaints caused by an   *
    *                    undocumented order dependence.            *
    *                    NOTE: Be aware that HG time and date      *
    *                    DD statements placed afterwards are NO    *
    *                    LONGER "just treated like comments".      *
    *                    You may have done this by accident,       *
    *                    when you converted to using HG IMS        *
    *                    Control Elements instead.                 *
    *                 2. NOTE: If you were using BOTH HG date      *
    *                    AND time DD statements TOGETHER to        *
    *                    adjust IMS HG simulated date and/or       *
    *                    time, along with the recommended          *
    *                    //HGIMSMSG to identify the task as IMS,   *
    *                    then you may have become accustomed to    *
    *                    the MVS batch-like errant HG altered      *
    *                    date rolling behavior, and you may need   *
    *                    to change usage to continue to achieve    *
    *                    your desired date rolling results.        *
    *                    You may prefer to install the IMS ROLL    *
    *                    usermod to do this, which will affect     *
    *                    all //HGIMSMSG identified batch jobs in   *
    *                    unison, including those using just CEs;   *
    *                    OR you may just remove the //HGIMSMSG     *
    *                    from the desired affected jobs, and       *
    *                    HG will treat them like an MVS batch      *
    *                    jobs instead.                             *
    *                 3. NOTE: Not using //HGIMSMSG in your        *
    *                    IMS region task JCL to identify it to     *
    *                    HG as an IMS region, but expecting DD     *
    *                    statement altered dates and times NOT     *
    *                    to include rolling dates "because it is   *
    *                    an IMS job", is considered user error!    *
    *                    ROLLING dates SHOULD be expected in       *
    *                    this (MVS BATCH) situation, and this      *
    *                    behaviour is NOT changed by this APAR.    *
    *                                                              *
    ****************************************************************
    

Problem conclusion

  • ***************************************************************
    * FIX DESCRIPTION:     Logic in AGGELIG in AGGFRONT module    *
    *                      was changed match intended design for  *
    *                      use with IMS and HG DD statements,     *
    *                      to achieve documented HG IMS behaviour.*
    *                   1. HGIMSMG can now be first or last among *
    *                      HG DD statements, or anywhere in       *
    *                      between.                               *
    *                   2. IMS region jobs with HGIMSMSG and both *
    *                      HG Date AND Time DDs should have IMS   *
    *                      expected non-rolling dates, as long as *
    *                      the IMS ROLL usermod is not in use.    *
    ***************************************************************
    * PRODUCT ELEMENTS AFFECTED BY THIS FIX:                      *
    ***************************************************************
    * NEW ELEMENTS ADDED:                                         *
    *     None.                                                   *
    *                                                             *
    ***************************************************************
    * EXISTING ELEMENTS MODIFIED:                                 *
    *   SAGGLOAD(AGGFRONT).#000014 2012/03/30.15:28:16.PM58160    *
    *     with     AGGELIG #000040.2012/08/30.15:45:01.PM71432    *
    ***************************************************************
    * EXISTING ELEMENTS DELETED:                                  *
    *     None.                                                   *
    *                                                             *
    ***************************************************************
    * IMPLEMENTATION:    * After installing the fix for this APAR *
    *                      it will be necessary to stop and       *
    *                      restart any running AGGLINK versions.  *
    *                                                             *
    ***************************************************************
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM71432

  • Reported component name

    IBM HOURGLASS

  • Reported component ID

    5655U4200

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-08-23

  • Closed date

    2012-10-10

  • Last modified date

    2012-11-01

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

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

    UK82513

Modules/Macros

  •    AGGFRONT
    

Fix information

  • Fixed component name

    IBM HOURGLASS

  • Fixed component ID

    5655U4200

Applicable component levels

  • R610 PSY UK82513

       UP12/10/15 P F210

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 #:

PM71432

Modified date:

2012-11-01

Translate my page

Machine Translation

Content navigation