HCL Workload Automation, Version 9.4

Run the EELINST installation aid

EELINST is a CLIST-driven ISPF dialog that helps you setup an agent for z/OS instance. Set EELINST up as soon as the agent for z/OS software is installed.

EELINST helps you with the installation by:
  • Building the batch-job JCLs which are tailored to your requirements and that you can use for a complete installation.
  • Creating the data sets used for your agent for z/OS instance.
  • Defining initialization statements in the parameter library (EELPARM).
  • Loading the default SSL certificates on the RACF® keystore database.
  • Listing the remaining manual steps required to complete the installation.

Setting up the EELINST installation aid

EELINST reads skeleton JCLs from the SEELSAMP library, tailors the JCLs, and then writes the tailored JCLs to an output library that you specify. The components of EELINST reside in these libraries:
SEELCLIB
CLIST to drive the dialog
SEELPNL0
EELINST panels
SEELSAMP
Sample JCL
To be able to run EELINST, allocate these libraries to the DD statements in your TSO session:
  • SEELCLIB to SYSPROC
  • SEELPNL0 to ISPPLIB
  • SEELSAMP to ISPSLIB

Running EELINST

To invoke EELINST, enter the EELINST TSO command from an ISPF environment. This panel is displayed:

         Welcome to the HCL Workload Automation distributed 
               agent for z/OS Installation


The installation program can assist you with the following operations:


ˆ Building a batch-job JCL that is tailored to your requirements and that can be 
  used for a complete installation.

ˆ Creating the data sets used for your agent for z/OS address space.

ˆ Defining initialization statements in the parameters library (EELPARM).

ˆ Loading the default SSL certificates on the RACF keystore database.

ˆ Providing a list of all the other manual steps you must apply on the system to
  complete the installation.



Press ENTER to continue the installation. Press PF3 to quit.

When you press ENTER, the following panel is displayed, with some of the fields pre-filled with default values:

                              Create customized sample jobs                             1/5


Job statement information:                                            
 //ZAGEINST JOB JOBNN_________________________________________________  
  ____________________________________________________________________  
  ____________________________________________________________________  
  ____________________________________________________________________  

  Product libraries (Steplib is optional):                              
  Steplib library    ===> ____________________________________________  
  Message library    ===> ZAGE.INST.SEELMSG0__________________________  
  Data library name  ===> ZAGE.INST.SEELDATA__________________________  

  Agent for z/OS subsystem information:                                 
  Datasets prefix    ===> TWSSSD_____________________                  
  Subsystem name     ===> ZAGE          Subsystem name                  
  Unit name          ===> 3390___      Default unit name               
  Volume serial      ===> EELVOL_       Default volume serial           

  Input  library: specified in the logon procedure (ISPSLIB)            
  Output library:                                                       
  Output dsn name    ===> ____________________________________________  

  SYSOUT class       ===> *             SYSOUT class for reports        

  Press ENTER to continue, PF12 for previous panel, PF3 to quit.

The length of the subsystem name can be at most 4 characters.

The length of the data set prefix can be at most 26 characters.

When you press ENTER, the following sample jobs are created in the Output dsn name data set:
Table 1. Sample jobs created by the installation aid
Sample name Description
EELAGT Generates an agent for z/OS started task procedure sample.
EELAGTP Generates default parameters for the agent for z/OS started task procedure sample.
EELALLDS Allocates the data sets used for the agent for z/OS started task.
EELFLWAS Calls the filewatch utility used to check HFS or ZFS files.
EELJER2V Restores the JES2 exits usermod.
EELJER3O Restores the EELUX091 JES3 usermod.
EELJER3U Restores the EELUX091 and EELUX191 as JES3 usermods.
EELJES2 Assembles and link-edits the JES2 EXIT7.
EELJES2U Installs the JES2 EXIT7 usermod.
EELJES2V Installs the JES2 EXIT51 usermod.
EELJES21 Assembles and link-edits the JES2 EXIT51.
EELJES3 Assembles and link-edits the JES3 exits.
EELJES3O Installs the EELUX091 JES3 usermod.
EELJES3U Installs the JES3 usermod.
EELRCERT Copies default certificates for SSL communication (EELCERCL member in library MISC) to RACF.
EELRETWT Sample program to simulate abends, return codes, and waits.
EELRMD A readme listing the successive manual steps.
EELSMF Assembles and installs the SMF exits.

Then, the following panel is displayed:

                       Create the data sets used for the Started task (EELALLDS)         2/5

The data sets in EELALLDS will be named:
DATASET PREFIX.SUBSYSTEM NAME.NAME

SUBMIT/EDIT JOB    ===> E           S to submit JOB, E to edit   
                                    N to skip to the next panel


