PH02971: NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All Db2 12 for z/OS users of job DSNTIJMV                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Placement of multiple tasks in job                           *
  * DSNTIJMV is convenient for Db2                               *
  * installation and migration but not                           *
  * for service and updates.                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply corrective PTF when available                          *
  ****************************************************************
  Installation job DSNTIJMV performs multiple tasks:
  - Updating the system parmlib to define Db2 and IRLM to MVS
  - Adding the address space startup JCL procs for Db2 (and
  optionally those for IRLM) to the system proclib
  - Adding the Db2 programming language JCL procs
  - Adding the address space startup JCL procs for the Db2-
  supplied WLM environments to the system proclib
  - Creating environment files for the Db2-supplied Java WLM
  environment
  
  This APAR splits Db2 12 installation job DSNTIJMV into the
  following task-specific jobs:
  - DSNTIJMV: For defining Db2 and IRLM to MVS
  - DSNTIJMA: For adding the Db2 and IRLM address space startup
  procs to the system proclib
  - DSNTIJMP: For copying the Db2 language procs to the system
  proclib
  - DSNTIJMW: For adding the address space startup procs for
  the Db2-supplied WLM environments to the system proclib
  - DSNTIJMJ: For creating the environment files for the Db2-
  supplied Java WLM environment
  
  There are a number of motives for the change, including:
  - Addressing separation of duties conflicts
  - Offering more granular control (without manual editing) of
  what tasks to perform when installing or migrating Db2
  - Facilitating automation of Db2 installation, migration,
  and provisioning
  
  When installing a Db2 12 subsystem or the first member of a
  data sharing group, run all five of the above jobs: DSNTIJMV,
  DSNTIJMA, DSNTIJMP, DSNTIJMW, and DSNTIJMJ.  When enabling
  data sharing or installing the second or subsequent menber of
  a Db2 12 data sharing group, run only DSNTIJMV and DSNTIJMA.
  
  When migrating a Db2 12 subsystem including the first member
  of a data sharing group, run all five jobs: DSNTIJMV,
  DSNTIJMA, DSNTIJMP, DSNTIJMW, and DSNTIJMJ.  When migrating
  the second or subsequent member of a data sharing group,
  run only job DSNTIJMA.  Note that updating the IEFSSNxx
  member of SYS1.PROCLIB to define the Db2 and IRLM subsystems
  to z/OS is no longer performed as part of migrating Db2.
  
  None of these jobs is needed in order to activate a
  function level on Db2 12 or to update a Db2 subsystem or
  data sharing member.
  
  Note: Currently, data sharing enablement and update mode are
  not supported by the Db2 z/OSMF processes.
  

Problem conclusion

Temporary fix

Comments

• z/OSMF panel changes:
  ---------------------
  This APAR modifies installation panels used by the Db2 12
  z/OSMF installation and migration processes. In the
  following Db2 CLIST panels:
    o DSNTIPMI (Steps for installing a subsystem or the
                first member of a data sharing group)
    o DSNTIPMA (Steps for adding a data sharing member)
    o DSNTIPME (Steps for enabling data sharing)
      -> Note: Currently, data sharing enablement is not
               supported by the Db2 z/OSMF processes.
    o DSNTIPMS (Steps for migrating a subsystem or the
                first member of a data sharing group)
    o DSNTIPMD (Steps for migrating a second or subsequent
                member of a data sharing group)
  the step for running job DSNTIJMV is split into steps for
  running one or more of jobs DSNTIJMV, DSNTIJMA, DSNTIJMP,
  DSNTIJMW, and DSNTIJMJ, as indicated in Table A below.
  
  z/OSMF workflow changes:
  ------------------------
  In the following z/OSMF workflow definition files:
    o DSNTIWIN (Installing a subsystem or the first DSG member)
    o DSNTIWIA (Adding a data sharing group member)
    o DSNTIWIE (Enabling data sharing)
      -> Note: Currently, data sharing enablement is not
               supported by the Db2 z/OSMF processes.
    o DSNTIWMS (Migrating a subsystem or the first DSG member)
    o DSNTIWMD (Migrating a second or subsequent DSG member)
  the step for running job DSNTIJMV is split into steps for
  running one or more of jobs DSNTIJMV, DSNTIJMA, DSNTIJMP,
  DSNTIJMW, and DSNTIJMJ, as indicated in Table A below.
  
  Table A. Correspondence of jobs/steps and panels/workflows
  -------------------------------------------------------------
  |         |                    CLIST Panel                  |
  |         |          zOSMF Workflow Definition File         |
  -------------------------------------------------------------
  |         |DSNTIPMI |DSNTIPMA |DSNTIPME |DSNTIPMS |DSNTIPMD |
  |  Step   |DSNTIWIN |DSNTIWIA |DSNTIWIE |DSNTIWMS |DSNTIWMD |
  -------------------------------------------------------------
  |DSNTIJMV |    X    |    X    |    X    |    X    |         |
  |DSNTIJMA |    X    |    X    |    X    |    X    |    X    |
  |DSNTIJMP |    X    |         |         |    X    |         |
  |DSNTIJMW |    X    |         |         |    X    |         |
  |DSNTIJMJ |    X    |         |         |    X    |         |
  -------------------------------------------------------------
  
  See IBM Knowledge Center for more information:
  http://ibm.biz/Db2-12-APARs (See "DSNTIJMV split into
  task-specific installation jobs")
  

APAR Information

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

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

  UI59805

Modules/Macros

• DSNTIJMA DSNTIPMA DSNTINMF DSNTIPMD DSNTIJMJ DSNTIPME DSNTIPMI
  DSNTIVMD DSNTIJMP DSNTIWMD DSNTIVIA DSNTINST DSNTIWIA DSNTIVIE
  DSNTIWIE DSNTIJMV DSNTIJMW DSNTIPMS DSNTIVMN DSNTIWMN DSNTIVIN
  DSNTIVMS DSNTIWIN DSNTIWMS DSNTINS1 DSNTINM1
  

Fix information

• Fixed component name

  DB2 OS/390 & Z/

• Fixed component ID

  5740XYR00

Applicable component levels

• RC10 PSY UI59805

     UP18/11/29 P F811

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.