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.