Preparing the environment for configuration with PARMGEN

Edit online

System preparation must be completed before you can create and configure an RTE using PARMGEN.

Procedure

Go through the checklist in technote Preinstallation Requirements and Instructions.

Note: You must have an IBM ID to use the checklist. Make sure all items in the checklist are met, and then move to the next step.
Create a new file system for OMEGAMON AI for JVM that use the RTE_USS_RTEDIR home directory parameter.
This file system must be created, mounted, and in read/write mode before the z/OS® UNIX® System Services jobs that define the file system paths are submitted. Select a name for your RTE that establishes or fits a naming convention that can be used as you install additional RTEs. The KCIUSSJB sample job in the gbl_target_hilev.TKANSAM SMP/E target library is run in the following RTE configuration task.
In the MOUNT FILESYSTEM command, the MOUNTPOINT() parameter equates to the value you will specify for the RTE_USS_RTEDIR parameter. For example, run the following TSO command:
```
MOUNT FILESYSTEM('&hlq_rte_home') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/rtehome') PARM('AGGRGROW')
```
So an example of this using RTE name TSTEST might be:
```
MOUNT FILESYSTEM('OMVS.TSTEST.HFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/tstest') PARM('AGGRGROW')
```
Note: Take note of the SMP/E TKANJAR DDDEF location in z/OS UNIX, which is key to the PARMGEN WCONFIG($GLB$USR) GBL_USS_TKANJAR_PATH required parameter when OMEGAMON AI for JVM 6.1 is installed.
Authorize the monitoring programs.
1. Authorize the product started tasks:
  1. Update RACF® or equivalent security system for the user ID (with OMVS segment) you will use for these started tasks:
    - Hub and remote monitoring servers (the default started task is named IBMDS)
    - Enhanced 3270 user interface (the default started task is named IBMTOM)
    - OMEGAMON AI for JVM (the default started task is IBMJJ)
  2. Identify the user ID you created as a Superuser:
```
ALU <user ID> OMVS(UID(0) HOME(/) PROGRAM(/bin/sh))
```
  3. Use the RDEFINE commands to associate the ID with the following started tasks:
    - IBMDS (the started task of the monitoring server)
    - IBMTOM (the started task of the enhanced 3270 user interface)
    - IBMJJ (the started task of the OMEGAMON AI for JVM agent)
    - IBMJT (the started task of the OMEGAMON AI for JVM collector)
```
*/associate the user ID with started tasks
RDEFINE STARTED IBMDS.* STDATA(USER(userID) GROUP(SYS1)) 
RDEFINE STARTED IBMTOM.* STDATA(USER(userID) GROUP(SYS1))
RDEFINE STARTED IBMJJ.* STDATA(USER(userID) GROUP(SYS1))
RDEFINE STARTED IBMJT.* STDATA(USER(userID) GROUP(SYS1))
```
  4. After you issue all the RDEFINE commands, issue the refresh command:
```
SETROPTS RACLIST(STARTED) REFRESH
```
Update IKJTSOnn with the names of authorized monitoring programs.
You might request your site's authorized system programmers to perform this step so it can be scheduled with the LPAR's change control processes.
- Add programs KPDDSCO, KOBROUTR, and KOBSPFAU to the system PARMLIB member IKJTSOnn under the AUTHPGM section.
- Refresh the IKJTSOnn member by issuing the set command (T IKJTSO=nn).

What to do next

After you finish the preparation tasks, go to PARMGEN and create an RTE.