PK34251: ADDING BATCHPIPES SUBSYS SUPPORT TO TEMPLATE UTILITY

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New function, adding BatchPipes subsys support to template
    utility.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All DB2 z/OS users.                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: ADDING BATCHPIPES SUBSYS SUPPORT TO     *
    *                      TEMPLATE UTILITY                        *
    ****************************************************************
    * RECOMMENDATION: Apply PTF when available.                    *
    ****************************************************************
    New TEMPLATE keywords to support dynamic allocation of MVS
    Batchpipes file.
    

Problem conclusion

Temporary fix

Comments

  • The fix for APAR PK34251 adds three new TEMPLATE utility
    keywords, SUBSYS, LRECL, and RECFM, to allow dynamic allocation
    of a DDNAME to use MVS BATCHPIPES SUBSYSTEM. This new support
    is to be used to dynamically allocate an input file for LOAD
    utility.
    
    The following is added to DB2 V8 and V9 z/OS Utility Guide and
    Reference (SC18742703 and SES1295002).
    Under the description of LOAD DISCARDDN keyword:
    
    |The DISCARDDN keyword is not supported if you use a BatchPipes
    |file as an input to LOAD (using INDDN name for TEMPLATE
    |SUBSYS).
    
    Under restarting LOAD utility add the following item:
    
    |Note:
    |o If you are using a BatchPipes file, you cannot restart the
    |LOAD utility. If the application that populates the BatchPipes
    |file terminates, you need to terminate the job where LOAD is
    |executing. If the LOAD utility was invoked from a stored
    |procedure, you also need to terminate the WLM application
    |environment of the LOAD utility that reads the BatchPipes
    |file. After you terminate the job, terminate the LOAD utility
    |using the DB2 TERM UTILITY command, and then you can resubmit
    |the LOAD job.
    
    TEMPLATE has three new keywords:
    
     >>__TEMPLATE_. . ._ _________________________________________ _
    |                   |                                         |
    |                     _SUBSYS__name__LRECL__int__RECFM_ _F__ _
    |                                                      |_FB_|
    |                                                      |_V__|
    |                                                      |_VB_|
    
     New option description:
    
    |SUBSYS name
    |      Specifies the MVS BATCHPIPES SUBSYSTEM name. The SUBSYS
    |      operand must be a valid BATCHPIPES SUBSYSTEM name, and
    |      must not exceed eight characters in length. When SUBSYS
    |      is specified, LRECL and RECFM are required.
    |      When SUBSYS is specified, TEMPLATE keywords that are not
    |      compatible with SUBSYS (such as UNIT) are ignored.
    |      Note:
    |      When using BATCHPIPES (TEMPLATE with SUBSYS keyword),
    |      the utility can not be restarted and the LOAD DISCARDDN
    |      keyword is not supported.
    |
    |LRECL  int
    |      Specifies the record length of the MVS BATCHPIPES
    |      SUBSYSTEM file. There is no default value and
    |      this option is required when SUBSYS is specified.
    |
    |RECFM
    |      Specifies the record format of the MVS BATCHPIPES
    |      SUBSYSTEM file. The valid values are F, FB, V, or VB.
    |      There is no default value and this option is
    |      required when SUBSYS is specified.
    
    The following messages are added to DB2 V8 and V9 z/OS Utility
    MESSAGES (GC18960200 and SES1294301).
    
    |DSNU1051I csect-name TEMPLATE SUBSYS IS NOT SUPPORTED TO
    |          ALLOCATE FILE FOR util-name UTILITY.
    |
    |Explanation: Dynamically allocating a BatchPipes file is not
    |supported for 'util-name' UTILITY.
    |
    |Severity: 8 (error)
    |
    |User Response: Remove the TEMPLATE keyword, SUBSYS, and
    |               resubmit the job.
    
    |DSNU1052I csect-name util-name UTILITY DOES NOT SUPPORT
    |          RESTART WHEN TEMPLATE SUBSYS IS USED.
    |
    |Explanation: The utility that uses the BatchPipes file cannot
    |be restarted.
    |
    |Severity: 8 (error)
    |
    |User Response: Use the DB2 command TERM UTILITY to terminate
    |               the stopped utility, and then rerun the job.
    
    |DSNU1053I csect-name KEYWORD k1 INVALID WITH  KEYWORD k2 ON
    |          utility  name
    |
    |Explanation: The use of KEYWORD k1 is not allowed due to a
    |conflicting keyword k2 on another utility control statement.
    |The conflicting LISTDEF or TEMPLATE name is shown.
    |
    |Severity: 8 (error)
    |
    |User Response: Correct one or both control statements in error
    |               and resubmit the job.
    

APAR Information

  • APAR number

    PK34251

  • Reported component name

    DB2 OS/390 & Z/

  • Reported component ID

    5740XYR00

  • Reported release

    810

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2006-11-07

  • Closed date

    2007-05-17

  • Last modified date

    2007-07-03

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

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

    UK25290 UK25291

Modules/Macros

  • DSNDUSMR DSNFMDIR DSNFUDRA DSNFUDRB DSNFUDRC
    DSNFUDRD DSNFUDRE DSNUBBCM DSNUBBCR DSNUBBID DSNUCRIX DSNUFCMR
    DSNUGDDR DSNUGDYN DSNUGLTM DSNUGMST DSNUGPPR DSNUGPRS DSNUGPRT
    DSNUGPRV DSNUGPS2 DSNUGPTC DSNUGQSV DSNUGTDS DSNUGTTR DSNUJTDR
    DSNUKDIN DSNUKLBD DSNUK001 DSNUMSGA DSNUMSGB DSNUMSGC DSNUMSGD
    DSNUMSGE DSNURELD DSNURORG DSNUULCB DSNUULDB DSNUULGL DSNUULPB
    DSNUUNLD DSNUZODR DSNU2BDR
    

Publications Referenced
SC18742703 SES1295002 GC18960200 SES1294301  

Fix information

  • Fixed component name

    DB2 OS/390 & Z/

  • Fixed component ID

    5740XYR00

Applicable component levels

  • R810 PSY UK25290

       UP07/06/07 P F706

  • R910 PSY UK25291

       UP07/06/06 P F706

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:

DB2 for z/OS

Software version:

8.0

Reference #:

PK34251

Modified date:

2007-07-03

Translate my page

Machine Translation

Content navigation