PM62545: ADD NEW FUNCTIONS FOR SRG - DETAILS WILL BE PROVIDED IN APAR CLOSING TEXT.

APAR status

• Closed as new function.

Error description

• Add new functions for SRG - Details will be provided in APAR
  closing text.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Sequential Randomizer       *
  *                 Generator for OS/390 Release 1               *
  *                 (FMID=H1J1110)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR addresses the following       *
  *                      requirements regarding equation         *
  *                      table optimization:                     *
  *                                                              *
  *                      1. Complete the optimization process    *
  *                      even if the number of equation table    *
  *                      entries is greater than 32767 (32767 is *
  *                      the maximum number of equation table    *
  *                      entries that can be specified through   *
  *                      the TLIMIT parameter).                  *
  *                                                              *
  *                      2. Stop the optimization process not    *
  *                      only by the number of equation tables,  *
  *                      but also by the elapsed time spent on   *
  *                      the optimization process.               *
  *                                                              *
  *                      3. Instead of issuing an FABO0116A      *
  *                      message when the size of an SR module   *
  *                      exceeds 16 MB, issue a message that     *
  *                      explicitly notifies the condition.      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Provides the following new functions to address the requirements
  described in the Problem Description.
  
  1. TNUMLIM parameter
  
  The new TNUMLIM parameter enhances the TLIMIT parameter. The
  TNUMLIM parameter can be used to specify the number of equation
  tables greater than 32767. By using the TNUMLIM parameter, the
  optimization condition that is specified by the OPTMZ parameter
  can be satisfied even if the number of the equation tables is
  greater than 32767 (32767 is the maximum number of equation
  table entries that can be specified through the TLIMIT
  parameter).
  
  The syntax is as follows:
  For HDAM and PHDAM:
      ANALYZE ...,
          TNUMLIM=number,
          ....
  For DEDB:
      AREADEF ...,
          TNUMLIM=number,
          ....
  
  The TNUMLIM parameter specifies the maximum number of equation
  tables of an SRT for equation table optimization.
  If the TNUMLIM parameter is specified, SRG stops the
  optimization processing when the number of equation tables of
  the SRT reaches the maximum value and generates an SR. In this
  case, the SR might not satisfy the optimization condition.
  
  2. OPTMTIME parameter
  
  By using the new OPTMTIME parameter, you can specify the maximum
  allowable time for the equation table optimization process.
  
  
  The syntax is as follows:
  For HDAM and PHDAM:
      ANALYZE ...,
          OPTMTIME=number,
          ....
  For DEDB:
      AREADEF ...,
          OPTMTIME=number,
          ....
  
  The OPTMTIME parameter specifies the maximum elapsed time in
  minutes for equation table optimization. Specify a value in the
  range of 0 - 1440.
  If the OPTMTIME parameter is specified, SRG stops the
  optimization processing when the maximum time is reached and
  generates an SR. In this case, the SR might not satisfy the
  optimization condition.
  
  3. SIZECHK parameter
  
  The SIZECHK parameter specifies to issue an FABO0133A or
  FABO0134A message when the size of an SR module exceeds 16 MB.
  This parameter helps you identify such error condition faster.
  
  
  The syntax is as follows:
  For HDAM, PHDAM, and DEDB:
      ANALYZE ...,
          SIZECHK=NO|YES,
          ....
  
  The SIZECHK parameter specifies whether SRG issues a message and
  stops processing when SRG determines that the size of one of the
  modules that composes the SR will exceed 16 MB.
  
    YES  SRG issues the FABO0133A or FABO0134A message and ends
         with RC=8 when the size of the SR module exceeds 16 MB.
  
    NO   SRG continues processing even when the size of the SR
         module exceeds 16 MB. As a result, the assembler program
         issues the ASMA039S message and SRG ends processing with
         RC=8 after issuing the FABO0116A message.
  
  Default: NO
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Sequential Randomizer Generator User's Guide will be
  revised to include the descriptions for these new functions.
  
  When the User's Guide is revised, you can locate the revised
  User's Guide (SC27-0926-02) at: http://www-304.ibm.com/support/
  docview.wss?uid=swg27020942#imsseqran-lib
  

APAR Information

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

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

  UK79318

Modules/Macros

•    FABOANA  FABOARE  FABOGNSR FABOMAIN FABOOPTM
  FABOSMTH FABOSRR0 FABOSRR1
  

Fix information

• Fixed component name

  IMS SEQ RANDOMI

• Fixed component ID

  5655E1100

Applicable component levels

• R110 PSY UK79318

     UP12/06/12 P F206