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:
| 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:
| Data set allocated by EELALLDS | DD name | Dataset description |
|---|---|---|
| - | EELBRDS | Internal reader. |
dataset_prefix.subsystem_name.EELDUMP |
EELDUMP |
Diagnostic data sets where the agent for z/OS writes debugging information when validity checking discovers internal error conditions. |
dataset_prefix.subsystem_name.EV |
EELEVDS |
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.
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.
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 panelAt 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.