Skip to main content

Define the z/OS STC

If you are using the z/OS Real Time Agent, define a started task userid for the agent started task.

The STC userid needs the following authorities:

  • An OMVS segment and home directory
  • Authority to connect to the z/OS SMF Real Time Interface in-memory resource.

This documentation uses the following values. They can be modified to suit your installation standards:

EntryValue
UseridEASYSMFU
GroupEASYSMFG
PROCEASYSMF
Home directory/var/lib/bhs/easysmf
UID and GIDAutomatically assigned
OWNERSECADMIN

Define the userid

Enter the following RACF commands to define the EasySMF user:

ADDGROUP EASYSMFG OMVS(AUTOGID) OWNER(SECADMIN)

ADDUSER EASYSMFU DFLTGRP(EASYSMFG) NOPASSWORD OMVS(AUTOUID HOME(/var/lib/bhs/easysmf) PROGRAM(/bin/sh)) OWNER(SECADMIN)

RDEFINE STARTED EASYSMF.* STDATA(USER(EASYSMFU) GROUP(EASYSMFG)) OWNER(SECADMIN)

SETR RACLIST(STARTED) REFRESH

Give access to the in-memory resource

e.g. if the in memory resource is IFASMF.EASYSMF:

PERMIT IFA.IFASMF.EASYSMF CLASS(FACILITY) ID(EASYSMFU) ACCESS(READ)

SETROPTS REFRESH RACLIST(FACILITY)

Multiple Real Time Agents

More than one EasySMF STC can be defined. You might want to separate high volume processing like CICS into its own task using a different SMF in-memory resource, so you can track the cost of processing those records.

For efficiency, avoid sending high volumes of SMF records to agents that will not process them.