Installation panels for installing or migrating with z/OSMF

If you specify USE Z/OSMF WORKFLOW ===> YES on panel DSNTIPA1, panel DSNTILA1 opens, and the CLIST uses a modified set of installation panels.

Panel DSNTILA1

This panel opens to replace panel DSNTIPA1 when you specify USE Z/OSMF WORKFLOW ===> YES. It is a variant of DSNTIPA1, but you can select certain fields to tailor the values as variables in the z/OSMF input variable files. For more information, see DSNTIPA1 or DSNTILA1: Main panel

Start of change When USE Z/OSMF WORKFLOW ===> YES is specified, INSTALL TYPE ===> UPDATE is not supported. End of change

Panels DSNTIP`xx`

When you run the CLIST to prepare z/OSMF workflow definition files, the CLIST panels are modified so that you can select fields to tailor the values as variables in the z/OSMF input variable file.

You can find the variable names for each panel field and subsystem parameter in Directory of subsystem parameters, panel fields, and application default values.

For example, the following figure shows the DSNTIPA2 panel. You can select each of the panel fields except for DEFINE CATALOG, which is not eligible to be selected as an input variable. In this example, the CATALOG ALIAS field is selected as an input variable.

 DSNTIPA2               INSTALL DB2 - CATALOG AND DIRECTORY                      
 ===>                                                                            
                                                                                 
 Check parameters and reenter to change:                                         
   1 CATALOG ALIAS         ===> DSNCAT   Alias of VSAM catalog for Db2 subsystem 
                                         data sets                               
   2 DEFINE CATALOG        ===> YES      YES or NO                               
                                                                                 
                              ------------------ SMS -------------------         
                              DATA CLASS      MGMT CLASS      STOR CLASS         
                              ----------      ----------      ----------         
   3 DIRECTORY AND CATALOG ===>            ===>            ===>                  
     DATA                                                                        
   4 DIRECTORY AND CATALOG ===>            ===>            ===>                  
     INDEXES                                                                     
   5 COMPRESS DB2 DIR LOBS ===> NO        Compress LOB table spaces in the Db2   
                                          directory (NO or YES)                  
                                                                                 
                                                                                 
                                                                                 
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

Panel DSNTIPM1

Contains fields for specifying that data sets for the tailored jobs, the workflow definition file, and the input variable file.

Figure 1. The Install Db2 - z/OSMF artifacts configuration panel: DSNTIPM1

DSNTIPM1      MIGRATE DB2 - Z/OSMF ARTIFACTS CONFIGURATION PANEL       
===>                                                                   
                                                                       
z/OSMF artifacts allocated by the installation CLIST for edited output:
  1  WORKFLOW DEFINITION LIBRARY ===>                                  
  2  JCL TEMPLATE LIBRARY        ===>                                  
  3  PATH FOR Z/OSMF ARTIFACTS   ===>                                  
                                                                       
For migration only: input the information of the prior release:        
  4  PRIOR RELEASE SDSNLOAD LIBRARY ===>                               
  5  PRIOR RELEASE SDSNEXIT LIBRARY ===>                               
  6  PRIOR RELEASE PARAMETER MODULE ===>                               
                                                                       
                                                                       
PRESS:  ENTER to continue   RETURN to exit   HELP for more information

WORKFLOW DEFINITION LIBRARY

The data set that stores the generated workflow definition files and input variable files.

JCL TEMPLATE LIBRARY

The data set that stores the tailored jobs for the z/OSMF workflow.

PATH FOR Z/OSMF ARTIFACTS

The name of the HFS or zFS path where CLIST processing places the generated z/OSMF variable file, workflow file, and JCL templates. The default setting of blank indicates that the installation CLIST does not copy generated z/OSMF artifacts into HFS or zFS. When the field is not blank, the entry is validated to ensure that the specified path does not already exist as a file, and the user ID running the CLIST is authorized to create the specified directory and to write content into it.

PRIOR RELEASE SDSNLOAD LIBRARY

For migration only, the location of the SDSNLOAD library from the previous Db2 release. The field is blank because the CLIST cannot determine the name of this library. You must specify a value for this field.

