IBM Support

PH30093: TEMPLATE UTILITY STATEMENT - FUTURE NEW ENHANCEMENT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Code to support future new enhancement in the TEMPLATE utility
    control statement.
    Ref:  E6661
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All Db2 12 for z/OS users of the TEMPLATE                    *
    * utility.                                                     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * Currently users are unable to make                           *
    * use of the Large Block Interface                             *
    * (LBI) during the creation of utility                         *
    * sequential data sets via the                                 *
    * TEMPLATE utility.                                            *
    * LBI allows for better                                        *
    * performance as it can help decrease                          *
    * CPU utilization and the elapsed                              *
    * time for utilities. LBI also allows                          *
    * utilities to handle much larger                              *
    * blocks with BSAM and allows                                  *
    * customers to increase their block                            *
    * size for data sets. LBI is useful                            *
    * mainly when creating new data sets on                        *
    * tapes. But to make use of LBI today,                         *
    * users are required to update their                           *
    * DFSMS data class. In order to provide                        *
    * more flexibility to users of the                             *
    * TEMPLATE utility, the TEMPLATE                               *
    * utility control statement will be                            *
    * enhanced to provide the ability to                           *
    * specify the BLKSZLIM option.                                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Currently users are unable to make use of the Large Block
    Interface (LBI) during the creation of utility
    sequential data sets via the TEMPLATE utility. LBI allows for
    better performance as it can help decrease CPU utilization
    and the elapsed time for utilities. LBI also allows
    utilities to handle much larger blocks with BSAM and allows
    customers to increase their block size for data sets. LBI is
    useful mainly when creating new data sets on tapes.
    But to make use of LBI today, users are required to update
    their DFSMS data class. In order to provide more flexibility
    to users of the TEMPLATE utility, the TEMPLATE utility control
    statement will be enhanced to provide the ability to
    specify the BLKSZLIM option.
    

Problem conclusion

Temporary fix

Comments

  • The TEMPLATE utility will be enhanced to support the
    specification of BLKSZLIM for FL500. Currently, the
    TEMPLATE utility does not allow the specification of
    BLKSZLIM for the creation of utility sequential data sets.
    System Determined Block Size (SDB) is used by TEMPLATE
    processing to setup the optimal block size. With the
    BLKSZLIM keyword, it will tell z/OS that the user has
    requested to use the large block interface and it would
    use the BLKSZLIM as the upper limit when it uses SDB to
    determine the optimal block size.
    >>-TEMPLATE--template-name-------------------------------->
    ...
    >--+-----------------------+------------------------------>
       '-BLKSZLIM--integer-+---'
                           +-K-+
                           +-M-+
                           '-G-'
    BLKSZLIM integer
    Specifies the upper limit for the block size for the data
    set if the system determines the block size for the data
    set. The minimum value is 32760 or 32K. The maximum value
    is 2,147,483,648 (coded without the commas) or 2G.
    Use the BLKSZLIM option to set the upper limit on a data
    set's block size if the system determines the block size
    for the data set.
    For additional information regarding the BLKSZLIM parameter
    in regards to usage and limitations, please refer to IBM's
    z/OS MVS JCL Reference.
    Modified messages:
    - DSNU1321I csect-name OPERAND FOR KEYWORD BLKSZLIM
      IN TEMPLATE template-name IS INVALID. REASON CODE 035C.
    The Db2 product documentation is updated for these changes.
    For more information, see the description of this APAR in:
    https://www.ibm.com/support/knowledgecenter/SSEPEK_12.0.0/
    wnew/src/tpc/db2z_12_enhancements.html
    

APAR Information

  • APAR number

    PH30093

  • Reported component name

    DB2 OS/390 & Z/

  • Reported component ID

    5740XYR00

  • Reported release

    C10

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-09-30

  • Closed date

    2020-11-30

  • Last modified date

    2021-01-04

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

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

    UI72836

Modules/Macros

  • DSNUGSDA DSNUGPXU DSNUGDYN DSNUGPRV DSNUGQSV DSNUGDDR DSNUGPPR
    DSNUGPRT
    

Fix information

  • Fixed component name

    DB2 OS/390 & Z/

  • Fixed component ID

    5740XYR00

Applicable component levels

  • RC10 PSY UI72836

       UP20/12/08 P F012

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"12.0"}]

Document Information

Modified date:
05 January 2021