DB2

1. Db2 13 for z/OS Install
and Migration Using
z/OSMF Workflows
Sueli Almeida,
IBM Silicon Valley Lab
2023 NEDb2UG Tech
Conference

2. Agenda
• Objectives
• Some background on Db2 13 and z/OSMF
• Current z/OSMF support for Db2
• Migration
• Install
• Provisioning template
• Create, review, execute z/OSMF workflows to migrate to Db2 13
• Next steps
• Summary

3. Objectives
• Automate task management for migrating Db2 for z/OS
subsystems and data sharing groups
• Provide "new user experience" for lifecycle operations for Db2
for z/OS to compensate for general weakening of traditional z/OS
skills
• Standardize migration procedure for all Db2 subsystems

4. Long term objective: simplified migrations
We build artifacts to migrate
that system
• Traditional jobs
• z/OSMF artifacts
• Build automation process
z/OSMF
Other automation method
• Other artifacts?
Online migration enhancement in Db2 13
‒ Display blockers/blocking threads
We discover all configuration
values for that specific system
• Eliminates need to navigate thru
a multitude of migration panels
• Prompts you values when
potential changes are needed for
this migration
You indicate which Db2
subsystem you would like to
migrate
You execute migration
exploiting online migration
enhancements
Options:
• Automated
• Manual invocation

5. Db2 13 simpler installation & migration
• Fewer zparms and improved defaults or allowable ranges
• Migration only from V12R1M510 with validation of migration readiness
• V13R1M100 introduces no new external function
• No catalog changes in V13 until after V13R1M500 to minimize risk and
complexity
• V13R1M500 supports some new features (without catalog changes)
• V13R1M501 supports all new features

6. z/OSMF support for Db2 simpler installation & migration
• Starting with Db2 11, Db2 provides support for customers to create their own
z/OSMF artifacts through the Db2 installation CLIST
‒ z/OSMF workflow definition
‒ z/OSMF variable input file
‒ Tailored JCL templates
• Published Db2 12 provisioning template that can be registered as Software
Services under z/OSMF Cloud Provisioning
‒ Orchestration on provisioning / deprovisioning based on tenant done by z/OSMF Cloud Provisioning

7. What is z/OSMF
• IBM z/OS Management Facility (z/OSMF) is a standard feature since z/OS
V2.2
• z/OSMF is a webserver for z/OS management applications
• Integrated lightweight application server, using WebSphere Application
Server Liberty profile
• User interface through a browser
• Security is implemented using standard z/OS SAF-based authorization
• Provides integrated applications (tasks) with capability to add additional
plug-ins
• Provides public RESTful services for z/OSMF and z/OS resources

8. Logging into z/OSMF

9. z/OSMF Welcome page prior to z/OS 2.5

10. z/OSMF now a desktop from z/OS 2.5

11. Db2 z/OSMF workflows in a nutshell

12. Executing the Db2 installation CLIST

13. Executing the Db2 installation CLIST (continued)

14. Executing the Db2 installation CLIST (continued)

15. Executing the Db2 installation CLIST (continued)

16. Executing the Db2 installation CLIST (continued)

17. Executing the Db2 installation CLIST (continued)
Select the steps that are
needed for your
migration process

18. Executing the Db2 installation CLIST (continued)

19. Executing the Db2 installation CLIST (continued)

20. Executing the Db2 installation CLIST (continued)

21. Db2 generated z/OSMF workflow artifacts
• DSNTIWMS + DSNTIVMS: z/OSMF workflow definition and variable
input files to migrate Db2 to V13R1M100
• Contains all the selected steps from DSNTIPMS and DSNTIPMT panels
• DSNTIWMN + DSNTIVMN: z/OSMF workflow definition and variable
input files to activate Db2 to V13R1M5xx
• Contains all the selected steps from DSNTIPMN panel

22. • The tailored jobs are used during workflow step execution
Note: ZFS path contains all the artifacts (workflow definition, variable input files and tailored jobs)
Db2 generated z/OSMF workflow artifacts
(continued)

23. Creating a workflow
instance

24. Using the PDS data sets
Using the ZFS files
Creating a
workflow
instance
(continued)

25. Creating a
workflow
instance
(continued)

26. Reviewing
the steps
of the
workflow

27. Getting
ready
to execute
the
workflow

28. Executing the
workflow,
automatically

29. Executing the
workflow,
manually

30. Reviewing workflow execution progress

31. Notifications & job execution status

32. Standardizing your workflow

33. Editing variable input file with z/OSMF 2.5

34. Editing variable input file with z/OSMF 2.5
(continued)

35. Editing variable input file with z/OSMF 2.5
(continued)