PRIOR RELEASE SDSNEXIT LIBRARY

For migration of a Db2 subsystem or the first or subsequent members of a data sharing group, the name of the Db2 SDSNEXIT library from the previous Db2 release. This field cannot be blank. Its initial value is set as follows:

The OLDEXIT setting from the current release DSNTIDXA/XB input parameter, if it is not blank.
Otherwise, the EXIT LIBRARY field on panel DSNTIPT, which is the current release Db2 SDSNEXIT library.

You can modify this field and select this field to tailor its value as a variable in the z/OSMF variable input file. The PRIOR RELEASE SDSNEXIT LIBRARY field is only relevant when migrating a Db2 subsystem or the first or subsequent members of a data sharing group. Otherwise, this field is set to blank. You cannot modify the setting nor can you select it to tailor its value as a variable in the z/OSMF variable input file.

PRIOR RELEASE PARAMETER MODULE

For migration of a Db2 subsystem or the first member of a data sharing group only, the name of the Db2 subsystem parameter module from the previous Db2 release. This field cannot be blank.

The initial values is set based on the following settings:

The OLDZPARM setting from the current release DSNTIDXA or DSNTIDXB input parameter, unless it is blank.
The PARAMETER MODULE field on panel DSNTIPO3, which is the Db2 subsystem parameter module from the current release.

You can modify this field and select this field to tailor its value as a variable in the z/OSMF variable input file.

Panels DSNTIPM3 and DSNTIPM4

Contain fields for the subsystem parameters that do not correspond to fields on any DSNTIPxx panels. For descriptions of the parameters on these panels, see Subsystem parameters that are not on installation panels.

You can select each panel field to specify that the value is tailored as a variable and stored in the z/OSMF input variable file.

Panel DSNTIPM5

Contains parameters to tailor the following installation jobs:

DSNTIJPM
DSNTIJSA
DSNTIJSO

Like the DSNTIPxx panels, you can select each panel field to specify that the value is tailored as a variable that is stored in the z/OSMF input variable file.

Panels for choosing z/OSMF workflow steps

On the following scenario-specific panels you can choose the steps to include in z/OSMF workflows for completing Db2 13 installation or migration tasks.

Each such panel indicates the required and optional steps, and whether they are selected by default, for example:

s indicates a required step.
S indicates an optional step that is selected by default.
An empty selection field indicates an optional step that is not selected by default.

Panel DSNTIPMS

Panel DSNTIPMS is a scenario-specific panel for choosing steps for migrating a non-data sharing Db2 subsystem or the first member of a data sharing group to Db2 13.

 DSNTIPMS REVIEW STEPS IN Z/OSMF MIGRATION WORKFLOW DEFINITION (PANEL 1)        
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  S Actions to complete before migration (DSNTIJPM)¹                            
  S Take image copies of the directory and catalog (DSNTIJIB)²                  
  S Make Db2 CLISTs available to TSO and batch users (DSNTIJVC)                 
  s Stop Db2 12 activity (DSNTIJSO)                                             
  s Define the Db2 subsystem parameter module (DSNTIJUZ)                        
  s Define the Db2 application defaults module (DSNTIJUA)                       
  s Define the Db2 offline message CCSIDs module (DSNTIJUM)
  s Convert BSDS records to support 1000 logs (DSNTIJCU)                     
    Define Db2 13 to z/OS (DSNTIJMV)                                            
    Add Db2 13 address space startup JCL procedures (DSNTIJMA)                  
    Add Db2 program preparation and utilities invocation JCL procs (DSNTIJMP)   
    Add address space JCL procs for the Db2-supplied WLM environments (DSNTIJMW)
    Add environment files for the Db2-supplied Java WLM environment (DSNTIJMJ)  
  s Define system data sets (DSNTIJIN)                                          
    Define user authorization exit routines (DSNTIJEX)                  
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

Notes:

Complete this step before migration.
DSNTIJIB is tailored based on DSNTIJIC, using the Db2 12 SDSNLOAD library.

