Installing and configuring

This chapter describes the tasks you need to complete to download, install, and configure the agent for z/OS software on the target z/OS system.

You install and configure the agent for z/OS in the z/OS system. As soon as it is configured, the agent automatically links with the dynamic workload broker component of HCL Workload Automation (defined during the configuration process) through the HTTP or HTTPS protocols.

Installation check-list

The following table summarizes the installation and setup tasks for the agent for z/OS:
Table 1. Checklist for installing the agent for z/OS
Task Description
1 Load the agent for z/OS software
2 Run the EELINST installation aid
Run EELINST for every instance of the agent for z/OS that you want to create as soon as the agent for z/OS software is loaded. It helps you to:
  • Create the sample job JCL to generate tailored samples from the EELINST dialog.
  • Allocate data sets for the agent.
  • Add SSL certificates.
  • Define initialization statements creating members in the parameter library (which is identified by the EELPARM DD statement in the agent for z/OS started task).
3 Add SMF and JES event tracking exits
Note: Run this step if you do not already have an HCL Workload Automation for Z tracker running in the system. If you have it, you are required to apply the exits related to the product latest version.However, if you are running in a JES3 environment, you must always apply the exit IATUX09, which is provided with the agent for z/OS.
4 Update SYS1.PARMLIB
Run the following tasks if they apply to your installation:
  • Define the agent for z/OS subsystem (IEFSSNnn).
  • Authorize the agent for z/OS load module library (IEAAPFnn or PROgnn).
  • Update dump-content definitions.
  • Update the z/OS link-library definition (LNKLSTnn).
  • Update SMF parameters (SMFPRMnn). Run this step only if you do not already have an HCL Workload Automation for Z tracker running in the system.
  • Choose whether to start the agent automatically (COMMNDnn).
5 Update RACF for the agent for z/OS started task
6 Set up the SSL environment
Do the following:
  1. Create as many private keys, certificates, and trusted certification authority (CA) chains as you plan to use in your network.
  2. Specify the SSL keywords in the HTTPOPTS initialization statement.
7 Update SYS1.PROCLIB

Create a JCL procedure for the address space.
8 Complete the installation
  1. IPL the system where you have installed the agent.
  2. Verify the installation.