SMFEXIT

The SMFEXIT configuration parameter is used to specify the name of an exit that is called at various processing points and can be used to record activity for historical analysis.

Description

The general format of the SMFEXIT parameter is that it starts with the name of the exit to be called followed by exit-specific parameters. A sample exit that is named CECSXSMF is provided that accepts the following required subparameters:
RECTYPE=nnn
This parameter identifies the record number that is produced by the exit, which is a numeric value between 128 and 255. Specify a value that is not used by any other application or package that produces SMF records.
SYSID=xxxx
In the SMF documentation, this is referred to as the 4-character JES subsystem ID. This is a required element in the SMF record.
Assuming SMF record 250 is available and you decide to use CECS for the SYSID, the information that is provided on the SMFEXIT parameter is:
CECSXSMF RECTYPE=250,SYSID=CECS
The activity that the SMFEXIT is called to report on varies by service:
  • When configured for the OPER service, the exit-name is called to report the clock and CPU time that is required to execute a remote operator command.
  • When configured for the QP service, the exit-name is called to report clock time and CPU time for an individual user session with a query processor task and the individual queries that are issued during the session.
  • When configured for the MAA service, the exit-name is called at periodic intervals to report on subscription activity and is also called when there is a state change for a subscription, or when an error is detected.

Specification

Use: Configuration parameter for the operator service.

Service classes: OPER, QP, MAA

Service tasks: OPER, CACQP, CECMAA

Data type: CHAR(64)

Default value: None

Note: The SMFEXIT parameter starts with the name of the exit to be called which is followed by the RECTYPE and SYSID parameters or QP service the exit-name that is specified is called.