The steps on panel DSNTIPMS continue on panel DSNTIPMT:

 DSNTIPMT REVIEW STEPS IN Z/OSMF MIGRATION WORKFLOW DEFINITION (PANEL 2)        
 ===>                                                                           
                                                                                
 Select additional steps which should be included in the workflow definition:   
  s Start Db2 13 (DSNTIJSA)                                                     
  s Tailor Db2 13 catalog (DSNTIJTC)                                            
    Ensure that the catalog indexes have no problems (DSNTIJCX)                 
  s Prepare dynamic SQL program (DSNTIJTM)                                      
  s Bind SPUFI and DCLGEN and user-maintained DB activity (DSNTIJSG)            
    Set up Db2-supplied routines (DSNTIJRW)                                     
  s Configure Db2 for running SPs and user-defined routines (DSNTIJRT)          
  S Validate the installation of Db2-supplied routines (DSNTIJRV)               
  S Convert EXPLAIN tables to the current format (DSNTIJXA)                     
  s Take an image copy of the Db2 catalog (DSNTIJIC)                            
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

For more information about the steps, see Migrating a Db2 for z/OS subsystem to Db2 13 at function level 100.

Panels DSNTIPMS and DSTIPMT are shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> MIGRATE
DATA SHARING ===> NO, or DATA SHARING ===> YES with option 1 selected in the DSNTIP0B window.

Panel DSNTIPMN

Panel DSNTIPMN scenario-specific panel for choosing steps for completing the Db2 13 migration process.

The panel options differ depending on the function level that you are activating. The following configuration is used for activating function level 500.

 DSNTIPMN REVIEW STEPS IN Z/OSMF COMPLETING MIGRATION WORKFLOW DEFINITION       
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Back up the Db2 directory and catalog (DSNTIJIC)                            
    Activate Db2 function level V13R1M500 (DSNTIJA0)                            
  s Tailor the Db2 catalog (DSNTIJTC)                                           
  s Activate a Db2 function level (DSNTIJAF)                                    
    Ensure that new catalog indexes have no problems (DSNTIJX2)                 
  S Rebuild the subsystem parameter module to change APPLCOMPAT level           
     (DSNTIJUZ)                                                                 
  S Bring the APPLCOMPAT change online (DSNTIJOZ)                               
  S Rebuild the application defaults module to change SQLLEVEL setting          
     (DSNTIJUA)                                                                 
  s Install and configure Db2-supplied routines that use new function           
     (DSNTIJRT)                                                                 
  S Validate Db2-supplied routines (DSNTIJRV)                                   
  s Remove sample applications and sample schema authorizations (DSNTEJ0)       
  S Create and load sample tables (DSNTEJ1)                                     
  S Prepare and invoke program DSNTEP2 (DSNTEJ1L)                               
  S Prepare and invoke program DSNTIAUL (DSNTEJ2A)                              
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

The following configuration is used for activating function level 501.

 DSNTIPMN REVIEW STEPS IN Z/OSMF COMPLETING MIGRATION WORKFLOW DEFINITION       
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Back up the Db2 directory and catalog (DSNTIJIC)                            
  s Activate Db2 function level V13R1M500 (DSNTIJA0)                            
  s Tailor the Db2 catalog (DSNTIJTC)                                           
  s Activate a Db2 function level (DSNTIJAF)                                    
  S Ensure that new catalog indexes have no problems (DSNTIJX2)                 
  S Rebuild the subsystem parameter module to change APPLCOMPAT level           
     (DSNTIJUZ)                                                                 
  S Bring the APPLCOMPAT change online (DSNTIJOZ)                               
  S Rebuild the application defaults module to change SQLLEVEL setting          
     (DSNTIJUA)                                                                 
  s Install and configure Db2-supplied routines that use new function           
     (DSNTIJRT)                                                                 
  S Validate Db2-supplied routines (DSNTIJRV)                                   
  s Remove sample applications and sample schema authorizations (DSNTEJ0)       
  S Create and load sample tables (DSNTEJ1)                                     
  S Prepare and invoke program DSNTEP2 (DSNTEJ1L)                               
  S Prepare and invoke program DSNTIAUL (DSNTEJ2A)                              
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

For more information about the steps, see Migrating a Db2 for z/OS subsystem to Db2 13 at function level 100 , beginning with Migration step 23: Take an image copy of the Db2 13 catalog: DSNTIJIC.

