Updating SMF parameters
Updating SMF parameters is necessary to activate the exits used by the agent for z/OS for event tracking.
The SMFPRMnn member defines parameters for the
System Management Facilities (SMF). You must verify that the active
SMF parameter member, SMFPRMnn, specifies that all SMF exits
used by the agent for z/OS for
event tracking are activated, and that the required SMF records are
being collected. If this is not the case, you must update the active
SMF parameter member. Event tracking requires these SMF exits:
- IEFACTRT
- Job-end and step-end exit.
- IEFUJI
- Job initiation exit.
- IEFU83
- Record write exit.
The agent for z/OS uses
the following SMF record types:
- 26
- For all job tracking
- 30
- For all job tracking
- 14
- only for EDWA with SRREAD=YES
- 15
- only for EDWA SRREAD=YES or SRREAD=NO
- 64
- only for EDWA with VSAM data sets
HCL Workload Automation Agent for z/OS requires more SMF records
to be collected if you install the SMF IEFU83 exit with SRREAD set to YES on the EELEXIT invocation.
Specify this if you want special resource availability events automatically generated when a data
set is closed after being opened for:
- Read processing
- Output processing
- Either read or output processing
These SMF records are needed:
- Type 14 records are required for non-VSAM data sets opened for INPUT or RDRBACK processing.
- Type 15 records are required for non-VSAM data sets opened for output.
- Type 64 records are required for VSAM data sets.
- Type 90 records support daylight savings time automatically (optional).
To avoid data set triggering, and thus to improve performance, specify SRREAD=NO in the IEFU83 SMF exit on invocation of the EELEXIT macro. The SRREAD=NO parameter prevents data set triggering for only SMF record type 14.
Active exits are defined by the EXITS parameter of the SYS and SUBSYS keywords. An example of
these keywords
is:
/*SYS and SUBSYS keywords*/
SYS(TYPE(4,5,6,14,15,28,30,37,38,39,64,70,71,72,73,74,75,76,77,78))
SYS(EXITS(IEFACTRT,IEFUJI,IEFU83,IEFU84,IEFU85,IEFUTL,IEFU29,IEFUJV))
SUBSYS(STC,EXITS(IEFACTRT,IEFUJI,IEFU29,IEFU83,IEFU84,IEFU85))
SUBSYS(JESn,EXITS(IEFUJI,IEFACTRT,IEFU83))
Important:
- JESn is either JES2 or JES3. This parameter does not refer to JES itself, but to batch jobs handled by JES. So do not suppress exit invocation. Ensure that you do not specify TYPE6=NO and TYPE26=NO on the JOBCLASS and STCCLASS statements of the JES2 initialization parameters.
- You might find it useful during installation to code two SMFPRMnn members, one with the exits active and the other with the exits inactive. You can then use the SET SMF=nn z/OS® command to switch your current SMF parameters to the new member. By switching back, using the SET SMF=nn command, you avoid the need to re-IPL, if you encounter a problem.
- Exits for SUBSYS STC are required only if you run
also HCL Workload Automation for Z in the same system. If
you run only the agent for z/OS, the
following line is of no use:
SUBSYS(STC,EXITS(IEFUJI,IEFACTRT,IEFU83))
Use the PROGnn parmlib member to specify installation exits and control their use. Using PROGnn, you can associate multiple exit routines with installation exits at IPL, or while the system is running. Consider using PROGnn in addition to SMFPRMnn to specify exits, whether or not you want to take advantage of these functions.
The following example shows how
you can specify SMF exits in a PROGxx parmlib member. If you
specify this in SMFPRMnn:
SYS(...EXITS(IEFACTRT,IEFUJI,IEFU83))
you
would add this to get the equivalent processing in PROGnn: EXIT ADD EXITNAME(SYS.IEFACTRT) MODNAME(IEFACTRT)
EXIT ADD EXITNAME(SYS.IEFUJI) MODNAME(IEFUJI)
EXIT ADD EXITNAME(SYS.IEFU83) MODNAME(IEFU83)
When
you associate new exit routines with SMF exits through PROGnn or
the SETPROG command, you must use the following naming conventions:
- For exits listed on the EXITS keyword of the SYS statement in SMFPRMnn, each exit will have the name SYS.xxxx (where xxxx is one of the exits listed).
- For exits listed on the EXITS keyword of the SUBSYS statement of SMFPRMnn, each exit will have the name SYSzzzzz.xxxx (where zzzz is the name of the subsystem and xxxx is one of the exits listed).