36. … Auto-discovery Phase 3
… Batch CLIST support for Install
… Db2 13 provisioning template update
… Auto-discovery Phase 1 & 2
… more simplification
4Q2016
• Db2 subsystem provisioning workflow
1Q2023
• Generate migration artifacts in background
2Q2020
• Db2 installation CLIST support for Db2 data sharing provisioning software
service template
2019
• Db2 data sharing provisioning software service template at GitHub server
• Db2 installation CLIST support for Db2 non-DS provisioning software service template
• Db2 non-DS subsystem provisioning software service template at GitHub server
2013
• Db2 subsystem installation and migration workflows
1H2022
• Db2 13 migration & installation with z/OSMF
Db2 z/OSMF support progress

37. GENERATING DB2 MIGRATION ARTIFACTS BY
RUNNING INSTALL CLIST IN BACKGROUND
Available soon

38. Use case 1: Customer has a valid and current DSNTIDXx file
Generating Db2 Migration Artifacts by Running Install CLIST in Background
• Input:
• Valid DSNTIDXx member from previous release migration or installation
• Override file for CLIST-generated parameter default values (NEW)
• DSNTIDXA
• Output: Migration artifacts
• Traditional to traditional <prefix>.SDSNSAMP, Output DSNTIDXx member
• Traditional to z/OSMF workflow <prefix>.SDSNMFSA, <prefix>.SDSNSAM2, Output DSNTIDXx member
• z/OSMF workflow to z/OSMF workflow <prefix>.SDSNMFSA, <prefix>.SDSNSAM2, Output DSNTIDXx member

39. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Use case 1 – 2023Q1 Migration artifacts
=> Valid and current previous release
migration DSNTIDXx file
DSNTIDXx
Db2
V12R1M510
DSNTXAZP
DSNTIDXx
’
Peter, Db2 sysprog
current Zparms
&
bufferpools

40. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Use case 1 – 2023Q1 Migration
artifacts
=> Valid and current DSNTIDXx file
(PH52482 and
PH52882 for Db2 VUE)
What is new
• Program DSNTIFMT
‒ Formats DSNTINST (foreground mode) into DSNTINSB
(background mode)
• Sample job DSNTIJBC
‒ Executes DSNTIFMT and starts the execution of
DSNTINSB
• Override files DSNTIDOM, DSNTIDON,
and DSNTIDOA
‒ Input to DSNTIJBC job step which runs DSNTINSB, that
overrides parameters values, when needed for Db2
subsystem migration, or function level activation
• Override file DSNTIDVU
‒ Additional input for DSNTIJBC, with the notice and
acceptance of OTC license

41. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Use case 1
The flow:
41

42. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Configuring DSNTIJBC
//DSNTIJBC JOB ,‘SYSADM’,MSGCLASS=H,CLASS=A,
// REGION=4M,MSGLEVEL=(1,1),NOTIFY=&SYSUID,
// USER=&SYSUID
//*
//* DESCRIPTIVE NAME = PREPARE AND RUN DB2 INSTALLATION CLIST IN
//* BATCH MODE
. . .
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//* STEP01 Run PGM=DSNTIFMT to reformat DSNTINST for batch use
//* -> Output member is called DSNTINSB
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//STEP01 EXEC PGM=DSNTIFMT
//STEPLIB DD DSN=DSND10.SDSNLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//INPUT DD DSN=DSND10.SDSNCLST(DSNTINST),DISP=SHR
//OUTPUT DD DSN=&&INSTALL(DSNTINSB),DISP=(MOD,PASS),
// UNIT=SYSDA,SPACE=(TRK,(4,2,4)),
// DCB=(RECFM=FB,LRECL=80),BLKSIZE=3120,RECFM=FB)
//SYSIN DD *
//*
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//* STEP01G Print DSNTINSB
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//STEP01G EXEC PGM=IEBGENER
//SYSIN DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD DISP=(OLD,PASS),DSN=&&INSTALL(DSNTINSB)
//SYSUT2 DD SYSOUT=*
//*
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//* STEP02 Run DSNTINSB
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//STEP02 EXEC BATISPF,COND=(4,LT)
//SYSTSIN DD *
ISPSTART CMD(%DSNTINSB +
OVERPARM(IVTD10.E21116.S21117.MIGRATE.TRTOTR(USERIDOM)) +
) BREDIMAX(1)
//*

43. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Configuring override parameter file
(DSNTIDOM – Required parameters)
IVTD10.E21116.S21117.MIGRATE.TRTOTR(USERIDOM)
Part1: Required parameters
BATCH_MODE=YES
USE_ZOSMF_WORKFLOW=YES
INSTALL_TYPE=MIGRATE
MIGRATE_INPUT_DATA_SET=DSNC10.CLIST.MEMBERS(ZCDSMEM1)
DATA_SHARING=YES
MIGRATE_FIRST_GROUP_MEMBER=YES
DB2_SMPE_LIBRARY_NAME_PREFIX=DSND10.APR1
DB2_SMPE_LIBRARY_NAME_SUFFIX=
INSTALL_DATA_SET_PREFIX=IVTD10B.ZDMIGM1
INSTALL_DATA_SET_SUFFIX=
DEFAULT_PARAMETER_INPUT_MEMBER=DSNTIDXA
PARAMETER_OUTPUT_MEMBER=ZDMIGM1
TARGET_FUNCTION_LEVEL=V13R1M502
CONSOLE_NAME=RACF000
Notes:
- Parameters from USE_ZOSMF_WORKFLOW to PARAMETER_OUTPUT_MEMBER
correspond to the fields on the Db2 installation CLIST panel DSNTIPA1/LA1
- Parameters TARGET_FUNCTION_LEVEL and CONSOLE_NAME are only required
if USE_Z/OSMF_WORKFLOW is YES

44. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
Configuring override parameter file
(DSNTIDOM – Optional parameters)
IVTD10.E21116.S21117.MIGRATE.TRTOTR(USERIDOM)
Part2: Optional parameters
INSTALL_IC_PREFIX=IVTD10
INSTALL_DS_PREFIX=IVTD10
TEMP_CLIST_LIBRARY=IVTD10B.ZDMIGM1.SDSNTEMP
SAMPLE_LIBRARY=IVTD10B.ZDMIGM1.SDSNSAMP
CLIST_LIBRARY=IVTD10B.ZDMIGM1.SDSNCLST
APPLICATION_DBRM=IVTD10B.ZDMIGM1.DBRMLIB
APPLICATION_LOAD=IVTD10B.ZDMIGM1.RUNLIB
DECLARATION_LIBRARY=IVTD10B.ZDMIGM1.SRCLIB
APPL_COMPAT_LEVEL=V13R1M503
PRECOMPILER_SQL_LEVEL=V13R1M503
JDBC_SQLJ_ENV_VAR_DIR=/usr/lpp/db2/db2c10/jdbc
DB2_BASE_JAVA_DIR=/var/db2zosmf/pdm/base
JAVA_ENV_DATA_SET=IVTD10B.ZDMIGM1.JAVAENV
JAVA_ENV_VAR_FILE=/var/db2zosmf/pdm/base/classes/dsn1envfile.txt
JVM_PROPERTIES_FILE=/var/db2zosmf/pdm/base/dsn1jvmsp
WORKFLOW_DEFINITION_LIBRARY=IVTD10B.ZDMIGM1.SDSNMFSA
JCL_TEMPLATE_LIBRARY=IVTD10B.ZDMIGM1.SDSNSAM2
PATH_FOR_ZOSMF_ARTIFACTS=/var/db2zosmf/zdmigm1/batch
Notes:
- There will be no warning that the data sets contents are going to be overwritten
- TEMP_CLIST_LIBRARY
- SAMPLE_LIBRARY
- CLIST_LIBRARY
- WORKFLOW_DEFINITION_LIBRARY
- JCL_TEMPLATE_LIBRARY
- PATH_FOR_ZOSMF_ARTIFACTS
- Override parameter names are very similar to the corresponding field names in
the Db2 installation CLIST panels