DSNTIPMN is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> MIGRATE
DATA SHARING ===> NO, or DATA SHARING ===> YES with option 1 selected in the DSNTIP0B window.

Panel DSNTIPMD

A scenario-specific panel for choosing steps for migrating subsequent data sharing group members to Db2 13.

 DSNTIPMD REVIEW STEPS IN Z/OSMF MIGRATION WORKFLOW DEFINITION                  
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Stop Db2 12 activity (DSNTIJSO)
  s Convert BSDS records to support 1000 logs (DSNTIJCU)                                            
  s Define the Db2 subsystem parameter module (DSNTIJUZ)                        
    Add Db2 13 address space startup JCL procedures (DSNTIJMA)                  
  s Start Db2 13 (DSNTIJSA)                                                     
  S Create additional work file table spaces (DSNTIJTM)                         
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

For more information about the steps, see Migrating subsequent members of a group to Db2 13. The workflow supports only steps that are shown in the panel.

DSNTIPMD is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> MIGRATE
DATA SHARING ===> YES with option 2 selected in the DSNTIP0B window.

Panel DSNTIPMI

Panel DSNTIPMIis a scenario-specific panel for choosing steps to include when installing a new Db2 subsystem.

 DSNTIPMI REVIEW STEPS IN Z/OSMF INSTALLATION WORKFLOW DEFINITION (PANEL 1)     
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Define Db2 to z/OS (DSNTIJMV)                                               
  s Add Db2 for z/OS address space startup JCL procedures (DSNTIJMA)            
  s Add Db2 program preparation and utilities invocation JCL procs (DSNTIJMP)   
  s Add address space JCL procs for the Db2-supplied WLM environments (DSNTIJMW)
  s Add environment files for the Db2-supplied Java WLM environment (DSNTIJMJ)  
  s Define the ICF catalog and alias (DSNTIJCA)                                 
  s Define system data sets (DSNTIJIN)                                          
  s Define the Db2 subsystem parameter module (DSNTIJUZ)                        
  s Define the Db2 application defaults module (DSNTIJUA)                       
  s Define the Db2 offline message CCSIDs module (DSNTIJUM)                     
  s Update DDF related information in the BSDS (DSNTIJUL)                       
  s Initialize system data sets - 1 (DSNTIJID)                                  
  s Initialize system data sets - 2 (DSNTIJIE)                                  
  s Initialize system data sets - 3 (DSNTIJIF)                                  
    Define user authorization exit routines (DSNTIJEX)                          
    Connect Db2 to TSO (DSNTIJVC)                                               
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

The steps on panel DSNTIJPMI continue on panel DSNTIPMJ.

 DSNTIPMJ REVIEW STEPS IN Z/OSMF INSTALLATION WORKFLOW DEFINITION (PANEL 2)     
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Start the Db2 subsystem (DSNTIJSA)                                          
  s Tailor the Db2 catalog (DSNTIJTC)                                           
  s Activate a Db2 function level (DSNTIJAF)                                    
  s Create default storage group, define temporary work files, and              
    bind Db2 REXX Language Support (DSNTIJTM)                                   
  s Define and bind Db2 objects (DSNTIJSG)                                      
  s Setting up the Db2 core WLM environments during migration (DSNTIJRW)        
  s Installing Db2-supplied routines during migration (DSNTIJRT)                
  s Validate the installation of Db2-supplied routines (DSNTIJRV)               
    Back up the Db2 directory and catalog (DSNTIJIC)
  s Stop the Db2 subsystem (DSNTIJSO)
  s Initialize active logs 94 - n (DSNTIJL1 - DSNTIJLx)
  s Start the Db2 subsystem (DSNTIJSA)                            
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

Note:

The following steps in panel DSNTIPMJ are optional and can be selected for installing Db2 13 at function level 501:

_ Tailor the Db2 catalog (DSNTIJTC)
_ Activate a Db2 function level (DSNTIJAF)

For installing Db2 13 at function level 502 or higher, they are force selected.

For more information about the steps, see Installing Db2 13.

