PM71432: GENERAL IMS FIXES

Obtain the fix for this APAR.

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