PI69585: IMS V14 DDL EXTENSIONS CREATE SPE DATA SHARING SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• IMS V14 DDL Extensions CREATE SPE data sharing support.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IMS V14 DDL Users with ACBMGMT=CATALOG                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function:                                                *
  * - Add DDL Extensions CREATE DATABASE and CREATE PROGRAMVIEW  *
  * for ACBSHR=Y for two or more IMS systems.                    *
  * - PI69585 is a follow-on SPE to PI64211 for single IMS       *
  * ACBSHR=Y and data sharing ACBSHR=N support.                  *
  * - Add new optional parameter CREATEOPTS=(CREPGM=YES|NO|Y|N)  *
  * in <SECTION=DDL> of                                          *
  *   DFSDFxxx PROCLIB.                                          *
  *   -  Option for DDL Auto Create|Auto Import to create a      *
  * runtime program definition of BMP type if                    *
  *      one does not exist and Dynamic Resource Definition      *
  * enabled at DDL CREATE PROGRAMVIEW                            *
  *      processing.                                             *
  * --------------------                                         *
  * For descriptions of V14 DDL Extensions CREATE DATABASE and   *
  * CREATE PROGRAMVIEW support, refer to:                        *
  * PI64211 V14 DDL Extensions CREATE DATABASE and CREATE        *
  * PROGRAMVIEW.                                                 *
  * PI71632 V14 DDL Extensions CREATE DATABASE data set naming   *
  * convention enhancement.                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * INSTALL CORRECTIVE SERVICE FOR APAR/PTF                      *
  ****************************************************************
  

Problem conclusion