Press ENTER to continue the installation. Press PF3 to quit.
After submitting EELALLDS, all the data sets for the new started task are available. They are:
Table 2. Data sets used with the agent for z/OS.
Data set allocated by EELALLDS DD name Dataset description
- EELBRDS Internal reader.

dataset_prefix.subsystem_name.EELDUMP
dataset_prefix.subsystem_name.SYSDUMP

EELDUMP
SYSDUMP

Diagnostic data sets where the agent for z/OS writes debugging information when validity checking discovers internal error conditions.

dataset_prefix.subsystem_name.EV
dataset_prefix.subsystem_name.HT
dataset_prefix.subsystem_name.HTREF

EELEVDS
EELHTDS
EELHTREF

Event data sets containing records that describe events created by the job tracking functions of the agent for z/OS. EELHTDS records events coming from dynamic workload broker, while EELEVDS records events created by JES and SMF that are to be transmitted to dynamic workload broker. EELHTREF is a service data set used for jobs submitted by reference or where the JCL requires variable resolution.
- EELJBLIB Job library data set for the JCLs submitted by reference. When the data set name is not specified in an agent for z/OS job definition, the agent searches EELJBLIB for the member name with which the JCL was saved.
- EELJCLIB The library contains the list of the data sets to trigger in the event rules.
- EELMLIB Messages library.
dataset_prefix.subsystem_name.MLOG EELMLOG Message log.
dataset_prefix.subsystem_name.PARM EELPARM Parameters library containing initialization statements that define runtime options for the agent for z/OS subsystem.

A sample copy of the agent started task (for example, AGT1) is inserted in the output data set.

Check the job output to make sure this step has completed before you continue with the following steps.

The next step inserts the default initialization statements in the parameter library used by the agent started task.

                    Define initialization statements in the parameters library         3/5


INITIALIZATION PARAMETERS ===> AGT1P___     Member in the EELPARM library        
CREATE/EDIT PARAMETERS    ===> E            C to create, E to edit   

Press ENTER to continue the installation. Press PF3 to quit.

The length of the member name in the EELPARM library can be at most 8 characters.

Select E to define the initialization statements with valid values at this time, or C to just create the statements and leave their functioning definition for a later time (this will require that you restart the agent). See Customization parameters for additional information on the initialization statements.

The next panel gives you the option to import the default SSL certificates into the RACF keystore data set.
                                                                           More:     + 
                    Run the EELRCERT job to import the default certificates to RACF      4/5


   To use them, configure the HTTPOPTS initialization statement to activate the SSL
   communication, setting parms TDWBSSL and/or SSL and add the following configurations:          
   SSLKEYRINGTYPE(SAF)                                                  
   SSLKEYRING(EELRING)                                                  
                                                                        
   Note: If you already run default certificates with IBM Workload Scheduler for z/OS, 
         skip this step and configure accordingly.                         
                                                                        
  SUBMIT/EDIT JOB    ===> N           S to submit JOB, E to edit        
                                      N  to skip to the next panel
If in the same system you run also IBM Workload Scheduler for z/OS and the related default SSL certificates, skip this step but configure the SSLKEYRING parameter with the value already used for that scheduler. If you fail to do this, the submission of EELCERT has no effect and returns an RC4 error code.

At the end, a panel that lists all the remaining steps you have to manually run on your z/OS® environment to complete the installation is displayed:

          List of additional manual steps required to complete the installation        5/5

o Add SMF and JES event tracking exits.
  Complete this step only if you do not already have an IBM Workload Scheduler for z/OS 
  tracker active on the z/OS system. Otherwise, see the Scheduling with the Agent for z/OS
  manual.
  
o Update SYS1.PARMLIB.
  - 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). Apply this change only if you do not already run
    an IBM Workload Scheduler for z/OS tracker on the z/OS system.
  - Choose whether to start the Agent for z/OS automatically (COMMNDnn). 

o Set up the RACF environment.

o Set up the SSL environment.
  - Create as many private keys, certificates, and trusted certification authority        
    (CA) chains as you plan to use in your network.
  - Configure the scheduler, by specifying the HTTPOPTS statement for each
    component of your network.

o Update SYS1.PROCLIB.
  - Create a JCL procedure for the z/OS address space.

o Activate TCP/IP connections.
  - Add TCP/IP network definitions. Define an IP address for the Agent for z/OS.
  - Add TCP/IP initialization options. Include initialization statement options in  
   the parameters library for all the Agent for z/OS started tasks.

o Complete the installation.
  - IPL each system where you have installed the Agent for z/OS.
  - Verify the installation.      

This information is also listed in the §EELRMD member of   
the output data set 

Press ENTER to complete, PF12 to return to the previous panel, PF3 to quit.         

The steps are described in the following sections.