Installing Db2 Administration Foundation

To work with and manage Db2 for z/OS® on your subsystems, you must have Db2 Administration Foundation installed and configured properly.

Before you begin

Review the software requirements for Db2 Administration Foundation. For details, see the Software requirements for Db2 Administration Foundation section.
The latest PTF for IBM Unified Management Server for z/OS must be installed.
You need to retrieve the UMS installation folder path on z/OS UNIX System Services and the config_hlq of your UMS installation data sets.
Note: This is not the installation path. It is the path of components.izp.workspaceDirectory.
The SMP/E install for Db2 Administration Foundation should be in the same SMP/E global zone as UMS.

Procedure

Shut down Zowe.
1. Go to System Display and Search Facility (SDSF) in 3270.
2. Stop ZSS cross-memory server.
```
/p <job_name>
```
  If Zowe defaults have been chosen, job_name should be replaced with ZWESISTC.
3. Stop Zowe server.
```
/p <job_name>
```
  If Zowe defaults have been chosen, job_name should be replaced with ZWESLSTC.
To perform the Db2 Administration Foundation SMP/E installation, see the Db2 Administration Foundation Program Directory. Note the z/OS UNIX location where Db2 Administration Foundation is installed.
To copy modules into libraries for Db2 experiences and to create a PARMLIB member IZPDB2PM, which are required in later steps, complete the following steps:
1. Add the experience SMP/E installation location to ZWEYAML array element components.izp.experiences:
```
experiences:
    - /uss/db2-afn/installation/directory
```
  The default location is: /usr/lpp/IBM/afn/<vrm>/bin.
2. Submit JCLLIB(IZPEXPIN). You can run IZPEXPIN multiple times if you need to install multiple experiences. It is necessary to include all your installed experiences in the components.izp.experiences array.
If you receive a return code other than 0, examine the output, correct errors, and resubmit the job.
Grant users the access to the Db2 catalog tables by completing the steps described in Granting catalog access to Db2 tables.
Start Zowe.
1. Start ZSS cross-memory server.
```
/s <job_name>,reusasid=yes
```
  If Zowe defaults have been chosen, job_name should be replaced with ZWESISTC. You must specify reusasid=yes after <job_name>.
2. Start Zowe server.
```
/s <job_name>
```
  If Zowe defaults have been chosen, job_name should be replaced with ZWESLSTC. Replace <zowe_instance> with the absolute path of your Zowe instance directory.
In a supported browser, log in to Zowe at the following URL and open IBM Unified Experience for z/OS.
```
https://<hostname>:<port>/ZLUX/plugins/org.zowe.zlux.bootstrap/web/#/
```
where <hostname> and <port> are the host name (or IP address) and port of the Zowe host computer.
Optional: Verify that Db2 Administration Foundation is correctly installed by completing the steps mentioned in Verifying the installation of Db2 Administration Foundation.

What to do next

If you want to generate the DDL of an explored object, you must configure a Workload Manager (WLM) environment for your subsystem:

Create a WLM environment by using the template in JCLLIB(WLMPROC) that points to the load libraries in <HLQ>.SIZPLLIB.
Start the WLM by using the template in JCLLIB(WLMPROC) that points to the WLM you created in step 1.
While registering the subsystem, specify the name of the WLM in the Workload Manager environment field on the Configuration tab.
Note: If the subsystem is already registered, edit the subsystem, specify the WLM environment, and click Update.