Start of change

Creating artifacts for provisioning Db2 by running the installation CLIST

Start of changeYou can run the installation CLIST to create artifacts for provisioning Db2 subsystems and data sharing groups. End of change

Before you begin

Apply the PTFs for the following APARs:

  • Start of changePH19751End of change
  • PH09857

Configure z/OSMF Version 2.3 with APAR PH09130 or higher.

About this task

With IBM Cloud® Provisioning and Management for z/OS®, you can create services for provisioning Db2 for z/OS subsystems and data sharing groups. Certain artifacts are needed for creating the services, and one way to create the artifacts is by running the Db2 installation CLIST.

For an overview of process for creating services, see IBM Cloud Provisioning and Management for z/OS .

Tip: The CLIST approach supports more customization for the provisioned Db2 subsystem. However, you can also create artifacts for provisioning Db2 in a standard configuration by downloading and customizing the sample Db2 software services template. For more information, see Creating services for provisioning Db2 for z/OS (DBaaS).

Procedure

To create artifacts for services that provision Db2 subsystems by running the installation CLIST, complete the following steps:

  1. Generate the required JCL jobs and input files. You can run the Db2 installation CLIST in interactive mode to generate the files. See steps 1- 6 in Generating tailored installation, migration, or function level activation jobs by running the Db2 installation CLIST in interactive mode.
  2. In the CLIST panel session, specify on panel DSNTIPA1 that you are preparing artifacts for provisioning Db2 subsystems by specifying the following options:
    • USE Z/OSMF WORKFLOW ==> YES
    • INSTALL TYPE ===> PROVISION
    • Start of changeDATA SHARING ===> NO or YESEnd of change
    • Set the PREFIX and SUFFIX fields to the values that you used when you allocated the Db2 libraries by using job DSNALLOC.
    • INPUT MEMBER NAME ===> DSNTIDXC The default name is DSNTIDXC. You can also specify your own name. However, do not specify DSNTIDXA or DSNTIDXB.
    • Start of changeOUTPUT MEMBER NAME ===> Specify a name other than DSNTIDSA, DSNTIDVB, DSNTIDXA, DSNTIDXB, or DSNTIDXC.End of change
    When you specify these options, the PROVISIONING PREFERENCES AND DATA SET NAMES panel DSNTIPAP is shown next in the CLIST panel session.
  3. On panel DSNTIPAP, specify the preferences for provisioning Db2 subsystems.
    For details, see DSNTIPAP: Provision DB2 - provisioning preferences and data set names.
  4. On panel DSNTIPG, specify the user ID that executes the provisioning workflow in the PROVISION EXEC ID field.
    This value populates the AGEXECID input variable in DSNTIVIN.
  5. Complete the rest of the CLIST panel session, as described in The Db2 installation CLIST panel session.
    The CLIST panel session is modified for the provisioning process. For example, certain z/OSMF workflow steps are force selected or deselected, some fields are preset with values generated in the provisioning process and protected, and all fields that are associated with z/OSMF variables are force selected.

Results

The CLIST generates the following output data sets. The generated z/OSMF artifacts are always written to the zFS path specified in the field PATH FOR Z/OSMF ARTIFACTS on panel DSNTIPM1. This field is mandatory for provisioning.

prefix.NEW.SDSNMFSA
A new data set that contains the z/OSMF variable input and workflow definitions, and the following new z/OSMF files that provide services for the provisioned Db2 subsystems. Except where otherwise noted, all files are common for provisioning both Db2 data sharing and stand-alone Db2 subsystems.
ACTIONS (DSNACTON)
Describes the actions that can be performed on a provisioned Db2 system.
DSNDDDF
Describes the workflow for displaying DDF information of a provisioned Db2 system.
DSNDGRPD
Describes the workflow for displaying group information of a provisioned Db2 system.
Start of changeDSNDEPRV (standalone only)End of change
Describes the workflow for deprovisioning a standalone Db2 subsystem.
Start of changeDSNDEPRC (data sharing only)End of change
Start of changeDescribes the workflow for deprovisioning a provisioned Db2 data sharing group.End of change
DSNOPENT
Describes entities for the workflow to enable optional features, such as JDBC, ODBC, Db2 REST Services, on a provisioned Db2 system. This file contains the steps that are shared/included in the DSNOPTFT, DSNTIWIN and DSNTIWPC workflow definition files.
DSNOPTFT
Describes the workflow to enable optional features, such as JDBC, ODBC, Db2 REST Services, on a provisioned Db2 system.
DSNSTART
Describes the workflow to start provisioned Db2 systems.
DSNTSTOP
Describes the workflow to stop provisioned Db2 systems.
DSNTIVIN
Describes the variables that define a standalone Db2 subsystem or the first member of a Db2 data sharing group. This is the file that the CLIST normally generates when installing the second or subsequent members of a data sharing group.
Start of changeDSNTIVIA (data sharing only)End of change
Start of changeAn input variable file that describes the variables that defines additional Db2 data sharing members after the first. This is the file that the CLIST normally generates when installing the second or subsequent members of a data sharing group.End of change
Start of changeDSNTIWIN (standalone only)End of change
Start of change Describes the workflow to provision a standalone Db2 subsystem.End of change
Start of changeDSNTIWPC (data sharing only)End of change
Start of changeDescribes the workflow to provision a data sharing group with at least 2 members. This workflow contains steps for installing an n-way data sharing system, where n > 1. It is basically a merge of DSNTIWIN (the workflow for provisioning a stand-alone Db2 subsystem) and DSTIWIA (the workflow for installing the second or subsequent member of a data sharing group).End of change
prefix.NEW.SDSNSAM2
The JCL templates for z/OSMF.

The CLIST generates the following mandatory steps for provisioning stand-alone Db2 subsystems. The new steps s00INSSS to s00DEFSS are added at the beginning, and stepJTU is added at the end before dsnOpEnt, of the DSNTIWIN workflow, which is the workflow generated when installing a stand-alone Db2 subsystem.

  1. s00INSSS — Instantiate and validate the Db2subsystem identifier ssid. (DSNTRSSN)
  2. s00SETVP — Set values for variables whose values are generated at provisioning time. (setVariable)
  3. s00PORT — Acquire Db2 ports from the network resource pool. (REST API)
  4. s00PORTRES — Acquire a TCP/IP port that is used to process requests for two-phase commit resynchronization.
  5. s00ALIAS — Define aliases for the instantiated Db2 system. (DSNTIJDA)
  6. s00PPROC — Allocate private procedure library for the instantiated Db2 system. (DSNTIJPP)
  7. s00SETVL — Assign values to BSDS, active and archive logs variables. (setVariable)
  8. s00IRLM — Assign IRLM SSID based on the instantiated Db2 system SSID. (Inline shell-JCL)
  9. s00DEFSS — Define the instantiated Db2 and IRLM systems to z/OS. (DSNTIJMD)
  10. stepJTU -- Create and grant usage of Db2 storage group for user data (DSNTIJTU)
End of change