45. Generating Db2 Migration Artifacts by
Running the Install CLIST Background
for
Db2 Value Unit Edition(VUE) systems
//DSNTIJBC JOB ,‘SYSADM’,MSGCLASS=H,CLASS=A,
// REGION=4M,MSGLEVEL=(1,1),NOTIFY=&SYSUID,
// USER=&SYSUID
//*
//* DESCRIPTIVE NAME = PREPARE AND RUN DB2 INSTALLATION CLIST IN
//* BATCH MODE
. . .
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//* STEP02 Example of running DSNTINSB in MIGRATE mode
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//STEP02 EXEC BATISPF,COND=(4,LT)
//SYSTSIN DD *
ISPSTART CMD(%DSNTINSB +
OVERPARM(<prefix>.SDSNSAMP(USERIDOM)) +
OTCLPARM(<prefix>.SDSNSAMP(USERIDVU)) +
) BREDIMAX(1
//*
DSNTIDVU
OTC_LICENSE_USAGE=
LICENSE_TERMS_ACCEPTED=

46. AUTO DISCOVERY OF CONFIGURATION
PARAMETERS SUPPORT
46
Next steps …

47. Auto Discovery Support
Use case 2 – Db2 migration input variables
=> Customer does not have a current
or valid DSNTIDXx file
Background
• DSNTIDXA
‒ Number of parameters : 1072
‒ Number of zparms + buffer pool parms : 513
(DSNTXAZP)
‒ Number of parameters to be discovered: 559 *
* 8 parameters to be removed
• Auto Discovery support
‒ Phase 1 - Number of parameters to be processed: 387
‒ After auto discovery phase 1, remaining number of
parameters still to be discovered: 164.

48. Auto Discovery Support, continued
Use case 2 – Db2 migration input variables
=> Customer does not have a current
or valid DSNTIDXx file
• Phase 1:
• DDF and LOG related parameter settings
• Routines settings (Access control list, Package
owner, WLM application environment)
• Authorization ID preferences for Db2-supplied
routines, migration jobs and IVP jobs
• Phase 2:
• IRLM related parameter settings
• Db2 object sizes
• Phase 3:
• Host language data set names
• z/OS product libraries
• …

49. Auto Discovery Support, continued
Use case 2 – Db2 migration input variables
=> Customer does not have a current
or valid DSNTIDXx file
DSNTIDXx
Db2
V12R1M510
DSNTXAZP+
DSNTIDXx
’
Peter, Db2 sysprog
current zparms,
buffepools,
DDF and logs,
Db2 supplied routines settings
authIDs preferences:
Db2 supplied routines and
IVP jobs

50. Summary
• The importance of continuing simplifying Db2 migration and install
processes
• Brief Db2 13 and z/OSMF overview
• What & how to exploit what is available to migrate to Db2 13
• Next steps on Db2 z/OSMF support
• Future readings
• Db2 13 redbooks
• Engage with Db2 for z/OS Customer Advisory Council (CAC)
• Important links

51. Further reading

52. Important links
• Db2 13 - Installation and migration - Automating Db2 installation
or migration with z/OS Management Facility
• Blog soon to be published
• z/OS Management Facility (z/OSMF) Configuration Guide
• z/OSMF Configuration Overview and Recommendations
• ServerPac Installation using z/OSMF
• Software Update with z/OSMF

53. IBM Db2 13 Redbook now available!
Take a read through the
new IBM RedbookS on
Db2 13 for z/OS and
its ecosystem
Get your copy at:
https://www.redbooks.ibm.com/abstracts/sg248527.html
https://www.redbooks.ibm.com/abstracts/sg248536.html

54. Speaker: Sueli Almeida
Company: IBM Silicon Valley Lab
Email Address: sueli@us.ibm.com
Thank You
2023 NEDb2UG Tech
Conference

55. More on z/OSMF usage
z/OSMF Software Management Installation of ServerPac
• Installation method uses a simplified web-based GUI replacing the ISPF CustomPac Dialog
• Manages allocation and placement of data sets, cataloging, and deployment in z/OSMF Software Management
• Customization and verification is done in z/OSMF Workflow
• IBM has been delivering ServerPac in Portable Software Instance format (CD)
• IMS, Db2, and CICS Transaction Server and associated products, all can be installed with z/OSMF today
• Consistent packaging and installation method as other leading software vendors
• z/OS 2.5 ServerPac
• Is available in Portable Software Instance format, and only that format as of July 10, 2022.
• All ServerPacs must now be installed with z/OSMF on the driving system
• This includes IMS, Db2, CICS, MQ, and program products
• To learn more about z/OSMF ServerPac Install and try a sample Portable Software Instance to be
familiar with the install, see the ServerPac Installation using z/OSMF web page
Note: CBPDO remains available unchanged

56. More on z/OSMF usage (continued)
z/OSMF Software update task (CD) with APAR PH28412 on z/OS V2.3 & V2.4
• GUI provides a simplified and guided process to install any SMP/E-packaged PTF, regardless of
software vendor
• Enables you to review and track SMP/E HOLDDATA in an orderly fashion. All installation output is
saved so you can review it at any time
• Supports three update use cases:
1. Corrective. Install individual software updates to fix a problem
2. Recommended. Install all software updates that are recommended by software vendors. The IBM recommendations are
those designated as IBM Recommended Service Upgrade (RSU) fixes
3. Functional. Install software updates to support new hardware, software, or functions identified with a SMP/E FIXCAT
• Existing traditional methods to install SMP/E-packaged software updates (batch JCL jobs) are still
possible, but z/OSMF Software Upgrade is expected to provide a simpler experience requiring lesser
SMP/E skill
• To learn more about z/OSMF Software Update, including helpful instructions on how to get started,
see the Software Update with z/OSMF web page