DSNTIPMI is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> INSTALL
DATA SHARING ===> NO, or DATA SHARING ===> YES with option 1 selected in the DSNTIP0A window.

Panel DSNTIPMA

Panel DSNTIPMA is scenario-specific panel for choosing steps for adding a Db2 subsystem to a data sharing group.

 DSNTIPMA REVIEW STEPS IN Z/OSMF INSTALLATION WORKFLOW DEFINITION               
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
    Define Db2 to z/OS (DSNTIJMV)                                               
    Add Db2 address space startup JCL procedures (DSNTIJMA)                     
  s Define system data sets (DSNTIJIN)                                          
  s Define the Db2 subsystem parameter module (DSNTIJUZ)                        
  s Update DDF related information in the BSDS (DSNTIJUL)                       
  s Initialize system data sets (DSNTIJID/DSNTIJIE/DSNTIJIF)                    
    Define user authorization exit routines (DSNTIJEX)                          
  s Start the Db2 subsystem (DSNTIJSA)                                          
  s Create default storage group, define temporary work files, and              
    bind Db2 REXX Language Support (DSNTIJTM)                                   
  S Back up the Db2 directory and catalog (DSNTIJIC)
  s Stop the Db2 subsystem (DSNTIJSO)
  s Initialize active logs 94 - n (DSNTIJL1 - DSNTIJLx)
  s Start the Db2 subsystem (DSNTIJSA)                           
                                                                                 
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

For more information about the steps, see Adding a new data sharing member. The workflow supports only steps that are shown in the panel.

DSNTIPMA is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> INSTALL
DATA SHARING ===> YES with option 2 selected in the DSNTIP0A window.

Panel DSNTIPMV

Panel DSNTIPMV is a scenario-specific panel for choosing steps to include when running installation verification jobs.

 DSNTIPMV   REVIEW STEPS IN Z/OSMF IVP WORKFLOW DEFINITION                      
 ===>                                                                           
                                                                                
 Select the IVP steps which should be included in the workflow definition:      
  _ Remove sample applications and sample schema authorizations (DSNTEJ0)       
  S Create and load sample tables (DSNTEJ1)                                     
  S Prepare and invoke program DSNTEP2 (DSNTEJ1L)                               
  S Prepare and invoke program DSNTIAUL (DSNTEJ2A)                              
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

For more information about the steps, see Verifying successful Db2 13 installation or migration with sample applications.

DSNTIPMV is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> INSTALL or MIGRATE
DATA SHARING ===>

Panel DSNTIPMF

Panel DSNTIPMF is a scenario-specific panel for choosing steps to include when activating a Db2 function level.

 DSNTIPMF REVIEW STEPS IN Z/OSMF ACTIVATION WORKFLOW DEFINITION                 
 ===>                                                                           
                                                                                
 Select the steps which should be included in the workflow definition:          
  s Back up the Db2 directory and catalog (DSNTIJIC)                            
  s Tailor the Db2 catalog (DSNTIJTC)                                           
  s Activate a Db2 function level (DSNTIJAF)                                    
    Ensure that new catalog indexes have no problems (DSNTIJX2)                 
  S Rebuild the subsystem parameter module to change APPLCOMPAT level           
     (DSNTIJUZ)                                                                 
  S Bring the APPLCOMPAT change online (DSNTIJOZ)                               
  S Rebuild the application defaults module to change SQLLEVEL setting          
     (DSNTIJUA)                                                                 
                                                                                
                                                                                
 PRESS:  ENTER to continue   RETURN to exit   HELP for more information

Note:

If the current function level is V13R1M501 or higher, the following step cannot be selected in panel DSNTIPMF:

Ensure that new catalog indexes have no problems (DSNTIJX2)

Otherwise, it can be selected.

For more information about the steps, see Activating Db2 13 function level 500 or higher

This panel is shown only when you specify the following values on panel DSNTILA1:

USE Z/OSMF WORKFLOW ===> YES
INSTALL TYPE ===> ACTVATE
DATA SHARING ===>

DSNTIPMU

Contains fields for specifying source and target workflow input variable files, for use when creating input variable files for installing or migrating members of a data sharing group after the first one.