• The following modules have been enhanced to add ACBSHR=Y data
  sharing support for
  V14 DDL Extensions CREATE DATABASE and CREATE PROGRAMVIEW:
  DFSOLC00:
  Add DDL Extensions CREATE DATABASE and CREATE PROGRAMVIEW for
  ACBSHR=Y data sharing support.
  Fix bad field contents sent from master IMS to DMU ACBSHR=Y data
  sharing IMS used for IMSLOG70 log records.
  DFSOLC50:
  Fix bad IMSLOG70 log record contents for DMU Import and DDL
  ACBSHR=Y data sharing IMS.
  DFSOLC70:
  Add DDL Extensions CREATE DATABASE and CREATE PROGRAMVIEW for
  ACBSHR=Y data sharing support.
  
  ----------------------------------
  The followng macro and modules have been enhanced for
  CREATEOPTS=(CREPGM=YES|NO|Y|N) support:
  DFSOLCD:
  Add MOLCI_CRPGBMP: 1 character field to show Y|N for CREPGM.
  
  DFSOLC00, DFSOLC70, DFS3DD00, DFS3DL40, DFS3DL50:
  Add CREATEOPTS=(CREPGM=YES|NO|Y|N) support.
  
  DFS3DL60, DFS3RU00:
  Recompile for macro length change.
  
  ----------------------------------
  PI69585 Documentation Changes:
  V14 DDL CREATE Extensions ACBSHR=Y Data Sharing Support
  
  Request for Publication Changes for the following documents:
  - GC19422400  Release Planning
  - SC19421400  Database Administration
  - GC19422600  System Definition
  - GC18421900  Messages and Codes, Volume 1: DFS Messages
  
  ------------------------------------------------------------
  GC19422400  Release Planning
  > IMS Version 14 enhancements
  > IMS Database Manager enhancements
  > Dynamic database definition enhancements
  > Data Definition Language (DDL) for IMS
  
  Under DDL CREATE Extensions:
  >>Change ACBSHR=N and ACBSHR=Y to ACBSHR=N|Y.
  
  The DDL CREATE Extensions SPE provides the capability to
  prepare and bring DDL CREATE databases and programs
  resources online and as active definitions in the Catalog
  without an IMPORT DEFN SOURCE(CATALOG) command for:
  - ACBSHR=N|Y
  
  >>Delete the following two paragraphs relating to
  CHANGE.RECON CATALOG(default-catalog-name) command:
  
  <Delete Begin>
  If the RECON header does not contain the CATALOG name already:
  - Before using DDL Extensions CREATE SPE, issue
    CHANGE.RECON CATALOG(default-catalog-name).
  
  If there is a need that the CATALOG cannot be set as the
  default in the RECON, you can continue to use DDL Extensions
  CREATE SPE without the DDL DBRC registration services.
  After DDL completion, the newly created DEDB databases would
  need to be manually registered to DBRC.
  <Delete End>
  ------------------------------------------------------------
  SC19421400 Database Administration
  > Database design and implementation
  > Implementing database design
  > Using DDL to design IMS databases
  
  Under:
  DDL CREATE Extensions for CREATE DATABASE|PROGRAMVIEW:
  >>Change ACBSHR=N and ACBSHR=Y to ACBSHR=N|Y.
  
  DDL CREATE is enhanced to prepare and bring the DDL CREATE
  definition for databases and program resources online
  without users manually perform the following operations:
  
  - Issue IMPORT DEFN SOURCE(CATALOG) command
    - To activate resources in the Catalog from
      pending to active state.
  
  - Issue CREATE DB and CREATE PROGRAM command
    - To create dynamic resource definition for the
      newly DDL created resources in DRD environment
      (MODBLKS=DYN in <SECTION=COMMON_SERVICE_LAYER>
       in DFSDFxxx PROCLIB)
  
  - Create data sets for newly DDL created DEDB databases.
  
  - ACBSHR=N|Y
  
  Under:
  (1) DDL AUTO IMPORT CREATE DATABASE|PROGRAMVIEW function:
  >>Delete ACBSHR=Y restriction.
  >>Add ACBSHR=Y restriction:
  >>For ACBSHR=Y:
    - One DDL CREATE job can be run in an IMSplex at one time.
    - If more than one DDL CREATE jobs are to be run
      concurrently in an IMSplex, submit them to one IMS
      system which serves as the master IMS to coordinate
      and serialize the DDL CREATE processes.
  
  (1) DDL AUTO IMPORT CREATE DATABASE|PROGRAMVIEW function:
  
      - Restrictions:
        - DEDB databases:
          - Support DEDB Area Single Area Data Set (SADS)
  
        - Databases not supported:
          - Fast Path Secondary Index databases
  
        - Do not support XRF.
  
  <Delete Begin>
        - Do not support ACBSHR=Y for two or more IMS systems.
          - To be delivered in a follow-on SPE.
  <Delete End>
  
  <Add Begin>
        - For ACBSHR=Y:
          - One DDL CREATE job can be run in an IMSplex at
            one time.
          - If more than one DDL CREATE jobs are to be
            run concurrently in an IMSplex, submit them
            to one IMS system which serves as the master IMS
            to coordinate and serialize the DDL CREATE
            processes.
  <Add End>
  
  Under:
  (2) DDL AUTO CREATE DATABASE DATA SET function (DEDB only):
  >>Delete ACBSHR=Y restriction.
  >>Add ACBSHR=Y restriction:
  >>For ACBSHR=Y:
    - One DDL CREATE job can be run in an IMSplex at one time.
    - If more than one DDL CREATE jobs are to be run
      concurrently in an IMSplex, submit them to one IMS
      system which serves as the master IMS to coordinate
      and serialize the DDL CREATE processes.
  
  (2) DDL AUTO CREATE DATABASE DATA SET function (DEDB only):
  
      - Restrictions:
        - DEDB databases:
          - Support DEDB Area Single Area Data Set (SADS)
  
        - Databases not supported:
          - Fast Path secondary index databases
          - Full function databases
          - HALDB databases
  
        - Do not support XRF.
  
  <Delete Begin>
        - Do not support ACBSHR=Y for two or more IMS systems.
          - To be delivered in a follow-on SPE.
  <Delete End>
  
  <Add Begin>
        - For ACBSHR=Y:
          - One DDL CREATE job can be run in an IMSplex at
            one time.
          - If more than one DDL CREATE jobs are to be
            run concurrently in an IMSplex, submit them
            to one IMS system which serves as the master IMS
            to coordinate and serialize the DDL CREATE
            processes.
  <Add End>
  ------------------------------------------------------------
  GC19422600 System Definition
  > Members of the IMS PROCLIB data set
  > DFSDFxxx member of the IMS PROCLIB data set
  
  Under <SECTION=DDL> in DFSDFxxx PROCLIB:
  
  Add new optional parameter CREATEOPTS=(CREPGM=YES|NO|Y|N)
  in Syntax diagram.
  
  Syntax
  
  >--+--------------+--------------+----+-->
     '              '-CREPGM=YES|Y-'    '
     '-CREATEOPTS=(-+--------------+-)--+
                    '-CREPGM=NO|N--'
  
  Parameters
  
  CREATEOPTS=(CREPGM=YES|NO|Y|N)
  
  Optional parameter. CREATEOPTS=(CREPGM=YES|Y) is the default.
  
  CREATEOPTS=(Create_Options)
     Create Options to be used at DDL Auto Create|Auto Import
     processing at DDL CREATE submisson.
  
  Create_Options:
  CREPGM=YES|Y
     DDL Auto Create|Auto Import creates a runtime program
     definition of BMP type if one does not exist and
     Dynamic Resource Definition enabled at DDL CREATE
     PROGRAMVIEW processing.
     Default program descriptor is used with BMPTYPE(Y) as
     override.
  
  CREPGM=NO|N
     DDL Auto Create|Auto Import does not create a runtime
     program definition if one does not exist and Dynamic
     Resource Definition enabled at DDL CREATE PROGRAMVIEW
     processing.
  
  Notes (1) and (2):
  (1) DDL Auto Create|Auto Import automatically creates a
        runtime database definition if one does not exist and
       Dynamic Resource Definition enabled at DDL CREATE
       DATABASE processing.
       Default database descriptor is used with RESIDENT(Y)
       as override for DEDB databases.
  
  (2) Manual or IMS checkpoint triggered EXPORT DEFN command
        must be used to export runtime database definition and
        runtime program definition created by DDL Auto Import
        so they would be recovered across an IMS cold start.
  
  ------------------------------------------------------------
  GC18421900  Messages and Codes, Volume 1: DFS Messages
  
  Change DFS4712E, DFS4716E, DFS4717E.
  Add      DFS4716I.
  

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:

  PI77545 UI45595

Modules/Macros

• DFSOLC00 DFSOLC50 DFSOLC70 DFS3RU00 DFS3DL40 DFS3DL50 DFS3DL60
  DFS3DD00 DFSOLCD
  

Fix information

• Fixed component name

  IMS V14

• Fixed component ID

  5635A0500

Applicable component levels

• R400 PSY UI45595

     UP17/04/28 P F704

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.